Mise en œuvre du service Experience Cloud Identity pour Analytics implement-the-experience-cloud-id-service-for-analytics

Ces instructions concernent les clientes et clients d’Analytics qui souhaitent utiliser le service d’identités d’Experience Cloud et n’utilisent pas les balises de collecte de données. Cependant, il est vivement recommandé d’utiliser les balises pour implémenter le service d’identités. Les balises optimisent le workflow d’implémentation et assurent automatiquement le placement et le séquencement adéquats du code.

Pour mettre en œuvre le service d’ID pour Adobe Analytics, procédez comme suit :

Étape 1 : télécharger le code du service d’ID section-ead9403a6b7e45b887f9ac959ef89f7f

Le service d’ID requiert la bibliothèque de code VisitorAPI.js. Pour télécharger cette bibliothèque de code :

Étape 2 : ajouter la fonction Visitor.getInstance au code du service d’ID section-6053a6b7c16c466a9f9fdbf9cb9db3df

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

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
});

Partie 2 : Ajoutez le code de la 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-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
});

Étape 3 : ajouter l’ID d’organisation Experience Cloud à Visitor.getInstance section-7b8a6e76dc124d0e9ab1ce96ab2ffb0e

Dans la Visitor.getInstance fonction, remplacez INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE par Experience Cloud l’ID d’organisation. Si vous ne connaissez pas votre ID d’organisation, vous pouvez le trouver dans la page Experience Cloud d’administration. Voir aussi Administration - Services principaux. La fonction modifiée peut ressembler à l’exemple ci-après.

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

Étape 4 : ajouter les serveurs de suivi à Visitor.getInstance section-70ec9ebff47940d8ab520be5ec4728c5

Les serveurs de suivi sont utilisés pour la Analytics collecte des 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 5 : mettre à jour le fichier AppMeasurement.js ou s_code.js section-b53113aea1bd4de896e0e4e9a7edee19

Ajoutez la fonction suivante au fichier AppMeasurement.js ou s_code.js :

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

Placez le code dans la section qui contient des configurations telles que linkInternalFilters, charSet, trackDownloads, etc.

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

Définissez une prop personnalisée dans le fichier AppMeasurement.js ou s_code.js pour mesurer la couverture. Ajoutez la prop personnalisée suivante à la doPluginsfonction du fichier AppMeasurement.js ou s_code.js :

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

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

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

Placez ce code en production après les tests et la vérification.

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

Si l’un de ces cas d’utilisation s’applique à votre situation, demandez à l’Assistance clientèle de mettre en place 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’ID et d’autres pas et si elles signalent des informations dans la même suite de Analytics rapports. Cela est courant si vous disposez d’une suite de rapports globale qui crée des rapports entre domaines.

Arrêtez la période de grâce après le déploiement du service d’ID sur toutes les pages Web qui génèrent des rapports 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 souhaitez que les nouveaux visiteurs disposent d’un cookie s_vi après la migration vers le service d’ID. 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 Cookies et service d’identités Experience Cloud.

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 parcours de navigation 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 Référence des colonnes de données du parcours de navigation.

Ingérer les données de flux de clics

Étape 8 : tester et déployer le code du service d’ID section-e9c1764ac21a4ec5be1ff338c0e2e01b

Vous pouvez tester et déployer les éléments comme suit.

Tests et vérification

Pour tester la mise en œuvre du service d’ID, recherchez les éléments suivants :

Voir Test et vérification du service Experience Cloud Identity.

Déploiement du code

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

Si vous avez activé une période de grâce à l’étape 7 :