Mettre en œuvre le service d’identification des visiteurs Adobe pour Analytics, Audience Manager et Target implement-the-experience-cloud-id-service-for-analytics-audience-manager-and-target

Ces instructions s’adressent aux clients Analytics, Audience Manager et Target qui souhaitent utiliser le service d’identification des visiteurs et n’utilisent pas de balises. Cependant, nous vous recommandons vivement d’utiliser les balises pour implémenter le service d’identification des visiteurs. Les balises optimisent le workflow d’implémentation et assurent automatiquement le placement et le séquencement adéquats du code.

Étape 1 : planifier le transfert côté serveur section-880797cc992d4755b29cada7b831f1fc

En plus des étapes décrites ici, les clients qui utilisent Analytics et Audience Manager doivent passer au transfert côté serveur. Le transfert côté serveur permet de supprimer le code DIL (code de collecte de données d’Audience Manager) et de le remplacer par le Module de Gestion de l’audience. Pour plus d’informations, voir la documentation sur le transfert côté serveur.

La migration vers le transfert côté serveur nécessite une planification et une coordination. Ce processus implique des modifications externes du code de votre site et des étapes internes qu’Adobe doit effectuer pour approvisionner votre compte. En fait, beaucoup de ces procédures de migration doivent se produire en parallèle et être publiées ensemble. Votre chemin d’implémentation doit suivre la séquence d’événements suivante :

Étape 2 : télécharger le code du service d’identification des visiteurs section-0780126cf43e4ad9b6fc5fe17bb3ef86

Le service d’identification des visiteurs nécessite la bibliothèque de code VisitorAPI.js. Pour télécharger cette bibliothèque de code :

Étape 3 : ajouter la fonction Visitor.getInstance au code du service d’identification des visiteurs section-9e30838b4d0741658a7a492153c49f27

Partie 1 : Copiez la fonction Visiteur.getInstance ci-dessous

var visitor = Visitor.getInstance("INSERT-IMS-ORG-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
});

Partie 2 : ajoutez le code de fonction au fichier VisitorAPI.js

Placez la Visitor.getInstance fonction à la fin du fichier, après le bloc de code. Le fichier modifié doit ressembler à celui-ci :

/*
========== 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-IMS-ORG-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
});

Étape 4 : ajouter votre ID d’organisation IMS à Visitor.getInstance section-e2947313492546789b0c3b2fc3e897d8

Dans la fonction Visitor.getInstance , remplacez INSERT-IMS-ORG-ID-HERE par votre ID d’organisation IMS. Si vous ne connaissez pas votre identifiant de l’organisation IMS, vous pouvez le trouver sur la page d’administration de l’entreprise CX. La fonction modifiée peut ressembler à l’exemple ci-après.

var visitor = Visitor.getInstance("1234567ABC@AdobeOrg", { ...

Étape 5 : ajouter des serveurs de suivi à Visitor.getInstance section-0dfc52096ac2427f86045aab9a0e0dfc

Analytics utilise des serveurs de suivi pour la collecte de données.

Partie 1 : Recherchez les URL de serveur de suivi

Dans le fichier s_code.js ou AppMeasurement.js, recherchez les URL de serveur de suivi. Les URL doivent être spécifiées par les variables suivantes :

Partie 2 : Définissez les variables de serveur de suivi

Pour déterminer les variables de serveur de suivi à utiliser :

Si vous ne savez pas comment trouver votre serveur de suivi, consultez la FAQ et la Collecte correcte des variables trackingServer et trackingServerSecure.

Étape 6 : mettre à jour votre fichier AppMeasurement.js section-5517e94a09bc44dfb492ebca14b43048

Cette étape nécessite AppMeasurement. Vous ne pouvez pas continuer si vous utilisez toujours s_code.

Ajoutez la Visitor.getInstance fonction affichée ci-dessous à votre AppMeasurement.js fichier. Placez-le dans la section qui contient des configurations telles que linkInternalFilters, charSet, trackDownloads, etc. :

s.visitor = Visitor.getInstance("INSERT-IMS-ORG-ID-HERE");

(Étape facultative mais recommandée) Créez une prop personnalisée.

Définir une prop personnalisée dans le fichier AppMeasurement.js pour mesurer la couverture. Ajoutez la prop personnalisée suivante à la doPlugins fonction de votre AppMeasurement.js fichier :

// prop1 is used as an example only. Choose any available prop.
s.prop1 = (typeof(Visitor) != "undefined" ? "VisitorAPI Present" : "VisitorAPI Missing");

Étape 7 : ajouter le code de l’API visiteur à la page section-c2bd096a3e484872a72967b6468d3673

Placez le fichier VisitorAPI.js à l’intérieur des balises <head> sur chaque page. Lorsque vous placez le VisitorAPI.js fichier sur votre page :

Étape 8 : (facultative) configurer un délai de grâce section-aceacdb7d5794f25ac6ff46f82e148e1

Si l’un de ces cas d’utilisation s’applique à votre situation, demandez à l’Assistance clientèle de configurer une période de grâce temporaire. Les périodes de grâce peuvent durer jusqu’à 180 jours. Vous pouvez renouveler une période de grâce si nécessaire.

Mise en œuvre partielle

Vous avez besoin d’une période de grâce si certaines pages utilisent le service d’identification des visiteurs et d’autres pas, et qu’elles génèrent toutes des rapports dans la même suite de rapports Analytics. Cela est courant si vous disposez d’une suite de rapports globale qui crée des rapports entre domaines.

Mettez fin à la période de grâce une fois que le service d’identification des visiteurs a été déployé sur toutes vos pages web qui font rapport dans la même suite de rapports.

Conditions requises pour le cookie s_vi

Vous avez besoin d’une période de grâce si vous avez besoin que les nouveaux visiteurs disposent d’un cookie s_vi après la migration vers le service d’identification des visiteurs. Cela est courant si votre implémentation lit le cookie s_vi et le stocke dans une variable.

Arrêtez la période de grâce une fois que votre implémentation peut capturer le MID au lieu de lire le cookie s_vi.

Voir aussi ​ Cookies et service d’identification des visiteurs ​.

Intégration des données du flux de clics

Vous avez besoin d’une période de grâce si vous envoyez les données à un système interne à partir d’un flux de données de flux de clics et si ce processus utilise les colonnes visid_high et visid_low.

Interrompez la période de grâce une fois que le processus d’ingestion des données peut utiliser les colonnes post_visid_high et post_visid_low.

Voir aussi Référence des colonnes de données du flux de clics.

Étape 9 : tester et vérifier section-f857542bfc70496dbb9f318d6b3ae110

Les solutions Entreprise CX de cette implémentation renvoient des identifiants sous la forme de paires clé-valeur. Chaque solution utilise différentes clés (par exemple, le SDID Analytics ou le mboxMCSDID Target) pour contenir le même identifiant. Pour tester votre mise en œuvre, chargez votre page dans un environnement de développement. Utilisez votre console ou logiciel de navigation qui surveille les demandes et réponses HTTP pour vérifier les identifiants répertoriés ci-dessous. Le service d’identification des visiteurs a été correctement mis en œuvre lorsque les paires clé-valeur répertoriées ci-dessous renvoient les mêmes valeurs d’identifiant.

Toutes les solutions

Vérifiez les éléments suivants :

Pour des vérifications supplémentaires qui vous aident à déterminer si le service d’identification des visiteurs fonctionne correctement, voir Test et vérification du service d’identification des visiteurs.

Analytics

Recherchez l’identifiant SDID dans la demande JavaScript. L’Analytics SDID doit correspondre au mboxMCSDID Target.

Si vos tests renvoient un AID, cela indique l’un des éléments suivants :

Lorsque vous voyez un AID, vérifiez sa valeur par rapport au mboxMCAVID cible. Ces valeurs sont identiques lorsque le service d’identification des visiteurs a été correctement implémenté.

Audience Manager

Pour tester le transfert côté serveur, voir Comment vérifier l’implémentation du transfert côté serveur.

Target

Vérifiez les éléments suivants :

Si vos tests renvoient un mboxMCAVID, cela indique l’un des éléments suivants :

Lorsque vous voyez un mboxMCAVID, vérifiez sa valeur par rapport à l’outil Analytics AID. Ces valeurs sont identiques lorsque le service d’identification des visiteurs a été correctement implémenté.

Déploiement

Étape 10 : déployer section-4188fa95e7dc455a986b48a6c517c1c9

Déployez votre code une fois qu’il a réussi le test.

Si vous avez activé une période de grâce :