Gebruikersnaam en regio's ophalen via de Adobe Experience Platform Identity Service get-user-ids-and-regions-through-the-experience-cloud-id-service
Gebruikers van id-services moeten naar deze sectie verwijzen voor informatie over het lezen van het bezoekerscookie voor de id's die nodig zijn om DCS API-aanroepen uit te voeren.
De gebruikersnaam ophalen van de ID Service Cookie get-user-ids-from-service-cookie
De Dienst van de Identiteit van Adobe Experience Platform wijst bezoeker en gebied IDs aan gebruikers toe die naar uw website komen. Deze id's identificeren gebruikers op alle oplossingen in de Experience Cloud en zijn vereist als u DCS -aanroepen wilt uitvoeren.
- user ID is vereist om gegevens aan een bepaalde bezoeker te identificeren en te koppelen.
- region ID is vereist omdat het is gekoppeld aan een regionale servernaam, die u gegevens naar DCS moet verzenden. In DCS wordt informatie opgeslagen in datacenters die zich geografisch het dichtst bij sitebezoekers bevinden. Zie DCS Gebied IDs, Locaties, en de Namen van de Gastheer .
De de dienstklanten van identiteitskaart kunnen deze informatie uit het de dienstkoekje van identiteitskaart halen of door een functie te roepen. In de onderstaande tabel worden de taken of stappen beschreven die u moet uitvoeren om aan de slag te gaan.
De code in cursief vertegenwoordigt veranderlijke placeholder.
U hebt een Experience Cloud rekening nodig om de dienst van identiteitskaart te gebruiken. Als u een Experience Cloud -account hebt, geweldig!
Als u geen deel van Experience Cloud uitmaakt, dan onderteken omhoog. We zouden je graag hebben en er is altijd ruimte voor meer. Voor instructies op hoe te opstelling een rekening, zie Toelatend Uw oplossingen voor de kerndiensten.
De dienst van identiteitskaart slaat de gebruiker en gebiedsidentiteitskaart in het koekje AMCV op. De volledige naam van de cookie is AMCV_###@AdobeOrg . De ### -elementen zijn plaatsaanduidingen voor uw organisatie-id. Zie Koekjes en identiteitskaart van Experience Cloudvoor details.
Parseer het cookie van AMCV voor deze sleutelwaardeparen:
mid=user ID: Dit sleutel-waarde paar houdt Experience Cloud gebruiker - identiteitskaartaamlh=region ID: Dit zeer belangrijk-waardepaar houdt gebiedsidentiteitskaart (soms genoemd een plaatshint ) die met een regionale servernaam wordt geassocieerd.
U kunt vraag aan DCS maken zodra u gebruiker en gebied IDs hebt.
(Facultatief) Deze functie keert Experience Cloud bezoeker identiteitskaart terug Het is ontworpen voor aangepaste oplossingen en specifieke gebruiksgevallen. Zie Werken met getMarketingCloudVisitorIDhieronder en de verwante de dienstdocumentatie van identiteitskaart.
U hoeft dit niet te gebruiken als u de gebruikers- en locatie-id's uit het cookie van de ID-service ontvangt.
Werken met getMarketingCloudVisitorID working-with-getmarketingcloudvisitorid
Een andere manier om de bezoekersidentiteitskaart te krijgen is met de getMarketingCloudVisitorID functie. Wanneer deze functie wordt aangeroepen, wordt de ID service opgevraagd en wordt een id geretourneerd. getMarketingCloudVisitorID accepteert het optionele argument callback zoals getoond:
var analyticsID = visitor.getAnalyticsVisitorID(callback)
Callback-gebruik en doel callback-usage
callback is optioneel. Deze functie werkt zonder deze, maar retourneert alleen een id wanneer een bezoeker een Experience Cloud cookie in zijn browser heeft. Als het bezoekerscookie ontbreekt of een bezoeker geen id heeft, retourneert de functie een leeg () -object. Dit kan zelfs gebeuren nadat de pagina is geladen en de bezoeker een nieuwe id ontvangt. Om dit te voorkomen, dwingt callback deze functie om op een bezoekersidentiteitskaart te controleren nadat de pagina laadt. Zonder callback retourneert de functie met de bezoeker-id geen id, zelfs niet als deze later naar de browser van de bezoeker is geschreven.
Volgende stappen next-steps
Zodra u de gebruikers- en regio-id hebt, kunt u beginnen met het verzenden en ontvangen van DCS -gegevens. Zie het Maken van vraag DCS API .