Aktionstypen
Nachdem Sie die Adobe Experience Platform Web SDK-Tag-Erweiterungmüssen Sie Ihre Aktionstypen konfigurieren.
Auf dieser Seite werden die von der Variablen Adobe Experience Platform Web SDK-Tag-Erweiterung.
Antwort anwenden apply-response
Verwenden Sie die Antwort anwenden Aktionstyp, wenn Sie basierend auf einer Antwort des Edge Networks verschiedene Aktionen durchführen möchten. Dieser Aktionstyp wird normalerweise in Hybridbereitstellungen verwendet, bei denen der Server einen ersten Aufruf an das Edge Network durchführt. Anschließend nimmt dieser Aktionstyp die Antwort aus diesem Aufruf und initialisiert das Web SDK im Browser.
Die Verwendung dieses Aktionstyps kann die Client-Ladezeiten für hybride Personalisierungsfälle verkürzen.
Dieser Aktionstyp unterstützt die folgenden Konfigurationsoptionen:
- Instanz: Wählen Sie die verwendete Web SDK-Instanz aus.
- Antwortheader: Wählen Sie das Datenelement aus, das ein Objekt zurückgibt, das die Header-Schlüssel und die vom Edge Network-Server-Aufruf zurückgegebenen Werte enthält.
- Antworttext: Wählen Sie das Datenelement aus, das das Objekt zurückgibt, das die von der Edge Network-Antwort bereitgestellte JSON-Payload enthält.
- visuelle Personalisierungsentscheidungen rendern: Aktivieren Sie diese Option, um den vom Edge Network bereitgestellten Personalisierungsinhalt automatisch zu rendern und den Inhalt vorab auszublenden, um Flackern zu vermeiden.
Ereignis senden send-event
Sendet ein Ereignis an Adobe Experience Platform damit Adobe Experience Platform die von Ihnen gesendeten Daten erfassen und entsprechend handeln kann. Wählen Sie eine Instanz aus (wenn mehrere Instanzen vorhanden sind). Alle Daten, die Sie senden möchten, können im XDM-Daten -Feld. Verwenden Sie ein JSON-Objekt, das der Struktur Ihres XDM-Schemas entspricht. Dieses Objekt kann entweder auf Ihrer Seite oder über eine Benutzerspezifischer Code Datenelement.
Es gibt einige weitere Felder im Aktionstyp Ereignis senden , die je nach Implementierung ebenfalls nützlich sein können. Bitte beachten Sie, dass alle diese Felder optional sind.
- Typ: In diesem Feld können Sie einen Ereignistyp angeben, der in Ihrem XDM-Schema aufgezeichnet wird. Siehe
typeimsendEventfür weitere Informationen. - Daten: Daten, die nicht mit einem XDM-Schema übereinstimmen, können mit diesem Feld gesendet werden. Dieses Feld ist nützlich, wenn Sie versuchen, ein Adobe Target-Profil zu aktualisieren oder Target Recommendations-Attribute zu senden. Siehe
dataimsendEventfür weitere Informationen. - Datensatz-ID: Wenn Sie Daten an einen Datensatz senden müssen, der nicht in Ihrem Datensatz angegeben wurde, können Sie diese Datensatz-ID hier angeben.
- Dokument wird entladen: Wenn Sie sicherstellen möchten, dass die Ereignisse den Server erreichen, auch wenn der Benutzer von der Seite weg navigiert, überprüfen Sie die Dokument wird entladen aktivieren. Dadurch können Ereignisse den Server erreichen, Antworten werden jedoch ignoriert.
- Entscheidungen zur visuellen Personalisierung rendern: Wenn Sie personalisierte Inhalte auf Ihrer Seite rendern möchten, überprüfen Sie die visuelle Personalisierungsentscheidungen rendern aktivieren. Sie können bei Bedarf auch Entscheidungsbereiche und/oder Oberflächen angeben. Siehe Personalisierungsdokumentation für weitere Informationen zum Rendern personalisierter Inhalte.
Einverständnis festlegen set-consent
Nachdem Sie die Einwilligung Ihres Benutzers erhalten haben, muss diese Einwilligung mithilfe des Aktionstyps "Einverständnis festlegen"an das Adobe Experience Platform Web SDK übermittelt werden. Derzeit werden zwei Arten von Standards unterstützt: „Adobe“ und „IAB TCF“. Siehe Unterstützende Voreinstellungen für die Kundeneinwilligung. Bei Verwendung von Adobe Version 2.0 wird nur ein Datenelementwert unterstützt. Sie müssen ein Datenelement erstellen, das in das Objekt für die Zustimmung aufgelöst wird.
Bei dieser Aktion erhalten Sie auch ein optionales Feld, um eine Identity Map einzuschließen, damit Identitäten synchronisiert werden können, sobald die Zustimmung eingeht. Die Synchronisierung ist nützlich, wenn die Zustimmung als "Ausstehend"oder "Out"konfiguriert ist, da der Zustimmungsaufruf wahrscheinlich der erste ausgelöste Aufruf ist.
Variable aktualisieren update-variable
Verwenden Sie diese Aktion, um ein XDM-Objekt als Ergebnis eines Ereignisses zu ändern. Mit dieser Aktion soll ein Objekt erstellt werden, das später über eine Ereignis senden -Aktion, um das Ereignis-XDM-Objekt aufzuzeichnen.
Um diesen Aktionstyp verwenden zu können, müssen Sie eine Variable Datenelement. Sobald Sie ein zu änderndes Variablendatenelement ausgewählt haben, wird ein Editor ähnlich dem Editor für XDM-Objekt Datenelement.
Das für den Editor verwendete XDM-Schema ist das Schema, das auf der Variable Datenelement. Sie können eine oder mehrere Eigenschaften des Objekts festlegen, indem Sie auf eine der Eigenschaften im Baum auf der linken Seite klicken und dann den Wert auf der rechten Seite ändern. Im folgenden Screenshot wird beispielsweise die Eigenschaft "productionBy"auf das Datenelement "Produced by data element"gesetzt.
Es gibt einige Unterschiede zwischen dem Editor in der Aktion "Variable aktualisieren"und dem Editor im XDM-Objektdatenelement. Zunächst enthält die Aktion für die Variable "update"ein Element auf der Stammebene mit der Bezeichnung "xdm". Wenn Sie auf dieses Element klicken, können Sie ein Datenelement angeben, das zum Festlegen des gesamten Objekts verwendet werden soll. Zweitens verfügt die Aktion für die Variable "update"über Kontrollkästchen, um die Daten aus dem xdm-Objekt zu löschen. Klicken Sie links auf eine der Eigenschaften und aktivieren Sie dann das Kontrollkästchen rechts, um den Wert zu löschen. Dadurch wird der aktuelle Wert gelöscht, bevor Werte für die Variable festgelegt werden.
Medienereignis senden send-media-event
Sendet ein Medienereignis an Adobe Experience Platform und/oder Adobe Analytics. Diese Aktion ist nützlich, wenn Sie Medienereignisse auf Ihrer Website verfolgen. Wählen Sie eine Instanz aus (wenn mehrere Instanzen vorhanden sind). Die Aktion erfordert eine playerId , der eine eindeutige Kennung für eine verfolgte Mediensitzung darstellt. Dazu ist auch eine Erlebnisqualität und playhead -Datenelement beim Starten einer Mediensitzung.
Die Medienereignis senden Der Aktionstyp unterstützt die folgenden Eigenschaften:
- Instanz: Die verwendete Web SDK-Instanz.
- Medien-Ereignistyp: Der Typ des zu verfolgenden Medienereignisses.
- Player-ID: Die eindeutige Kennung der Mediensitzung.
- Abspielleiste: Die aktuelle Position der Medienwiedergabe in Sekunden.
- Details zur Mediensitzung: Beim Senden eines Medienstartereignisses sollten die erforderlichen Details zur Mediensitzung angegeben werden.
- Kapiteldetails: In diesem Abschnitt können Sie die Kapiteldetails beim Senden eines Kapitelstart-Medienereignisses angeben.
- Werbedetails: Beim Senden einer
AdBreakStart-Ereignis verwenden, müssen Sie die erforderlichen Werbedetails angeben. - Details zum Anzeigen-Pod: Details zum Anzeigen-Pod beim Senden einer
AdStart-Ereignis. - Fehlerdetails: Details zum Wiedergabefehler, der verfolgt wird.
- Statusaktualisierungsdetails: Der Player-Status, der aktualisiert wird.
- Benutzerdefinierte Metadaten: Die benutzerdefinierten Metadaten zum Medienereignis, das verfolgt wird.
- Erlebnisqualität: Die Medienqualität der getrackten Erlebnisdaten.
Media Analytics-Tracker abrufen get-media-analytics-tracker
Mit dieser Aktion wird die veraltete Media Analytics-API abgerufen. Wenn die Aktion konfiguriert und ein Objektname angegeben wird, wird die veraltete Media Analytics-API in dieses Fensterobjekt exportiert. Wenn keines angegeben ist, wird er nach window.Media , wie es die aktuelle Media JS-Bibliothek tut.
Umleiten mit Identität redirect-with-identity
Verwenden Sie diesen Aktionstyp, um Identitäten von der aktuellen Seite für andere Domänen freizugeben. Diese Aktion ist für die Verwendung mit einer click Ereignistyp und eine Wertvergleichsbedingung. Siehe Anhängen der Identität an URL mithilfe der Web SDK-Erweiterung für weitere Informationen zur Verwendung dieses Aktionstyps.
Nächste Schritte next-steps
Nach dem Lesen dieses Artikels sollten Sie ein besseres Verständnis davon haben, wie Sie Ihre Aktionen konfigurieren. Lesen Sie als Nächstes, wie Sie Datenelementtypen konfigurieren.