Quando Audience Manager invia informazioni sui segmenti a un partner dati, identifica questi oggetti con ID numerici. In qualità di partner dati, quando condividi queste informazioni con i clienti (o lavori con essi personalmente), un nome e una descrizione effettivi offrono ai clienti un’esperienza migliore nei rapporti, nelle dashboard o in altre interfacce utente (UI). I partner di dati possono rendere questi nomi descrittivi disponibili ai propri clienti con i metodi manuali o automatizzati descritti in questa sezione.
In qualità di partner dati, probabilmente sei abituato a ottenere metadati di pubblico dai clienti attraverso processi manuali. Potrebbe includere file allegati alle e-mail o provenienti da clienti che aggiungono tali dati tramite una UI hai creato e gestito per questo scopo. Questi processi funzionano, ma sono spesso complicati, richiedono tempo e possono richiedere l'immissione manuale dei dati. Questi metodi vengono spesso utilizzati per rendere operativa rapidamente un’integrazione, ma non forniscono la migliore esperienza del cliente nel lungo periodo. In alternativa, è possibile utilizzare Audience Manager API per ottenere automaticamente i metadati dei segmenti.
Audience Manager fornisce una serie di API REST che ti consente di recuperare automaticamente i metadati del segmento. Con il API, è possibile creare processi che recuperano i metadati del segmento a intervalli pianificati o automaticamente, ogni volta che si elabora Audience Manager e trova un nuovo ID segmento. Per ulteriori informazioni, consulta i passaggi seguenti.
Il Guida introduttiva alle API REST Questa sezione contiene informazioni su requisiti generali, autenticazione, metodi disponibili e così via. Questo è un buon punto di partenza se non hai lavorato con il Audience Manager API prima.
È necessario un ID client e un segreto per effettuare API chiamate. Puoi ottenere un ID client e un segreto dallo specialista dell’integrazione durante il processo di configurazione dell’integrazione. Puoi anche inviare una richiesta e-mail a Audience Manager Customer Care a amsupport@adobe.com.
Richiedi quanto segue a ogni cliente integrato:
Dopo aver completato i passaggi precedenti, puoi utilizzare un’ GET
per recuperare i metadati del segmento. Per un esempio di richiesta e risposta, consulta Restituisci mappature destinazione. Questa chiamata restituisce dati del segmento formattati come coppie chiave-valore in una JSON oggetto. Alcuni degli attributi importanti del segmento restituiti nella risposta sono elencati nella tabella seguente.
Parametro | Descrizione |
---|---|
|
Il Audience Manager ID segmento. |
|
Il nome del segmento. |
|
Testo che descrive brevemente il segmento. |
|
Lo stato corrente del mapping dei segmenti. Le opzioni di stato restituite includono:
|