[Äldre]{class="badge informative"}
Kontextdata och Edge Decisioneringsbegäranden edge
I det här avsnittet får du hjälp med att skicka kontextdata i Edge Decisioning-begäranden och använda dem i reglerna för behörighet. Vi kommer att utforska ett heltäckande användningsexempel som visar hur vi kan leverera personaliserade erbjudanden baserat på den typ av enhet som kunderna använder.
Det här exemplet innehåller flera viktiga steg:
- Konfigurera förutsättningar: Kontrollera att alla nödvändiga steg har slutförts för att skicka kontextdata i dina begäranden.
- Använd kontextdata i berättiganderegler: Skapa regler som avgör vilka erbjudanden som ska visas baserat på användarens enhetstyp.
- Designa enhetsspecifika erbjudanden: Skapa anpassade erbjudanden för varje enhetstyp och länka dem till motsvarande regler.
- Skapa en erbjudandesamling: Gruppera alla erbjudanden till en statisk samling.
- Konfigurera ett beslut : Skapa ett nytt beslut som utnyttjar beslutsmotorn för erbjudanden för att välja det bästa erbjudandet som ska visas för användare baserat på deras enhetstyp.
- Skicka kontextdata i Edge Decisioning-begäran: Skicka kontextdata via din API-begäran för att hämta och presentera lämpliga erbjudanden för användarna.
Om du vill gå vidare kan du även använda kontextdata i rankningsformler eller för att anpassa dina offertrepresentationer dynamiskt. Du kan till exempel skapa ett enda erbjudande och använda personaliseringsfält för att anpassa dess representation baserat på kontextdata. Du kan till exempel visa en viss bild om användaren har en iPhone och en annan för iPad-användare. Mer information finns i följande avsnitt:
Krav för att skicka kontextdata i Edge Decisioning-begäranden prerequisites
Till skillnad från när kontext skickas i ett kostnadsfritt format med hjälp av API:t för beslut kräver Edge Decisioning-kontexten XDM-kompatibilitet. Kontextnyttolasten måste vara XDM Experience Event-kompatibel. För att göra detta måste sammanhanget definieras som en del av XDM Experience Event som används för datainsamling.
-
Definiera ett händelseschema för upplevelser. I det här fallet skapas ett"Erbjudandekontext"-schema och erbjudandekontextfälten ingår i en"Erbjudandekontext"-fältgrupp. I själva verket läggs fältgruppen till i det händelseschema för upplevelsehändelser som används för datainsamling som är associerad med datastream"Edge Collection Network".
note note NOTE Schemat för upplevelsehändelser för erbjudandekontext måste vara en del av profilen, där fältet CUSTOMER_ID används som primär identitet. I det här exemplet har fältgruppen"Erbjudandekontext" två egenskaper: language och deviceType. Dessa egenskaper kommer att användas i reglerna för rankning och behörighet.
Lär dig hur du arbetar med scheman i guiden Adobe Experience Platform Experience Data Model (XDM)
-
Skapa en datauppsättning (här"Erbjudandekontext") och se till att den är aktiverad för profilen.
-
Skapa en ny datastream från menyn Data Collection > Datastreams. Lär dig hur du skapar och konfigurerar dataström i Adobe Experience Platform Datastreams-guiden
Här har vi skapat en datastam för"Erbjudandekontext" med händelseschemat"Erbjudandeinnehåll" markerat.
-
Redigera den nya datastreamen och välj"Adobe Experience Platform" som tjänst och"Erbjud kontext" som händelsedatamängd.
-
Spara datastream och kopiera dess ID. Detta ID används i API-begärans slutpunkt. Lär dig hur du skapar API-anropet
Använd kontextdata i berättiganderegler rules
Skapa regler för behörighet som avgör vilka erbjudanden som ska visas baserat på användarens enhetstyp:
-
Regel för iPhone-enhet:
-
Regelnamn:"Edge-kontextregel - iphone"
-
Konfiguration: deviceType = 'iphone'
-
PQL syntax:
code language-none select _Any1 from xEvent where _Any1._experienceplatform.offerContextData.deviceType.equals("iphone", false)
-
-
Regel för iPad-enhet:
-
Regelnamn:"Edge Context Rule - ipad"
-
Konfiguration: deviceType = 'ipad'
-
PQL syntax
code language-none select _Any1 from xEvent where _Any1._experienceplatform.offerContextData.deviceType.equals("ipad", false)
-
Skapa erbjudanden offers
Skapa ett erbjudande för varje enhetstyp och länka det till motsvarande berättiganderegel som skapats tidigare:
-
Erbjudande för iPhone-användare:
- Erbjudandenamn:"Edge Context - iPhone Offer Content"
- Associerad regel:"Edge Context Rule - iphone"
-
Erbjudande för iPad-användare:
- Erbjudandenamn:"Edge Context - iPad Offer Content"
- Associerad regel:"Edge Context Rule - ipad"
Skapa dessutom ett reserverbjudande (här"Context Fallback Content") som visas om inga specifika enhetskriterier uppfylls.
Lägg till erbjudanden i en samling collection
Lägg till erbjudanden som skapats tidigare i en statisk samling som heter här"Edge Device Context". I den här samlingen väljs valbara erbjudanden ut till kunderna.
Skapa offertbeslut decision
Skapa ett nytt beslut som utnyttjar beslutsmotorn för erbjudanden för att välja det bästa erbjudandet som ska visas för användarna baserat på deras enhetstyp med erbjudandet"Context Fallback" valt som reserverbjudande.
Skicka kontextdata i Edge Decisioning-begäran request
Slutpunkt
Använd ID:t för datastream som skapades tidigare i slutpunkten.
https://edge.adobedc.net/ee/irl1/v1/interact?configId=f3c47f2a-c484-4908-87a5-a82b55039e22
Nyttolast
Här är ett exempel på en begäran som skickar kontextdata.
-
Information om enhetstypen skickas i noden
xdm:ContextData. -
I noden
decisionScopeskopierar och klistrar du in beslutsomfånget för det erbjudandebeslut som konfigurerats tidigare.accordion Var beslutets omfattning ska hämtas 
{
"events": [{
"xdm": {
"identityMap": {
"customerId": [{
"id": "0000158216",
"authenticatedState": "authenticated",
"primary": true
}]
},
"_experienceplatform": {
"identity": {
"core": {
"customerId": "0000158216"
}
},
"offerContextData" : {
"language" : "NL",
"deviceType" : "iphone"
}
}
}
}],
"query": {
"personalization": {
"decisionScopes": ["eyJ4ZG06YWN0aXZpdHlJZCI6Inhjb3JlOm9mZmVyLWFjdGl2aXR5OjE3M2I1MGM5Mjg0ZGQ4NzkiLCJ4ZG06cGxhY2VtZW50SWQiOiJ4Y29yZTpvZmZlci1wbGFjZW1lbnQ6MTZhMzQxZWQ4ZDYyMzc2MSJ9"]
}
}
}
Svar
Här följer ett exempelsvar:
{
"requestId": "14a2d3f5-a6fa-494e-b42c-cc65a845284a",
"handle": [
{
"payload": [
{
"id": "1eafc831-4819-4800-8e25-c9e9f0838e09",
"scope": "eyJ4ZG06YWN0aXZpdHlJZCI6Inhjb3JlOm9mZmVyLWFjdGl2aXR5OjE3M2I1MGM5Mjg0ZGQ4NzkiLCJ4ZG06cGxhY2VtZW50SWQiOiJ4Y29yZTpvZmZlci1wbGFjZW1lbnQ6MTZhMzQxZWQ4ZDYyMzc2MSJ9",
"activity": {
"id": "xcore:offer-activity:173b50c9284dd879",
"etag": "1",
"name": "Edge Device Context"
},
"placement": {
"id": "xcore:offer-placement:16a341ed8d623761",
"etag": "1",
"name": "HIB",
"channel": "https://ns.adobe.com/xdm/channel-types/mobile",
"componentType": "https://ns.adobe.com/experience/offer-management/content-component-json"
},
"items": [
{
"id": "xcore:personalized-offer:173b4e05676d87f5",
"etag": "3",
"name": "Edge Context - iPhone Offer",
"priority": 0,
"schema": "https://ns.adobe.com/experience/offer-management/content-component-json",
"data": {
"id": "xcore:personalized-offer:173b4e05676d87f5",
"format": "application/json",
"language": [
"en-gb"
],
"content": "{\n \"name\" : \"iphone offer\"\n}"
}
}
]
}
],
"type": "personalization:decisions",
"eventIndex": 0
},
{
"payload": [],
"type": "activation:pull",
"eventIndex": 0
},
{
"payload": [],
"type": "personalization:decisions",
"eventIndex": 0
},
{
"payload": [
{
"scope": "Target",
"hint": "37",
"ttlSeconds": 1800
},
{
"scope": "AAM",
"hint": "6",
"ttlSeconds": 1800
},
{
"scope": "EdgeNetwork",
"hint": "irl1",
"ttlSeconds": 1800
}
],
"type": "locationHint:result"
},
{
"payload": [
{
"key": "kndctr_907075E95BF479EC0A495C73_AdobeOrg_identity",
"value": "CiY0MDAwMDgyMjMzNTEzNzU1OTcwMjQ0NDcyNjU1MTAyMDEwNDQ3MVIRCNnE4Y6QMRABGAEqBElSTDHwAdnE4Y6QMQ==",
"maxAge": 34128000
},
{
"key": "kndctr_907075E95BF479EC0A495C73_AdobeOrg_cluster",
"value": "irl1",
"maxAge": 1800
}
],
"type": "state:store"
}
]
}