Senden von Parametern an Target mithilfe von Platform Web SDK
Target-Implementierungen unterscheiden sich je nach Website-Architektur, Geschäftsanforderungen und verwendeten Funktionen je nach Website. Bei den meisten Target-Implementierungen werden verschiedene Parameter für Kontextinformationen, Zielgruppen und Inhaltsempfehlungen übergeben.
Anhand einer einfachen Produktdetailseite und einer Bestellbestätigungsseite möchten wir die Unterschiede zwischen den Bibliotheken beim Übergeben von Parametern an Target demonstrieren.
Angenommen, die folgenden beiden Beispielseiten verwenden at.js:
| code language-html |
|---|
|
| code language-html |
|---|
|
Zusammenfassung der Parameterzuordnung
Die Zielgruppen-Parameter für diese Seiten werden mit Platform Web SDK unterschiedlich gesendet. Es gibt mehrere Möglichkeiten, Parameter mithilfe von at.js an Target zu übergeben:
- Mit
targetPageParams()Funktion für das Seitenladeereignis festgelegt (wird in den Beispielen auf dieser Seite verwendet) - Mit
targetPageParamsAll()Funktion für alle Target-Anfragen auf der Seite festlegen - Senden von Parametern direkt mit der
getOffer()-Funktion für einen einzelnen Speicherort - Parameter direkt mit der
getOffers()für einen oder mehrere Standorte senden
Platform Web SDK bietet eine einzige, konsistente Möglichkeit zum Senden von Daten, ohne dass zusätzliche Funktionen erforderlich sind. Alle Parameter müssen in der Payload mit dem Befehl sendEvent übergeben werden und fallen unter zwei Kategorien:
- Automatisch vom
xdmObjekt zugeordnet - Manuelles Übergeben mit dem
data.__adobe.target
In der folgenden Tabelle ist beschrieben, wie die Beispielparameter mithilfe von Platform Web SDK neu zugeordnet werden:
at_propertysendEvent nicht festgelegt werden.pageNamexdm.web.webPageDetails.namexdm übergeben werden und einem Schema mit der XDM ExperienceEvent-Klasse entsprechen. Mbox-Parameter können nicht als Teil des data übergeben werden.profile.genderdata.__adobe.target.profile.genderdata übergeben werden und das Präfix profile. aufweisen, damit sie entsprechend zugeordnet werden können.user.categoryIddata.__adobe.target.user.categoryIddata übergeben werden muss.entity.iddata.__adobe.target.entity.idODER
xdm.productListItems[0].SKUdata-Objekts übergeben oder automatisch vom ersten Element im xdm.productListItems-Array zugeordnet werden, wenn Ihre Implementierung diese Feldergruppe verwendet.entity.categoryIddata.__adobe.target.entity.categoryIddata übergeben werden.entity.customEntitydata.__adobe.target.entity.customEntitydata übergeben werden.cartIdsdata.__adobe.target.cartIdsexcludedIdsdata.__adobe.target.excludedIdsmbox3rdPartyIdxdm.identityMap festgelegtorderIdxdm.commerce.order.purchaseIDorderTotalxdm.commerce.order.priceTotalproductPurchasedIddata.__adobe.target.productPurchasedIdODER
xdm.productListItems[0-n].SKUmboxPageValuedata.__adobe.target.mboxPageValueBenutzerdefinierte Parameter
Benutzerdefinierte Mbox-Parameter müssen mit dem sendEvent-Befehl als XDM-Daten übergeben werden. Es ist wichtig sicherzustellen, dass das XDM-Schema alle Felder enthält, die für Ihre Target-Implementierung erforderlich sind.
at.js-Beispiel mit targetPageParams():
targetPageParams = function() {
return {
"pageName": "product detail"
};
};
Beispiele für Platform Web SDK JavaScript mit sendEvent Befehl:
| code language-javascript |
|---|
|
Verwenden Sie in Tags zunächst ein XDM-Objekt-Datenelement, das dem XDM-Feld zugeordnet werden soll:
Fügen Sie dann Ihr XDM-Objekt in Ihr Ereignis senden Aktion ein (mehrere XDM-Objekte können zusammengeführt):
xdm -Objekts sind, müssen Sie alle Zielgruppen, Aktivitäten oder Profilskripte aktualisieren, die mit ihren neuen Namen auf diese Mbox-Parameter verweisen. Weitere Informationen finden auf der Seite Aktualisieren von Target-Zielgruppen und Profilskripten für die Kompatibilität mit Platform Web SDK in diesem Tutorial .Profilparameter
Zielprofilparameter müssen unter dem data.__adobe.target-Objekt in der Payload des Platform Web SDK-sendEvent übergeben werden.
Ähnlich wie at.js müssen auch alle Profilparameter mit dem Präfix profile. versehen werden, damit der Wert ordnungsgemäß als persistentes Zielprofilattribut gespeichert wird. Dem reservierten user.categoryId für die Funktion der Kategorieaffinität von Target wird das Präfix user. vorangestellt.
at.js-Beispiel mit targetPageParams():
targetPageParams = function() {
return {
"profile.gender": "male",
"user.categoryId": "clothing"
};
};
Beispiele für Platform Web SDK mit sendEvent Befehl:
| code language-javascript |
|---|
|
Erstellen Sie in Tags zunächst ein Datenelement, um das data.__adobe.target zu definieren:
Fügen Sie dann Ihr Datenobjekt in Ihr Sendeereignis Aktion ein (mehrere Objekte können zusammengeführt):
Entitätsparameter
Entitätsparameter werden verwendet, um Verhaltensdaten und zusätzliche Kataloginformationen für Target Recommendations zu übergeben. Alle Entitätsparameter die von at.js unterstützt werden, werden auch von Platform Web SDK unterstützt. Ähnlich wie Profilparameter sollten alle Entitätsparameter unter dem data.__adobe.target-Objekt in der Payload des Platform Web SDK sendEvent-Befehls übergeben werden.
Entitätsparameter für ein bestimmtes Element müssen mit dem Präfix entity. versehen werden, um eine ordnungsgemäße Datenerfassung zu gewährleisten. Die reservierten cartIds- und excludedIds-Parameter für Recommendations-Algorithmen sollten nicht mit einem Präfix versehen werden und der Wert für jedes muss eine kommagetrennte Liste von Entitäts-IDs enthalten.
at.js-Beispiel mit targetPageParams():
targetPageParams = function() {
return {
"entity.id": "SKU-00001-LARGE",
"entity.categoryId": "clothing,shirts",
"entity.customEntity": "some value",
"cartIds": "SKU-00002,SKU-00003",
"excludedIds": "SKU-00001-SMALL"
};
};
Beispiele für Platform Web SDK mit sendEvent Befehl:
| code language-javascript |
|---|
|
Erstellen Sie in Tags zunächst ein Datenelement, um das data.__adobe.target zu definieren:
Fügen Sie dann Ihr Datenobjekt in Ihr Sendeereignis Aktion ein (mehrere Objekte können zusammengeführt):
commerce Feldgruppe verwendet wird und das productListItems-Array in der XDM-Payload enthalten ist, wird der erste SKU in diesem Array entity.id zugeordnet, um eine Produktansicht zu inkrementieren.Kaufparameter
Kaufparameter werden nach erfolgreicher Bestellung auf einer Auftragsbestätigungsseite weitergeleitet und für Konversions- und Optimierungsziele von Target verwendet. Bei einer Implementierung von Platform Web SDK werden diese Parameter und automatisch aus XDM-Daten zugeordnet, die als Teil der commerce Feldergruppe übergeben werden.
at.js-Beispiel mit targetPageParams():
targetPageParams = function() {
return {
"orderId": "ABC123",
"productPurchasedId": "SKU-00002,SKU-00003"
"orderTotal": 1337.89
};
};
Kaufinformationen werden an Target übergeben, wenn die commerce Feldergruppe auf 1 gesetzt purchases.value. Die Auftrags-ID und die Bestellsumme werden automatisch aus dem order Objekt zugeordnet. Wenn das productListItems-Array vorhanden ist, werden die SKU Werte für die productPurchasedId verwendet.
Platform Web SDK-Beispiel mit sendEvent:
| code language-javascript |
|---|
|
Verwenden Sie in Tags zunächst ein XDM-Objekt-Datenelement, um es den erforderlichen XDM-Feldern (siehe das JavaScript-Beispiel) und optional dem benutzerdefinierten Bereich zuzuordnen:
Fügen Sie dann Ihr XDM-Objekt in Ihr Ereignis senden Aktion ein (mehrere XDM-Objekte können zusammengeführt):
_experience.decisioning.propositionEventType muss mit display: 1 festgelegt werden, damit der Aufruf zum Inkrementieren einer Zielmetrik verwendet werden kann.orderConfirmPage, füllen Sie das _experience.decisioning.propositions-Array mit einem benutzerdefinierten Bereich wie im obigen Beispiel.productPurchasedId kann auch als kommagetrennte Liste von Entitäts-IDs unter dem data-Objekt übergeben werden.Kunden-ID (mbox3rdPartyId)
Target ermöglicht die Synchronisierung von Profilen über Geräte und Systeme hinweg mithilfe einer einzigen Kunden-ID. Bei „at.js“ kann dies als mbox3rdPartyId in der Target-Anfrage oder als erste Kunden-ID festgelegt werden, die an den Experience Cloud Identity Service gesendet wird. Im Gegensatz zu at.js können Sie bei einer Platform Web SDK-Implementierung festlegen, welche Kunden-ID als mbox3rdPartyId verwendet werden soll, wenn mehrere vorhanden sind. Wenn Ihr Unternehmen beispielsweise über eine globale Kunden-ID und separate Kunden-IDs für verschiedene Geschäftsbereiche verfügt, können Sie konfigurieren, welche ID Target verwenden soll.
Es gibt einige Schritte, um die ID-Synchronisierung für Anwendungsfälle mit geräteübergreifenden und Kundenattributen einzurichten:
- Erstellen Sie Identity-Namespace für die Kunden-ID Bildschirm "" der Datenerfassung oder Plattform
- Stellen Sie sicher dass der in Kundenattributen mit dem Identitätssymbol Ihres Namespace übereinstimmt
- Geben Sie Identitätssymbol als Target-Drittanbieter-ID-Namespace in der Target-Konfiguration des Datenstroms an
- Ausführen eines
sendEventBefehls mithilfe deridentityMapFeldergruppe
at.js-Beispiel mit targetPageParams():
targetPageParams = function() {
return {
"mbox3rdPartyId": "TT8675309"
};
};
Beispiele für Platform Web SDK mit sendEvent Befehl:
| code language-javascript |
|---|
|
Der ID-Wert, Authentifizierungsstatus und Namespace werden in einem Datenelement Identitätszuordnung erfasst:
Das Identitätszuordnung-Datenelement wird dann verwendet, um das Feld identityMap im XDM-Objekt-Datenelement festzulegen:
Das XDMObjekt wird dann in die Aktion Ereignis senden einer Regel aufgenommen:
Stellen Sie im Adobe Target-Service Ihres Datenstroms sicher, dass Sie den Namespace Target Third-Party-ID auf denselben Namespace festlegen, der im Datenelement Identitätszuordnung verwendet wird:
Beispiel für Platform Web SDK
Nachdem Sie nun wissen, wie die verschiedenen Zielparameter mithilfe der Platform Web SDK zugeordnet werden, können Sie unsere beiden Beispielseiten wie unten dargestellt von at.js zur Platform Web SDK migrieren. Die Beispielseiten enthalten Folgendes:
- Target-Code zum Vorab-Ausblenden für eine asynchrone Bibliotheksimplementierung
- Der Platform Web SDK-Basis-Code
- Die Platform Web SDK JavaScript-Bibliothek
- Ein
configureBefehl zum Initialisieren der Bibliothek - Ein
sendEventBefehl zum Senden von Daten und zum Anfordern von zu rendernden Target-Inhalten
| code language-html |
|---|
|
| code language-html |
|---|
|
Erfahren Sie als Nächstes, wie Sie Target-Konversionsereignisse Platform Web SDK verfolgen.