Gruppsegmenteringsguide
Gruppsegmentering är en metod för segmenteringsutvärdering som gör att du kan flytta alla profildata samtidigt för att skapa motsvarande målgrupper.
Med gruppsegmentering kan ni skapa detaljerade och detaljerade målgrupper och köra segmenteringsjobb för att avgöra när ni vill att dessa data ska spridas till tjänster längre fram i kedjan.
Berättigade frågetyper
Alla frågor kan gruppsegmenteras.
Skapa målgrupper
Du kan skapa en målgrupp som utvärderas med batchsegmentering med hjälp av segmenteringstjänstens API eller genom målgruppsportalen i användargränssnittet.
API-format
POST /segment/definitions
Begäran
En exempelbegäran om att skapa en segmentdefinition som är aktiverad för batchsegmentering
curl -X POST https://platform.adobe.io/data/core/ups/segment/definitions
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
-d '{
"name": "People in the USA",
"description: "An audience that looks for people who live in the USA",
"expression": {
"type": "PQL",
"format": "pql/text",
"value": "homeAddress.country = \"US\""
},
"evaluationInfo": {
"batch": {
"enabled": true
},
"continuous": {
"enabled": false
},
"synchronous": {
"enabled": false
}
},
"schema": {
"name": "_xdm.context.profile"
}
}'
Svar
Ett lyckat svar returnerar HTTP-status 200 med information om den segmentdefinition du nyss skapade.
Ett exempelsvar när du skapar en segmentdefinition.
{
"id": "4afe34ae-8c98-4513-8a1d-67ccaa54bc05",
"schema": {
"name": "_xdm.context.profile"
},
"profileInstanceId": "ups",
"imsOrgId": "{ORG_ID}",
"sandbox": {
"sandboxId": "28e74200-e3de-11e9-8f5d-7f27416c5f0d",
"sandboxName": "prod",
"type": "production",
"default": true
},
"name": "People in the USA",
"description": "An audience that looks for people who live in the USA",
"expression": {
"type": "PQL",
"format": "pql/text",
"value": "homeAddress.country = \"US\""
},
"evaluationInfo": {
"batch": {
"enabled": true
},
"continuous": {
"enabled": false
},
"synchronous": {
"enabled": false
}
},
"dataGovernancePolicy": {
"excludeOptOut": true
},
"creationTime": 0,
"updateEpoch": 1579292094,
"updateTime": 1579292094000
}
Mer information om hur du använder den här slutpunkten finns i segmentdefinitionsguiden.
Välj Create audience i Audience Portal.
En pover visas. Välj Build rules om du vill ange Segment Builder.
När du har skapat segmentdefinitionen väljer du Batch som Evaluation method.
Mer information om hur du skapar segmentdefinitioner finns i guiden Segment Builder
Hämta målgrupper
Du kan hämta alla målgrupper som utvärderas med batchsegmentering med hjälp av segmenteringstjänstens API eller genom målgruppsportalen i användargränssnittet.
Hämta en lista över alla segmentdefinitioner som har utvärderats med batchsegmentering i organisationen genom att göra en GET-begäran till slutpunkten /segment/definitions.
API-format
Du måste inkludera frågeparametern evaluationInfo.batch.enabled=true i sökvägen för begäran för att hämta segmentdefinitioner som utvärderats med gruppsegmentering.
GET /segment/definitions?evaluationInfo.batch.enabled=true
Begäran
En exempelbegäran om att lista alla gruppaktiverade segmentdefinitioner
curl -X GET \
'https://platform.adobe.io/data/core/ups/segment/definitions?evaluationInfo.batch.enabled=true' \
-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}'
Svar
Ett lyckat svar returnerar HTTP-status 200 med en array med segmentdefinitioner i organisationen som utvärderas med gruppsegmentering.
Ett exempelsvar som innehåller en lista med alla segmentdefinitioner som utvärderas i grupp för gruppsegmentering i din organisation
{
"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": true
},
"continuous": {
"enabled": false
},
"synchronous": {
"enabled": false
}
},
"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": true
},
"continuous": {
"enabled": true
},
"synchronous": {
"enabled": false
}
},
"creationTime": 1572021085000,
"updateEpoch": 1572021086000,
"updateTime": 1572021086000
}
],
"page": {
"totalCount": 2,
"totalPages": 1,
"sortField": "creationTime",
"sort": "desc",
"pageSize": 2,
"limit": 100
},
"link": {}
}
Mer detaljerad information om den returnerade segmentdefinitionen finns i stödlinjen för segmentdefinitioner.
Du kan hämta alla målgrupper som har aktiverats för batchsegmentering inom organisationen med hjälp av filter i Audience Portal. Välj
Gå till Update frequency och välj Batch inom de tillgängliga filtren. När du använder det här filtret visas alla målgrupper i organisationen som utvärderas med batchsegmentering.
Om du vill veta mer om hur du visar målgrupper i Experience Platform kan du läsa guiden för målportalen.