Documentatie Experience Platform Gids voor Segmentation Service

Hulplijn voor stroomsegmentatie

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

Onderwerpen:

Gemaakt voor:

Gebruiker

Streaming segmentering is de mogelijkheid om het publiek in Adobe Experience Platform in bijna realtime te evalueren en tegelijk de nadruk te leggen op gegevensrijkdom.

Met het stromen segmentatie, gebeurt de publiekskwalificatie nu aangezien het stromen gegevens in Platform landen, die de behoefte verlichten om segmentatietaken te plannen en in werking te stellen. Hierdoor kunt u gegevens evalueren terwijl deze worden doorgegeven aan Platform, zodat het lidmaatschap van het publiek automatisch wordt bijgewerkt.

In aanmerking komende querytypen query-types

Een query komt in aanmerking voor streamingsegmentatie als deze voldoet aan een van de criteria die in de volgende tabel worden beschreven.

NOTE

Opdat het stromen segmentatie aan het werk is, zult u geplande segmentatie voor de organisatie moeten toelaten. Voor details bij het toelaten van geplande segmentatie, gelieve te verwijzen naar het Poortoverzicht van het Poort van het Publiek.

Type query

Details

Query

Voorbeeld

Eén gebeurtenis binnen een tijdsvenster van minder dan 24 uur

Elke segmentdefinitie die verwijst naar één binnenkomende gebeurtenis binnen een tijdvenster van minder dan 24 uur.

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

een voorbeeld van één enkele gebeurtenis binnen een relatief tijdvenster wordt getoond.

Alleen profiel

Elke segmentdefinitie die alleen naar een profielkenmerk verwijst.

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

een voorbeeld van een getoonde profielattributen.

Eén gebeurtenis met een profielkenmerk binnen een relatief tijdvenster van minder dan 24 uur

Elke segmentdefinitie die verwijst naar één binnenkomende gebeurtenis, met een of meer profielkenmerken, en die optreedt binnen een relatief tijdvenster van minder dan 24 uur.

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

een voorbeeld van één enkele gebeurtenis met een profielattribuut binnen een relatief tijdvenster wordt getoond.

Segment van segmenten

Elke segmentdefinitie die een of meer batch- of streaming segmenten bevat. Nota: als een segment van segmenten wordt gebruikt, zal de profielontzetting elke 24 uren gebeuren.

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

een voorbeeld van een segment van segmenten wordt getoond.

Meerdere gebeurtenissen met een profielkenmerk

Om het even welke segmentdefinitie die naar veelvoudige gebeurtenissen binnen de laatste 24 uren verwijst en (naar keuze) heeft één of meerdere profielattributen.

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)])

een voorbeeld van veelvoudige gebeurtenissen met een profielattribuut wordt getoond.

Een segmentdefinitie zal niet voor het stromen segmentatie in de volgende scenario's in aanmerking komen:

De segmentdefinitie omvat Adobe Audience Manager (AAM)-segmenten of -kenmerken.
De segmentdefinitie omvat meerdere entiteiten (vragen van meerdere entiteiten).
De segmentdefinitie bevat een combinatie van één gebeurtenis en een inSegment -gebeurtenis.
- Nochtans, als de segmentdefinitie in de inSegment gebeurtenis profiel slechts is, zal de segmentdefinitie voor het stromen segmentatie worden toegelaten.
In de segmentdefinitie wordt "Jaar negeren" gebruikt als onderdeel van de tijdbeperkingen.

Houd rekening met de volgende richtlijnen die van toepassing zijn op streamingsegmenteringsvragen:

Type query

Richtsnoer

Single-event-query

Er gelden geen limieten voor het terugzoekvenster.

Query uitvoeren met gebeurtenisgeschiedenis

Het raadplegingsvenster is beperkt tot één dag.
Een strikte tijd-opdracht gevend voorwaarde moet tussen de gebeurtenissen bestaan.
Query's met ten minste één genegeerde gebeurtenis worden ondersteund. Nochtans, kan de volledige gebeurtenis niet een negatie zijn.

Als een segmentdefinitie wordt gewijzigd zodat deze niet meer voldoet aan de criteria voor het streamen van segmentatie, schakelt de segmentdefinitie automatisch over van "Streaming" naar "Batch".

Bovendien, segmentonkwalificatie, zo gelijkaardig aan segmentkwalificatie, gebeurt in real time. Als een publiek niet langer in aanmerking komt voor een segment, is het dus onmiddellijk niet gekwalificeerd. Bijvoorbeeld, als de segmentdefinitie "Alle gebruikers vraagt die rode schoenen in de laatste drie uren"kochten, na drie uren, zullen alle profielen die aanvankelijk voor de segmentdefinitie kwalificeerden ongekwalificeerd zijn.

publiek maken create-audience

U kunt een publiek tot stand brengen dat gebruikend het stromen segmentatie gebruikend of de Dienst API van de Segmentatie of door het Portaal van de Publiek in UI wordt geëvalueerd.

Een segmentdefinitie kan stromen-toegelaten zijn als het één van de in aanmerking komende vraagtypesaanpast.

de Dienst API van de Segmentatie

API formaat

code language-http
`POST /segment/definitions`

Verzoek

accordion

Een voorbeeldverzoek om een segmentdefinitie te maken die is ingeschakeld voor het streamen van segmentatie

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"
        }
     }'

Reactie

Een succesvolle reactie keert status 200 van HTTP met details van uw pas gecreëerde segmentdefinitie terug.

accordion

Een voorbeeldreactie bij het maken van een segmentdefinitie.

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
}

Meer informatie over het gebruiken van dit eindpunt kan in de gids van het het eindpunt van de segmentdefinitieworden gevonden.

Audience Portal

Selecteer Create audience in Audience Portal.

Create publieksknoop wordt benadrukt in het Portaal van het Publiek.

Er verschijnt een pop-up. Selecteer Build rules om Segment Builder in te voeren.

de knoop van de Regels van de Bouwstijl wordt benadrukt in creeer publiek popover.

Binnen de Bouwer van het Segment, creeer een segmentdefinitie die één van de in aanmerking komende vraagtypesaanpast. Als de segmentdefinitie voor het stromen segmentatie kwalificeert, zult u Streaming als Evaluation method kunnen selecteren.

de segmentdefinitie wordt getoond. Het evaluatietype wordt benadrukt, die de segmentdefinitie tonen kan worden geëvalueerd gebruikend het stromen segmentatie.

Om meer over het creëren van segmentdefinities te leren, te lezen gelieve de gids van de Bouwer van het Segment

Soorten publiek ophalen retrieve-audiences

U kunt al publiek terugwinnen dat gebruikend het stromen segmentatie gebruikend of de Dienst API van de Segmentatie of door het Portaal van het Publiek in UI wordt geëvalueerd.

de Dienst API van de Segmentatie

Haal een lijst op van alle segmentdefinities die worden geëvalueerd met behulp van streamingsegmentatie binnen uw organisatie door een GET-aanvraag in te dienen bij het /segment/definitions -eindpunt.

API formaat

U moet de vraagparameter evaluationInfo.synchronous.enabled=true in de verzoekweg omvatten om segmentdefinities terug te winnen die gebruikend het stromen segmentatie worden geëvalueerd.

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

Verzoek

accordion

Een voorbeeldverzoek om alle streaming-toegelaten segmentdefinities op te nemen

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}'

Reactie

Een succesvolle reactie keert status 200 van HTTP met een serie van segmentdefinities in uw organisatie terug die voor het stromen segmentatie worden toegelaten.

accordion

A steekproefreactie die een lijst van alle het stromen-segmenteren-Toegelaten segmentdefinities in uw organisatie bevat

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

De meer gedetailleerde informatie over de gesegmenteerde teruggekeerde definitie kan in de gids van het de segmentdefinitiedetectietypeworden gevonden.

Audience Portal

U kunt al publiek terugwinnen dat voor het stromen segmentatie binnen uw organisatie door filters in het Portaal van de Publiek wordt toegelaten te gebruiken. Selecteer het pictogram om de lijst van filters te tonen.

het filterpictogram wordt benadrukt in het Portaal van het Publiek.

Ga binnen de beschikbare filters naar Update frequency en selecteer "Streaming". Met dit filter geeft u alle soorten publiek in uw organisatie weer die zijn geëvalueerd met behulp van streaming segmentatie.

de het stromen updatefrequentie wordt geselecteerd, tonend alle publiek in de organisatie die gebruikend het stromen segmentatie worden geëvalueerd.

Meer over het bekijken van publiek in Platform leren, gelieve de gids van het Portaal van het Publiekte lezen.

Details publiek audience-details

U kunt details van een specifiek publiek bekijken die gebruikend het stromen segmentatie door het binnen de Portaal van het Publiek te selecteren wordt geëvalueerd.

Na het selecteren van een publiek op de Portaal van de Publiek, verschijnt de pagina van publieksdetails. Dit toont informatie over het publiek, met inbegrip van een samenvatting van de publieksdetails, de hoeveelheid gekwalificeerde profielen in tijd, evenals de bestemmingen het publiek aan geactiveerd is.

de pagina van publieksdetails wordt getoond voor een publiek dat gebruikend het stromen segmentatie wordt geëvalueerd.

Voor streaming-toegelaten publiek, wordt de Profiles over time kaart getoond, die het totaal kwalificeerde en nieuwe publiek bijgewerkte metriek toont.

Total qualified metrisch vertegenwoordigt het totale aantal gekwalificeerde publiek, dat op partij en het stromen evaluaties voor dit publiek wordt gebaseerd.

New audience updated metrisch wordt vertegenwoordigd door een lijngrafiek die de verandering in publieksgrootte door het stromen segmentatie toont. U kunt het vervolgkeuzemenu aanpassen en de laatste 24 uur, vorige week of 30 dagen weergeven.

De Profielen over tijdkaart wordt benadrukt.

Voor meer details op publieksdetails, te lezen gelieve het Poortoverzicht van het Poort van het Publiek.

Volgende stappen

Deze gids verklaart hoe het stromen-toegelaten segmentdefinities op Adobe Experience Platform werken en hoe te om het stromen-toegelaten segmentdefinities te controleren.

Om meer over het gebruiken van het gebruikersinterface van Adobe Experience Platform te leren, te lezen gelieve de gebruikersgids van de Segmentatie.

Voor vaak gestelde vragen over het stromen segmentatie, te lezen gelieve de het stromen segmenteringssectie van FAQ.

recommendation-more-help

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