Hämtar segmentmetadata retrieving-segment-metadata

När Audience Manager skickar segmentinformation till en datapartner identifieras dessa objekt med numeriska ID:n. När du delar den här informationen med dina kunder (eller arbetar med den själv) är det ett faktiskt namn och en beskrivning som ger en bättre upplevelse för kunderna i rapporter, instrumentpaneler eller andra användargränssnitt (UI). Data partners kan göra dessa egna namn tillgängliga för sina kunder med antingen de manuella eller automatiserade metoder som beskrivs i detta avsnitt.

Manuell metod manual-method

Som datapartent är ni antagligen vana att hämta målgruppsmetadata från era kunder via manuella processer. Detta kan omfatta filer som är kopplade till e-postmeddelanden eller från kunder som lägger till dessa data via en UI som du har skapat och underhållet för detta ändamål. Dessa processer fungerar, men de är ofta krångliga och tidskrävande och kan kräva manuell datainmatning. Dessa metoder används ofta för att snabbt komma igång med en integrering, men de ger inte den bästa kundupplevelsen i längden. Som ett alternativ kan du använda Audience Manager API för att hämta segmentmetadata automatiskt.

Automatiserad metod automated-method

Audience Manager innehåller en uppsättning REST API:er som gör att du kan hämta segmentmetadata automatiskt. Med API kan du skapa jobb som hämtar segmentmetadata med schemalagda intervall eller automatiskt när du bearbetar Audience Manager-data och hittar ett nytt segment-ID. Se stegen nedan för mer information.

Steg 1: Granska API:erna för Audience Manager

Avsnittet Komma igång med REST API:er innehåller information om allmänna krav, autentisering, tillgängliga metoder osv. Det här är en bra plats att börja på om du inte har arbetat med Audience Manager API tidigare.

Steg 2: Begär autentiseringsuppgifter för OAuth2-åtkomst

Du behöver ett klient-ID och en hemlighet för att kunna ringa API. Du kan få ett klient-ID och en hemlighet från din integreringsspecialist under konfigurationsprocessen. Du kan också skicka en e-postförfrågan till Audience Manager Customer Care på amsupport@adobe.com.

Steg 3: Samla in kundspecifik information från varje integrerad kund

Begär följande från varje integrerad kund:

  • Användarnamn: Detta är för en begränsad användare som har skrivskyddad behörighet för målet som är associerat med en viss integrering.
  • Lösenord: Användarlösenordet.
  • Mål-ID: Detta är det ID (ett heltal) som är associerat med målet som skapas för den specifika server-till-server-integreringen.

Steg 4: Hämta segmentmetadata med ett API-anrop

När du har slutfört de föregående stegen kan du använda en GET-metod för att hämta segmentmetadata. Ett exempel på begäran och svar finns i Returmålsmappningar. Det här anropet returnerar segmentdata som är formaterade som nyckelvärdepar i ett JSON-objekt. Vissa viktiga segmentattribut som returneras i svaret visas i följande tabell.

Parameter
Beskrivning
destinationMappingId
Segment-ID:t för Audience Manager.
elementName
Segmentnamnet.
elementDescription
Text som kort beskriver segmentet.
elementStatus

Segmentmappningens aktuella status. Alternativ för returstatus är:

  • active
  • inactive
  • deleted
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695