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

In questa pagina