Hämta användar-ID:n och regioner via Adobe Experience Platform identitetstjänst

Senast uppdaterad: 20 juli 2024

ID-tjänstkunder bör läsa det här avsnittet för information om hur du läser besökarens cookie för de ID:n som krävs för att göra DCS API-anrop.

Adobe Experience Platform identitetstjänst tilldelar besökar- och region-ID till användare som kommer till din webbplats. Dessa ID:n identifierar användare i alla lösningar i Experience Cloud och de krävs om du vill ringa DCS-samtal.

  • user ID krävs för att identifiera och associera data med en viss besökare.
  • region ID krävs eftersom det är kopplat till ett regionalt servernamn som du måste skicka data till DCS. DCS lagrar information i datacenter som är geografiskt närmast webbplatsbesökarna. Se ID:n för DCS-region, platser och värdnamn.

ID-tjänstkunder kan extrahera den här informationen från ID-tjänstens cookie eller genom att anropa en funktion. Tabellen nedan beskriver de uppgifter och steg som du behöver utföra för att komma igång.

Kod i kursiv representerar en variabelplatshållare.

UppgiftBeskrivning
1. Kontrollera din Experience Cloud-status

Du behöver ett Experience Cloud-konto för att använda ID-tjänsten. Om du har ett Experience Cloud-konto, bra!

Registrera dig om du inte är en del av Experience Cloud. Vi vill gärna ha dig och det finns alltid plats för mer. Instruktioner om hur du konfigurerar ett konto finns i Aktivera dina lösningar för bastjänster.

2. Konfigurera ID-tjänstenID-tjänsten består av JavaScript-kod som placeras på varje sida som du vill använda för datainsamling. Mer information finns i implementeringsguiderna för ID-tjänsten .
3. Läs ID-tjänsten cookie

-ID-tjänsten lagrar användar-ID och region-ID i AMCV-cookien. Det fullständiga cookie-namnet är AMCV_###@AdobeOrg. Elementen ### är platshållare för ditt företags-ID. Mer information finns i Cookies och Experience Cloud ID.

Tolka AMCV-cookien för följande nyckelvärdepar:

  • mid=user ID: Detta nyckelvärdepar innehåller användar-ID:t Experience Cloud .
  • aamlh=region ID: Detta nyckelvärdepar innehåller region-ID:t (kallas ibland platstips ) som är associerat med ett regionalt servernamn.

Du kan ringa till DCS när du har användar-ID:n och region-ID:n.

4. Hämta Experience Cloud ID med getMarketingCloudVisitorID

(Valfritt) Den här funktionen returnerar besökar-ID:t Experience Cloud . Den är utformad för anpassade lösningar och specifika användningsfall. Se Arbeta med getMarketingCloudVisitorIDnedan och den relaterade ID-tjänstdokumentationen.

Du behöver inte använda detta om du hämtar användar-ID:n och plats-ID:n från ID-tjänstens cookie.

Arbetar med getMarketingCloudVisitorID

Ett annat sätt att hämta besökar-ID är med funktionen getMarketingCloudVisitorID. När funktionen anropas frågar den om ID service och returnerar ett ID. getMarketingCloudVisitorID accepterar det valfria callback-argumentet som det visas:

var analyticsID = visitor.getAnalyticsVisitorID(callback)

Användning och syfte av återanrop

callback är valfritt. Den här funktionen fungerar utan den, men returnerar bara ett ID när en besökare har en Experience Cloud-cookie i sin webbläsare. Om besökarens cookie saknas, eller om en besökare inte har något ID, returnerar funktionen ett tomt ()-objekt. Detta kan inträffa även efter att sidan har lästs in och besökaren får ett nytt ID. För att undvika detta tvingar callback den här funktionen att söka efter ett besökar-ID när sidan har lästs in. Utan callback returnerar inte besökar-ID-funktionen ett ID, även om det skrivs till besökarens webbläsare senare.

Nästa steg

När du har användar-ID och region-ID kan du börja skicka och ta emot DCS-data. Se Göra DCS API-anrop.

Föregående sida
Nästa sida

Audience Manager