Verwenden Adobe Target mit dem Platform Web SDK

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.

Die folgenden Funktionen wurden getestet und werden derzeit in Target:

• A/B-Tests
• A4T-Impressions- und Konversionsberichte
• Automated Personalization-Aktivitäten
• Erlebnis-Targeting-Aktivitäten
• Multivarianz-Tests (MVT)
• Recommendations-Aktivitäten
• Native Target-Impressions- und Konversionsberichte
• VEC-Unterstützung

Platform Web SDK Systemdiagramm

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

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: Blenden Sie nur bestimmte Teile der Seite aus.

Verwenden von Adobe Target VEC

So verwenden Sie VEC mit einer Platform 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 Platform 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 Platform 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 hauptsächlich zum Senden von Metadaten an Dritte wie Google, Facebook usw. verwendet. Antwort-Token werden im meta Feld 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 sich für alloy.sendEvent Versprechen, durchlaufen propositions
und 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:

• Formularbasierter Composer basierend 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-Anwendungsansicht 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 Platform Web SDK ermöglicht die Aktualisierung des Profils auf Target und dem Platform Web SDK als Erlebnisereignis.

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

• Unter "data {"
• Unter "__adobe.target"
• Präfix "profile." z. B. wie folgt

Typisch 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

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

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

Terminologie

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

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

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

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

Ressourcen für Business.Adobe.com