Recupero dei metadati dei segmenti retrieving-segment-metadata

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.

Metodo manuale manual-method

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 da clienti che aggiungono tali dati tramite un UI creato e gestito a 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 del segmento.

Metodo automatizzato automated-method

Audience Manager fornisce un set di API REST che consentono di recuperare automaticamente i metadati del segmento. Con API, puoi creare processi che recuperano i metadati del segmento a intervalli pianificati o automaticamente, ogni volta che elabori Audience Manager dati e trovi un nuovo ID segmento. Per ulteriori informazioni, consulta i passaggi seguenti.

Passaggio 1: rivedere le API di Audience Manager

La sezione Guida introduttiva alle API REST contiene informazioni sui requisiti generali, l'autenticazione, i metodi disponibili e così via. Questo è un buon punto di partenza se non hai già lavorato con Audience Manager API.

Passaggio 2: richiesta delle credenziali di accesso OAuth2

Sono necessari 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 all'indirizzo amsupport@adobe.com.

Passaggio 3: raccogliere informazioni specifiche su ciascun cliente integrato

Richiedi quanto segue a ogni cliente integrato:

Passaggio 4: recuperare i metadati dei segmenti con una chiamata API

Dopo aver completato i passaggi precedenti, puoi utilizzare un metodo GET per recuperare i metadati del segmento. Per un esempio di richiesta e risposta, vedi Mappature di destinazione restituite. Questa chiamata restituisce i dati del segmento formattati come coppie chiave-valore in un oggetto JSON. Alcuni degli attributi importanti del segmento restituiti nella risposta sono elencati nella tabella seguente.