Verwendung Adobe Target und Web SDK zur Personalisierung

Adobe Experience Platform Web SDK kann personalisierte Erlebnisse bereitstellen und rendern, die in verwaltet werden Adobe Target zum Webkanal hinzu. Sie können einen WYSIWYG-Editor mit dem Namen Visual Experience Composer (VEC) oder einer nicht visuellen Benutzeroberfläche, der Form-Based Experience Composer, um Ihre Aktivitäten und Personalisierungserlebnisse zu erstellen, zu aktivieren und bereitzustellen.

IMPORTANT
Erfahren Sie, wie Sie Ihre Target-Implementierung mit dem Migrieren von Target von at.js 2.x zum Platform Web SDK Tutorial.
Erfahren Sie, wie Sie Target zum ersten Mal mit der Implementieren von Adobe Experience Cloud mit dem Web SDK Tutorial. Spezifische Informationen zu Target finden Sie im Tutorial-Abschnitt mit dem Titel Target mit dem Platform Web SDK einrichten.

Die folgenden Funktionen wurden getestet und werden derzeit in Target:

Web SDK Systemdiagramm

Das folgende Diagramm hilft Ihnen, den Workflow von Target und Web SDK Edge-Entscheidung.

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

Aufruf
Details
1
Das Gerät lädt die Web SDK. Die Web SDK sendet eine Anfrage mit XDM-Daten, der ID der Datastreams-Umgebung, ü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 an die Target -Edge mit der Besucher-ID und den übergebenen Parametern.
4
Profilskripte werden ausgeführt und anschließend in Target Profilspeicherung. Der Profilspeicher ruft Segmente aus der Zielgruppenbibliothek (z. B. Segmente, die von Adobe Analytics, Adobe Audience Manager, die Adobe Experience Platform).
5
Basierend auf URL-Anforderungsparametern und Profildaten, Target bestimmt, welche Aktivitäten und Erlebnisse dem Besucher für die aktuelle Seitenansicht und für künftige vorab abgerufene Ansichten angezeigt werden. Target sendet diesen 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 geht voran Analytics for Target (A4T) Details (Aktivitäts-, Erlebnis- und Konversionsmetadaten) in die Analytics -Kante.

Aktivieren Adobe Target

Aktivieren Targetführen Sie folgende Schritte aus:

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

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.
  • Vorabausblenden eines Snippets: Blendet nur bestimmte Teile der Seite aus.

Verwenden von Adobe Target VEC

So verwenden Sie VEC mit einer Web SDK Implementierung, Installation und Aktivierung der Firefox oder Chrome VEC Helper-Erweiterung.

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

Rendern von personalisiertem Inhalt

Siehe Rendern von Personalisierungsinhalten für weitere Informationen.

Zielgruppen in XDM

Beim Definieren von Zielgruppen für Ihre Target Aktivitäten, die über die Web SDK, XDM müssen definiert und verwendet werden. Nachdem Sie XDM-Schemas, Klassen und Schemafeldgruppen definiert haben, können Sie eine Target Zielgruppenregel, die durch XDM-Daten für das Targeting definiert wird. Within Target, werden XDM-Daten in der Audience Builder als benutzerdefinierten Parameter. Das XDM wird mit Punktnotation serialisiert (z. B. web.webPageDetails.name).

Wenn Sie Target Aktivitäten mit vordefinierten Zielgruppen, die benutzerdefinierte Parameter oder ein Benutzerprofil verwenden, werden nicht korrekt über das SDK bereitgestellt. Statt benutzerdefinierte Parameter oder das Benutzerprofil zu verwenden, müssen Sie stattdessen XDM verwenden. Es werden jedoch native Zielgruppen-Targeting-Felder über die Web SDK die kein XDM erfordern. Diese Felder sind im Abschnitt Target Benutzeroberfläche, die kein XDM erfordert:

  • Ziel-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 im meta -Feld in 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 erfassen, müssen Sie sich für alloy.sendEvent Versprechen, durchlaufen propositionsund extrahieren Sie die Details aus items -> meta.

Alle proposition hat eine renderAttempted boolesches Feld, das angibt, ob das 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-basiert propositions mit renderAttempted Markierung gesetzt auf false
  • Visual Experience Composer-basierte Vorschläge mit renderAttempted Markierung gesetzt auf true
  • Visual Experience Composer-basierte Vorschläge für eine Einzelseiten-Anwendungsansicht mit renderAttempted Markierung gesetzt auf true

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

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

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

Beim Laden der Seite:

  • Form-based Composer-basiert propositions mit renderAttempted Markierung gesetzt auf false
  • Visual Experience Composer-basierte Vorschläge mit renderAttempted Markierung gesetzt auf false
  • Visual Experience Composer-basierte Vorschläge für eine Einzelseiten-App-Ansicht mit renderAttempted Markierung gesetzt auf false

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

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

Einzelprofil-Update

Die Web SDK ermöglicht die Aktualisierung des Profils auf Target und dem Web SDK als Erlebnisereignis.

So aktualisieren Sie eine Target Profil erstellen, müssen Sie sicherstellen, dass die Profildaten mit Folgendem übergeben werden:

  • under "data {"
  • under "__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 an gesendet werden Target Lösungen unter der Zielklasse.

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

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

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 __save Markierung gesetzt auf false 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) für die entsprechenden Attribute, die aufgezeichnet werden sollen.

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

alloy ( "sendEvent" , {
  renderDecisions : true,
  data : {
    __adobe : {
      target : {
        "profile.gender" : "female",
        "profile.age" : 30,
        "entity.name" : "T-shirt" ,
        "entity.id" : "1234" ,
        "track": {
          "scopes": [ "mbox1", "mbox2"],
          "type": "display|click|..."
        }
      }
    }
  }
} ) ;
NOTE
Wenn die Variable __save ausgelassen wird, werden die Profil- und Entitätsattribute sofort gespeichert, so als ob die Anfrage ausgeführt wurde, selbst wenn der Rest der Anfrage ein Vorabruf der Personalisierung ist. Die __save -Direktive ist nur für Profil- und Entitätsattribute relevant. Wenn das track -Objekt vorhanden ist, wird die __save wird ignoriert. Die Daten werden sofort gespeichert und die Benachrichtigung wird aufgezeichnet.

sendEventmit Profildaten

alloy("sendEvent", {
   renderDecisions: true|false,
   xdm: { // Experience Event XDM data },
   data: { // Freeform data }
});

So senden Sie Profilattribute an Adobe Target:

alloy("sendEvent", {
  "renderDecisions": true,
  "data": {
    "__adobe": {
      "target": {
        "profile.gender": "female",
        "profile.age": 30
      }
    }
  }
});

Empfehlungen anfordern

Die folgende Tabelle enthält Recommendations -Attribute und darüber, ob jede dieser Attribute über die Web SDK:

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

So senden Sie Recommendations-Attribute an Adobe Target:

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

Debugging

mboxTrace und mboxDebug werden nicht mehr unterstützt. Verwenden Sie eine Methode von Web SDK-Debugging anstatt.

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 Anwendungsbereich der Entscheidung. In Adobe Target, ist der Bereich die mBox. Die globale mBox ist die __view__ Umfang.

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

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