Gebruikers-id’s en -regio’s ontvangen via de Adobe Experience Platform Identity Service

Laatst bijgewerkt: 20 mei 2023
  • Onderwerpen:
  • DCS

Klanten 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.

De Adobe Experience Platform Identity Service Hiermee worden gebruikers die naar uw website komen, toegewezen aan gebruikers van de gebruikers en regio-id's. Deze id's identificeren gebruikers op alle oplossingen in de Experience Cloud en zijn vereist als u wilt maken DCS oproepen.

  • De user ID is vereist om gegevens te identificeren en aan een bepaalde bezoeker te koppelen.
  • De region ID is vereist omdat deze gekoppeld is aan een regionale servernaam die u gegevens naar de DCS. De DCS slaat informatie in gegevenscentra op die geografisch dichtst bij bezoekers van de plaats zijn. Zie Id's, locaties en hostnamen van DCS-regio's.

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.

Code in cursief vertegenwoordigt een variabele placeholder.

TaakBeschrijving
1. Controleer uw Experience Cloud status

U hebt een Experience Cloud account voor gebruik van de ID-service. Als u een Experience Cloud account, geweldig!

Als u geen deel uitmaakt van de Experience Clouden meld u vervolgens aan. We zouden je graag hebben en er is altijd ruimte voor meer. Voor instructies over het instellen van een account raadpleegt u Uw oplossingen inschakelen voor kernservices.

2. Stel de ID-serviceDe ID-service bestaat uit JavaScript-code die wordt geplaatst op elke pagina die u wilt gebruiken voor gegevensverzameling. Zie de id-service implementatiehulplijnen voor meer informatie .
3. Lees de ID-service koekje

De ID-service slaat de gebruikers- en regio-id op in het AMCV-cookie. De volledige naam van de cookie is AMCV_###@AdobeOrg. De ### elementen zijn plaatsaanduidingen voor uw organisatie-id. Zie Cookies en de Experience Cloud-id voor meer informatie.

Parseer het cookie van AMCV voor deze sleutelwaardeparen:

  • mid=user ID: Dit sleutelwaardepaar houdt het Experience Cloud gebruikersnaam.
  • aamlh=region ID: Dit sleutelwaardepaar houdt gebiedsidentiteitskaart (soms genoemd locatiehint) die is gekoppeld aan een regionale servernaam.

U kunt oproepen aan DCS als u de gebruikers- en regio-id's hebt.

4. De Experience Cloud-id met getMarketingCloudVisitorID

(Optioneel) Deze functie retourneert de Experience Cloud bezoeker-id. Het is ontworpen voor aangepaste oplossingen en specifieke gebruiksgevallen. Zie Werken met getMarketingCloudVisitorID en de gerelateerde documentatie over id-services.

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

Een andere manier om de bezoekersidentiteitskaart te krijgen is met getMarketingCloudVisitorID functie. Wanneer deze functie wordt aangeroepen, wordt de ID service en retourneert een id. getMarketingCloudVisitorID accepteert de optionele callback argument zoals getoond:

var analyticsID = visitor.getAnalyticsVisitorID(callback)

Callback-gebruik en doel

callback is optioneel. Deze functie werkt zonder deze, maar retourneert alleen een id wanneer een bezoeker een Experience Cloud cookie in hun browser. Als het bezoekerscookie ontbreekt of als een bezoeker geen id heeft, retourneert de functie een leeg cookie () object. Dit kan zelfs gebeuren nadat de pagina is geladen en de bezoeker een nieuwe id ontvangt. Om dit te voorkomen, callback forceert 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

Zodra u de gebruikers- en regio-id hebt, kunt u beginnen met verzenden en ontvangen DCS gegevens. Zie DCS API-aanroepen maken.

Vorige pagina
Volgende pagina

Audience Manager