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 de 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.

Stap 1: Plan voor server-zij door:sturen section-880797cc992d4755b29cada7b831f1fc

Naast de hier beschreven stappen, zouden klanten die Analytics en Audience Manager gebruiken aan server-zijdoor:sturen moeten migreren. Server-kant door:sturen laat u DIL (de code van de de gegevensinzameling van de Audience Manager) verwijderen en het vervangen met de Module van het Beheer van de Auditie. Zie server-kant het door:sturen documentatievoor 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:

Stap 2: Download de ID Service-code section-0780126cf43e4ad9b6fc5fe17bb3ef86

De id-service vereist de codebibliotheek van VisitorAPI.js . Deze codebibliotheek downloaden:

Stap 3: Voeg de functie Visitor.getInstance aan de code van de Dienst van identiteitskaart toe section-9e30838b4d0741658a7a492153c49f27

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 Bezoeker API.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 4: Voeg uw identiteitskaart van de Organisatie van het Experience Cloud aan Visitor.getInstance toe section-e2947313492546789b0c3b2fc3e897d8

Vervang INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE in de functie Visitor.getInstance door de 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: 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:

Deel 2: Plaats volgende servervariabelen

Om te bepalen welke volgende servervariabelen moeten worden gebruikt:

Als u niet zeker bent hoe te om uw het volgen server te vinden FAQziet en bevolkt correct de variabelen trackingServer en trackingServerSecure.

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 hieronder getoonde functie Visitor.getInstance toe aan uw AppMeasurement.js bestand. Plaats het in de sectie die configuraties zoals linkInternalFilters, charSet, trackDownloads, enz. bevat:

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

(Facultatief, maar geadviseerd) creeer een douaneprep ​

Stel een aangepaste proxy in AppMeasurement.js in om de dekking te meten. Voeg deze aangepaste proxy toe aan de functie doPlugins van het 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 het bestand VisitorAPI.js binnen de tags <head> op elke pagina. Wanneer u het VisitorAPI.js -bestand op de pagina plaatst:

Stap 8: (Optioneel) Configureer een evaluatieperiode section-aceacdb7d5794f25ac6ff46f82e148e1

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 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 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 ook, Cookies en de Dienst van de Identiteit van het Experience Cloud.

de Integratie van Gegevens van de ClikStream

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 ook, de Verwijzing van de Kolom van Gegevens 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 versus de 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:

Voor extra controles die u helpen bepalen als de dienst van identiteitskaart behoorlijk werkt, zie Test en verifieer de Dienst van de Identiteit van het Experience Cloud.

Analytics

Controleer of de id van de SDID voorkomt in de JavaScript-aanvraag. 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:

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 uw server-kant het door:sturen implementatieverifiëren.

Doel

Controleren op:

Als uw tests een mboxMCAVID terugkeren, wijst dat op één van beiden van het volgende:

Wanneer u een mboxMCAVID ziet, controleer zijn waarde tegen Analytics HULP. Deze waarden zijn identiek wanneer de dienst van identiteitskaart correct is uitgevoerd.

Plaatsing

Stap 10: Distribueren section-4188fa95e7dc455a986b48a6c517c1c9

Implementeer de code nadat deze voor het testen is geslaagd.

Als u een respijtperiode hebt ingeschakeld: