Creazione di un segmento

Questo documento fornisce un'esercitazione per lo sviluppo, il test, l'anteprima e il salvataggio di una definizione di segmento mediante l'API Adobe Experience Platform Segmentation Service API.

Per informazioni su come creare segmenti utilizzando l’interfaccia utente, consulta la guida diSegment Builder (Generatore di segmenti).

Introduzione

Questa esercitazione richiede una conoscenza approfondita dei vari Adobe Experience Platform servizi coinvolti nella creazione di segmenti di pubblico. Prima di iniziare questa esercitazione, consulta la documentazione relativa ai seguenti servizi:

Le sezioni seguenti forniscono informazioni aggiuntive che sarà necessario conoscere per eseguire correttamente le chiamate alle Platform API.

Lettura di chiamate API di esempio

Questa esercitazione fornisce esempi di chiamate API per dimostrare come formattare le richieste. Questi includono percorsi, intestazioni richieste e payload di richieste formattati correttamente. Viene inoltre fornito un JSON di esempio restituito nelle risposte API. Per informazioni sulle convenzioni utilizzate nella documentazione per le chiamate API di esempio, vedete la sezione come leggere chiamate API di esempio nella guida alla Experience Platform risoluzione dei problemi.

Raccogli valori per le intestazioni richieste

Per effettuare chiamate alle Platform API, è prima necessario completare l'esercitazione sull'autenticazione. Completando l'esercitazione sull'autenticazione, vengono forniti i valori per ciascuna delle intestazioni richieste in tutte le chiamate Experience Platform API, come illustrato di seguito:

  • Autorizzazione: Portatore {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}

Tutte le risorse in Experience Platform sono isolate in sandbox virtuali specifiche. Tutte le richieste alle Platform API richiedono un'intestazione che specifica il nome della sandbox in cui avrà luogo l'operazione:

  • x-sandbox-name: {SANDBOX_NAME}
Nota

Per ulteriori informazioni sulle sandbox in Platform, consultate la documentazione sulla panoramica dellasandbox.

Tutte le richieste che contengono un payload (POST, PUT, PATCH) richiedono un'intestazione aggiuntiva:

  • Content-Type: application/json

Sviluppo di una definizione di segmento

Il primo passo nella segmentazione consiste nel definire un segmento, rappresentato in un costrutto chiamato definizione di segmento. Una definizione di segmento è un oggetto che racchiude una query scritta in Profile Query Language (PQL). Questo oggetto è anche denominato predicato PQL. I predicati PQL definiscono le regole per il segmento in base alle condizioni relative a qualsiasi record o dati delle serie temporali forniti da Real-time Customer Profile. Per ulteriori informazioni sulla scrittura di query PQL, consultate la guida PQL.

Puoi creare una nuova definizione di segmento effettuando una richiesta di POST all’ /segment/definitions endpoint nell’ Segmentation API. L'esempio seguente illustra come formattare una richiesta di definizione, incluse le informazioni necessarie per definire correttamente un segmento.

Per una spiegazione dettagliata su come definire un segmento, consulta la guida per gli sviluppatori per la definizione delsegmento.

Stima e anteprima di un'audience

Mentre sviluppate la definizione del segmento, potete utilizzare gli strumenti di stima e anteprima all’interno Real-time Customer Profile per visualizzare le informazioni a livello di riepilogo per garantire che l’audience attesa sia isolata. Le stime forniscono informazioni statistiche sulla definizione di un segmento, come la dimensione dell'audience e l'intervallo di confidenza proiettati. Le anteprime forniscono elenchi impaginati di profili di qualifica per una definizione di segmento, consentendo di confrontare i risultati con quanto previsto.

Stimando e visualizzando in anteprima il pubblico, potete sottoporre a test e ottimizzare i predicati PQL fino a ottenere un risultato desiderato, da cui poi utilizzarli in una definizione aggiornata del segmento.

Sono necessari due passaggi per visualizzare l’anteprima o ottenere una stima del segmento:

  1. Creare un processo di anteprima
  2. Visualizzare la stima o l’anteprima utilizzando l’ID del processo di anteprima

Modalità di generazione delle stime

Gli esempi di dati vengono utilizzati per valutare i segmenti e stimare il numero di profili di qualifica. I nuovi dati vengono caricati in memoria ogni mattina (tra le 12AM-2AM PT, che è 7-9AM UTC), e tutte le query di segmentazione sono stimate utilizzando i dati di esempio di quel giorno. Di conseguenza, eventuali nuovi campi aggiunti o dati aggiuntivi raccolti saranno riportati nelle stime il giorno successivo.

La dimensione del campione dipende dal numero complessivo di entità nell'archivio profili. Queste dimensioni di campione sono rappresentate nella seguente tabella:

Entità nell'archivio profili Dimensione del campione
Meno di 1 milione Set di dati completo
Da 1 a 20 milioni 1 milione
Oltre 20 milioni 5% del totale

Le stime generalmente vengono eseguite su un periodo di 10-15 secondi, a partire da una stima approssimativa e con un perfezionamento man mano che vengono letti più record.

Creare un processo di anteprima

Per creare un nuovo processo di anteprima, effettuate una richiesta di POST all’ /preview endpoint.

Per istruzioni dettagliate sulla creazione di un processo di anteprima, consultate la guida alleanteprime e agli endpoint delle stime.

Visualizzare una stima o un'anteprima

I processi di stima e anteprima vengono eseguiti in modo asincrono, in quanto le diverse query possono richiedere diversi tempi di completamento. Una volta avviata la query, potete utilizzare le chiamate API per recuperare (GET) lo stato corrente della stima o dell'anteprima mentre progredisce.

Utilizzando l' Segmentation Service API, potete cercare lo stato corrente di un processo di anteprima con il relativo ID. Se lo stato è "RESULT_READY", è possibile visualizzare i risultati. Per visualizzare lo stato corrente di un processo di anteprima, consultate la sezione sul recupero di una sezione del processo di anteprima nella guida alle anteprime e alle stime degli endpoint. Per verificare lo stato corrente di un processo di stima, consultare la sezione sul recupero di un processo di stima nella guida alle anteprime e agli endpoint delle stime.

Passaggi successivi

Dopo aver sviluppato, testato e salvato la definizione del segmento, puoi creare un processo di segmento per creare un pubblico utilizzando l' Segmentation Service API. Per informazioni dettagliate su come valutare e accedere ai risultati del segmento, consulta l’esercitazione.

In questa pagina