Adobe Experience Platform Web SDK Extension

Die AEP Web SDK Extension sendet Daten aus Webeigenschaften über das Adobe Experience Platform Edge Network an das Adobe Experience Cloud. Die Adobe Experience Platform Web SDK-Erweiterung ermöglicht das Streaming von Daten auf eine Plattform, die Synchronisierung von Identitäten, die Teilnahme und die automatische Erfassung von Kontextdaten.

AEP Web SDK-Erweiterung konfigurieren

Dieser Abschnitt enthält eine Referenz zu den Optionen, die beim Konfigurieren der Adobe Experience Platform Web SDK-Erweiterung verfügbar sind.

Wenn die Adobe Experience Platform Web SDK-Erweiterung noch nicht installiert ist, öffnen Sie Ihre Eigenschaft, wählen Sie Extensions > Catalog, halten Sie den Mauszeiger über die Adobe Experience Platform Web SDK-Erweiterung und wählen Sie Install.

Um die Erweiterung zu konfigurieren, öffnen Sie die Registerkarte Extensions, halten Sie den Mauszeiger über die Erweiterung und wählen Sie Configure.

Name der Instanz

Die AEP Web SDK-Erweiterung unterstützt mehrere Instanzen auf der Seite. Dadurch können Daten mit einer einzigen Adobe Experience Platform Launch-Konfiguration an mehrere Organisationen gesendet werden. Die Name-Standardeinstellung ist Alloy. Sie können den Instanznamen jedoch in einen beliebigen anderen gültigen JavaScript-Objektnamen ändern. Die Adobe Experience Platform-Erweiterung verlangt, dass jede Instanz eine eigene Config ID und eine eigene Organization ID hat.

Config ID

Config ID gibt an, wohin Adobe Experience Platform die Daten senden soll und welche Konfigurationen auf dem Server verwendet werden sollen. Dies ist unbedingt erforderlich, damit die Adobe Experience Platform-Erweiterung funktioniert. Wenn Sie eine Konfigurations-ID benötigen, wenden Sie sich an die Kundenunterstützung.

Organization ID

Organization ID bezeichnet die Organisation, an die die Daten von Adobe gesendet werden sollen. Meistens können Sie den Standardwert verwenden, der automatisch eingefügt wird. Wenn Sie mehrere Instanzen auf der Seite haben, geben Sie hier den Wert der zweiten Organisation ein, an die Sie Daten senden möchten.

Edge Domain

Edge Domain ist die Domäne, von der die Adobe Experience Platform-Erweiterung Daten sendet und empfängt. Für die Erweiterung ist es erforderlich, dass Sie einen Erstanbieter-CNAME für den Produktions-Traffic verwenden. Die standardmäßige Drittanbieterdomäne funktioniert in Entwicklungsumgebungen, ist jedoch nicht für Produktionsumgebungen geeignet. Anweisungen zum Einrichten eines Erstanbieter-CNAME finden Sie hier.

Enable Errors

Wenn bei der Erweiterung ein Fehler auftritt, wird dieser standardmäßig in der Konsole protokolliert. Wenn Sie die Fehler in einer Produktionsumgebung ausblenden möchten, deaktivieren Sie das Kontrollkästchen Enable Errors. Wenn das Debugging in Platform Launch aktiviert ist, werden Fehler aber weiterhin ausgegeben.

Enable Opt-in

Wenn Enable Opt-in aktiviert ist, kann die AEP Web SDK-Erweiterung Treffer halten, bis eine Teilnahme eingegangen ist. In der Erweiterung ist eine Aktion zum Einrichten der Opt-in-Einstellungen vorhanden.

Enable Migrate ECID

Die AEP Web SDK-Erweiterung verwendet ein neues Cookie, um die ECID zu speichern. Diese Einstellung ermöglicht die Kompatibilität zwischen dem neuen und alten Cookie zu Migrationszwecken. Adobe empfiehlt dringend, diese Option zu aktivieren, es sei denn, Sie haben keine vorhandenen Besucher mit einer ECID.

Use 3rd Party Cookies

Adobe Experience Platform speichert ein Cookie immer in der Erstanbieterdomäne. Mit dieser Option können Sie neben dem Cookie in der Erstanbieterdomäne auch ein Drittanbieter-Cookie verwenden, das in demdex.net eingerichtet wurde. Dies kann hilfreich sein, wenn Benutzer zwischen mehreren Domänen wechseln. Dadurch werden Aufrufe von demdex.net deaktiviert.

Context

Die Erweiterung erfasst automatisch Informationen zum Kontext der Anfrage (z… B. Details zur URL und zum Browser). Dies kann durch das Deselektieren einzelner Kontexte deaktiviert werden.

  • web – Informationen zur Webseite wie URL, Referrer usw.
  • device – Informationen zum Gerät, wie Bildschirmausrichtung, Bildschirmhöhe und Bildschirmbreite.
  • environment – Informationen zur Computerumgebung (Browser, Verbindung usw.)
  • location – Eingeschränkte Informationen zum Standort des Benutzers

Aktionstypen

Ereignis senden

Sendet ein Ereignis an Adobe Experience Platform, damit Adobe Experience Platform die gesendeten Daten erfassen und entsprechende Aktionen setzen kann. Sie müssen eine Instanz auswählen (wenn mehrere Instanzen vorhanden sind). Wenn das Ereignis zu Beginn eines Seitenladevorgangs oder während einer Ansichtsänderung in einer Einzelseitenanwendung eintritt, wählen Sie die Option Occurs at the start of a view aus.

Alle zu sendenden Daten können im Feld XDM Data gesendet werden. Dies sollte ein JSON-Objekt sein, das der Struktur Ihres XDM-Schemas entspricht. Dieses Objekt kann entweder auf Ihrer Seite oder über ein Custom Code Data Element erstellt werden.

Zustimmung festlegen

Nachdem Sie die Einwilligung Ihres Benutzers erhalten haben, muss dies dem AEP Web SDK mitgeteilt werden. Dazu verwenden Sie den Aktionstyp "Zustimmung festlegen". Derzeit werden zwei Arten von Standards unterstützt: "Adobe"und "IAB TCF". Bei Verwendung des Adobe-Standards können Sie die Einwilligung derzeit als "In", "Out"festlegen oder mithilfe eines Datenelements bereitstellen. Wenn Sie den IAB-TCF-Standard verwenden, geben Sie die Version und den Wert an, die Sie verwenden möchten, sowie zusätzliche Informationen zum GDPR.

In dieser Aktion erhalten Sie auch ein optionales Feld, um eine Identitätskarte einzuschließen, damit Identitäten nach Erhalt der Zustimmung synchronisiert werden können. Dies kann nützlich sein, wenn die Zustimmung als "Ausstehend"konfiguriert ist, da der Einverständnisaufruf wahrscheinlich der erste ausgelöste Aufruf sein wird.

Ereignis-Zusammenführungs-ID zurücksetzen

Wenn Sie Ihre Ereignis Merge ID auf Ihrer Seite zurücksetzen möchten, können Sie dies mit dieser Aktion tun. Um Ihre ID zurückzusetzen, müssen Sie die Merge-ID auswählen, die Sie zurücksetzen möchten, und die Aktion nach Bedarf starten.

Datenelementtypen

Ereignis Merge ID

Dieses Datenelement stellt bei Verwendung eine Ereignis Merge-ID bereit. Für dieses Datenelement ist keine Konfiguration erforderlich. Das bereitgestellte Datenelement bleibt gleich, bis der Besucher die Seite verlässt oder bis der Aktionstyp "Ereignis-Merge-ID zurücksetzen"verwendet wird.

Identitätszuordnung

Mit dem Datenelement "Identitätszuordnung"können Sie Identitäten aus anderen Datenelementen oder anderen von Ihnen angegebenen Werten erstellen. Alle von Ihnen erstellten Identitäten müssen an einen entsprechenden Namensraum zurückgebunden werden. Dieses Datenelement bietet eine Dropdown-Liste mit allen von Ihnen erstellten Standard-Namensräumen.

XDM-Objekt

Alle Daten, die Sie an das Adobe Experience Platform Web SDK senden, sollten im XDM-Format vorliegen. Die Formatierung Ihrer Daten ist mit dem XDM-Objektdatenelement einfacher. Wenn Sie dieses Datenelement zum ersten Mal öffnen, wählen Sie die richtige Adobe Experience Platform-Sandbox und das richtige Schema aus. Nachdem Sie Ihr Schema ausgewählt haben, sehen Sie die Struktur Ihres Schemas, die Sie einfach ausfüllen können.

Beachten Sie, dass beim Öffnen bestimmter Felder Ihres Schemas, z. B. web.webPageDetails.URL, einige Elemente automatisch erfasst werden. Obwohl mehrere Elemente automatisch erfasst werden, haben Sie die Möglichkeit, bei Bedarf alle Elemente zu überschreiben. Alle Werte können manuell oder mithilfe anderer Datenelemente ausgefüllt werden.

HINWEIS

Sie brauchen nur die Informationen einzutragen, die Sie sammeln möchten. Alles, was nicht ausgefüllt wird, wird gesendet, wenn die Daten an die Lösungen gesendet werden.

Auf dieser Seite