Segmentazione Edge
La segmentazione di Edge è la capacità di valutare le definizioni dei segmenti in Adobe Experience Platform istantaneamente al limite, abilitando casi di utilizzo di personalizzazione della stessa pagina e della pagina successiva.
Introduzione
Questa guida per gli sviluppatori richiede una buona conoscenza dei vari servizi Adobe Experience Platform coinvolti nella segmentazione Edge. Prima di iniziare questo tutorial, consulta la documentazione dei seguenti servizi:
- Real-Time Customer Profile: fornisce un profilo consumer unificato in tempo reale, basato su dati aggregati provenienti da più origini.
- Adobe Experience Platform Segmentation Service: consente di creare tipi di pubblico dai dati di Real-Time Customer Profile.
- Experience Data Model (XDM): framework standardizzato tramite il quale Platform organizza i dati sull'esperienza del cliente.
Per effettuare correttamente le chiamate a qualsiasi endpoint API Experience Platform, leggi la guida guida introduttiva alle API Platform per scoprire le intestazioni richieste e come leggere le chiamate API di esempio.
Tipi di query di segmentazione di Edge query-types
Affinché un segmento possa essere valutato utilizzando la segmentazione Edge, la query deve essere conforme alle seguenti linee guida:
Inoltre, il segmento must deve essere associato a un criterio di unione attivo su Edge. Per ulteriori informazioni sui criteri di unione, leggere la guida ai criteri di unione.
Una definizione di segmento non verrà abilitata per la segmentazione Edge nei seguenti scenari:
- La definizione del segmento include una combinazione di un singolo evento e un evento
inSegment.- Tuttavia, se il segmento contenuto nell'evento
inSegmentè solo di profilo, la definizione del segmento sarà abilitata per la segmentazione Edge.
- Tuttavia, se il segmento contenuto nell'evento
- La definizione del segmento utilizza "Ignora anno" come parte dei vincoli di tempo.
Recupera tutti i segmenti abilitati per la segmentazione Edge
Per recuperare un elenco di tutti i segmenti abilitati per la segmentazione Edge nell'organizzazione, effettua una richiesta di GET all'endpoint /segment/definitions.
Formato API
Per recuperare i segmenti abilitati per la segmentazione Edge, è necessario includere il parametro di query evaluationInfo.synchronous.enabled=true nel percorso della richiesta.
GET /segment/definitions?evaluationInfo.synchronous.enabled=true
Richiesta
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}'
Risposta
In caso di esito positivo, la risposta restituisce un array di segmenti dell’organizzazione abilitati per la segmentazione Edge. Informazioni più dettagliate sulla definizione del segmento restituita sono disponibili nella guida dell'endpoint per le definizioni dei segmenti.
{
"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": {}
}
Creare un segmento abilitato per la segmentazione Edge
Per creare un segmento abilitato per la segmentazione Edge, devi eseguire una richiesta POST all'endpoint /segment/definitions che corrisponda a uno dei tipi di query di segmentazione Edge elencati sopra.
Formato API
POST /segment/definitions
Richiesta
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
}
}
}'
Risposta
In caso di esito positivo, la risposta restituisce i dettagli della definizione del segmento appena creata, abilitata per la segmentazione Edge.
{
"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
}
Passaggi successivi
Ora che sai come creare segmenti abilitati per la segmentazione edge, puoi utilizzarli per abilitare casi d’uso di personalizzazione della stessa pagina e della pagina successiva.
Per informazioni su come eseguire azioni simili e lavorare con i segmenti utilizzando l'interfaccia utente di Adobe Experience Platform, visita la guida utente di Segment Builder.
Appendice
Nella sezione seguente sono elencate le domande frequenti relative alla segmentazione Edge:
Quanto tempo ci vuole affinché un segmento sia disponibile nell’Edge Network?
È necessaria fino a un’ora perché un segmento sia disponibile nell’Edge Network.