Adobe Target und Web SDK für Personalisierung verwenden

Adobe Experience Platform Web SDK können personalisierte Erlebnisse bereitstellen und rendern, die in Adobe Target für den Web-Kanal 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 Ihre Aktivitäten und Personalisierungserlebnisse zu erstellen, zu aktivieren und bereitzustellen.

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

Web SDK

Das folgende Diagramm hilft Ihnen, den Workflow von Target und Web SDK Edge Decisioning zu verstehen.

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 des Adobe Target VEC

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

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

Rendern von personalisiertem Inhalt

Weitere Informationen Sie untervon Personalisierungsinhalten .

Zielgruppen in XDM

Beim Definieren von Zielgruppen für die Target-Aktivitäten, die über die Web SDK bereitgestellt werden mussXDM) definiert und verwendet werden. Nachdem Sie XDM-Schemata, Klassen und Schemafeldgruppen definiert haben, können Sie eine Target Zielgruppenregel erstellen, die durch XDM-Daten für das Targeting definiert wird. In Target werden XDM-Daten in 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 ordnungsgemäß über die SDK bereitgestellt. Anstatt benutzerdefinierte Parameter oder das Benutzerprofil zu verwenden, müssen Sie stattdessen XDM verwenden. Es gibt jedoch vordefinierte Zielgruppen-Targeting-Felder, die über die Web SDK unterstützt werden und kein XDM erfordern. Diese Felder sind in der Target-Benutzeroberfläche verfügbar, die kein XDM erfordern:

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 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 alloy.sendEvent Versprechen abonnieren, propositions durchlaufen und die Details aus items -> meta extrahieren.

Jeder proposition verfügt über ein renderAttempted boolesches Feld, das angibt, ob der proposition gerendert wurde oder nicht. Siehe folgendes Beispiel:

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 die automatische Wiedergabe aktiviert ist, enthält das Vorschläge-Array Folgendes:

Beim Laden der Seite:

Bei Ansicht - Änderung (für Ansichten im Cache):

Wenn die automatische Wiedergabe deaktiviert ist, enthält das Vorschläge-Array Folgendes:

Beim Laden der Seite:

Bei Ansicht - Änderung (für Ansichten im Cache):

Aktualisierung eines einzelnen Profils

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

Um ein Target zu aktualisieren, stellen Sie sicher, dass die Profildaten mit den folgenden Informationen übergeben werden:

Speichern von Profil- oder Entitätsparametern verzögern, bis dem Endbenutzer Inhalte angezeigt wurden

Um Aufzeichnungsattribute im Profil zu verzögern, bis der Inhalt angezeigt wurde, legen Sie in Ihrer Anfrage data.adobe.target._save=false fest.

Beispielsweise enthält Ihre Website drei Entscheidungsumfänge, die drei Kategorienlinks auf der Website entsprechen (Männer, Frauen und Kinder), und Sie möchten die Kategorie verfolgen, die der Benutzer letztendlich besucht hat. Senden Sie diese Anfragen, wobei das __save-Flag 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 eventToken und stateToken), damit die entsprechenden Attribute aufgezeichnet werden.

Im folgenden Beispiel wird eine Nachricht im Stil von trackEvent 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 Recommendations Attribute aufgeführt und es wird angegeben, ob sie ü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 Mbox-Konversionen für die Anzeige 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 eine Methode vom 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 Typ des Angebots in Adobe Target.

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

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