Recupero dei metadati dei segmenti

Quando Audience Manager invia informazioni sui segmenti a un partner dati, identifica tali oggetti con ID numerici. In qualità di partner dati, quando condividi queste informazioni con i tuoi clienti (o lavori con te stesso), un nome e una descrizione effettivi forniscono ai clienti una migliore esperienza in report, dashboard o altre interfacce utente (UI). I partner 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 di dati, sei probabilmente abituato a ricevere i metadati del pubblico dai tuoi clienti attraverso processi manuali. Questo potrebbe includere file allegati alle e-mail o dai clienti che aggiungono tali dati tramite un UI creato e mantenuto a questo scopo. Questi processi funzionano, ma spesso sono complicati e richiedono molto tempo e possono richiedere l’inserimento manuale dei dati. Questi metodi sono spesso utilizzati per facilitare l’avvio e l’esecuzione rapida di un’integrazione, ma non offrono la migliore esperienza cliente a lungo termine. In alternativa, puoi utilizzare Audience Manager API per ottenere automaticamente i metadati dei segmenti.

Metodo automatizzato

Audience Manager fornisce un set di API REST che ti consente di recuperare automaticamente i metadati dei segmenti. Con API è possibile creare processi che recuperano i metadati dei segmenti a intervalli pianificati o automaticamente, ogni volta che si elaborano i dati Audience Manager e si trova un nuovo ID segmento. Per ulteriori informazioni, consulta i passaggi seguenti.

Passaggio 1: Controlla le API di Audience Manager

La sezione Guida introduttiva alle API REST contiene informazioni su requisiti generali, autenticazione, metodi disponibili, ecc. Questo è un buon punto di partenza se non hai lavorato con Audience Manager API prima.

Passaggio 2: Richiedere le credenziali di accesso OAuth2

Per effettuare chiamate API è necessario un ID client e un segreto. Durante il processo di configurazione dell’integrazione, puoi ottenere un ID cliente e un segreto dallo specialista dell’integrazione. Puoi anche inviare una richiesta e-mail a Audience Manager Customer Care all’indirizzo amsupport@adobe.com.

Passaggio 3: Raccogliere informazioni specifiche per cliente da ogni cliente integrato

Richiedi quanto segue da ogni cliente integrato:

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

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

Dopo aver completato i passaggi precedenti, puoi utilizzare un metodo GET per recuperare i metadati dei segmenti. Per un esempio di richiesta e risposta, consulta Invio di mappature di destinazione. 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.

Parametro	Descrizione
`destinationMappingId`	ID del segmento Audience Manager.
`elementName`	Nome del segmento.
`elementDescription`	Testo che descrive brevemente il segmento.
`elementStatus`	Lo stato corrente della mappatura del segmento. Le opzioni di stato restituite includono: `active` `inactive` `deleted`