Aktionstypen

Last update: Mon Dec 30 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:

Erstellt für:

Entwickler

Nachdem Sie die Tag-Erweiterung Adobe Experience Platform Web SDK konfiguriert haben, müssen Sie Ihre Aktionstypen konfigurieren.

Auf dieser Seite werden die von der Adobe Experience Platform Web SDK-Tag-Erweiterung unterstützten Aktionstypen beschrieben.

Vorschläge anwenden apply-propositions

Mit Aktionstyp " anwenden“ können Sie Vorschläge in Single Page Applications rendern, ohne die Metriken zu inkrementieren.

Dieser Aktionstyp ist nützlich bei der Arbeit mit Einzelseitenanwendungen, bei denen Teile der Seite erneut gerendert werden, wodurch möglicherweise bereits auf die Seite angewendete Personalisierungen überschrieben werden.

Sie können diesen Aktionstyp für verschiedene Anwendungsfälle verwenden, z. B.:

Mbox HTML-Angebote rendern. Vorschläge, die explizit über einen Bereich oder eine Oberfläche von einer Ereignis senden-Aktion angefordert werden, werden nicht automatisch gerendert. Sie können den Aktionstyp Vorschläge anwenden verwenden, um Web SDK mitzuteilen, wo sie gerendert werden sollen, indem Sie die Vorschlagsmetadaten angeben.
Rendern der Angebote für eine Ansicht auf einer Einzelseitenanwendung. Wenn beim Rendern eines Ansichtsänderungsereignisses die Analysedaten noch nicht bereit sind, können Sie die Aktion Vorschläge anwenden verwenden, um die Ansichtsvorschläge oben auf der Seite zu rendern. Siehe Ereignisse oben und unten auf der Seite (Zweite Seitenansicht - Option 2) für weitere Details. Um dies zu verwenden, geben Sie einen Ansichtsnamen in das Formular ein.
Vorschläge neu rendern. Wenn Ihre Site ein Framework wie React verwendet, um Inhalte erneut zu rendern, müssen Sie möglicherweise die Personalisierung erneut anwenden. In solchen Fällen können Sie den Aktionstyp Vorschläge anwenden verwenden, um dies zu tun.

Dieser Aktionstyp sendet kein Anzeigeereignis für gerenderte Vorschläge. Er verfolgt die gerenderten Vorschläge, damit diese in nachfolgenden (Ereignis senden Aufrufen werden können.

Platform Tags-Benutzeroberfläche mit dem Aktionstyp „Vorschläge anwenden“.

Dieser Aktionstyp unterstützt die folgenden Felder:

Vorschläge: Ein Array von Vorschlagsobjekten, die Sie erneut rendern möchten.
Ansichtsname: Der Name der zu rendernden Ansicht.
Vorschlagsmetadaten: Ein Objekt, das bestimmt, wie HTML-Angebote angewendet werden können. Sie können diese Informationen entweder über das Formular oder über ein Datenelement bereitstellen. Sie enthält die folgenden Eigenschaften:
- Perimeter
- selector
- Aktionstyp

Antwort anwenden apply-response

Verwenden Sie Aktionstyp Antwort anwenden“, wenn Sie basierend auf einer Antwort des Edge Networks verschiedene Aktionen ausführen möchten. Dieser Aktionstyp wird normalerweise in Hybridbereitstellungen verwendet, bei denen der -Server einen ersten Aufruf an das -Edge Network sendet. Dieser Aktionstyp nimmt die Antwort aus diesem Aufruf entgegen und initialisiert die Web-SDK im Browser.

Die Verwendung dieses Aktionstyps kann die Client-Ladezeiten für Anwendungsfälle der hybriden Personalisierung reduzieren.

Abbildung der Experience Platform-Benutzeroberfläche mit dem Aktionstyp „Antwort anwenden“.

Dieser Aktionstyp unterstützt die folgenden Konfigurationsoptionen:

Instanz: Wählen Sie die verwendete Web-SDK-Instanz aus.
Antwort-Header: Wählen Sie das Datenelement aus, das ein Objekt zurückgibt, das die Header-Schlüssel und -Werte enthält, die vom Edge Network-Server-Aufruf zurückgegeben werden.
Antworttext: Wählen Sie das Datenelement aus, das das Objekt mit der JSON-Payload zurückgibt, die von der Edge Network-Antwort bereitgestellt wird.
Visuelle Personalisierungsentscheidungen rendern: Aktivieren Sie diese Option, um den vom Edge Network bereitgestellten Personalisierungsinhalt automatisch zu rendern und den Inhalt vorab auszublenden, um ein Flackern zu verhindern.

Regelsätze auswerten evaluate-rulesets

Mit diesem Aktionstyp wird die Auswertung von Regelsätzen manuell Trigger. Regelsätze werden von Adobe Journey Optimizer zurückgegeben, um Funktionen wie In-Browser-Nachrichten zu unterstützen.

Abbildung der Experience Platform-Benutzeroberfläche mit dem Aktionstyp „Regelsätze auswerten“.

Dieser Aktionstyp unterstützt die folgenden Optionen:

Visuelle Personalisierungsentscheidungen rendern: Aktivieren Sie diese Option, um visuelle Personalisierungsentscheidungen für die entsprechenden Regelsatzelemente zu rendern.
Entscheidungskontext: Dies ist eine Schlüssel-Wert-Zuordnung, die bei der Auswertung von Adobe Journey Optimizer-Regelsätzen für die geräteinterne Entscheidungsfindung verwendet wird. Sie können den Entscheidungskontext manuell oder über ein Datenelement bereitstellen.

Abrufen von Media Analytics Tracker get-media-analytics-tracker

Mit dieser Aktion wird die veraltete Media Analytics-API abgerufen. Wenn Sie die Aktion konfigurieren und einen Objektnamen angeben, wird die veraltete Media Analytics-API in dieses Fensterobjekt exportiert. Wenn keine angegeben wird, wird sie wie die aktuelle Media JS-Bibliothek nach window.Media exportiert.

Platform-UI-Bild, das den Aktionstyp „Media Analytics-Tracker abrufen“ zeigt.

Mit Identität umleiten redirect-with-identity

Verwenden Sie diesen Aktionstyp, um Identitäten von der aktuellen Seite für andere Domains freizugeben. Diese Aktion ist für die Verwendung mit einem Klick-Ereignistyp und einer Wertvergleichsbedingung vorgesehen. Weitere Informationen Verwendung dieses Aktionstyps finden Sie unter „Anfügen vonan URL mithilfe der Web-SDK-Erweiterung“.

Ereignis senden send-event

Sendet ein Ereignis an Experience Platform, damit Platform die von Ihnen gesendeten Daten erfassen und auf diese Informationen reagieren kann. Alle Daten, die Sie senden möchten, können im Feld XDM-Daten gesendet werden. Verwenden Sie ein JSON, das der Struktur Ihres XDM entspricht. Dieses Objekt kann entweder auf Ihrer Seite oder über ein benutzerdefinierter Code-erstellt.

Der Ereignis senden Aktionstyp unterstützt die unten beschriebenen Felder und Einstellungen. Diese Felder sind alle optional.

Instanzeneinstellungen instance

Verwenden Sie den Instance-Selektor, um die Web SDK-Instanz auszuwählen, die Sie konfigurieren möchten. Wenn Sie nur eine Instanz haben, ist diese vorausgewählt.

Bild der Platform Tags-Benutzeroberfläche mit den Instanzeinstellungen für den Aktionstyp „Ereignis senden“.

Instanz: Wählen Sie die Web-SDK-Instanz aus, die Sie konfigurieren möchten. Wenn Sie nur über eine Instanz verfügen, ist diese vorausgewählt.

Geführte Ereignisse verwenden: Aktivieren Sie diese Option, um bestimmte Felder automatisch auszufüllen oder auszublenden, um einen bestimmten Anwendungsfall zu aktivieren. Durch Aktivierung dieser Option wird die Anzeige der folgenden Einstellungen Trigger.

Personalisierung anfordern: Dieses Ereignis sollte am Seitenanfang aufgerufen werden. Wenn dieses Ereignis ausgewählt ist, werden die folgenden Felder festgelegt:
- type: decisioning-Vorschlag abrufen
- Anzeige-Ereignis automatisch senden: false
- Um in diesem Fall die Personalisierung automatisch zu rendern, aktivieren Sie die Option Visuelle Personalisierungsentscheidungen rendern .
Analytics erfassen: Dieses Ereignis soll am unteren Rand der Seite aufgerufen werden. Wenn dieses Ereignis ausgewählt ist, werden die folgenden Felder festgelegt:
- Gerenderte Vorschläge einschließen: true
- Die Einstellungen für Personalization sind ausgeblendet

note note
NOTE
Die geführten Ereignisse beziehen sich auf Ereignisse oben und unten auf der Seite.

Daten data

Bild der Platform Tags-Benutzeroberfläche mit den Datenelementeinstellungen für den Aktionstyp „Ereignis senden“.

Type: In diesem Feld können Sie einen Ereignistyp angeben, der in Ihrem XDM-Schema aufgezeichnet wird. Weitere Informationen finden Sie unter type im sendEvent.
XDM:
Data: Verwenden Sie dieses Feld, um Daten zu senden, die nicht mit einem XDM-Schema übereinstimmen. Dieses Feld ist nützlich, wenn Sie versuchen, ein Adobe Target-Profil zu aktualisieren oder Target-Recommendations-Attribute zu senden. Weitere Informationen finden Sie unter data im sendEvent.
Gerenderte Vorschläge einschließen: Aktivieren Sie diese Option, um alle Vorschläge einzuschließen, die gerendert wurden, für die jedoch kein Anzeigeereignis gesendet wurde. Verwenden Sie diese Option zusammen mit Automatisch ein Anzeigeereignis senden deaktiviert. Diese Einstellung aktualisiert das XDM-Feld _experience.decisioning mit Informationen zu den gerenderten Vorschlägen.
Dokument wird entladen: Aktivieren Sie diese Option, um sicherzustellen, dass die Ereignisse den Server erreichen, auch wenn der Benutzer die Seite verlässt. Dadurch können Ereignisse den Server erreichen, Antworten werden jedoch ignoriert.
Zusammenführungs-ID: Dieses Feld ist veraltet. Dadurch wird das eventMergeId XDM-Feld ausgefüllt.

Personalisierung personalization

Bild der Platform Tags-Benutzeroberfläche mit den Personalization-Einstellungen für den Aktionstyp „Ereignis senden“.

Bereiche: Wählen Sie die Bereiche (Adobe Target-mboxes) aus, die Sie explizit von der Personalisierung anfordern möchten. Sie können die Bereiche manuell eingeben oder ein Datenelement bereitstellen.
Oberflächen: Legen Sie die Web-Oberflächen fest, die auf der Seite zur Personalisierung verfügbar sind. Weitere Informationen finden Sie in der Dokumentation 🔗 Adobe Journey Optimizer .
Visuelle Personalisierungsentscheidungen rendern: Wenn Sie personalisierte Inhalte auf Ihrer Seite rendern möchten, aktivieren Sie das Kontrollkästchen Visuelle Personalisierungsentscheidungen rendern. Sie können bei Bedarf auch Entscheidungsumfänge und/oder Oberflächen angeben. Weitere Informationen Rendern personalisierter Inhalte findenin der Personalisierungsdokumentation .
Standardpersonalisierung anfordern: Verwenden Sie diesen Abschnitt, um zu steuern, ob der seitenweite Bereich (globale Mbox) und die Standardoberfläche (Web-Oberfläche basierend auf der aktuellen URL) angefordert werden. Standardmäßig wird dies automatisch beim ersten sendEvent des Seitenladevorgangs angefordert. Sie können aus den folgenden Optionen wählen:
- Automatisch: Dies ist das Standardverhalten. Fordern Sie nur die Standard-Personalisierung an, wenn sie noch nicht angefordert wurde. Dies entspricht requestDefaultPersonalization , die im Web-SDK-Befehl nicht festgelegt sind.
- Aktiviert: Explizit den Seitenbereich und die Standardoberfläche anfordern. Dadurch wird der SPA-Ansichtscache aktualisiert. Dies entspricht requestDefaultPersonalization auf true festgelegten Wert.
- Deaktiviert: Unterdrückt die Anforderung für den Seitenbereich und die Standardoberfläche explizit. Dies entspricht requestDefaultPersonalization auf false festgelegten Wert.
Entscheidungskontext: Dies ist eine Schlüssel-Wert-Zuordnung, die bei der Auswertung von Adobe Journey Optimizer-Regelsätzen für die geräteinterne Entscheidungsfindung verwendet wird. Sie können den Entscheidungskontext manuell oder über ein Datenelement bereitstellen.

Überschreibungen der Datenstromkonfiguration datastream-overrides

Mit Datenstromüberschreibungen können Sie zusätzliche Konfigurationen für Ihre Datenströme definieren, die über das Web SDK an das Edge-Netzwerk übergeben werden.

Auf diese Weise können Sie andere Datenstromverhaltensweisen als die standardmäßigen Trigger vornehmen, ohne einen neuen Datenstrom zu erstellen oder Ihre bestehenden Einstellungen zu ändern. Weitere Informationen finden Sie in Dokumentation unter „Konfigurieren von".

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. Instanz auswählen (wenn mehrere Instanzen vorhanden sind) Die Aktion erfordert eine playerId, die eine eindeutige Kennung für eine verfolgte Mediensitzung darstellt. Darüber hinaus sind „Erlebnisqualität und ein playhead Datenelement beim Starten einer Mediensitzung erforderlich.

Platform-UI-Bild, das den Bildschirm „Medienereignis senden“ anzeigt.

Der Aktionstyp Medienereignis senden unterstützt die folgenden Eigenschaften:

Instance: Die verwendete Web-SDK-Instanz.
Medienereignistyp: Der Typ des verfolgten Medienereignisses.
Player-ID: Die eindeutige Kennung der Mediensitzung.
Abspielkopf: 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 Medienereignisses für den Kapitelstart angeben.
Advertising-: Beim Senden eines AdBreakStart müssen Sie die erforderlichen Werbedetails angeben.
Advertising-Pod-: Details zum Advertising-Pod beim Senden eines AdStart.
Fehlerdetails: Details zum Wiedergabefehler, der verfolgt wird.
Statusaktualisierungsdetails: Der Player-Status, der aktualisiert wird.
Benutzerdefinierte Metadaten: Die benutzerdefinierten Metadaten über das Medienereignis, das verfolgt wird.
Erlebnisqualität: Die Medienqualität der Erlebnisdaten, die verfolgt wird.

Nachdem Sie das Einverständnis Ihres Benutzers erhalten haben, muss dieses Einverständnis mithilfe des Aktionstyps „Einverständnis festlegen“ an die Adobe Experience Platform Web SDK übermittelt werden. Derzeit werden zwei Arten von Standards unterstützt: „Adobe“ und „IAB TCF“. Siehe Unterstützen von Voreinstellungen für das Kundeneinverständnis. Bei Verwendung von Adobe Version 2.0 wird nur ein Datenelementwert unterstützt. Sie müssen ein Datenelement erstellen, das zum Einverständnisobjekt aufgelöst wird.

In dieser Aktion wird Ihnen auch ein optionales Feld bereitgestellt, um eine Identitätszuordnung einzuschließen, damit Identitäten nach Erhalt des Einverständnisses synchronisiert werden können. Die Synchronisierung ist nützlich, wenn das Einverständnis als „Ausstehend“ oder „Out“ konfiguriert ist, da der Einverständnisaufruf wahrscheinlich der erste auszulösende Aufruf ist.

Variable aktualisieren update-variable

Verwenden Sie diese Aktion, um ein XDM-Objekt als Ergebnis eines Ereignisses zu ändern. Diese Aktion dient zum Erstellen eines -Objekts, auf das später von einer Ereignis senden-Aktion verwiesen werden kann, um das Ereignis-XDM-Objekt aufzuzeichnen.

Um diesen Aktionstyp verwenden zu können, müssen Sie ein Datenelement Variable definiert haben. Nachdem Sie ein variables Datenelement zum Ändern ausgewählt haben, wird ein Editor angezeigt, ähnlich dem Editor für das Datenelement XDMObjekt.

Das XDM-Schema, das für den Editor verwendet wird, ist das Schema, das im Datenelement Variable ausgewählt wird. Sie können eine oder mehrere Eigenschaften des Objekts festlegen, indem Sie auf eine der Eigenschaften im Baum links klicken und dann den Wert rechts ändern. Im folgenden Screenshot wird beispielsweise die Eigenschaft „productedBy“ auf das Datenelement „Produced by data element“ festgelegt.

Es gibt einige Unterschiede zwischen dem Editor in der Aktion „Variable aktualisieren“ und dem Editor im XDM-Objektdatenelement. Erstens verfügt die Aktion Variable aktualisieren über ein Stammelement 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 Variable aktualisieren über Kontrollkästchen, um die Daten aus dem XDM-Objekt zu löschen. Klicken Sie auf eine der Eigenschaften auf der linken Seite, und aktivieren Sie dann das Kontrollkästchen auf der rechten Seite, um den Wert zu löschen. Dadurch wird der aktuelle Wert gelöscht, bevor Werte für die Variable festgelegt werden.

Nächste Schritte next-steps

Nach dem Lesen dieses Artikels sollten Sie besser verstehen, wie Sie Ihre Aktionen konfigurieren können. Lesen Sie als Nächstes über das Konfigurieren Ihrer Datenelementtypen.

recommendation-more-help

12b4e4a9-5028-4d88-8ce6-64a580811743