Hulplijn voor stroomsegmentatie

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 streamingsegmentatie gebeurt de kwalificatie van het publiek nu terwijl streaming data naar Experience Platform landt, waardoor de noodzaak om segmentatietaken te plannen en uit te voeren, wordt verminderd. Op deze manier kunt u gegevens evalueren terwijl deze worden doorgegeven aan Experience Platform, zodat het lidmaatschap van het publiek automatisch wordt bijgewerkt.

In aanmerking komende regels rulesets

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

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

Alleen profiel

Elke segmentdefinitie die alleen naar een profielkenmerk verwijst.

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

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

Meerdere gebeurtenissen binnen een relatief tijdvenster van 24 uur

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 segmentdefinitie zal niet voor het stromen segmentatie in de volgende scenario's in aanmerking komen:

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

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.

Soorten publiek combineren combine-audiences

Als u gegevens van zowel batch- als streaming bronnen wilt combineren, moet u de batch- en streaming componenten scheiden in verschillende soorten publiek.

Laten we bijvoorbeeld rekening houden met de volgende twee soorten publiek:

Als u de partijcomponent in uw het stromen publiek wilt gebruiken, zult u een verwijzing naar het partijpubliek moeten maken gebruikend segment van segmenten.

Een voorbeeldregel die de twee soorten publiek samenvoegt, ziet er als volgt uit:

inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and
CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false))
WHEN(<= 24 hours before now)])

Het resulterende publiek zal worden geëvalueerd gebruikend het stromen segmentatie, aangezien het hefboomwerkingen het lidmaatschap van het partijpubliek door naar de component van het partijpubliek te verwijzen.

Nochtans, als u twee publiek met gebeurtenisgegevens wilt combineren, kunt u niet enkel de twee gebeurtenissen combineren. U moet beide soorten publiek maken en vervolgens een ander publiek maken dat inSegment gebruikt om naar beide soorten publiek te verwijzen.

Bijvoorbeeld, laten wij zeggen u twee publiek hebt, met beide publiek woonachtig gebeurtenisschemagegevens:

In deze situatie, zou u een derde publiek als volgt moeten creëren:

inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and inSegment("9e1646bb-57ff-4309-ba59-17d6c5bab6a1")

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

POST /segment/definitions

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

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

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.

GET /segment/definitions?evaluationInfo.continuous.enabled=true

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

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

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.

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.

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.