Recupero dei metadati dei segmenti

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

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.

Metodo automatizzato

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.

Passaggio 1: rivedere le API di Audience Manager

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.

Passaggio 2: richiesta delle credenziali di accesso OAuth2

È 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.

Passaggio 3: raccogliere informazioni specifiche su ciascun cliente integrato

Richiedi quanto segue a ogni cliente integrato:

Nome utente: si tratta di un utente con restrizioni che dispone di autorizzazioni di sola lettura per la destinazione associata a una specifica integrazione.
Password: password utente.
ID destinazione: questo è l’ID (un numero intero) associato alla destinazione creata per l’integrazione server-to-server specifica.

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

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
`destinationMappingId`	Il Audience Manager ID segmento.
`elementName`	Il nome del segmento.
`elementDescription`	Testo che descrive brevemente il segmento.
`elementStatus`	Lo stato corrente del mapping dei segmenti. Le opzioni di stato restituite includono: `active` `inactive` `deleted`