Edge segmentering
Edge segmentering är möjligheten att omedelbart utvärdera segmentdefinitioner i Adobe Experience Platform, vilket möjliggör användning av samma sida och nästa sida.
Komma igång
Den här utvecklarhandboken kräver en fungerande förståelse av de olika Adobe Experience Platform-tjänster som är involverade i kantsegmentering. Innan du börjar med den här självstudiekursen bör du läsa dokumentationen för följande tjänster:
- Real-Time Customer Profile: Tillhandahåller en enhetlig konsumentprofil i realtid baserat på aggregerade data från flera källor.
- Adobe Experience Platform Segmentation Service: Gör att du kan skapa målgrupper från Real-Time Customer Profile-data.
- Experience Data Model (XDM): Det standardiserade ramverket som Platform organiserar kundupplevelsedata med.
Om du vill kunna anropa alla Experience Platform API-slutpunkter läser du guiden komma igång med plattforms-API:er för att få information om vilka huvuden som krävs och hur du läser exempel-API-anrop.
Edge segmenteringsfrågetyper query-types
För att ett segment ska kunna utvärderas med hjälp av kantsegmentering måste frågan följa följande riktlinjer:
Dessutom måste segmentet vara kopplat till en sammanfogningsprincip som är aktiv på kanten. Mer information om sammanfogningsprinciper finns i policyguiden för sammanfogning.
En segmentdefinition kommer inte att aktiveras för kantsegmentering i följande scenarier:
- Segmentdefinitionen innehåller en kombination av en enda händelse och en
inSegment
-händelse.- Om segmentet i
inSegment
-händelsen bara är en profil aktiveras segmentdefinitionen för kantsegmentering.
- Om segmentet i
- I segmentdefinitionen används"Ignorera år" som en del av tidsbegränsningarna.
Hämta alla segment aktiverade för kantsegmentering
Du kan hämta en lista över alla segment som har aktiverats för kantsegmentering inom din organisation genom att göra en GET-förfrågan till slutpunkten /segment/definitions
.
API-format
Om du vill hämta segment som är aktiverade för kantsegmentering måste du ta med frågeparametern evaluationInfo.synchronous.enabled=true
i sökvägen för begäran.
GET /segment/definitions?evaluationInfo.synchronous.enabled=true
Begäran
curl -X GET \
'https://platform.adobe.io/data/core/ups/segment/definitions?evaluationInfo.synchronous.enabled=true' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Svar
Ett lyckat svar returnerar en array med segment i organisationen som är aktiverade för kantsegmentering. Mer detaljerad information om den returnerade segmentdefinitionen finns i stödlinjen för segmentdefinitioner.
{
"segments": [
{
"id": "15063cb-2da8-4851-a2e2-bf59ddd2f004",
"schema": {
"name": "_xdm.context.profile"
},
"imsOrgId": "{ORG_ID}",
"sandbox": {
"sandboxId": "",
"sandboxName": "",
"type": "production",
"default": true
},
"name": " People who are NOT on their homepage ",
"expression": {
"type": "PQL",
"format": "pql/text",
"value": "select var1 from xEvent where var1._experience.analytics.endUser.firstWeb.webPageDetails.isHomePage = false"
},
"evaluationInfo": {
"batch": {
"enabled": false
},
"continuous": {
"enabled": false
},
"synchronous": {
"enabled": true
}
},
"creationTime": 1572029711000,
"updateEpoch": 1572029712000,
"updateTime": 1572029712000
},
{
"id": "f15063cb-2da8-4851-a2e2-bf59ddd2f004",
"schema": {
"name": "_xdm.context.profile"
},
"imsOrgId": "{ORG_ID}",
"sandbox": {
"sandboxId": "",
"sandboxName": "",
"type": "production",
"default": true
},
"name": "Homepage_continuous",
"description": "People who are on their homepage - continuous",
"expression": {
"type": "PQL",
"format": "pql/text",
"value": "select var1 from xEvent where var1._experience.analytics.endUser.firstWeb.webPageDetails.isHomePage = true"
},
"evaluationInfo": {
"batch": {
"enabled": false
},
"continuous": {
"enabled": false
},
"synchronous": {
"enabled": true
}
},
"creationTime": 1572021085000,
"updateEpoch": 1572021086000,
"updateTime": 1572021086000
}
],
"page": {
"totalCount": 2,
"totalPages": 1,
"sortField": "creationTime",
"sort": "desc",
"pageSize": 2,
"limit": 100
},
"link": {}
}
Skapa ett segment som är aktiverat för kantsegmentering
Du kan skapa ett segment som är aktiverat för kantsegmentering genom att göra en POST-förfrågan till /segment/definitions
-slutpunkten som matchar någon av de kantsegmenteringsfrågor som listas ovan.
API-format
POST /segment/definitions
Begäran
curl -X POST \
https://platform.adobe.io/data/core/ups/segment/definitions \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"schema": {
"name": "_xdm.context.profile"
},
"name": "Homepage_continuous",
"description": "People who are on their homepage - continuous",
"expression": {
"type": "PQL",
"format": "pql/text",
"value": "select var1 from xEvent where var1._experience.analytics.endUser.firstWeb.webPageDetails.isHomePage = true"
},
"evaluationInfo": {
"batch": {
"enabled": false
},
"continuous": {
"enabled": false
},
"synchronous": {
"enabled": true
}
}
}'
Svar
Ett lyckat svar returnerar detaljerna om den nyligen skapade segmentdefinitionen som är aktiverad för kantsegmentering.
{
"id": "f15063cb-2da8-4851-a2e2-bf59ddd2f004",
"schema": {
"name": "_xdm.context.profile"
},
"imsOrgId": "{ORG_ID}",
"sandbox": {
"sandboxId": "{SANDBOX_ID}",
"sandboxName": "{SANDBOX_NAME}",
"type": "production",
"default": true
},
"name": "Homepage_continuous",
"description": "People who are on their homepage - continuous",
"expression": {
"type": "PQL",
"format": "pql/text",
"value": "chain(xEvent, timestamp, [X: WHAT(var1._experience.analytics.endUser.firstWeb.webPageDetails.isHomePage = "true")])"
},
"evaluationInfo": {
"batch": {
"enabled": false
},
"continuous": {
"enabled": false
},
"synchronous": {
"enabled": true
}
},
"creationTime": 1572021085000,
"updateEpoch": 1572021086000,
"updateTime": 1572021086000
}
Nästa steg
Nu när ni vet hur ni skapar segment med stöd för kantsegmentering kan ni använda dem för att skapa personalisering på samma sida och nästa sida.
Om du vill lära dig hur du utför liknande åtgärder och arbetar med segment med Adobe Experience Platform användargränssnitt kan du gå till användarhandboken för Segment Builder.
Bilaga
I följande avsnitt visas vanliga frågor om kantsegmentering:
Hur lång tid tar det innan ett segment blir tillgängligt på Edge Network?
Det tar upp till en timme för ett segment att vara tillgängligt på Edge Network.