Verwenden Sie Adobe Target und Web SDK für die Personalisierung

Adobe Experience Platform Web SDK kann personalisierte Erlebnisse, die in Adobe Target verwaltet werden, für den Webkanal bereitstellen und rendern. Sie können einen WYSIWYG-Editor namens Visual Experience Composer (VEC) oder eine nicht visuelle Schnittstelle, den formularbasierten Experience Composer, verwenden, um Aktivitäten und Personalisierungserlebnisse zu erstellen, zu aktivieren und bereitzustellen.

IMPORTANT
Erfahren Sie, wie Sie Ihre Target-Implementierung mit dem Tutorial Migration von Target von at.js 2.x zum Platform Web SDK in das Platform Web SDK migrieren.
Erfahren Sie, wie Sie Target zum ersten Mal mit dem Tutorial Adobe Experience Cloud mit Web SDK implementieren implementieren. Spezifische Informationen zu Target finden Sie im Tutorial-Abschnitt mit dem Titel Einrichten von Target mit Platform Web SDK .

Die folgenden Funktionen wurden getestet und werden derzeit in Target unterstützt:

Web SDK Systemdiagramm

Das folgende Diagramm veranschaulicht den Arbeitsablauf der Edge-Entscheidungsfindung von Target und Web SDK.

Diagramm der Adobe Target-Edge-Entscheidung mit dem Platform Web SDK

Aufruf
Details
1
Das Gerät lädt den Web SDK. Der Web SDK sendet eine Anfrage mit XDM-Daten, der ID der Datastreams-Umgebung, den übergebenen Parametern und der Kunden-ID (optional) an das Edge Network. Seite (oder Container) ist vorab ausgeblendet.
2
Das Edge Network sendet die Anfrage an die Edge-Dienste, um sie mit der Besucher-ID, der Zustimmung und anderen Besucherkontextinformationen wie Geolocation und gerätefreundlichen Namen anzureichern.
3
Das Edge Network sendet die angereicherte Personalisierungsanforderung mit der Besucher-ID und den übergebenen Parametern an den Target -Edge.
4
Profilskripte werden ausgeführt und dann in den Target -Profilspeicher eingespeist. Der Profilspeicher ruft Segmente aus der Zielgruppenbibliothek ab (z. B. Segmente, die aus Adobe Analytics, Adobe Audience Manager und dem Adobe Experience Platform freigegeben wurden).
5
Basierend auf URL-Anforderungsparametern und Profildaten bestimmt Target, welche Aktivitäten und Erlebnisse für den Besucher für die aktuelle Seitenansicht und für künftige vorab abgerufene Ansichten angezeigt werden sollen. Target sendet dies dann zurück an das Edge Network.
6
a. Das Edge Network sendet die Personalisierungsantwort zurück an die Seite, optional einschließlich der Profilwerte für eine zusätzliche Personalisierung. Personalisierte Inhalte auf der aktuellen Seite werden so schnell wie möglich bereitgestellt, ohne dass Standardinhalte aufflackern.
b. Personalisierte Inhalte für Ansichten, die als Ergebnis von Benutzeraktionen in einer Einzelseiten-App (SPA) angezeigt werden, werden zwischengespeichert und können sofort ohne zusätzlichen Server-Aufruf angewendet werden, wenn die Ansichten ausgelöst werden.
c. Das Edge Network sendet die Besucher-ID und andere Werte in Cookies, z. B. Zustimmung, Sitzungs-ID, Identität, Cookie-Prüfung, Personalisierung.
7
Das Web SDK sendet die Benachrichtigung vom Gerät an das Edge Network.
8
Das Edge Network leitet Analytics for Target (A4T)-Details (Aktivitäts-, Erlebnis- und Konversionsmetadaten) an den Analytics -Edge weiter.

Aktivieren von Adobe Target

Gehen Sie wie folgt vor, um Target zu aktivieren:

  1. Aktivieren Sie Target in Ihrem datastream mit dem entsprechenden Clientcode.
  2. Fügen Sie Ihren Ereignissen die Option renderDecisions hinzu.

Anschließend können Sie optional auch die folgenden Optionen hinzufügen:

  • decisionScopes: Rufen Sie bestimmte Aktivitäten ab (nützlich für Aktivitäten, die mit dem formularbasierten Composer erstellt wurden), indem Sie diese Option zu Ihren Ereignissen hinzufügen.
  • Codeausschnitt vorab ausblenden: Blendet nur bestimmte Teile der Seite aus.

Verwenden von Adobe Target VEC

Um VEC mit einer Implementierung vom Typ Web SDK zu verwenden, installieren und aktivieren Sie entweder die VEC Helper-Erweiterung Firefox oder die VEC Helper-Erweiterung Chrome .

Weitere Informationen finden Sie unter Visual Experience Composer Helper Extension im Adobe Target-Handbuch.

Rendern von personalisiertem Inhalt

Weitere Informationen finden Sie unter Rendern von Personalisierungsinhalten .

Zielgruppen in XDM

Beim Definieren von Zielgruppen für Ihre Target -Aktivitäten, die über Web SDK bereitgestellt werden, muss XDM definiert und verwendet werden. Nachdem Sie XDM-Schemas, Klassen und Schemafeldgruppen definiert haben, können Sie eine Target-Zielgruppenregel erstellen, die von XDM-Daten für das Targeting definiert wird. Innerhalb von Target werden XDM-Daten im Audience Builder als benutzerdefinierter Parameter angezeigt. Das XDM wird mit Punktnotation serialisiert (z. B. web.webPageDetails.name).

Wenn Sie über Target -Aktivitäten mit vordefinierten Zielgruppen verfügen, die benutzerdefinierte Parameter oder ein Benutzerprofil verwenden, werden diese nicht korrekt über das SDK bereitgestellt. Statt benutzerdefinierte Parameter oder das Benutzerprofil zu verwenden, müssen Sie stattdessen XDM verwenden. Es gibt jedoch native Zielgruppen-Targeting-Felder, die über die Web SDK unterstützt werden und keine XDM erfordern. Diese Felder sind in der Benutzeroberfläche von Target verfügbar, für die kein XDM erforderlich ist:

  • Target-Bibliothek
  • Geo
  • Netzwerk
  • Operating System
  • Seiten der Site
  • Browser
  • Traffic-Quellen
  • Zeitrahmen

Weitere Informationen finden Sie unter Kategorien für Zielgruppen im Adobe Target-Handbuch.

Antwort-Token

Antwort-Token werden verwendet, um Metadaten an Dritte wie Google oder Facebook zu senden. Antwort-Token werden zurückgegeben
im Feld meta innerhalb von propositions -> items. Im Folgenden finden Sie ein Beispiel:

{
  "id": "AT:eyJhY3Rpdml0eUlkIjoiMTI2NzM2IiwiZXhwZXJpZW5jZUlkIjoiMCJ9",
  "scope": "__view__",
  "scopeDetails": ...,
  "renderAttempted": true,
  "items": [
    {
      "id": "0",
      "schema": "https://ns.adobe.com/personalization/dom-action",
      "meta": {
        "experience.id": "0",
        "activity.id": "126736",
        "offer.name": "Default Content",
        "offer.id": "0"
      }
    }
  ]
}

Um die Antwort-Token zu sammeln, müssen Sie das alloy.sendEvent-Versprechen abonnieren, durch propositions navigieren und die Details aus items -> meta extrahieren.

Jede proposition hat ein boolesches Feld renderAttempted, das angibt, ob die proposition gerendert wurde oder nicht. Siehe Beispiel unten:

alloy("sendEvent",
  {
    "renderDecisions": true,
    "decisionScopes": [
      "hero-container"
    ]
  }).then(result => {
    const { propositions } = result;

    // filter rendered propositions
    const renderedPropositions = propositions.filter(proposition => proposition.renderAttempted === true);

    // collect the item metadata that represents the response tokens
    const collectMetaData = (items) => {
      return items.filter(item => item.meta !== undefined).map(item => item.meta);
    }

    const pageLoadResponseTokens = renderedPropositions
      .map(proposition => collectMetaData(proposition.items))
      .filter(e => e.length > 0)
      .flatMap(e => e);
  });

Wenn das automatische Rendering aktiviert ist, enthält das Vorschlagsarray:

Beim Laden der Seite:

  • Form-Based Composer based propositions , wobei die Markierung renderAttempted auf false gesetzt ist
  • Visual Experience Composer-basierte Vorschläge mit renderAttempted -Markierung auf true gesetzt
  • Visual Experience Composer-basierte Vorschläge für eine Einzelseiten-Anwendungsansicht mit renderAttempted -Markierung auf true

On View - change (für zwischengespeicherte Ansichten):

  • Visual Experience Composer-basierte Vorschläge für eine Einzelseiten-Anwendungsansicht mit renderAttempted -Markierung auf true

Wenn das automatische Rendering deaktiviert ist, enthält das Vorschlagsarray:

Beim Laden der Seite:

  • Form-based Composer-basiertes propositions mit renderAttempted -Markierung auf false gesetzt
  • Visual Experience Composer basierte Vorschläge mit renderAttempted Markierung auf false gesetzt
  • Visual Experience Composer-basierte Vorschläge für eine Einzelseiten-Anwendungsansicht, deren Markierung renderAttempted auf false gesetzt ist

On View - change (für zwischengespeicherte Ansichten):

  • Visual Experience Composer-basierte Vorschläge für eine Einzelseiten-Anwendungsansicht mit der Markierung renderAttempted, die auf false gesetzt ist

Einzelprofil-Update

Mit dem Web SDK können Sie das Profil als Erlebnisereignis auf das Profil Target und auf das Profil Web SDK aktualisieren.

Um ein Target -Profil zu aktualisieren, stellen Sie sicher, dass die Profildaten mit folgenden Werten übergeben werden:

  • Unter "data {"
  • Unter "__adobe.target"
  • Präfix "profile."
Schlüssel
Typ
Beschreibung
renderDecisions
Boolesch
Weist die Personalisierungskomponente an, ob DOM-Aktionen interpretiert werden sollen
decisionScopes
Array <String>
Eine Liste der Bereiche, für die Entscheidungen abgerufen werden sollen
xdm
Objekt
In XDM formatierte Daten, die im Web SDK als Erlebnisereignis landen
data
Objekt
Beliebige Schlüssel/Wert-Paare, die unter der Zielklasse an Target -Lösungen gesendet werden.

Verzögern Sie das Speichern von Profil- oder Entitätsparametern, bis dem Endbenutzer Inhalt angezeigt wurde

Um die Aufzeichnung von Attributen im Profil so lange zu verzögern, bis der Inhalt angezeigt wurde, setzen Sie in Ihrer Anfrage data.adobe.target._save=false .

Ihre Website enthält beispielsweise drei Entscheidungsbereiche, die drei Kategorielinks auf der Website entsprechen (Männer, Frauen und Kinder), und Sie möchten die Kategorie verfolgen, die der Benutzer schließlich besucht hat. Senden Sie diese Anfragen mit der Markierung __save , die auf false gesetzt ist, um zu vermeiden, dass die Kategorie zum Zeitpunkt der Inhaltsanforderung beibehalten wird. Nachdem der Inhalt visualisiert wurde, senden Sie die richtige Payload (einschließlich der eventToken und stateToken), damit die entsprechenden Attribute aufgezeichnet werden.

Im folgenden Beispiel wird eine trackEvent-Meldung gesendet, Profilskripte ausgeführt, Attribute gespeichert und das Ereignis sofort aufgezeichnet.

alloy("sendEvent", {
    "renderDecisions": true,
    "data": {
        "xdm": { // Experience Event XDM data },
            "__adobe": {
                "target": {
                    " __save": true|false,
                    //defaults to true if omitted
                    "profile.gender": "female",
                    "profile.age": 30,
                    "entity.name": "T-shirt",
                    "entity.id": "1234"
                }
            }
        }
    }
})
NOTE
Wenn die Anweisung __save weggelassen wird, werden die Profil- und Entitätsattribute sofort gespeichert. Die Anweisung __save ist nur für Profilattribute und Entitätsdetails relevant.

Empfehlungen anfordern

In der folgenden Tabelle sind die Recommendations -Attribute aufgeführt und es wird angezeigt, ob die einzelnen Attribute über die Web SDK unterstützt werden:

Kategorie
Attribut
Unterstützungsstatus
Recommendations - Standardattribute der Entität
entity.id
Unterstützt
entity.name
Unterstützt
entity.categoryId
Unterstützt
entity.pageUrl
Unterstützt
entity.thumbnailUrl
Unterstützt
entity.message
Unterstützt
entity.value
Unterstützt
entity.inventory
Unterstützt
entity.brand
Unterstützt
entity.margin
Unterstützt
entity.event.detailsOnly
Unterstützt
Recommendations - Benutzerdefinierte Entitätsattribute
entity.yourCustomAttributeName
Unterstützt
Recommendations - Reservierte Mbox-/Seitenparameter
excludedIds
Unterstützt
cartIds
Unterstützt
productPurchasedId
Unterstützt
Seiten- oder Elementkategorie für Kategorieaffinität
user.categoryId
Unterstützt

Senden von Recommendations-Attributen an Adobe Target:

alloy("sendEvent", {
  "renderDecisions": true,
  "data": {
    "__adobe": {
      "target": {
        "entity.id": "123",
        "entity.genre": "Drama"
      }
    }
  }
});

Mbox-Konversionsmetriken anzeigen display-mbox-conversion-metrics

Das folgende Beispiel zeigt, wie Sie Anzeige-Mbox-Konversionen verfolgen und Profilparameter an Adobe Target senden können, ohne sich für Inhalte oder Aktivitäten qualifizieren zu müssen.

alloy("sendEvent", {
    "xdm": {
        "_experience": {
            "decisioning": {
                "propositions": [{
                    "scope": "conversion-step-1" //example scope name
                }],
                "propositionEventType": {
                    "display": 1
                }
            }
        },
        "eventType": "decisioning.propositionDisplay"
    }
});
Eigenschaft
Beschreibung
xdm._experience.decisioning.propositions[x].scope
Der Bereich, mit dem die Erfolgsmetrik verknüpft werden soll (wodurch sie einer bestimmten Aktivität auf der Target-Seite zugeordnet wird).
xdm._experience.decisioning.propositions[x].eventType
Eine Zeichenfolge, die den beabsichtigten Ereignistyp beschreibt. Setzen Sie dies für diesen Anwendungsfall auf "decisioning.propositionDisplay" .

Debugging

mboxTrace und mboxDebug werden nicht mehr unterstützt. Verwenden Sie stattdessen die Methode Web SDK debugging .

Terminologie

Vorschläge: In Adobe Target korrelieren Vorschläge mit dem Erlebnis, das aus einer Aktivität ausgewählt wird.

Schema: Das Schema einer Entscheidung ist der Angebotstyp in Adobe Target.

Umfang: Der Umfang der Entscheidung. In Adobe Target ist der Umfang die mBox. Die globale mBox ist der Bereich __view__ .

XDM: Das XDM wird in Punktnotation serialisiert und dann als mBox-Parameter in Adobe Target eingefügt.

recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636