Voer de Dienst van de Identiteit van het Experience Cloud voor Analytics, Audience Manager, en Doel uit implement-the-experience-cloud-id-service-for-analytics-audience-manager-and-target
Deze instructies zijn voor Analytics, Audience Manager, en de klanten van het Doel die de Dienst van de Identiteit van het Experience Cloud willen gebruiken en niet gebruiken Labels voor gegevensverzameling. 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.
- Klanten die s_code gebruiken kunnen deze procedure niet voltooien. Voer een upgrade uit naar mbox-code v61 om deze procedure te voltooien.
- Deze code configureren en testen in een ontwikkelomgeving voor die u in productie toepast.
Stap 1: Plan voor server-zij door:sturen section-880797cc992d4755b29cada7b831f1fc
Naast de hier beschreven stappen, klanten die Analytics en Audience Manager zou aan server-kant door:sturen moeten migreren. Door:sturen aan de serverzijde kunt u DIL (de code van de de gegevensinzameling van de Audience Manager) verwijderen en het vervangen met Module voor publieksbeheer. Zie de server-kant het door:sturen documentatie voor meer informatie .
Het migreren aan server-zij door:sturen vereist planning en coördinatie. Dit proces omvat externe wijzigingen in uw sitecode en interne stappen die Adobe moet uitvoeren om uw account te kunnen aanbieden. Veel van deze migratieprocedures moeten parallel lopen en samen worden vrijgegeven. Het implementatiepad moet deze reeks gebeurtenissen volgen:
-
Werk met uw Analytics en Audience Manager contacten om uw dienst van identiteitskaart en server-kant het door:sturen migratie te plannen. Maak het selecteren van een volgende server een belangrijk deel van dit plan.
-
Vul het formulier in op het tabblad integratie- en inrichtingssite aan de slag.
-
Voer de dienst van identiteitskaart en uit Audience Management Module tegelijkertijd. Om goed te werken, Audience Management Module (server-kant door:sturen) en de dienst van identiteitskaart moet voor de zelfde reeks pagina's en tezelfdertijd worden vrijgegeven.
Stap 2: Download de ID Service-code section-0780126cf43e4ad9b6fc5fe17bb3ef86
De id-service vereist de VisitorAPI.js
codebibliotheek. Deze codebibliotheek downloaden:
-
Ga naar Admin > Code Manager.
-
Klik in Codebeheer op JavaScrpt (New) of JavaScript (Legacy). Hiermee worden gecomprimeerde codebibliotheken gedownload.
-
Het codebestand decomprimeren en het dialoogvenster
VisitorAPI.js
bestand.
Stap 3: Voeg de functie Visitor.getInstance aan de code van de Dienst van identiteitskaart toe section-9e30838b4d0741658a7a492153c49f27
- Eerdere versies van de id service-API hebben deze functie op een andere locatie geplaatst en een andere syntaxis vereist. Als u migreert op basis van een eerdere versie dan versie 1.4, let op de nieuwe plaatsing en syntaxis die 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 de functie Visitor.getInstance hieronder
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: Functiecode toevoegen aan het bestand Visitor API.js
Plaats de 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 4: Voeg uw identiteitskaart van de Organisatie van het Experience Cloud aan Visitor.getInstance toe section-e2947313492546789b0c3b2fc3e897d8
In de Visitor.getInstance
functie, vervangen INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE
met uw organisatie-id van het Experience Cloud. Als u uw organisatie-id niet kent, kunt u deze vinden op de pagina voor het beheer van Experiencen Cloud. De bewerkte functie kan er ongeveer zo uitzien als het onderstaande voorbeeld.
var visitor = Visitor.getInstance("1234567ABC@AdobeOrg", { ...
Stap 5: Voeg uw volgende servers aan Visitor.getInstance toe section-0dfc52096ac2427f86045aab9a0e0dfc
Analytics gebruikt trackingservers voor gegevensverzameling.
Deel 1: Zoeken naar URL's van uw trackingserver
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: Set tracking server variables
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 het volgen server en de servervariabelen van het Experience Cloud uit de code.
- Experience Cloud-server-URL = URL van trackingserver
- Beveiligde URL van server voor Experience Cloud = beveiligde URL van server bijhouden
Als u niet zeker bent hoe te om uw het volgen server te vinden zie Veelgestelde vragen en De variabelen trackingServer en trackingServerSecure correct vullen.
Stap 6: Werk uw AppMeasurement.js- dossier bij section-5517e94a09bc44dfb492ebca14b43048
Deze stap vereist AppMeasurement. U kunt niet doorgaan als u nog steeds s_code gebruikt.
Voeg de Visitor.getInstance
hieronder weergegeven functie AppMeasurement.js
bestand. Plaats het in de sectie die configuraties zoals bevat linkInternalFilters
, charSet
, trackDownloads
, enz. :
s.visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE");
(Optioneel, maar aanbevolen) Een aangepaste proxy maken
Aangepaste proxy instellen in AppMeasurement.js
om de dekking te meten. Deze aangepaste proxy toevoegen aan de doPlugins
functie van uw AppMeasurement.js
bestand:
// prop1 is used as an example only. Choose any available prop.
s.prop1 = (typeof(Visitor) != "undefined" ? "VisitorAPI Present" : "VisitorAPI Missing");
Stap 7: Voeg de API-code van de bezoeker toe aan de pagina section-c2bd096a3e484872a72967b6468d3673
Plaats de VisitorAPI.js
bestand in het <head>
-tags op elke pagina. Wanneer u VisitorAPI.js
bestand naar uw pagina:
- Zet het aan het begin van
<head>
voor andere oplossingstags. - Het moet vóór AppMeasurement en de code voor andere uitvoeren Experience Cloud oplossingen.
Stap 8: (Optioneel) Configureer een evaluatieperiode section-aceacdb7d5794f25ac6ff46f82e148e1
Als een van deze gebruiksgevallen op uw situatie van toepassing is, raadpleegt u Klantenservice een tijdelijke respijtperiode. 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 hebt die de id-service gebruiken en sommige pagina's die dat niet doen, en deze allemaal in dezelfde analytische 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 Cookie-vereisten
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 ook: Cookies en de identiteitsservice van Experiencen Cloud.
De Integratie van Gegevens Clickstream
U hebt een respijtperiode nodig als u gegevens naar een intern systeem verzendt vanuit een Clickstream-gegevensinvoer en die processen het visid_high
en visid_low
kolommen.
De respijtperiode beëindigen nadat het proces voor het invoeren van gegevens de post_visid_high
en post_visid_low
kolommen.
Zie ook: Referentie kolom Clickstream.
Stap 9: Testen en verifiëren section-f857542bfc70496dbb9f318d6b3ae110
De Experience Cloud oplossingen in deze implementatie retourneren-id's in de vorm van sleutelwaardeparen. Elke oplossing gebruikt verschillende toetsen (bijvoorbeeld de Analytics SDID vs. Target mboxMCSDID) om dezelfde id te bevatten. Als u uw implementatie wilt testen, laadt u uw pagina's in een ontwikkelomgeving. Gebruik de browserconsole of software die HTTP-aanvragen en -reacties controleert om de hieronder vermelde id's te controleren. De ID-service is correct geïmplementeerd wanneer de onderstaande sleutelwaardeparen dezelfde id-waarden retourneren.
Alle oplossingen
Controleren op:
- AMCV cookie in het domein waar u pagina ontvangt.
- Experience Cloud ID (MID) met de Adobe foutopsporing of uw voorkeurshulpprogramma voor foutopsporing.
Voor extra controles die u helpen bepalen als de dienst van identiteitskaart behoorlijk werkt, zie De identiteitsdienst van het Experience Cloud testen en verifiëren.
Analytics
Controleer in de JavaScript-aanvraag of de id van de SDID aanwezig is. De SDID van Analytics moet overeenkomen met de Target mboxMCSDID.
Als uw tests een identiteitskaart terugkeren, wijst dat op één van beiden van het volgende:
- U bent een terugkerende bezoeker in het migratieproces van verouderde Analytics ID's.
- U hebt een respijtperiode ingeschakeld.
Wanneer u een HULP ziet, controleer zijn waarde tegen Target mboxMCAVID. Deze waarden zijn identiek wanneer de dienst van identiteitskaart correct is uitgevoerd.
Audience Manager
Om server-kant het door:sturen te testen, zie Hoe te om uw server-kant te verifiëren die implementatie door:sturen.
Target
Controleren op:
- mboxMCGVID
- mboxMCSDID (De mboxMCSDID moet overeenkomen met de Analytics SDID.)
Als uw tests een mboxMCAVID terugkeren, wijst dat op één van beiden van het volgende:
- U bent een terugkerende bezoeker in het migratieproces van verouderde Analytics ID's.
- U hebt een respijtperiode ingeschakeld.
Wanneer u een mboxMCAVID ziet, controleer zijn waarde tegen Analytics STEUN Deze waarden zijn identiek wanneer de dienst van identiteitskaart correct is uitgevoerd.
Implementatie
Stap 10: Distribueren section-4188fa95e7dc455a986b48a6c517c1c9
Implementeer de code nadat deze voor het testen is geslaagd.
Als u een respijtperiode hebt ingeschakeld:
- Zorg ervoor dat de opties Analytics ID (AID) en MID in de afbeeldingsaanvraag staan.
- Vergeet niet de respijtperiode uit te schakelen wanneer u voldoet aan de criteria voor stopzetting.