Guida introduttiva all’API del servizio di segmentazione getting-started
Adobe Experience Platform Segmentation Service consente di creare tipi di pubblico tramite definizioni di segmenti o altre origini in Adobe Experience Platform dai dati di Real-Time Customer Profile.
La Guida per gli sviluppatori richiede una buona conoscenza dei vari servizi Experience Platform coinvolti nell'utilizzo di Segmentation Service.
- Adobe Experience Platform Segmentation Service: consente di creare tipi di pubblico dai dati di Real-Time Customer Profile.
- Experience Data Model (XDM) System: framework standardizzato tramite il quale Experience Platform organizza i dati sull'esperienza del cliente. Per utilizzare al meglio la segmentazione, assicurati che i dati vengano acquisiti come profili ed eventi in base alle best practice per la modellazione dei dati.
- Real-Time Customer Profile: fornisce un profilo consumer unificato e in tempo reale basato su dati aggregati provenienti da più origini.
- Sandbox: Experience Platform fornisce sandbox virtuali che suddividono una singola istanza di Platform in ambienti virtuali separati, utili per le attività di sviluppo e aggiornamento delle applicazioni di esperienza digitale.
Le sezioni seguenti forniscono informazioni aggiuntive che è necessario conoscere per utilizzare correttamente l'API Segmentation.
Lettura delle chiamate API di esempio
La documentazione API Segmentation Service 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 codice JSON di esempio restituito nelle risposte API. Per informazioni sulle convenzioni utilizzate nella documentazione per le chiamate API di esempio, consulta la sezione su come leggere chiamate API di esempio nella guida alla risoluzione dei problemi di Experience Platform.
Intestazioni richieste
La documentazione API richiede inoltre di aver completato l'esercitazione sull'autenticazione per effettuare correttamente le chiamate agli endpoint Platform. Il completamento del tutorial di autenticazione fornisce i valori per ciascuna delle intestazioni richieste nelle chiamate API Experience Platform, come illustrato di seguito:
- Autorizzazione:
Bearer {ACCESS_TOKEN} - x-api-key:
{API_KEY} - x-gw-ims-org-id:
{ORG_ID}
Tutte le risorse in Experience Platform sono isolate in specifiche sandbox virtuali. Tutte le richieste alle API Platform richiedono un'intestazione che specifichi il nome della sandbox in cui verrà eseguita l'operazione:
- x-sandbox-name:
{SANDBOX_NAME}
Passaggi successivi
Per effettuare chiamate tramite l'API Segmentation Service, seleziona una delle guide degli endpoint disponibili utilizzando la barra di navigazione a sinistra o nella panoramica della guida per sviluppatori