Hämta segmentmetadata retrieving-segment-metadata

När Audience Manager skickar segmentinformation till en datapartner identifieras dessa objekt med numeriska ID:n. När du som datapartner delar informationen med dina kunder (eller arbetar med den själv) ger ett faktiskt namn och en beskrivning 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 bifogats till e-postmeddelanden eller från kunder som lägger till dessa data via en UI du har byggt 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. Du kan också använda Audience Manager API för att få 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 APIkan du skapa jobb som hämtar segmentmetadata vid schemalagda intervaller eller automatiskt när du bearbetar Audience Manager data och hitta ett nytt segment-ID. Se stegen nedan för mer information.

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

The 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 före.

Steg 2: Begär OAuth2-autentiseringsuppgifter

Du behöver ett klient-ID och en hemlighet för att kunna göra API samtal. Du kan få ett klient-ID och en hemlighet från din integreringsspecialist under konfigurationsprocessen. Du kan även 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 skrivskyddade behörigheter för det mål 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 är klar med föregående steg kan du använda en GET metod för att hämta segmentmetadata. Ett exempel på en begäran och ett svar finns på Returmålsmappningar. Det här anropet returnerar segmentdata som är formaterade som nyckelvärdepar i en JSON -objekt. Vissa viktiga segmentattribut som returneras i svaret visas i följande tabell.

Parameter
Beskrivning
destinationMappingId
The Audience Manager segment-ID.
elementName
Segmentnamnet.
elementDescription
Viss text som kortfattat beskriver segmentet.
elementStatus

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

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