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.

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.

Aktivieren von Adobe Target

Gehen Sie wie folgt vor, um Target zu aktivieren:

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

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:

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:

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

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

Beim Laden der Seite:

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

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:

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,
    "xdm": { /* Experience Event XDM data */ },
    "data": {
        "__adobe": {
            "target": {
                " __save": true|false,
                //defaults to true if omitted
                "profile.gender": "female",
                "profile.age": 30,
                "entity.name": "T-shirt",
                "entity.id": "1234"
            }
        }
    }
})

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:

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"
    }
});

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.