Segmentmetagegevens ophalen retrieving-segment-metadata
Wanneer Audience Manager gesegmenteerde informatie 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 bestanden die zijn toegevoegd via een UI die u voor dit doel hebt gemaakt 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 Audience Manager API gebruiken om automatisch segmentmetagegevens op te halen.
Geautomatiseerde methode automated-method
Audience Manager verstrekt een reeks REST APIs die u segmentmeta-gegevens automatisch laten terugwinnen. Met API, kunt u banen tot stand brengen die segmentmeta-gegevens met geplande intervallen of automatisch terugwinnen, wanneer u Audience Manager gegevens verwerkt en een nieuwe segmentidentiteitskaart vindt. Zie de onderstaande stappen voor meer informatie.
Stap 1: de Audience Manager API's bekijken
Begonnen het worden met REST APIs sectie bevat informatie over algemene vereisten, authentificatie, beschikbare methodes, enz. Dit is een goede plaats om te beginnen als u niet eerder met Audience Manager API hebt gewerkt.
Stap 2: Verzoek OAuth2 toegangsgeloofsbrieven
U hebt een client-id en een geheim nodig om API -aanroepen uit te voeren. Tijdens het integratieproces kunt u een client-id en een geheim opvragen bij uw integratiespecialist. U kunt ook een e-mailaanvraag verzenden naar Audience Manager Customer Care op 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 alleen-lezen toestemmingen voor de bestemming verbonden aan een specifieke integratie heeft.
- Wachtwoord: het gebruikerswachtwoord.
- Bestemming-id: dit is de id (een geheel getal) die is gekoppeld aan het doel dat is gemaakt voor de specifieke server-naar-server integratie.
Stap 4: Segmentmetagegevens ophalen met een API-aanroep
Nadat u de vorige stappen hebt uitgevoerd, kunt u de methode GET gebruiken om de metagegevens van segmenten op te halen. Voor een steekproefverzoek en een reactie, zie Toewijzingen van de Bestemming van de Terugkeer . Deze aanroep retourneert segmentgegevens die zijn opgemaakt als sleutel-waardeparen in een JSON -object. Enkele belangrijke segmentkenmerken die in de reactie worden geretourneerd, worden in de volgende tabel weergegeven.
destinationMappingIdelementNameelementDescriptionelementStatusDe huidige status van de segmenttoewijzing. Tot de statusopties voor geretourneerde meldingen behoren:
activeinactivedeleted