De här instruktionerna är till för Analytics- och Audience Manager-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.
Utöver de steg som beskrivs här bör kunder som använder Analytics och Audience Manager migrera till vidarebefordran på serversidan. Vidarebefordran på serversidan gör att du kan 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 tillsammans. Din implementeringsväg ska följa den här händelsesekvensen:
Arbeta med dina Analytics- och Audience Manager-kontakter för att planera migreringen av din ID-tjänst och vidarebefordran på serversidan. Gör det viktigt att välja en spårningsserver i den här planen.
Fyll i formuläret på integrerings- och provisioneringswebbplatsen för att komma igång.
Implementera ID-tjänsten och Audience Management Module samtidigt. För att fungera på rätt sätt måste Audience Management Module (vidarebefordran på serversidan) och ID-tjänsten frisläppas för samma uppsättning sidor och samtidigt.
ID-tjänsten kräver kodbiblioteket VisitorAPI.js
. Så här hämtar du det här kodbiblioteket:
Gå till Admin > Code Manager.
Klicka antingen på JavaScrpt (New) eller JavaScript (Legacy) i Kodhanteraren. Detta hämtar komprimerade kodbibliotek.
Dekomprimera kodfilen och öppna filen VisitorAPI.js
.
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 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
});
I funktionen Visitor.getInstance
ersätter du 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", { ...
Ändra inte skiftläget för tecknen i ditt organisations-ID. ID:t är skiftlägeskänsligt och måste användas exakt som angivet.
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 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:
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:
Om du är osäker på hur du hittar spårningsservern kan du läsa Vanliga frågor och svar och Fylla i variablerna trackingServer och trackingServerSecure.
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 det avsnitt som innehåller konfigurationer som linkInternalFilters
, charSet
, trackDownloads
osv. :
s.visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE");
Nu bör du ta bort DIL-koden Audience Manager och ersätta den med Audience Management Module. Mer information finns i Implementera vidarebefordran på serversidan.
(Valfritt, men rekommenderas) Skapa ett anpassat utkast
Ange en anpassad prop i AppMeasurement.js
för att mäta täckning. Lägg till den här anpassade proppen i doPlugins
-funktionen för din AppMeasurement.js
-fil:
// prop1 is used as an example only. Choose any available prop.
s.prop1 = (typeof(Visitor) != "undefined" ? "VisitorAPI Present" : "VisitorAPI Missing");
Placera VisitorAPI.js
-filen i <head>
-taggarna på varje sida. När du sparar VisitorAPI.js
-filen på sidan:
<head>
-avsnittet så att den visas före andra lösningstaggar.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.
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:
Information om hur du verifierar vidarebefordran på serversidan finns i Hur du verifierar implementeringen av vidarebefordran på serversidan.
Distribuera
Distribuera koden när den har testats.
Om du aktiverade en respitperiod: