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 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 automated-method

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
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695