Dokumentation Experience Platform Användarhandbok om segmenteringstjänst

Edge segmenteringsguide

Last update: Fri Feb 21 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:

Skapat för:

Användare

Edge-segmentering är möjligheten att omedelbart utvärdera segmentdefinitioner i Adobe Experience Platform på kanten, vilket möjliggör användning av samma sida och nästa sidanpassning.

IMPORTANT

Kantdata lagras på en edge-serverplats som ligger närmast den plats där de samlades in. Dessa data kan också lagras på en annan plats än den som anges som Adobe Experience Platform datacenter (eller huvudkontor).

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.

Edge segmenteringsfrågetyper query-types

En fråga kan utvärderas med kantsegmentering om den uppfyller något av villkoren i följande tabell.

NOTE

Om frågan matchar någon av frågetyperna i följande tabell utvärderas den automatiskt med kantsegmentering. Den här funktionen bestäms automatiskt av systemet baserat på frågeuttrycket.

Frågetyp

Information

Fråga

Exempel

En händelse inom ett tidsfönster på mindre än 24 timmar

En segmentdefinition som refererar till en enda inkommande händelse inom ett tidsfönster på mindre än 24 timmar.

CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])

Ett exempel på en enskild händelse i ett relativt tidsfönster visas.

Endast profil

En segmentdefinition som bara refererar till ett profilattribut.

homeAddress.country.equals("US", false)

Ett exempel på ett profilattribut visas.

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.

workAddress.country.equals("US", false) and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])

Ett exempel på en enskild händelse med ett profilattribut i ett relativt tidsfönster visas.

Segmentering

En segmentdefinition som innehåller en eller flera grupp- eller kantsegment. Obs! Om ett segment används, inaktiveras profiler var 24:e timme.

inSegment("a730ed3f-119c-415b-a4ac-27c396ae2dff") and inSegment("8fbbe169-2da6-4c9d-a332-b6a6ecf559b9")

Ett exempel på ett segment av segment visas.

Flera händelser med ett profilattribut

Alla segmentdefinitioner som refererar till flera händelser under de senaste 24 timmarna och (valfritt) har ett eller flera profilattribut.

workAddress.country.equals("US", false) and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("directMarketing.emailClicked", false)) WHEN(today), C1: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])

Ett exempel på flera händelser med ett profilattribut visas.

Dessutom måste segmentdefinitionen vara knuten till en sammanfogningsprincip som är aktiv på kanten. Mer information om sammanfogningsprinciper finns i policyguiden för sammanfogning.

En segmentdefinition är inte berättigad till kantsegmentering i följande scenario:

Segmentdefinitionen innehåller en kombination av en enda händelse och en inSegment-händelse.
- Om segmentdefinitionen i inSegment-händelsen bara är en profil aktiveras segmentdefinitionen för kantsegmentering.
I segmentdefinitionen används"Ignorera år" som en del av tidsbegränsningarna.

Skapa målgrupper create-audience

Du kan skapa en målgrupp som utvärderas med hjälp av kantsegmentering med hjälp av antingen segmenteringstjänstens API eller genom målgruppsportalen i användargränssnittet.

En segmentdefinition kan vara kantaktiverad om den matchar någon av de valbara frågetyperna.

Segmenteringstjänstens API

API-format

code language-http
`POST /segment/definitions`

Begäran

accordion

En exempelbegäran om att skapa en segmentdefinition som är aktiverad för kantsegmentering

code language-shell

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": false
            },
            "continuous": {
                "enabled": false
            },
            "synchronous": {
                "enabled": true
            }
        },
        "schema": {
            "name": "_xdm.context.profile"
        }
     }'

Svar

Ett lyckat svar returnerar HTTP-status 200 med information om den segmentdefinition du nyss skapade.

accordion

Ett exempelsvar när du skapar en segmentdefinition.

code language-json

{
    "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": false
        },
        "continuous": {
            "enabled": false
        },
        "synchronous": {
            "enabled": true
        }
    },
    "dataGovernancePolicy": {
        "excludeOptOut": true
    },
    "creationTime": 0,
    "updateEpoch": 1579292094,
    "updateTime": 1579292094000
}

Mer information om hur du använder den här slutpunkten finns i segmentdefinitionsguiden.

Målgruppsportal

Välj Create audience i Audience Portal.

Knappen Skapa målgrupp är markerad i målgruppsportalen.

En pover visas. Välj Build rules om du vill ange Segment Builder.

Knappen Skapa regler markeras i porten för att skapa målgrupper.

Skapa en segmentdefinition som matchar någon av de valbara frågetyperna i Segment Builder. Om segmentdefinitionen kvalificerar för kantsegmentering kan du välja Edge som Evaluation method.

Segmentdefinitionen visas. Utvärderingstypen är markerad och visar att segmentdefinitionen kan utvärderas med hjälp av kantsegmentering.

Mer information om hur du skapar segmentdefinitioner finns i guiden Segment Builder

Hämta in målgrupper som utvärderats med kantsegmentering retrieve-audiences

Du kan hämta alla målgrupper som utvärderas med hjälp av kantsegmentering med hjälp av antingen segmenteringstjänstens API eller genom målgruppsportalen i användargränssnittet.

Segmenteringstjänstens API

Hämta en lista över alla segmentdefinitioner som har utvärderats med hjälp av kantsegmentering i organisationen genom att göra en GET-begäran till slutpunkten /segment/definitions.

API-format

Du måste inkludera frågeparametern evaluationInfo.synchronous.enabled=true i sökvägen för begäran för att hämta segmentdefinitioner som utvärderats med hjälp av kantsegmentering.

code language-http
`GET /segment/definitions?evaluationInfo.synchronous.enabled=true`

Begäran

accordion

Ett exempel på en begäran om att lista alla de edge-aktiverade segmentdefinitionerna

code language-shell

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 HTTP-status 200 med en array med segmentdefinitioner i organisationen som är aktiverade för kantsegmentering.

accordion

Ett exempelsvar som innehåller en lista med alla segmentdefinitioner som är aktiverade för kantsegmentering i organisationen

code language-json

{
    "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": {}
}

Mer detaljerad information om den returnerade segmentdefinitionen finns i stödlinjen för segmentdefinitioner.

Målgruppsportal

Du kan hämta alla målgrupper som är aktiverade för kantsegmentering inom organisationen med hjälp av filter i Audience Portal. Välj för att visa filterlistan.

Filterikonen är markerad i målportalen.

Gå till Uppdateringsfrekvens inom de tillgängliga filtren och välj Edge. Med det här filtret visas alla målgrupper i organisationen som utvärderas med kantsegmentering.

Edge uppdateringsfrekvens har valts och visar alla målgrupper i organisationen som utvärderas med kantsegmentering.

Läs handboken Målgruppsportal om du vill veta mer om hur du visar målgrupper i Platform.

Målgruppsinformation audience-details

Du kan visa information om en viss målgrupp som utvärderats med hjälp av kantsegmentering genom att markera den i målgruppsportalen.

När du har valt en målgrupp på Audience Portal visas sidan med målgruppsinformation. Här visas information om målgruppen, inklusive en sammanfattning av målgruppsinformationen, antalet kvalificerade profiler över tiden samt vilka mål målgruppen har aktiverats för.

Sidan med målgruppsinformation visas för en målgrupp som utvärderats med kantsegmentering.

För kantaktiverade målgrupper visas Profiles over time-kortet, som visar det totala antalet kvalificerade och det nya målgruppsuppdaterade måttet.

Måttet Total qualified representerar det totala antalet kvalificerade målgrupper, baserat på kantutvärderingar för den här målgruppen.

Måttet New audience updated representeras av ett linjediagram som visar förändringen i målgruppsstorlek genom kantsegmentering. Du kan justera listrutan så att den visar de senaste 24 timmarna, den senaste veckan eller de senaste 30 dagarna.

Profilerna över tidskortet är markerade.

Mer information om målgruppsinformation finns i Översikt över målgruppsportalen.

Nästa steg

Den här guiden förklarar vilken kantsegmentering som är och hur du skapar en segmentdefinition som kan utvärderas med hjälp av kantsegmentering i Adobe Experience Platform.

Läs Användarhandboken för segmentering om du vill veta mer om hur du använder användargränssnittet i Experience Platform.

Vanliga frågor om kantsegmentering finns i avsnittet kantsegmentering i Frågor och svar.

recommendation-more-help

770bc05d-534a-48a7-9f07-017ec1e14871