Implementera Experience Cloud Identity Service för analys

Dessa instruktioner är till för Analytics-kunder som vill använda Experience Cloud Identity Service och inte använder Dynamic Tag Management (DTM). Vi rekommenderar dock starkt att du använder DTM för att implementera ID-tjänsten. DTM effektiviserar implementeringsarbetsflödet och säkerställer automatiskt korrekt kodplacering och sekvensering.

VIKTIGT
  • Läs kraven innan du börjar.
  • Konfigurera och testa koden i en utvecklingsmiljö innan den implementeras i produktionen.

Så här implementerar du ID-tjänsten för Adobe Analytics:

  1. Hämta ID-tjänstkoden
  2. Lägg till funktionen Visitor.getInstance i ID-tjänstkoden
  3. Lägg till ditt organisations-ID för Experience Cloud i Visitor.getInstance
  4. Lägg till dina spårningsservrar i Visitor.getInstance
  5. Uppdatera filen AppMeasurement.js eller s_code.js
  6. Lägg till API-kod för besökare på sidan
  7. (Valfritt) Konfigurera en respitperiod
  8. Testa och distribuera ID-tjänstkod

Steg 1: Hämta ID-tjänstkoden

The ID Service kräver VisitorAPI.js kodbibliotek. Så här hämtar du det här kodbiblioteket:

  1. Gå till Admin > Code Manager.

  2. I Code Managerklickar du på antingen JavaScript (New) eller JavaScript (Legacy).

    Detta hämtar komprimerade kodbibliotek.

  3. Dekomprimera kodfilen och öppna VisitorAPI.js -fil.

Steg 2. Lägg till funktionen Visitor.getInstance i ID-tjänstkoden

VIKTIGT
  • I tidigare versioner av ID-tjänstens API placerades den här funktionen på en annan plats och en annan syntax krävdes. Om du migrerar från en version som är tidigare version 1.4, notera den nya placeringen och syntaxen som beskrivs här.
  • Kod i ALL CAPS är en platshållare för faktiska värden. Ersätt den här texten med ditt företags-ID, URL för spårningsserver eller annat namngivet värde.

Del 1: Kopiera funktionen Visitor.getInstance nedan

var visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION-ID-HERE", {
     trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer
     trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure

     // To enable CNAME support, add the following configuration variables
     // If you are not using CNAME, DO NOT include these variables
     marketingCloudServer: "INSERT-TRACKING-SERVER-HERE",
     marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure
});

Del 2: Lägga till funktionskod i filen VisitorAPI.js

Placera Visitor.getInstance i slutet av filen efter kodblocket. Den redigerade filen ska se ut så här:

/*
========== DO NOT ALTER ANYTHING BELOW THIS LINE ==========
Version and copyright section
*/

// Visitor API code library section

// Put Visitor.getInstance at the end of the file, after the code library

var visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION-ID-HERE", {
     trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer
     trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure

     // To enable CNAME support, add the following configuration variables
     // If you are not using CNAME, DO NOT include these variables
     marketingCloudServer: "INSERT-TRACKING-SERVER-HERE",
     marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure
});

Steg 3: Lägg till ditt organisations-ID för Experience Cloud i Visitor.getInstance

I Visitor.getInstance funktion, ersätt INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE med Experience Cloud organisations-ID. Om du inte känner till ditt organisations-ID kan du hitta det på Experience Cloud administrationssida. Se även Administration - bastjänster. Den redigerade funktionen kan se ut ungefär som i exemplet nedan.

var visitor = Visitor.getInstance("1234567ABC@AdobeOrg", { ...

VIKTIGT

Gör inte ändra skiftläget för tecknen i ditt organisations-ID. ID:t är skiftlägeskänsligt och måste användas exakt som angivet.

Steg 4: Lägg till dina spårningsservrar i Visitor.getInstance

Spårningsservrar används för Analytics datainsamling.

Del 1: Hitta URL:er till spårningsservern

Kontrollera s_code.js eller AppMeasurement.js filer för att hitta spårningsserverns URL:er. Du vill att URL:erna som anges av dessa variabler ska vara:

  • s.trackingServer
  • s.trackingServerSecure

Del 2: Ange spårningsservervariabler

Så här tar du reda på vilka spårningsservervariabler som ska användas:

  1. Besvara frågorna i beslutsmatrisen nedan. Använd de variabler som motsvarar dina svar.
  2. Ersätt platshållarna för spårningsservern med URL:erna för spårningsservern.
  3. Ta bort oanvänd spårningsserver och Experience Cloud servervariabler från koden.

OBSERVERA

Om det används matchar du Experience Cloud server-URL:er till deras motsvarande spårningsserver-URL:er enligt följande:

  • Experience Cloud server-URL = URL för spårningsserver
  • Experience Cloud säker URL för server = spårningsserverns säkra URL

Om du är osäker på hur du hittar spårningsservern kan du läsa Vanliga frågor och Fylla i variablerna trackingServer och trackingServerSecure korrekt.

Steg 5: Uppdatera filen AppMeasurement.js eller s_code.js

Lägg till den här funktionen i AppMeasurement.js eller s_code.js fil:

s.visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE");

Placera koden i samma avsnitt som innehåller konfigurationer som linkInternalFilters, charSet, trackDownloads, osv.

(Valfritt men rekommenderas) Skapa en anpassad egenskap ​

Ange en anpassad svällning i AppMeasurement.js eller s_code.js för att mäta täckningen. Lägg till den här anpassade sviten i doPlugins din AppMeasurement.js eller s_code.js filer:

// prop1 is used as an example only. Choose any available prop.
s.prop1 = (typeof(Visitor) != "undefined" ? "VisitorAPI Present" : "VisitorAPI Missing");

Steg 6: Lägg till API-kod för besökare på sidan

Placera VisitorAPI.js i <head> -taggar på varje sida. När du VisitorAPI.js till din sida:

  • Placera den i början av <head> -avsnittet visas före andra lösningstaggar.
  • Den måste köras före AppMeasurement och koden för andra Experience Cloud lösningar.

Flytta koden till produktion efter testning och verifiering.

Steg 7: (Valfritt) Konfigurera en respitperiod

Om något av dessa fall gäller din situation, fråga Kundtjänst för att konfigurera en temporär respitperiod. Gränsperioder kan vara upp till 180 dagar. Du kan förnya en respitperiod om det behövs.

Partiell implementering

Du behöver en respitperiod om du har sidor som använder ID-tjänsten och vissa sidor som inte gör det, och de alla rapporterar till samma Analytics rapportsvit. Det här är vanligt om du har en global rapportserie som rapporterar över domäner.

Avbryt respitperioden när ID-tjänsten har distribuerats på alla dina webbsidor som rapporterar till samma rapportsvit.

s_vi Cookie-krav

Du behöver en respitperiod om du kräver att nya besökare ska ha en s_vi-cookie efter migrering till ID-tjänsten. Detta är vanligt om implementeringen läser s_vi-cookien och lagrar den i en variabel.

Avbryt respitperioden när implementeringen kan hämta MID i stället för att läsa s_vi-cookien.

Se, Cookies och Experience Cloud Identity Service.

Du behöver en frist om du skickar data till ett internt system från en datafeed i Clickstream och som bearbetar använder visid_high och visid_low kolumner.

Avbryt respitperioden efter att dataöverföringsprocessen kan använda post_visid_high och post_visid_low kolumner.

Se, Referens för Clickstream-datakolumn.

Inmatning av data i Clickstream

Steg 8: Testa och distribuera ID-tjänstkod

Du kan testa och distribuera enligt följande.

Testa och verifiera

Om du vill testa implementeringen av din ID-tjänst ska du kontrollera följande:

Se, Testa och verifiera Experience Cloud Identity Service.

Distribuera kod

Distribuera koden när den har testats.

Om du aktiverat en respitperiod i Steg 7:

  • Se till att Analytics ID (AID) och MID finns i bildbegäran.
  • Kom ihåg att inaktivera fristen när du uppfyller villkoren för att avbryta prenumerationen.

På denna sida