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
xdm
Objekt 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_property
sendEvent
nicht festgelegt werden.pageName
xdm.web.webPageDetails.name
xdm
übergeben werden und einem Schema mit der XDM ExperienceEvent-Klasse entsprechen. Mbox-Parameter können nicht als Teil des data
übergeben werden.profile.gender
data.__adobe.target.profile.gender
data
übergeben werden und das Präfix profile.
aufweisen, damit sie entsprechend zugeordnet werden können.user.categoryId
data.__adobe.target.user.categoryId
data
übergeben werden muss.entity.id
data.__adobe.target.entity.id
ODER
xdm.productListItems[0].SKU
data
-Objekts übergeben oder automatisch vom ersten Element im xdm.productListItems
-Array zugeordnet werden, wenn Ihre Implementierung diese Feldergruppe verwendet.entity.categoryId
data.__adobe.target.entity.categoryId
data
übergeben werden.entity.customEntity
data.__adobe.target.entity.customEntity
data
übergeben werden.cartIds
data.__adobe.target.cartIds
excludedIds
data.__adobe.target.excludedIds
mbox3rdPartyId
xdm.identityMap
festgelegtorderId
xdm.commerce.order.purchaseID
orderTotal
xdm.commerce.order.priceTotal
productPurchasedId
data.__adobe.target.productPurchasedId
ODER
xdm.productListItems[0-n].SKU
mboxPageValue
data.__adobe.target.mboxPageValue
Benutzerdefinierte 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 WebSDK 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
sendEvent
Befehls mithilfe deridentityMap
Feldergruppe
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
configure
Befehl zum Initialisieren der Bibliothek - Ein
sendEvent
Befehl 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-KonversionsereignissePlatform Web SDK verfolgen.