Implementera identitetstjänsten Experience Cloud för Analytics, Audience Manager och Target implement-the-experience-cloud-id-service-for-analytics-audience-manager-and-target

De här instruktionerna gäller för Analytics-, Audience Manager- och Target-kunder som vill använda Experience Cloud Identity Service och som inte använder datainsamlingstaggar. Vi rekommenderar dock att du använder taggar för att implementera ID-tjänsten. Taggar effektiviserar implementeringsarbetsflödet och säkerställer automatiskt korrekt kodplacering och sekvensering.

Steg 1: Planera för vidarebefordran på serversidan section-880797cc992d4755b29cada7b831f1fc

Utöver de steg som beskrivs här bör kunder som använder Analytics och Audience Manager migrera till vidarebefordran på serversidan. Med hjälp av vidarebefordran på serversidan kan du ta bort DIL (Audience Manager data collection code) och ersätta den med Audience Management Module. Mer information finns i vidarebefordringsdokumentationen på serversidan.

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 ut tillsammans. Din implementeringsväg ska följa den här händelsesekvensen:

Steg 2: Hämta ID-tjänstkoden section-0780126cf43e4ad9b6fc5fe17bb3ef86

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

Steg 3: Lägg till funktionen Visitor.getInstance i ID-tjänstkoden section-9e30838b4d0741658a7a492153c49f27

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ägg till funktionskod i Visitor API.js-filen

Placera funktionen 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 section-e2947313492546789b0c3b2fc3e897d8

Ersätt INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE med ditt företags-ID i funktionen Visitor.getInstance. 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", { ...

Steg 5: Lägg till dina spårningsservrar i Visitor.getInstance section-0dfc52096ac2427f86045aab9a0e0dfc

Analytics använder spårningsservrar för datainsamling.

Del 1: Hitta URL:er till spårningsservern

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

Del 2: Ange spårningsservervariabler

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

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 section-5517e94a09bc44dfb492ebca14b43048

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

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

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

(Valfritt, men rekommenderas) Skapa en anpassad prop ​

Ange en anpassad prop i AppMeasurement.js för att mäta täckning. Lägg till den här anpassade proppen i funktionen doPlugins i 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 section-c2bd096a3e484872a72967b6468d3673

Placera VisitorAPI.js-filen i <head> -taggarna på varje sida. När du skickar filen VisitorAPI.js till sidan:

Steg 8: (Valfritt) Konfigurera en respitperiod section-aceacdb7d5794f25ac6ff46f82e148e1

Om något av dessa användningsfall gäller din situation ber du kundtjänst att ställa in en tillfällig 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 respitperiod om du skickar data till ett internt system från en Clickstream-datafeed och som bearbetar använder kolumnerna visid_high och visid_low.

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

Se även Referens för Clickstream-datakolumn.

Steg 9: Testa och verifiera section-f857542bfc70496dbb9f318d6b3ae110

Experience Cloud-lösningarna i den här implementeringen returnerar ID:n i form av nyckelvärdepar. Varje lösning använder olika nycklar (t.ex. SDID:t Analytics 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.

Alla lösningar

Sök efter:

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

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:

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.

Mål

Sök efter:

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

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

Distribution

Steg 10: Distribuera section-4188fa95e7dc455a986b48a6c517c1c9

Distribuera koden när den har testats.

Om du aktiverade en respitperiod: