Implementera identitetstjänsten Experience Cloud för Analytics, Audience Manager och Target

Senaste uppdatering: 2023-04-27
  • Skapat för:
  • Developer
    User
    Admin
    Leader

De här instruktionerna är till för Analytics-, Audience Manager- och Target-kunder som vill använda Experience Cloud Identity Service och som 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 ID-tjänsten krav innan du börjar och noterar följande krav som är specifika för den här implementeringen:

  • Kunder som använder s_code kan inte slutföra den här proceduren. Uppgradera till mbox-kod v61 för att slutföra den här proceduren.
  • Konfigurera och testa koden i en utvecklingsmiljö före implementera i produktionen.

Steg 1: Planera för vidarebefordran på serversidan

Förutom de steg som beskrivs här, använder kunder som Analytics och Audience Manager bör migrera till vidarebefordran på serversidan. Med vidarebefordran på serversidan kan du ta bort DIL (Audience Manager datainsamlingskod) och ersätta den med Audience Management Module. Se vidarebefordringsdokumentation på serversidan för mer information.

Migrering till vidarebefordran på serversidan kräver planering och samordning. Den här processen innebär externa ändringar av webbplatskoden och interna åtgärder som Adobe måste vidta för att etablera ditt konto. Många av dessa migreringsprocedurer måste faktiskt ske parallellt och släppas tillsammans. Din implementeringsväg ska följa den här händelsesekvensen:

  1. Arbeta med dina Analytics och Audience Manager kontakter för att planera din ID-tjänst och migrering på serversidan. Gör det viktigt att välja en spårningsserver i den här planen.

  2. Fyll i formuläret på integrations- och provisioneringswebbplats för att komma igång.

  3. Implementera ID-tjänsten och Audience Management Module samtidigt. För att fungera som det ska Audience Management Module (vidarebefordran på serversidan) och ID-tjänsten måste släppas för samma uppsättning sidor samtidigt.

Steg 2: Hämta ID-tjänstkoden

ID-tjänsten kräver VisitorAPI.js kodbibliotek. Så här hämtar du det här kodbiblioteket:

  1. Gå till Admin > Code Manager.

  2. I Kodhanteraren klickar du på antingen JavaScrpt (New) eller JavaScript (Legacy). Detta hämtar komprimerade kodbibliotek.

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

Steg 3: 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 Visitor API.js-filen

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 4: 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 ditt företags-ID för Experience Cloud. Om du inte känner till ditt organisations-ID kan du hitta det på administrationssidan för Experience Cloud. 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 5: Lägg till dina spårningsservrar i Visitor.getInstance

Analytics använder spårningsservrar för 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ända spårningsserver- och Experience Cloud-servervariabler från koden.

OBSERVERA

Om det används matchar du URL:erna för Experience Cloud-servern med deras motsvarande URL:er för spårningsservern så här:

  • URL för Experience Cloud-server = URL för spårningsserver
  • Säker URL för Experience Cloud-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 6: Uppdatera filen AppMeasurement.js

Det här steget kräver AppMeasurement. Du kan inte fortsätta om du fortfarande använder s_code.

Lägg till Visitor.getInstance funktionen som visas nedan för AppMeasurement.js -fil. Placera den i det avsnitt som innehåller konfigurationer som linkInternalFilters, charSet, trackDownloads, osv. :

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

VIKTIGT

Nu bör du ta bort Audience Manager Koda DIL och ersätt den med Audience Management Module. Se Implementera vidarebefordran på serversidan för instruktioner.

(Valfritt, men rekommenderas) Skapa en anpassad propp ​

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

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

Steg 7: 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.

Steg 8: (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-rapportserie. 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 även Cookies och Experience Cloud Identity Service.

Integrering av Clickstream-data

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 även Referens för Clickstream-datakolumn.

Steg 9: Testa och verifiera

The Experience Cloud lösningar i den här implementeringen returnerar ID:n i form av nyckelvärdepar. Varje lösning använder olika nycklar (t.ex. Analytics SDID jämfört med Target mboxMCSDID) för samma ID. Om du vill testa implementeringen läser du in sidorna i en utvecklingsmiljö. Använd webbläsarkonsolen eller programvara som övervakar HTTP-begäranden och svar för att kontrollera ID:n som anges nedan. ID-tjänsten har implementerats korrekt när nyckelvärdepar som anges nedan returnerar samma ID-värden.

TIPS

Du kan använda Felsökning för Adobe eller Charles HTTP-proxy om du vill söka efter dessa lösningsspecifika ID:n. Du bör dock kunna använda det verktyg eller den felsökare som passar dig bäst.

Alla lösningar

Sök efter:

  • AMCV cookie i domänen där sidan finns.
  • Experience Cloud ID (MID) med Adobe felsökningsprogram eller det felsökningsverktyg du föredrar.

Ytterligare kontroller som hjälper dig att avgöra om ID-tjänsten fungerar som den ska finns i Testa och verifiera Experience Cloud Identity Service.

Analytics

Sök efter SDID-identifieraren i JavaScript-begäran. Analytics SDID ska matcha Target mboxMCSDID.

Om testerna returnerar ett ID, innebär det något av följande:

  • Du är en återkommande besökare som håller på att migrera äldre Analytics ID:n.
  • Du har en respitperiod aktiverat.

När du ser ett AID kontrollerar du dess värde mot Target mboxMCAVID. Dessa värden är identiska när ID-tjänsten har implementerats korrekt.

Audience Manager

Information om hur du testar vidarebefordran på serversidan finns i Så här verifierar du implementeringen av vidarebefordring på serversidan.

Target

Sök efter:

  • mboxMCGVID
  • mboxMCSDID (mboxMCSDID ska matcha Analytics SDID.)

Om dina tester returnerar ett mboxMCAVID, visar det något av följande:

  • Du är en återkommande besökare som håller på att migrera äldre Analytics ID:n.
  • Du har aktiverat en respitperiod.

När du ser ett mboxMCAVID kontrollerar du dess värde mot Analytics STÖD. Dessa värden är identiska när ID-tjänsten har implementerats korrekt.

Distribution

Steg 10: Distribuera

Distribuera koden när den har testats.

Om du aktiverade en respitperiod:

  • Kontrollera att Analytics ID (AID) och MID finns i bildbegäran.
  • Kom ihåg att inaktivera respitperioden när du har uppfyllt kriterier för upphörande.

På denna sida