Implementeer de dienst Identiteit Experience Cloud voor Analytics implement-the-experience-cloud-id-service-for-analytics
Deze instructies zijn voor klanten Analytics die de Dienst van de Identiteit van het Experience Cloud willen gebruiken en geen markeringen van de Inzameling van Gegevensgebruiken. Nochtans, adviseren wij sterk dat u markeringen gebruikt om de dienst van identiteitskaart uit te voeren. Met labels wordt de implementatieworkflow gestroomlijnd en wordt automatisch de juiste plaatsing van code en de juiste volgorde gegarandeerd.
- leest de vereistenalvorens u begint.
- Vorm en test deze code in een ontwikkelomgeving alvorens het in productie uit te voeren.
Voer de volgende stappen uit om de id-service voor Adobe Analytics te implementeren:
- Download de code van de Dienst van identiteitskaart
- voeg de functie Visitor.getInstance aan de Code van de Dienst van identiteitskaart toe
- voeg uw identiteitskaart van de Organisatie van het Experience Cloud aan Visitor.getInstancetoe
- voeg uw volgende servers aan Visitor.getInstancetoe
- werk uw AppMeasurement.js of s_code.js- dossierbij
- voeg de code van Bezoeker API aan de pagina toe
- (Optioneel) Configureer een respijtperiode
- ID-servicecode testen en implementeren
Stap 1: Download de ID Service-code section-ead9403a6b7e45b887f9ac959ef89f7f
Voor ID Service is de codebibliotheek van VisitorAPI.js
vereist. Deze codebibliotheek downloaden:
-
Ga naar Admin > Code Manager .
-
Klik in Code Manager op JavaScript (New) of JavaScript (Legacy) .
Hiermee worden gecomprimeerde codebibliotheken gedownload.
-
Decomprimeer het codebestand en open het
VisitorAPI.js
-bestand.
Stap 2. Voeg de functie Visitor.getInstance aan de Code van de Dienst van identiteitskaart toe section-6053a6b7c16c466a9f9fdbf9cb9db3df
- Eerdere versies van de id service-API hebben deze functie op een andere locatie geplaatst en een andere syntaxis vereist. Als u van een versie voorafgaand aan versie 1.4migreert, neem nota van de nieuwe die plaatsing en syntaxis hier wordt gedocumenteerd.
- Code in ALL CAPS is een plaatsaanduiding voor werkelijke waarden. Vervang deze tekst door uw organisatie-id, URL van trackingserver of een andere benoemde waarde.
Deel 1: Kopieer hieronder de functie Visitor.getInstance
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
});
Deel 2: Voeg functiecode aan het VisitorAPI.js- dossier toe
Plaats de functie Visitor.getInstance
aan het einde van het bestand na het codeblok. Het bewerkte bestand moet er als volgt uitzien:
/*
========== 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
});
Stap 3: Voeg uw identiteitskaart van de Organisatie van het Experience Cloud aan Visitor.getInstance toe section-7b8a6e76dc124d0e9ab1ce96ab2ffb0e
Vervang INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE
in de functie Experience Cloud door uw organisatie-id. Visitor.getInstance
Als u uw organisatie-id niet kent, vindt u deze op de beheerpagina van Experience Cloud . Zie ook, Beleid - de Diensten van de Kern. De bewerkte functie kan er ongeveer zo uitzien als het onderstaande voorbeeld.
var visitor = Visitor.getInstance("1234567ABC@AdobeOrg", { ...
Stap 4: Voeg uw volgende servers aan Visitor.getInstance toe section-70ec9ebff47940d8ab520be5ec4728c5
Trackingservers worden gebruikt voor Analytics gegevensverzameling.
Deel 1: Vind uw het volgen server URLs
Controleer uw s_code.js
- of AppMeasurement.js
-bestanden om de URL's van de trackingserver te zoeken. U wilt de URL's die door deze variabelen worden opgegeven:
s.trackingServer
s.trackingServerSecure
Deel 2: Plaats volgende servervariabelen
Om te bepalen welke volgende servervariabelen moeten worden gebruikt:
- Beantwoord de vragen in de onderstaande beslissingsmatrix. Gebruik de variabelen die overeenkomen met uw antwoorden.
- Vervang de plaatsaanduidingen van de trackingserver door de URL's van de trackingserver.
- Verwijder ongebruikte trackingserver en Experience Cloud servervariabelen uit de code.
- Experience Cloud server-URL = URL van traceringsserver
- Experience Cloud beveiligde URL van server = beveiligde URL van server bijhouden
Als u niet zeker bent hoe te om uw het volgen server te vinden FAQziet en bevolkt correct de variabelen trackingServer en trackingServerSecure.
Stap 5: Werk uw AppMeasurement.js of s_code.js- dossier bij section-b53113aea1bd4de896e0e4e9a7edee19
Voeg deze functie toe aan uw AppMeasurement.js
- of s_code.js
-bestand:
s.visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE");
Plaats de code in dezelfde sectie die configuraties bevat, zoals linkInternalFilters
, charSet
, trackDownloads
, enz.
(Optioneel maar aanbevolen) Een aangepaste proxy maken
Stel een aangepaste proxy in AppMeasurement.js
of s_code.js
in om de dekking te meten. Voeg deze aangepaste proxy toe aan de functie doPlugins
van uw AppMeasurement.js
- of s_code.js
-bestanden:
// prop1 is used as an example only. Choose any available prop.
s.prop1 = (typeof(Visitor) != "undefined" ? "VisitorAPI Present" : "VisitorAPI Missing");
Stap 6: Bezoeker-API-code toevoegen aan de pagina section-d46d6aa324c842f2931d901e38d6db1d
Plaats het bestand VisitorAPI.js
binnen de tags <head>
op elke pagina. Wanneer u het VisitorAPI.js
-bestand op de pagina plaatst:
- Plaats deze aan het begin van de sectie
<head>
, zodat deze voor andere oplossingstags wordt weergegeven. - Deze moet worden uitgevoerd vóór AppMeasurement en de code voor andere Experience Cloud -oplossingen.
Verplaats deze code naar productie na het testen en controleren.
Stap 7: (Optioneel) Configureer een evaluatieperiode section-7bbb2f72c26e4abeb8881e18366797a3
Als om het even welk van deze gebruiksgevallen op uw situatie van toepassing zijn, vraag 🔗 de Zorg van de Klant om een tijdelijke respijtperiodete vestigen. Respijtperioden kunnen maximaal 180 dagen duren. U kunt een respijtperiode verlengen als dat nodig is.
Gedeeltelijke Implementatie
U hebt een respijtperiode nodig als u sommige pagina's gebruikt die de id-service gebruiken en sommige pagina's dat niet doen, en deze allemaal in dezelfde Analytics -rapportsuite rapporteren. Dit komt vaak voor als u een algemene rapportsuite hebt die rapporten opstelt in verschillende domeinen.
Sluit de respijtperiode af nadat de id-service is geïmplementeerd op al uw webpagina's die in dezelfde rapportsuite rapporteren.
s_vi de Vereisten van het Koekje
U hebt een respijtperiode nodig als u nieuwe bezoekers een s_vi koekje na het migreren aan de dienst van identiteitskaart wilt hebben. Dit is algemeen als uw implementatie het s_vi koekje leest en het in een variabele opslaat.
Sluit de respijtperiode af nadat uw implementatie de MID kan vastleggen in plaats van het s_vi cookie te lezen.
Zie, Cookies en de Dienst van de Identiteit van het Experience Cloud.
U hebt een respijtperiode nodig als u gegevens naar een intern systeem verzendt vanuit een Clickstream-gegevensfeed en die processen de kolommen visid_high
en visid_low
gebruiken.
Sluit de respijtperiode af nadat de kolommen post_visid_high
en post_visid_low
door het gegevensinvoerproces kunnen worden gebruikt.
Zie, {de Verwijzing van de Kolom van Gegevens 0} Clikstream 🔗.
Ingestie van Gegevens Clickstream
Stap 8: Test en implementeer ID-servicecode section-e9c1764ac21a4ec5be1ff338c0e2e01b
U kunt als volgt testen en opstellen.
Test en verifieer
Als u de implementatie van uw id-service wilt testen, controleert u op het volgende:
- het koekje van AMCVin het domein waar uw pagina wordt ontvangen.
- MID waarde in het Analytics beeldverzoek met het debugger hulpmiddel van de Adobe.
Zie, Test en verifieer de Dienst van de Identiteit van het Experience Cloud.
stel code op
Implementeer de code nadat deze voor het testen is geslaagd.
Als u een respijtperiode in Stap 7toeliet:
- Zorg ervoor dat de velden voor Analytics ID (AID) en MID zich in de afbeeldingsaanvraag bevinden.
- Vergeet niet de respijtperiode uit te schakelen wanneer u voldoet aan de criteria voor stopzetting.