Implementera Experience Cloud Identity Service för analys implement-the-experience-cloud-id-service-for-analytics
De här instruktionerna är till för Analytics-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.
- 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:
- Hämta ID-tjänstkoden
- Lägg till funktionen Visitor.getInstance i ID-tjänstkoden
- Lägg till ditt organisations-ID för Experience Cloud i Visitor.getInstance
- Lägg till dina spårningsservrar i Visitor.getInstance
- Uppdatera filen AppMeasurement.js eller s_code.js
- Lägg till API-kod för besökare på sidan
- (Valfritt) Konfigurera en respitperiod
- Testa och distribuera ID-tjänstkod
Steg 1: Hämta ID-tjänstkoden section-ead9403a6b7e45b887f9ac959ef89f7f
ID Service kräver kodbiblioteket VisitorAPI.js
. Så här hämtar du det här kodbiblioteket:
-
Gå till Admin > Code Manager.
-
I Code Manager klickar du antingen på JavaScript (New) eller JavaScript (Legacy).
Detta hämtar komprimerade kodbibliotek.
-
Dekomprimera kodfilen och öppna filen
VisitorAPI.js
.
Steg 2. Lägg till funktionen Visitor.getInstance i ID-tjänstkoden section-6053a6b7c16c466a9f9fdbf9cb9db3df
- 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 äldre än version 1.4 bör du 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ägg till funktionskod i filen VisitorAPI.js
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 3: Lägg till ditt organisations-ID för Experience Cloud i Visitor.getInstance section-7b8a6e76dc124d0e9ab1ce96ab2ffb0e
Ersätt INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE
med ditt Experience Cloud-organisations-ID i funktionen Visitor.getInstance
. Om du inte känner till ditt organisations-ID kan du hitta det på administrationssidan för Experience Cloud. Se även Administration - bastjänster. Den redigerade funktionen kan se ut ungefär som i exemplet nedan.
var visitor = Visitor.getInstance("1234567ABC@AdobeOrg", { ...
Steg 4: Lägg till dina spårningsservrar i Visitor.getInstance section-70ec9ebff47940d8ab520be5ec4728c5
Spårningsservrar används för datainsamling Analytics.
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:
s.trackingServer
s.trackingServerSecure
Del 2: Ange spårningsservervariabler
Så här tar du reda på vilka spårningsservervariabler som ska användas:
- Besvara frågorna i beslutsmatrisen nedan. Använd de variabler som motsvarar dina svar.
- Ersätt platshållarna för spårningsservern med URL:erna för spårningsservern.
- Ta bort oanvända spårningsservrar och Experience Cloud servervariabler från koden.
- Experience Cloud server-URL = URL för spårningsserver
- Skyddad 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 5: Uppdatera filen AppMeasurement.js eller s_code.js section-b53113aea1bd4de896e0e4e9a7edee19
Lägg till den här funktionen i din 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 prop i AppMeasurement.js
eller s_code.js
för att mäta täckning. Lägg till den här anpassade proppen i funktionen doPlugins
för dina 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 section-d46d6aa324c842f2931d901e38d6db1d
Placera VisitorAPI.js
-filen i <head>
-taggarna på varje sida. När du skickar filen VisitorAPI.js
till sidan:
- Placera det i början av avsnittet
<head>
så att det visas före andra lösningstaggar. - Den måste köras före AppMeasurementet och koden för andra Experience Cloud-lösningar.
Flytta koden till produktion efter testning och verifiering.
Steg 7: (Valfritt) Konfigurera en respitperiod section-7bbb2f72c26e4abeb8881e18366797a3
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 Cookies och Experience Cloud Identity Service.
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
.
Mer information finns i Referens för Clickstream-datakolumn.
Inmatning av data i Clickstream
Steg 8: Testa och distribuera ID-tjänstkoden section-e9c1764ac21a4ec5be1ff338c0e2e01b
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:
- AMCV-cookie i domänen där sidan finns.
- MID-värde i bildbegäran Analytics med felsökningsverktyget Adobe.
Se Testa och verifiera identitetstjänsten Experience Cloud.
Distribuera kod
Distribuera koden när den har testats.
Om du aktiverade en respitperiod i steg 7:
- Kontrollera 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.