Verwenden von Adobe Target mit Platform Web SDK

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

WICHTIG

Die Adobe Target-Dokumentation enthält Themen mit spezifischen Informationen zum Platform Web SDK, da sie sich auf Target-Funktionen bezieht.

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

Platform Web SDK Systemdiagramm

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

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

Aufruf Details
1 Das Gerät lädt Platform Web SDK. Platform Web SDK sendet eine Anfrage mit XDM-Daten, der DataStreams-Umgebungs-ID, den übergebenen Parametern und der Kunden-ID (optional) an das Edge-Netzwerk. Seite (oder Container) ist vorab ausgeblendet.
2 Das Edge-Netzwerk 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-Netzwerk sendet die angereicherte Personalisierungsanforderung an den Target -Edge mit der Besucher-ID und den übergebenen Parametern.
4 Profilskripte werden ausgeführt und dann in den Profilspeicher Target eingespeist. Der Profilspeicher ruft Segmente aus der Zielgruppenbibliothek ab (z. B. Segmente, die von Adobe Analytics, Adobe Audience Manager, 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 diese dann zurück an das Edge-Netzwerk.
6 a. Das Edge-Netzwerk 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-Netzwerk sendet die Besucher-ID und andere Werte in Cookies, z. B. Zustimmung, Sitzungs-ID, Identität, Cookie-Prüfung, Personalisierung usw.
7 Das Edge-Netzwerk 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.
  • Vorabausblenden von Snippets: Blenden Sie nur bestimmte Teile der Seite aus.

Verwenden von Adobe Target VEC

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

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 Platform 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 Platform Web SDK unterstützt werden und keine XDM erfordern. Diese Felder sind in der Target-Benutzeroberfläche verfügbar, für die kein XDM erforderlich ist:

  • 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 hauptsächlich zum Senden von Metadaten an Dritte wie Google, Facebook usw. verwendet. Antwort-Token werden zurückgegeben
im Feld meta in propositions -> items. Hier 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 das alloy.sendEvent-Versprechen abonnieren, durch propositions iterieren
und extrahieren Sie die Details aus items -> meta. Jedes proposition hat ein boolesches renderAttempted -Feld.
gibt an, ob 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 renderAttempted-Markierung 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 der Markierung renderAttempted, die auf true 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 true gesetzt ist

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

Beim Laden der Seite:

  • Form-Based Composer based propositions , wobei die renderAttempted-Markierung auf false gesetzt ist
  • Visual Experience Composer-basierte Vorschläge mit renderAttempted-Markierung auf false gesetzt
  • Visual Experience Composer-basierte Vorschläge für eine Einzelseiten-Anwendungsansicht mit der Markierung renderAttempted, die 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 Platform Web SDK können Sie das Profil als Erlebnisereignis auf das Profil Target und auf das Profil Platform Web SDK aktualisieren.

Um ein Target-Profil zu aktualisieren, stellen Sie sicher, dass die Profildaten wie folgt übergeben werden:

  • Unter “data {“
  • Unter “__adobe.target”
  • Präfix “profile.”, z. B. wie unten
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 Platform Web SDK als Erlebnisereignis landen
data Objekt Beliebige Schlüssel/Wert-Paare, die an Target -Lösungen unter der Zielklasse gesendet werden.

Der typische Platform Web SDK-Code, der diesen Befehl verwendet, sieht wie folgt aus:

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

In der folgenden Tabelle sind die Recommendations-Attribute aufgeführt und es wird angezeigt, ob die einzelnen Attribute über Platform 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

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 Platform Web SDK debugging.

Terminologie

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

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

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

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

Auf dieser Seite