Metadata van segmenten ophalen retrieving-segment-metadata
Wanneer de Audience Manager segmentinformatie naar een gegevenspartner verzendt, identificeert het deze voorwerpen met numerieke IDs. Als gegevenspartner, wanneer u deze informatie met uw klanten (of het werk met het zelf) deelt, verstrekken een daadwerkelijke naam en een beschrijving een betere ervaring voor klanten in rapporten, dashboards, of andere gebruikersinterfaces (UI). De partners van gegevens kunnen deze vriendschappelijke namen ter beschikking stellen aan hun klanten met of de hand of geautomatiseerde methodes die in deze sectie worden beschreven.
Handmatige methode manual-method
Als gegevenspartner, wordt u waarschijnlijk gewend aan het krijgen van publieksmeta-gegevens van uw klanten door handprocessen. Dit kunnen bestanden zijn die zijn gekoppeld aan e-mailberichten of die afkomstig zijn van klanten die deze gegevens via een UI u hebt voor dit doel gebouwd en onderhouden. Deze processen werken, maar zijn vaak omslachtig, tijdrovend, en kunnen handwerk van de gegevensingang vereisen. Deze methodes worden vaak gebruikt om een integratie te helpen snel in werking te stellen, maar zij verstrekken niet de beste klantenervaring op de lange termijn. Als alternatief kunt u de Audience Manager API om automatisch segmentmetagegevens op te halen.
Geautomatiseerde methode automated-method
Audience Manager verstrekt een reeks van REST API's Hiermee kunt u automatisch segmentmetagegevens ophalen. Met de API, kunt u banen creëren die segmentmeta-gegevens met geplande intervallen of automatisch terugwinnen wanneer u verwerkt Audience Manager gegevens en zoek een nieuwe segment-id. Zie de onderstaande stappen voor meer informatie.
Stap 1: De Audience Manager-API's bekijken
De Aan de slag met REST API's Deze sectie bevat informatie over algemene vereisten, authenticatie, beschikbare methoden, enz. Dit is een goede plek om te beginnen als je niet met de Audience Manager API voor.
Stap 2: OAuth2-toegangsreferenties aanvragen
U hebt een client-id en een geheim nodig om API oproepen. Tijdens het integratieproces kunt u een client-id en een geheim opvragen bij uw integratiespecialist. U kunt ook een e-mailverzoek verzenden naar Audience Manager Customer Care om amsupport@adobe.com.
Stap 3: Verzamel klant-specifieke informatie van elke geïntegreerde klant
Vraag het volgende van elke geïntegreerde klant:
- Gebruikersnaam: Dit is voor een beperkte gebruiker die read-only toestemmingen voor de bestemming verbonden aan een specifieke integratie heeft.
- Wachtwoord: Het gebruikerswachtwoord.
- Doel-id: Dit is identiteitskaart (een geheel) verbonden aan de bestemming die voor de specifieke server-aan-server integratie wordt gecreeerd.
Stap 4: Segmentmetagegevens ophalen met een API-aanroep
Nadat u de vorige stappen hebt uitgevoerd, kunt u een GET
methode om segmentmeta-gegevens terug te winnen. Voor een voorbeeldverzoek en een reactie raadpleegt u Toewijzingen retourbestemming. Deze vraag keert segmentgegevens terug die als zeer belangrijk-waardeparen in a worden geformatteerd JSON object. Enkele belangrijke segmentkenmerken die in de reactie worden geretourneerd, worden in de volgende tabel weergegeven.
destinationMappingId
elementName
elementDescription
elementStatus
De huidige status van de segmenttoewijzing. Tot de statusopties voor geretourneerde meldingen behoren:
active
inactive
deleted