Edge-segmentatie

NOTE
In het volgende document wordt beschreven hoe u randsegmentatie kunt uitvoeren met behulp van de API. Voor informatie die randsegmentatie gebruikend UI uitvoert, te lezen gelieve de gids van de randsegmentatie UI.
Edge-segmentatie is nu algemeen beschikbaar voor alle platformgebruikers. Als u de definities van het randsegment tijdens bèta creeerde, zullen deze segmentdefinities operationeel blijven.

Edge-segmentatie is de mogelijkheid om segmentdefinities direct aan de rand van Adobe Experience Platform te evalueren, zodat dezelfde pagina en de volgende pagina kunnen worden gebruikt.

IMPORTANT
De Edge-gegevens worden opgeslagen op een locatie op de Edge-server die het dichtst bij de locatie ligt waar ze zijn verzameld en kunnen worden opgeslagen op een andere locatie dan die welke is aangewezen als het Adobe Experience Platform-datacenter in de hub (of principal).
Bovendien, zal de motor van de randsegmentatie slechts verzoeken op de rand waar er één primaire duidelijke identiteit is, die met niet op rand-gebaseerde primaire identiteiten verenigbaar is.

Aan de slag

Deze ontwikkelaarshandleiding vereist een goed begrip van de verschillende Adobe Experience Platform -services die te maken hebben met segmentatie van randen. Voordat u met deze zelfstudie begint, raadpleegt u de documentatie voor de volgende services:

Om vraag aan om het even welk Experience Platform API eindpunten met succes te maken, te lezen gelieve de gids op begonnen wordt met Platform APIsom over vereiste kopballen te leren en hoe te om steekproefAPI vraag te lezen.

Type Edge-segmentquery query-types

Opdat een segment wordt geëvalueerd gebruikend randsegmentatie, moet de vraag aan de volgende richtlijnen in overeenstemming zijn:

Type query
Details
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.
Alleen profiel
Elke segmentdefinitie die alleen naar een profielkenmerk verwijst.
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.
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.
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.

Bovendien, moet het segment ​aan een fusiebeleid worden gebonden dat op rand actief is. Voor meer informatie over samenvoegingsbeleid, te lezen gelieve de gids van het samenvoegingsbeleid.

Een segmentdefinitie zal ​niet voor randsegmentatie in de volgende scenario's worden toegelaten:

  • De segmentdefinitie bevat een combinatie van één gebeurtenis en een inSegment -gebeurtenis.
    • Nochtans, als het segment in de inSegment gebeurtenis profiel slechts is, zal de segmentdefinitie ​voor randsegmentatie worden toegelaten.
  • In de segmentdefinitie wordt "Jaar negeren" gebruikt als onderdeel van de tijdbeperkingen.

Alle segmenten ophalen die zijn ingeschakeld voor segmentatie van randen

U kunt een lijst van alle segmenten terugwinnen die voor randsegmentatie binnen uw organisatie door een verzoek van de GET aan het /segment/definitions eindpunt te doen worden toegelaten.

API formaat

Als u segmenten wilt ophalen die zijn ingeschakeld voor randsegmentatie, moet u de queryparameter evaluationInfo.synchronous.enabled=true opnemen in het aanvraagpad.

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

Verzoek

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

Reactie

Een succesvolle reactie keert een serie van segmenten in uw organisatie terug die voor randsegmentatie worden toegelaten. De meer gedetailleerde informatie over de gesegmenteerde teruggekeerde definitie kan in de gids van het de segmentdefinitiedetectietypeworden gevonden.

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

Een segment maken dat is ingeschakeld voor randsegmentatie

U kunt een segment tot stand brengen dat voor randsegmentatie door een verzoek van de POST aan het /segment/definitions eindpunt wordt toegelaten dat één van de hierboven vermelde de vraagtypes van de randsegmentatieaanpast.

API formaat

POST /segment/definitions

Verzoek

NOTE
Het onderstaande voorbeeld is een standaardverzoek om een segment te maken. Voor meer informatie over het creëren van een segmentdefinitie, te lezen gelieve het leerprogramma bij het creëren van een segment.
curl -X POST \
  https://platform.adobe.io/data/core/ups/segment/definitions \
  -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}' \
  -d '{
    "schema": {
        "name": "_xdm.context.profile"
    },
    "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
        }
    }
}'

Reactie

Een succesvolle reactie keert de details van de pas gecreëerde segmentdefinitie terug die voor randsegmentatie wordt toegelaten.

{
    "id": "f15063cb-2da8-4851-a2e2-bf59ddd2f004",
    "schema": {
        "name": "_xdm.context.profile"
    },
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "{SANDBOX_ID}",
        "sandboxName": "{SANDBOX_NAME}",
        "type": "production",
        "default": true
    },
    "name": "Homepage_continuous",
    "description": "People who are on their homepage - continuous",
    "expression": {
        "type": "PQL",
        "format": "pql/text",
        "value": "chain(xEvent, timestamp, [X: WHAT(var1._experience.analytics.endUser.firstWeb.webPageDetails.isHomePage = "true")])"
    },
    "evaluationInfo": {
        "batch": {
            "enabled": false
        },
        "continuous": {
            "enabled": false
        },
        "synchronous": {
            "enabled": true
        }
    },
    "creationTime": 1572021085000,
    "updateEpoch": 1572021086000,
    "updateTime": 1572021086000
}

Volgende stappen

Nu u weet hoe te om rand-segmentatie-Toegelaten segmenten tot stand te brengen, kunt u hen gebruiken om het gebruik van de zelfde-pagina en volgende-pagina verpersoonlijking toe te laten gevallen.

Leren hoe te om gelijkaardige acties uit te voeren en met segmenten te werken gebruikend het gebruikersinterface van Adobe Experience Platform, gelieve de gebruikersgids van de Bouwer van het Segmentte bezoeken.

Bijlage

In de volgende sectie worden veelgestelde vragen over de segmentatie van randen weergegeven:

Hoe lang duurt het voordat een segment beschikbaar is op de Edge Network?

Het duurt tot één uur voor een segment beschikbaar is op de Edge Network.

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