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.
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:
Das folgende Diagramm hilft Ihnen, den Workflow von Target und Platform Web SDK Edge-Entscheidungsfindung.
Aufruf | Details |
---|---|
1 | Das Gerät lädt die Platform Web SDK. Die Platform Web SDK sendet eine Anfrage mit XDM-Daten, der ID der Datastreams-Umgebung, ü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 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 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 nach vorne Analytics for Target (A4T) Details (Aktivitäts-, Erlebnis- und Konversionsmetadaten) in die Analytics -Kante. |
Aktivieren Targetführen Sie folgende Schritte aus:
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.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.
Siehe Rendern von Personalisierungsinhalten für weitere Informationen.
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:
Weitere Informationen finden Sie unter Kategorien für Zielgruppen im Adobe Target-Handbuch.
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:
propositions
mit renderAttempted
Markierung gesetzt auf false
renderAttempted
Markierung gesetzt auf true
renderAttempted
Markierung gesetzt auf true
renderAttempted
Markierung gesetzt auf true
Wenn das automatische Rendering deaktiviert ist, enthält das Vorschlagsarray:
propositions
mit renderAttempted
Markierung gesetzt auf false
renderAttempted
Markierung gesetzt auf false
renderAttempted
Markierung gesetzt auf false
renderAttempted
Markierung gesetzt auf false
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:
"data {"
"__adobe.target"
"profile."
z. B. wie folgtSchlü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 gesendet werden Target Lösungen unter der Zielklasse. |
Typisch Platform Web SDK Code, der diesen Befehl verwendet, sieht wie folgt aus:
sendEvent
mit 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
}
}
}
});
Die folgende Tabelle enthält Recommendations -Attribute und darüber, ob jede dieser Attribute über die Platform 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"
}
}
}
});
mboxTrace und mboxDebug werden nicht mehr unterstützt. Verwendung Platform Web SDK Debugging.
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.