Show Menu
TOPICS×

Mise en œuvre du service Experience Cloud Identity pour Analytics

Ces instructions concernent les clients d’Analytics qui souhaitent utiliser le service Experience Cloud Identity et n’utilisent pas Dynamic Tag Management (DTM). Cependant, nous vous recommandons vivement d’utiliser DTM pour mettre en œuvre le service d’ID. DTM facilite le workflow de mise en œuvre et assure automatiquement le placement et le séquencement adéquats du code.
  • Lisez les conditions requises avant de commencer.
  • Configurez ce code et testez-le dans un environnement de développement avant de le mettre en œuvre en production.
Pour mettre en œuvre le service d’ID pour Adobe Analytics, procédez comme suit :

Étape 1 : Téléchargement du code du service d’ID

Le service d’ID requiert la bibliothèque de code
VisitorAPI.js
. Pour télécharger cette bibliothèque de code :
  1. Accédez à
    Admin
     > 
    Gestionnaire de code
    .
  2. Dans Gestionnaire de code, cliquez sur
    JavaScript (nouveau)
    ou
    JavaScript (hérité)
    .
    Les bibliothèques de code compressées sont alors téléchargées.
  3. Décompressez le fichier de code, puis ouvrez le
    VisitorAPI.js
    fichier.

Étape 2 : Ajout de la fonction Visitor.getInstance au code du service d’ID

  • Les versions précédentes de l’API du service d’ID plaçaient cette fonction à un autre emplacement et nécessitaient une syntaxe différente. Si vous effectuez une migration à partir d’une version antérieure à la version 1.4 , prenez note du nouvel emplacement et de la nouvelle syntaxe documentés dans cette section.
  • Le code dans ALL CAPS est un espace réservé pour les valeurs réelles. Remplacez ce texte par votre ID d’organisation, l’URL du serveur de suivi ou une autre valeur de nom.
Partie 1 : Copiez la fonction Visitor.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 : Ajout de l’ID d’organisation Experience Cloud à Visitor.getInstance

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 également Administration – Services principaux . La fonction modifiée peut ressembler à l’exemple ci-après.
var visitor = Visitor.getInstance("1234567ABC@AdobeOrg", { ...
Ne modifiez pas
la casse des caractères de l’ID d’organisation. L’ID est sensible à la casse et doit être utilisé tel quel.

Étape 4 : Ajout des serveurs de suivi à Visitor.getInstance

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 :
  • s.trackingServer
  • s.trackingServerSecure
Partie 2 : Définissez les variables de serveur de suivi
Pour déterminer les variables de serveur de suivi à utiliser, procédez comme suit :
  1. Répondez aux questions présentées dans le tableau ci-après. Utilisez les variables qui correspondent à vos réponses.
  2. Remplacez les espaces réservés de serveur de suivi par vos URL de serveur de suivi.
  3. Supprimez les variables de serveur de suivi et de Experience Cloud serveur inutilisées du code.
Lorsqu’elles sont utilisées, faites correspondre les Experience Cloud URL du serveur aux URL du serveur de suivi de la façon suivante :
  • Experience CloudURL du serveur = URL du serveur de suivi
  • Experience CloudURL du serveur sécurisé = URL du serveur sécurisé de suivi
If you're not sure how to find your tracking server see the FAQ and Correctly Populate the trackingServer and trackingServerSecure variables .

Étape 5 : Mise à jour du fichier AppMeasurement.js ou s_code.js

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
doPlugins
fonction 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 : Ajout du code de l’API visiteur à la page

Placez le fichier
VisitorAPI.js
à l’intérieur des balises
<head>
sur chaque page. Lorsque vous placez le
VisitorAPI.js
fichier sur votre page :
  • Insérez-le au début de la
    <head>
    section afin qu’il s’affiche avant les balises d’autres solutions.
  • Il doit s’exécuter avant AppMeasurement et le code d’autres Experience Cloud solutions.
Placez ce code en production après les tests et la vérification.

Étape 7 : (facultative) Configuration d’une période de grâce

If any of these use cases apply to your situation, ask Customer Care to set up a temporary grace period . Les périodes de grâce peuvent durer jusqu’à 180 jours. En cas de besoin, vous pouvez renouveler une période de grâce.
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. Il s’agit d’une situation courante si vous disposez d’une suite de rapports globale qui signale des informations entre les domaines.
Interrompez la période de grâce une fois que le service d’ID est déployé sur toutes les pages Web qui signalent des informations dans la même suite de rapports.
Exigences liées au cookie s_vi
Vous avez besoin d’une période de grâce si les nouveaux visiteurs doivent avoir un cookie s_vi une fois la migration vers le service d’ID effectuée. Cette situation est courante si votre mise en œuvre lit le cookie s_vi et le stocke dans une variable.
Interrompez la période de grâce une fois que votre mise en œuvre peut capturer le MID au lieu de lire le cookie s_vi.
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
.
Ingestion des données du parcours de navigation

Étape 8 : Test et déploiement du code du service d’ID

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 :
Déploiement du code
Déployez votre code une fois qu’il a réussi les tests.
Si vous avez activé une période de grâce à l’ étape 7  :
  • Vérifiez que l’Analytics ID (AID) et le MID figurent dans la demande d’image.
  • Souvenez-vous de désactiver la période de grâce lorsque les critères d’interruption sont remplis.