Edge segmentering
NOTE
I följande dokument beskrivs hur du utför kantsegmentering med API:t. Mer information om kantsegmentering med hjälp av användargränssnittet finns i gränssnittsguiden för kantsegmentering.
Edge segmentering är nu allmänt tillgängligt för alla plattformsanvändare. Om du skapade definitioner för kantsegment under betaversionen kommer dessa segmentdefinitioner att fortsätta att fungera.
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.
IMPORTANT
Kantdata lagras på en edge-serverplats som ligger närmast den plats där de samlades in och kan lagras på en annan plats än den som anges som Adobe Experience Platform datacenter (eller huvudserver).
Dessutom kommer kantsegmenteringsmotorn endast att efterleva begäranden på kanten där det finns en primär markerad identitet, vilket är förenligt med icke-kantbaserade primära identiteter.
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:
Frågetyp
Information
Exempel
Exempel på PQL
En händelse
En segmentdefinition som refererar till en enda inkommande händelse utan tidsbegränsning.
Personer som har lagt till ett objekt i kundvagnen.
chain(xEvent, timestamp, [A: WHAT(eventType = "addToCart")])En profil
Alla segmentdefinitioner som refererar till ett enskilt profilattribut
Folk som bor i USA.
homeAddress.countryCode = "US"En händelse som refererar till en profil
En segmentdefinition som refererar till ett eller flera profilattribut och en enda inkommande händelse utan tidsbegränsning.
Folk som bor i USA som besökte hemsidan.
homeAddress.countryCode = "US" and chain(xEvent, timestamp, [A: WHAT(eventType = "addToCart")])Negerad enkel händelse med ett profilattribut
En segmentdefinition som refererar till en negerad enkel inkommande händelse och ett eller flera profilattribut
Personer som bor i USA och som inte har besökt hemsidan.
not(chain(xEvent, timestamp, [A: WHAT(eventType = "homePageView")]))En händelse i ett tidsfönster
En segmentdefinition som refererar till en enda inkommande händelse inom en angiven tidsperiod.
Personer som besökt hemsidan de senaste 24 timmarna.
chain(xEvent, timestamp, [X: WHAT(eventType = "addToCart") WHEN(< 24 hours before now)])En händelse med ett profilattribut inom ett relativt tidsfönster på mindre än 24 timmar
En segmentdefinition som refererar till en enda inkommande händelse, med ett eller flera profilattribut, och som inträffar inom ett relativt tidsfönster på mindre än 24 timmar.
Personer som bor i USA och som har besökt hemsidan de senaste 24 timmarna.
homeAddress.countryCode = "US" and chain(xEvent, timestamp, [X: WHAT(eventType = "addToCart") WHEN(< 24 hours before now)])Negerad enkel händelse med ett profilattribut i ett tidsfönster
En segmentdefinition som refererar till ett eller flera profilattribut och en negerad enkel inkommande händelse inom en tidsperiod.
Personer som bor i USA och som inte har besökt hemsidan de senaste 24 timmarna.
homeAddress.countryCode = "US" and not(chain(xEvent, timestamp, [X: WHAT(eventType = "addToCart") WHEN(< 24 hours before now)]))Frekvenshändelse inom ett 24-timmarsfönster
En segmentdefinition som refererar till en händelse som inträffar ett visst antal gånger inom ett tidsfönster på 24 timmar.
Personer som besökte hemsidan minst fem gånger de senaste 24 timmarna.
chain(xEvent, timestamp, [A: WHAT(eventType = "homePageView") WHEN(< 24 hours before now) COUNT(5) ] )Frekvenshändelse med ett profilattribut inom ett 24-timmarsfönster
En segmentdefinition som refererar till ett eller flera profilattribut och en händelse som inträffar ett visst antal gånger inom ett tidsfönster på 24 timmar.
Personer från USA som besökte hemsidan minst fem gånger de senaste 24 timmarna.
homeAddress.countryCode = "US" and chain(xEvent, timestamp, [A: WHAT(eventType = "homePageView") WHEN(< 24 hours before now) COUNT(5) ] )Negerad frekvenshändelse med en profil inom ett 24-timmarsfönster
En segmentdefinition som refererar till ett eller flera profilattribut och en negerad händelse som inträffar ett visst antal gånger inom ett tidsfönster på 24 timmar.
Personer som inte har besökt hemsidan mer än fem gånger de senaste 24 timmarna.
not(chain(xEvent, timestamp, [A: WHAT(eventType = "homePageView") WHEN(< 24 hours before now) COUNT(5) ] ))Flera inkommande träffar inom en tidsprofil på 24 timmar
En segmentdefinition som refererar till flera händelser som inträffar inom ett tidsfönster på 24 timmar.
Personer som besökte hemsidan eller besökte utcheckningssidan inom de senaste 24 timmarna.
chain(xEvent, timestamp, [X: WHAT(eventType = "homePageView") WHEN(< 24 hours before now)]) and chain(xEvent, timestamp, [X: WHAT(eventType = "checkoutPageView") WHEN(< 24 hours before now)])Flera händelser med en profil inom ett 24-timmarsfönster
En segmentdefinition som refererar till ett eller flera profilattribut och flera händelser som inträffar inom ett tidsfönster på 24 timmar.
Personer från USA som besökte hemsidan och besökte utcheckningssidan inom de senaste 24 timmarna.
homeAddress.countryCode = "US" and chain(xEvent, timestamp, [X: WHAT(eventType = "homePageView") WHEN(< 24 hours before now)]) and chain(xEvent, timestamp, [X: WHAT(eventType = "checkoutPageView") WHEN(< 24 hours before now)])Segmentering
En segmentdefinition som innehåller en eller flera grupper eller direktuppspelningssegment.
Personer som bor i USA och som är i segmentet "befintligt".
homeAddress.countryCode = "US" and inSegment("existing segment")Fråga som refererar till en karta
En segmentdefinition som refererar till en egenskapskarta.
Personer som har lagt till i kundvagnen baserat på externa segmentdata.
chain(xEvent, timestamp, [A: WHAT(eventType = "addToCart") WHERE(externalSegmentMapProperty.values().exists(stringProperty="active"))])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"
},
"ttlInDays": 30,
"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"
},
"ttlInDays": 30,
"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
NOTE
Exemplet nedan är en standardbegäran om att skapa ett segment. Mer information om hur du skapar en segmentdefinition finns i självstudiekursen om att skapa ett segment.
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"
},
"ttlInDays": 30,
"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"
},
"ttlInDays": 30,
"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.
recommendation-more-help
770bc05d-534a-48a7-9f07-017ec1e14871