Parameters verzenden naar doel met gebruik van Platform Web SDK
De doelimplementaties verschillen per website vanwege de sitearchitectuur, de zakelijke vereisten en de gebruikte functies. De meeste doelimplementaties bevatten het doorgeven van verschillende parameters voor contextuele informatie, doelgroepen en aanbevelingen voor inhoud.
Laten we een eenvoudige pagina met productdetails en een pagina met orderbevestiging gebruiken om de verschillen tussen de bibliotheken aan te tonen bij het doorgeven van parameters aan Doel.
Stel dat de volgende twee voorbeeldpagina's at.js gebruiken:
| code language-html |
|---|
|
| code language-html |
|---|
|
Overzicht van parametertoewijzing
De parameters van het Doel voor deze pagina's worden anders verzonden gebruikend het Web SDK van het Platform. Er zijn veelvoudige manieren om parameters tot Doel over te gaan gebruikend at.js:
- Instellen met functie
targetPageParams()voor de gebeurtenis load van de pagina (wordt gebruikt in de voorbeelden op deze pagina) - Instellen met functie
targetPageParamsAll()voor alle doelaanvragen op de pagina - Parameters rechtstreeks verzenden met de functie
getOffer()voor één locatie - Parameters rechtstreeks verzenden met de functie
getOffers()voor een of meer locaties
De SDK van het Web van het Platform verstrekt één enkele verenigbare manier om gegevens zonder de behoefte aan extra functies te verzenden. Alle parameters moeten in de lading met het sendEvent bevel worden overgegaan en onder twee categorieën vallen:
- Automatisch toegewezen via het
xdm-object - Handmatig worden doorgegeven met het object
data.__adobe.target
In de onderstaande tabel wordt beschreven hoe de voorbeeldparameters opnieuw worden toegewezen met gebruik van Platform Web SDK:
at_propertysendEvent vraag worden geplaatst.pageNamexdm.web.webPageDetails.namexdm -object en moeten in overeenstemming zijn met een schema met behulp van de XDM ExperienceEvent-klasse. Mbox-parameters kunnen niet worden doorgegeven als onderdeel van het data -object.profile.genderdata.__adobe.target.profile.genderdata -object en vooraf ingesteld met profile. om correct te worden toegewezen.user.categoryIddata.__adobe.target.user.categoryIddata -object.entity.iddata.__adobe.target.entity.idOF
xdm.productListItems[0].SKUdata -object of automatisch worden toegewezen vanuit het eerste item in de xdm.productListItems -array als die veldgroep door de implementatie wordt gebruikt.entity.categoryIddata.__adobe.target.entity.categoryIddata -object.entity.customEntitydata.__adobe.target.entity.customEntitydata .cartIdsdata.__adobe.target.cartIdsexcludedIdsdata.__adobe.target.excludedIdsmbox3rdPartyIdxdm.identityMaporderIdxdm.commerce.order.purchaseIDorderTotalxdm.commerce.order.priceTotalproductPurchasedIddata.__adobe.target.productPurchasedIdOF
xdm.productListItems[0-n].SKUmboxPageValuedata.__adobe.target.mboxPageValueAangepaste parameters
Aangepaste mbox-parameters moeten als XDM-gegevens worden doorgegeven met de opdracht sendEvent . Het is belangrijk om ervoor te zorgen dat het schema XDM alle gebieden omvat die voor uw implementatie van het Doel worden vereist.
bij.js-voorbeeld met targetPageParams() :
targetPageParams = function() {
return {
"pageName": "product detail"
};
};
Platform Web SDK JavaScript voorbeelden met de opdracht sendEvent :
| code language-javascript |
|---|
|
Gebruik in tags eerst een gegevenselement XDM object om toe te wijzen aan het XDM-veld:
En dan omvat uw XDM object in uw Send event action (het veelvoud XDM objects kan worden samengevoegd ):
xdm -object, moet u alle soorten publiek-, activiteiten- of profielscripts die naar deze mbox-parameters verwijzen, bijwerken met hun nieuwe naam. Zie het publiek van het Doel van de Update en profielmanuscripten voor de verenigbaarheid van SDK van het Web van het Platform pagina van dit leerprogramma voor meer informatie.Profielparameters
Doelprofielparameters moeten worden doorgegeven onder het data.__adobe.target -object in de opdrachtpayload van de opdracht Platform Web SDK sendEvent .
Net als bij at.js moeten alle profielparameters ook vooraf met profile. worden opgeslagen om de waarde als blijvend doelprofielkenmerk correct te kunnen opslaan. De gereserveerde user.categoryId -parameter voor de Categorie-affiniteit van Doel wordt vooraf ingesteld door user. .
bij.js-voorbeeld met targetPageParams() :
targetPageParams = function() {
return {
"profile.gender": "male",
"user.categoryId": "clothing"
};
};
Voorbeelden van Platform Web SDK met de opdracht sendEvent :
| code language-javascript |
|---|
|
Maak in tags eerst een gegevenselement om het object data.__adobe.target te definiëren:
En dan omvat uw gegevensvoorwerp in uw Send event action (het veelvoud objects kan worden samengevoegd ):
Parameters entiteit
Entiteitsparameters worden gebruikt om gedragsgegevens en aanvullende catalogusinformatie voor Target Recommendations door te geven. Alle entiteitparameters die door at.js worden gesteund worden ook gesteund door het Web SDK van het Platform. Net als profielparameters moeten alle entiteitsparameters worden doorgegeven onder het data.__adobe.target -object in de opdrachtpayload van de opdracht Platform Web SDK sendEvent .
Entiteiteits-parameters voor een specifiek item moeten vooraf met entity. worden vastgelegd om de gegevens correct vast te leggen. De gereserveerde cartIds - en excludedIds -parameters voor aanbevelingen-algoritmen mogen niet vooraf worden ingesteld en de waarde voor beide moet een door komma's gescheiden lijst met entiteit-id's bevatten.
bij.js-voorbeeld met 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"
};
};
Voorbeelden van Platform Web SDK met de opdracht sendEvent :
| code language-javascript |
|---|
|
Maak in tags eerst een gegevenselement om het object data.__adobe.target te definiëren:
En dan omvat uw gegevensvoorwerp in uw Send event action (het veelvoud objects kan worden samengevoegd ):
commerce wordt gebruikt en de array productListItems is opgenomen in de XDM-payload, wordt de eerste SKU -waarde in deze array toegewezen aan entity.id voor het verhogen van de productweergave.Aankoopparameters
De parameters van de aankoop worden overgegaan op een de bevestigingspagina van het orde na een succesvolle orde en voor de omzettings en optimalisatiedoelstellingen van het Doel gebruikt. Met een implementatie van het Web SDK van het Platform, deze parameters en automatisch in kaart gebracht van gegevens XDM die als deel van de commerce gebiedsgroep worden overgegaan.
bij.js-voorbeeld met targetPageParams() :
targetPageParams = function() {
return {
"orderId": "ABC123",
"productPurchasedId": "SKU-00002,SKU-00003"
"orderTotal": 1337.89
};
};
Aankoopgegevens worden doorgegeven aan Target wanneer voor de veldgroep commerce purchases.value is ingesteld op 1 . De bestellings-id en het totaal van de bestellingen worden automatisch toegewezen aan het order -object. Als de array productListItems aanwezig is, worden de waarden SKU gebruikt voor productPurchasedId .
Voorbeeld van Platform Web SDK met sendEvent :
| code language-javascript |
|---|
|
Gebruik in tags eerst een gegevenselement XDM object om toe te wijzen aan de vereiste XDM-velden (zie het JavaScript-voorbeeld) en een optioneel aangepast bereik:
En dan omvat uw XDM object in uw Send event action (het veelvoud XDM objects kan worden samengevoegd ):
_experience.decisioning.propositionEventType moet met display: 1 worden geplaatst om de vraag te gebruiken om metrisch van het Doel te verhogen.orderConfirmPage , vult u de array _experience.decisioning.propositions met een aangepast bereik, zoals in het bovenstaande voorbeeld.productPurchasedId kan ook worden doorgegeven als een door komma's gescheiden lijst met entiteit-id's onder het object data .Klant-id (mbox3rdPartyId)
Het doel staat profielsynchronisatie over apparaten en systemen toe gebruikend één enkele klant ID. Met at.js, kon dit als mbox3rdPartyId in het verzoek van het Doel worden geplaatst of als eerste klantenidentiteitskaart die naar de Dienst van de Identiteit van het Experience Cloud wordt verzonden. In tegenstelling tot at.js, staat een implementatie van SDK van het Web van het Platform u toe om te specificeren welke klantenidentiteitskaart aan gebruik als mbox3rdPartyId als er veelvoudige zijn. Bijvoorbeeld, als uw zaken een globale klant identiteitskaart en afzonderlijke klant IDs voor verschillende lijnen van zaken hebben, kunt u vormen welk Doel van identiteitskaart zou moeten gebruiken.
Er zijn een paar stappen aan opstellingsidentiteitskaart die voor dwars-apparaat en de het gebruikscituaties van Attributen van de Klant synchroniseert:
- Maak een identity namespace voor de klant-id in het Identities -scherm van gegevensverzameling of -platform
- Zorg ervoor dat alias in Klantkenmerken overeenkomt met de identity symbol van uw naamruimte
- Geef de identy symbol op als de Target Third Party ID Namespace in de configuratie Doel van de gegevensstroom
- Een opdracht
sendEventuitvoeren met de veldgroepidentityMap
bij.js-voorbeeld met targetPageParams() :
targetPageParams = function() {
return {
"mbox3rdPartyId": "TT8675309"
};
};
Voorbeelden van Platform Web SDK met de opdracht sendEvent :
| code language-javascript |
|---|
|
De ID value Authenticated state en Namespace worden vastgelegd in een Identity map data-element:
Het gegevenselement Identity map wordt vervolgens gebruikt om het identityMap veld in het gegevenselement XDM object in te stellen:
XDM object wordt vervolgens opgenomen in de Send event -handeling van een regel:
In de Adobe Target-service van uw gegevensstroom moet u de Target Third Party ID Namespace instellen op dezelfde naamruimte als in het gegevenselement Identity map :
Platform Web SDK, voorbeeld
Nu u begrijpt hoe de verschillende parameters van het Doel gebruikend het Web SDK van het Platform in kaart worden gebracht, zouden onze twee voorbeeldpagina's van at.js aan het Web SDK van het Platform zoals hieronder getoond kunnen worden gemigreerd. De voorbeeldpagina's omvatten het volgende:
- Voorverborgen fragment voor asynchrone bibliotheekimplementatie als doel
- De basiscode van de SDK van het Web Platform
- De Platform Web SDK JavaScript-bibliotheek
- Een opdracht
configureom de bibliotheek te initialiseren - Een opdracht
sendEventom gegevens te verzenden en om te vragen dat doelinhoud moet worden gerenderd
| code language-html |
|---|
|
| code language-html |
|---|
|
Daarna, leer hoe te de omzettingsgebeurtenissen van het spoordoel met het Web SDK van het Platform.