Guida alla segmentazione in streaming
Creato per:
- Utente
NOTAAggiornamenti di idoneità
IMPORTANTESet di regole
Qualsiasi definizione di segmento nuova o modificata che corrisponde ai seguenti set di regole non sarà più valutata mediante streaming o segmentazione Edge. Verranno invece valutati utilizzando la segmentazione batch.
- Un singolo evento con una finestra temporale più lunga di 24 ore
- Attiva un pubblico con tutti i profili che hanno visualizzato una pagina web negli ultimi 3 giorni.
- Un singolo evento senza finestra temporale
- Attiva un pubblico con tutti i profili che hanno visualizzato una pagina web.
Finestra temporale
Per valutare un pubblico con segmentazione in streaming, deve essere vincolato entro un intervallo di tempo di 24 ore.
Inclusione di dati batch nei tipi di pubblico in streaming
Prima di questo aggiornamento, era possibile creare una definizione di pubblico in streaming che combinasse origini dati in batch e in streaming. Tuttavia, con l’ultimo aggiornamento, la creazione di un pubblico con origini di dati in batch e in streaming verrà valutata utilizzando la segmentazione batch.
Se devi valutare una definizione di segmento utilizzando la segmentazione in streaming o Edge che corrisponde al set di regole aggiornato, devi creare esplicitamente un batch e un set di regole in streaming e combinarli utilizzando un segmento di segmenti. Il set di regole batch deve essere basato su uno schema di profilo.
Ad esempio, supponiamo che tu abbia due tipi di pubblico, con un pubblico che ospita i dati dello schema del profilo e gli altri dati dello schema dell’evento dell’esperienza di alloggio:
e3be6d7f-1727-401f-a41e-c296b45f607a9e1646bb-57ff-4309-ba59-17d6c5bab6a1Se desideri utilizzare il componente batch nel pubblico in streaming, devi fare riferimento al pubblico batch utilizzando un segmento di segmenti.
Quindi, un set di regole di esempio che combinasse i due tipi di pubblico si presenterebbe come segue:
inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and
CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false))
WHEN(<= 24 hours before now)])
Il pubblico risultante sarà valutato utilizzando la segmentazione in streaming, poiché sfrutta l'appartenenza del pubblico batch facendo riferimento al componente pubblico batch.
Tuttavia, se desideri combinare due tipi di pubblico con i dati dell'evento, non è possibile semplicemente combinare i due eventi. È necessario creare entrambi i tipi di pubblico, quindi creare un altro pubblico che utilizza inSegment per fare riferimento a entrambi.
Ad esempio, supponiamo che tu abbia due tipi di pubblico, entrambi contenenti i dati dello schema dell’evento esperienza:
e3be6d7f-1727-401f-a41e-c296b45f607a9e1646bb-57ff-4309-ba59-17d6c5bab6a1In questa situazione, devi creare un terzo pubblico come segue:
inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and inSegment("9e1646bb-57ff-4309-ba59-17d6c5bab6a1")
Criterio di unione
Qualsiasi definizione di segmento nuova o modificata idonea per lo streaming o la segmentazione Edge deve essere nel criterio di unione "Attivo su Edge".
Se non è impostato alcun criterio di unione attivo, è necessario configurare il criterio di unione e impostarlo per essere attivo sul server Edge.
La segmentazione in streaming è la capacità di valutare i tipi di pubblico in Adobe Experience Platform in tempo quasi reale concentrandosi sulla ricchezza dei dati.
Con la segmentazione in streaming, la qualificazione del pubblico ora avviene quando i dati in streaming arrivano in Experience Platform, alleviando la necessità di pianificare ed eseguire processi di segmentazione. Questo consente di valutare i dati trasmessi in Experience Platform, e di mantenere automaticamente aggiornata l’iscrizione al pubblico.
Set di regole idonei
IMPORTANTUn set di regole è idoneo per la segmentazione in streaming se soddisfa uno dei criteri descritti nella tabella seguente.
NOTECHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])
homeAddress.country.equals("US", false)
workAddress.country.equals("US", false) and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])
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)])
Una definizione di segmento non sarà idonea per la segmentazione in streaming nei seguenti scenari:
- La definizione del segmento include segmenti o caratteristiche di Adobe Audience Manager (AAM).
- La definizione del segmento include più entità (query con più entità).
- La definizione del segmento include una combinazione di un singolo evento e un evento
inSegment.- Ad esempio, concatenando quanto segue in un singolo set di regole:
inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(<= 24 hours before now)]).
- Ad esempio, concatenando quanto segue in un singolo set di regole:
- La definizione del segmento utilizza "Ignora anno" come parte dei vincoli di tempo.
Tieni presente le seguenti linee guida applicabili alle query di segmentazione in streaming:
- L'intervallo di lookback è limitato a un giorno.
- Tra gli eventi è presente una condizione di ordinamento temporale must.
- Sono supportate le query con almeno un evento negato. L'intero evento non può essere una negazione.
Se una definizione di segmento viene modificata in modo da non soddisfare più i criteri per la segmentazione in streaming, la definizione del segmento passerà automaticamente da "Streaming" a "Batch".
Inoltre, l’annullamento del riconoscimento del segmento, in modo simile alla qualificazione del segmento, avviene in tempo reale. Di conseguenza, se un pubblico non è più idoneo per un segmento, non sarà immediatamente qualificato. Ad esempio, se la definizione del segmento richiede "Tutti gli utenti che hanno acquistato scarpe rosse nelle ultime tre ore", dopo tre ore tutti i profili che si sono inizialmente qualificati per la definizione del segmento non saranno qualificati.
Combinare tipi di pubblico
Per combinare i dati provenienti sia da origini batch che da origini in streaming, è necessario separare i componenti batch e in streaming in tipi di pubblico separati.
Attributo profilo ed evento esperienza
Ad esempio, prendiamo in considerazione i due tipi di pubblico di esempio seguenti:
e3be6d7f-1727-401f-a41e-c296b45f607a9e1646bb-57ff-4309-ba59-17d6c5bab6a1Se desideri utilizzare il componente batch nel pubblico in streaming, devi fare riferimento al pubblico batch utilizzando un segmento di segmenti.
Quindi, un set di regole di esempio che combinasse i due tipi di pubblico si presenterebbe come segue:
inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and
CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false))
WHEN(<= 24 hours before now)])
Il pubblico risultante sarà valutato utilizzando la segmentazione in streaming, poiché sfrutta l'appartenenza del pubblico batch facendo riferimento al componente pubblico batch.
Più eventi esperienza
Se vuoi combinare più tipi di pubblico con i dati dell'evento, non puoi semplicemente combinare gli eventi. È necessario creare un pubblico per ogni evento, quindi creare un altro pubblico che utilizza inSegment per fare riferimento a tutti i tipi di pubblico.
Ad esempio, supponiamo che tu abbia due tipi di pubblico, entrambi contenenti i dati dello schema dell’evento esperienza:
7deb246a-49b4-4687-95f9-6316df0499489e1646bb-57ff-4309-ba59-17d6c5bab6a1In questa situazione, devi creare un terzo pubblico come segue:
inSegment("7deb246a-49b4-4687-95f9-6316df049948) and inSegment("9e1646bb-57ff-4309-ba59-17d6c5bab6a1")
Crea pubblico
Puoi creare un pubblico valutato utilizzando la segmentazione in streaming utilizzando l’API del servizio di segmentazione o tramite Audience Portal nell’interfaccia utente.
Una definizione di segmento può essere abilitata per lo streaming se corrisponde a uno dei set di regole idonei.
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-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"
}
}'
Risposta
In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con i dettagli della definizione del segmento appena creata.
{
"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
}
Ulteriori informazioni sull'utilizzo di questo endpoint sono disponibili nella guida dell'endpoint di definizione del segmento.
In Audience Portal, seleziona Crea pubblico.
Viene visualizzata una finestra a comparsa. Seleziona Genera regole per accedere al Generatore di segmenti.
In Segment Builder, crea una definizione di segmento corrispondente a uno dei set di regole idonei. Se la definizione del segmento è idonea per la segmentazione in streaming, potrai selezionare Streaming come metodo di valutazione.
Per ulteriori informazioni sulla creazione delle definizioni dei segmenti, consulta la guida del Generatore di segmenti
Recuperare i tipi di pubblico
Puoi recuperare tutti i tipi di pubblico valutati utilizzando la segmentazione in streaming utilizzando l’API del servizio di segmentazione o tramite Audience Portal nell’interfaccia utente.
Recupera un elenco di tutte le definizioni di segmenti valutate utilizzando la segmentazione in streaming all'interno della tua organizzazione effettuando una richiesta GET all'endpoint /segment/definitions.
Formato API
È necessario includere il parametro query evaluationInfo.synchronous.enabled=true nel percorso della richiesta per recuperare le definizioni dei segmenti valutate utilizzando la segmentazione in streaming.
GET /segment/definitions?evaluationInfo.continuous.enabled=true
Richiesta
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}'
Risposta
In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con un array di definizioni di segmenti nell’organizzazione abilitate per la segmentazione in streaming.
{
"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": {}
}
Informazioni più dettagliate sulla definizione del segmento restituita sono disponibili nella guida dell'endpoint per le definizioni dei segmenti.
Puoi recuperare tutti i tipi di pubblico abilitati per la segmentazione in streaming all’interno della tua organizzazione utilizzando i filtri in Audience Portal. Seleziona l'icona
All'interno dei filtri disponibili, vai a Frequenza di aggiornamento e seleziona "Streaming". Utilizzando questo filtro vengono visualizzati tutti i tipi di pubblico dell’organizzazione valutati mediante la segmentazione in streaming.
Per ulteriori informazioni sulla visualizzazione dei tipi di pubblico in Experience Platform, consulta la guida di Audience Portal.
Dettagli del pubblico
Puoi visualizzare i dettagli di un pubblico specifico valutato utilizzando la segmentazione in streaming selezionandola all’interno di Audience Portal.
Dopo aver selezionato un pubblico su Audience Portal, viene visualizzata la pagina dei dettagli del pubblico. Visualizza informazioni sul pubblico, tra cui un riepilogo dei dettagli del pubblico, la quantità di profili qualificati nel tempo, nonché le destinazioni in cui il pubblico è stato attivato.
Per i tipi di pubblico abilitati per lo streaming, viene visualizzata la scheda Profili nel tempo, che mostra il totale delle metriche qualificate e le nuove metriche di aggiornamento del pubblico.
La metrica Totale qualificato rappresenta il numero totale di tipi di pubblico qualificati, in base alle valutazioni in batch e in streaming per questo pubblico.
La metrica Nuovo pubblico aggiornato è rappresentata da un grafico a linee che mostra la modifica nella dimensione del pubblico tramite la segmentazione in streaming. Puoi regolare il menu a discesa per visualizzare le ultime 24 ore, l’ultima settimana o gli ultimi 30 giorni.
Per ulteriori dettagli sui dettagli del pubblico, consulta la Panoramica di Audience Portal.
Passaggi successivi
Questa guida spiega come le definizioni dei segmenti abilitati per lo streaming funzionano in Adobe Experience Platform e come monitorare le definizioni dei segmenti abilitati per lo streaming.
Per ulteriori informazioni sull'utilizzo dell'interfaccia utente di Adobe Experience Platform, leggere la Guida utente per la segmentazione.
Per le domande frequenti sulla segmentazione in streaming, leggi la sezione segmentazione in streaming delle domande frequenti.