DokumentationExperience PlatformAnvändarhandbok om segmenteringstjänst

Direktuppspelningssegmenteringsguide

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

Skapat för:

  • Användare

Direktuppspelningssegmentering är möjligheten att utvärdera målgrupper i Adobe Experience Platform i nära realtid samtidigt som man fokuserar på datainsamling.

Med direktuppspelningssegmentering blir det numera en upplevelse av målgruppskvalificering när strömmande data når plattformen, vilket minskar behovet av att schemalägga och köra segmenteringsjobb. På så sätt kan ni utvärdera data när de skickas till Platform och automatiskt hålla målgruppsmedlemskapet uppdaterat.

Berättigade frågetyper query-types

En fråga är berättigad till direktuppspelningssegmentering om den uppfyller något av villkoren i följande tabell.

NOTE
För att direktuppspelningssegmenteringen ska fungera måste du aktivera schemalagd segmentering för organisationen. Mer information om hur du aktiverar schemalagd segmentering finns i översikten över målportalen.
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 grupper eller direktuppspelningssegment. 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.

En segmentdefinition är inte berättigad till direktuppspelningssegmentering i följande scenarier:

  • Segmentdefinitionen innehåller segment eller egenskaper för Adobe Audience Manager (AAM).
  • Segmentdefinitionen innehåller flera enheter (frågor om flera enheter).
  • 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 direktuppspelningssegmentering.
  • I segmentdefinitionen används"Ignorera år" som en del av tidsbegränsningarna.

Observera följande riktlinjer som gäller frågor om direktuppspelningssegmentering:

Frågetyp
Riktlinje
Enkel händelsefråga
Det finns inga begränsningar för uppslagsfönstret.
Fråga med händelsehistorik
  • Uppslagsfönstret är begränsat till en dag.
  • Det finns ett strikt tidsordningsvillkor måste mellan händelserna.
  • Frågor med minst en negerad händelse stöds. Hela händelsen kan dock inte vara en negation.

Om en segmentdefinition ändras så att den inte längre uppfyller villkoren för direktuppspelningssegmentering, kommer segmentdefinitionen automatiskt att växla från"direktuppspelning" till"Gruppering".

Dessutom sker okvalificerat segment, på samma sätt som segmentkvalificering, i realtid. Om en publik inte längre kvalificerar sig för ett segment blir det därför omedelbart okvalificerat. Om segmentdefinitionen till exempel frågar efter"Alla användare som har köpt röda skor de senaste tre timmarna", efter tre timmar, kommer alla profiler som ursprungligen kvalificerades för segmentdefinitionen att vara okvalificerade.

Skapa målgrupper create-audience

Du kan skapa en målgrupp som utvärderas med direktuppspelningssegmentering med hjälp av API:t för segmenteringstjänsten eller via Audience Portal i användargränssnittet.

En segmentdefinition kan vara direktuppspelningsaktiverad om den matchar någon av de berättigade 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 direktuppspelningssegmentering
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": true
            },
            "synchronous": {
                "enabled": false
            }
        },
        "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": true
        },
        "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.

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 direktuppspelningssegmentering kan du välja Streaming som Evaluation method.

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

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

Hämta målgrupper retrieve-audiences

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

Segmenteringstjänstens API

Hämta en lista över alla segmentdefinitioner som har utvärderats med hjälp av direktuppspelningssegmentering 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 direktuppspelningssegmentering.

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

Begäran

accordion
Ett exempel på en begäran om att lista alla segmentdefinitioner som kan direktuppspelas
code language-shell 
curl -X GET 'https://platform.adobe.io/data/core/ups/segment/definitions?evaluationInfo.continuous.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 är aktiverade för direktuppspelningssegmentering.

accordion
Ett exempelsvar som innehåller en lista med alla segmentdefinitioner som kan direktuppspelas i organisationen
code language-json 
{
    "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": true
                },
                "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.
Målgruppsportal

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

Filterikonen är markerad i målportalen.

Gå till Update frequency och välj Streaming inom de tillgängliga filtren. När du använder det här filtret visas alla målgrupper i organisationen som utvärderas med direktuppspelningssegmentering.

Uppdateringsfrekvensen för direktuppspelning har valts och visar alla målgrupper i organisationen som utvärderas med direktuppspelningssegmentering.

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 direktuppspelningssegmentering genom att markera den i målportalen.

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 direktuppspelningssegmentering.

För direktuppspelningsaktiverade målgrupper visas Profiles over time-kortet, som visar det totala antalet kvalificerade och de nya målgruppsuppdaterade mätvärdena.

Måttet Total qualified representerar det totala antalet kvalificerade målgrupper baserat på batch- och direktuppspelningsutvä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 direktuppspelningssegmentering. 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 hur definitioner av direktuppspelningsaktiverade segment fungerar i Adobe Experience Platform och hur man övervakar definitioner av direktuppspelningsaktiverade segment.

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

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

recommendation-more-help
770bc05d-534a-48a7-9f07-017ec1e14871