Creazione di un segmento tramite l’API del servizio di segmentazione

Questo documento fornisce un'esercitazione per sviluppare, testare, visualizzare in anteprima e salvare una definizione di segmento utilizzando Adobe Experience Platform Segmentation Service API.

Per informazioni su come creare segmenti utilizzando l'interfaccia utente, consultare la Guida per la generazione di segmenti.

Introduzione

Questa esercitazione richiede una conoscenza approfondita dei vari servizi Adobe Experience Platform 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, consultate la sezione relativa a come leggere chiamate API di esempio nella guida alla risoluzione dei problemi di Experience Platform.

Raccogli valori per le intestazioni richieste

Per effettuare chiamate alle Platform API, è innanzitutto necessario completare l'esercitazione sull'autenticazione a2/>. Completando l'esercitazione sull'autenticazione, vengono forniti i valori per ciascuna delle intestazioni richieste in tutte le chiamate API Experience Platform, 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 verrà eseguita l'operazione:

  • x-sandbox-name: {SANDBOX_NAME}
NOTA

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

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 a Real-time Customer Profile. Per ulteriori informazioni sulla scrittura di query PQL, vedere la Guida PQL.

Puoi creare una nuova definizione di segmento effettuando una richiesta di POST all'endpoint /segment/definitions nell'API Segmentation. 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, leggere la guida per gli sviluppatori di definizione del segmento.

Stima e anteprima di un'audience

Mentre sviluppate la definizione del segmento, potete utilizzare gli strumenti di stima e anteprima all'interno di 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

Potete creare un nuovo processo di anteprima effettuando una richiesta di POST all'endpoint /preview.

Per istruzioni dettagliate sulla creazione di un processo di anteprima, consultate la guida alle anteprime 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'API Segmentation Service, potete cercare lo stato corrente di un processo di anteprima in base al relativo ID. Se lo stato è "RESULT_READY", è possibile visualizzare i risultati. Per verificare lo stato corrente di un processo di anteprima, consultare la sezione relativa al recupero di una sezione del processo di anteprima](…/api/previews-and-estimates.md#get-preview) nella guida anteprime e stime degli endpoint. Per verificare lo stato corrente di un processo stimato, consultare la sezione relativa al recupero di un processo stimato nella guida alle anteprime e alle stime degli endpoint.[

Passaggi successivi

Dopo aver sviluppato, testato e salvato la definizione del segmento, puoi creare un processo di segmento per creare un pubblico utilizzando l'API Segmentation Service. Per informazioni dettagliate su come eseguire questa operazione, vedere l'esercitazione su valutazione e accesso ai risultati del segmento.

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free