Le déploiement de cette intégration est un processus simple qui nécessite les actions suivantes.
Pour activer l’intégration, vous devez exécuter l’assistant de configuration dans l’interface des Data Connectors.
Élément | Description |
---|---|
Adresse électronique | Adresse électronique du contact principal. |
Description | (Facultatif) Description de cette configuration d’intégration. |
Clé d’API Demandbase | Vous pouvez obtenir cette information auprès de votre représentant Demandbase. |
Numéro de dimension Demandbase personnalisée | Il s’agit des ID des 8 dimensions facultatives. Pour plus d’informations, voir Dimensions personnalisées Demandbase. |
Envoyer à Adobe Target | Si la valeur est « true », les dimensions Demandbase sont également envoyées à Adobe Target à l’aide d’une mbox masquée. Remarque : un fichier mbox.js configuré doit être implémenté sur la page web pour que les dimensions soient collectées. |
Configurez les éléments de mappage de variables suivants :
Élément | Description |
---|---|
Dimensions Demandbase | Choisissez une variable eVar disponible dans votre suite de rapports. |
Dimensions personnalisées Demandbase (facultatif) | Choisissez une variable eVar disponible dans votre suite de rapports. |
Configurez les noms de la dimension personnalisée (le cas échéant).
Cochez la case pour que le tableau de bord d’intégration Demandbase soit automatiquement créé (recommandé).
Vérifiez tous les éléments de configuration et cliquez sur Activer maintenant.
Après avoir exécuté l’assistant d’intégration, vous devez déployer le code d’intégration dans votre code de déploiement Adobe Analytics (s_code).
Si vous avez utilisé Adobe TagManager ou Dynamic Tag Management pour déployer Adobe Analytics, vous pouvez facilement ajouter le code d’intégration à l’aide de l’un de ces outils.
Accédez à l’onglet Assistance et téléchargez puis enregistrez la ressource integration code v2_0_1
depuis la zone Ressources de l’intégration.
Le cas échéant, apportez les modifications nécessaires au code. Pour plus d’informations, voir Modification du code d’intégration (sur cette page).
Incluez le module Integrate s’il n’est pas déjà présent dans votre code de déploiement Adobe Analytics.
Déployez le code à l’aide de l’une des méthodes suivantes :
Assurez-vous de tester le déploiement de cette intégration dans un environnement de développement/d’évaluation avant de la déployer dans un environnement de production.
Dans la plupart des cas, vous n’avez pas besoin d’apporter des modifications au code d’intégration généré par l’assistant des connecteurs de données.
Toutefois, si vous devez effectuer des ajustements, certains paramètres de code sont décrits ci-dessous.
Paramètre de code | Description |
---|---|
s.maxDelay | Nombre maximal de millisecondes pendant lesquelles la demande d’image Adobe Analytics attend les données de Demandbase avant de se déconnecter du serveur de collecte Analytics. Remarque : ce paramètre s’applique à toutes les intégrations qui peuvent être exécutées via le module Integrate. |
_db._key | Votre clé d’API Demandbase. |
_db._apiURL | Modèle d’URL pour l’API Demandbase. |
_db._delim | Délimiteur utilisé pour séparer les éléments de dimension Demandbase lorsqu’ils sont envoyés à Adobe Analytics. La modification de ce paramètre peut entraîner le mauvais fonctionnement des règles de classification par défaut. |
_db._setTnt | Si la valeur est true, le code d’intégration tente d’utiliser une mbox masquée pour envoyer les dimensions Demandbase à Adobe Target en tant que paramètres de profil. Remarque : cela implique que le code mbox.js existe sur la page. |
_db._tntVarPrefix | Cette chaîne est précédée de chaque nom de dimension Demandbase avant d’être envoyée à Adobe Target. Par exemple, si ce paramètre a la valeur « db_ », la dimension « industry » sera envoyée à Adobe Target sous la forme « db_industry ». |
_db._dimensionsArray | Dimensions Demandbase standard envoyées à Adobe Analytics. Il est recommandé de ne pas modifier ce paramètre. La propriété « max_size » correspond au nombre de caractères autorisés pour la dimension avant la troncation. |
_db._dimensionsArrayCustom | Dimensions Demandbase personnalisées envoyées à Adobe Analytics. La propriété « max_size » correspond au nombre de caractères autorisés pour la dimension avant la troncation. |
_db._cName | Nom du cookie de session utilisé pour conserver l’état de la communication de l’API Demandbase. |
_db._contextName | Nom de la variable contextData utilisée pour envoyer les dimensions standard à Adobe Analytics. Il est recommandé de ne pas modifier ce paramètre. |
_db._contextNameCustom | Nom de la variable contextData utilisée pour envoyer les dimensions personnalisées à Adobe Analytics. Il est recommandé de ne pas modifier ce paramètre. |
Le code d’intégration requiert que le module Integrate existe dans votre déploiement Adobe Analytics.
Si vous ne disposez pas déjà du module Integrate dans le cadre de votre déploiement, procédez comme suit en fonction du type d’implémentation dont vous disposez.
Décompressez le fichier zip AppMeasurement que vous avez téléchargé depuis Analytics > Admin > CodeManager.
Ouvrez le fichier nommé AppMeasurement_Module_Integrate.js.
Copiez et collez le contenu de ce fichier dans votre fichier principal AppMeasurement.js.
Collez-le juste avant le commentaire DO NOT ALTER ANYTHING BELOW THIS LINE dans le fichier.
Téléchargez le module Integrate à partir de la zone « Resources » de l’interface utilisateur des Data Connectors (sous l’onglet Assistance).
Copiez et collez le contenu de ce fichier dans votre fichier s_code.
Collez-le juste avant le commentaire DO NOT ALTER ANYTHING BELOW THIS LINE dans le fichier.
Vérifiez que l’intégration collecte correctement les données en vérifiant le suivi en direct et la création de rapports.
Utilisez l’outil de débogage DigitalPulse pour vérifier que les données de dimension Demandbase sont envoyées à Adobe Analytics. Après avoir supprimé vos cookies, rechargez une page de votre site web sur laquelle le code d’intégration a été déployé. En supposant que votre adresse IP actuelle correspond à une organisation reconnue par Demandbase, vous devriez voir les résultats semblables à ceux-ci.
Reports & Analytics (anciennement SiteCatalyst) inclut les deux variables de données contextuelles Demandbase :
La mbox Target inclut les paramètres de profil Demandbase :
Vous ne verrez cela que si Target est implémenté sur la page ET que cette intégration est configurée pour Adobe Target - voir Étape 4 de l’assistant d’intégration Adobe.
Consultez vos rapports Demandbase dans Adobe Analytics à l’aide du tableau de bord qui a été automatiquement créé pour vous à l’aide de l’assistant d’intégration Adobe (étape 7).
Vous pouvez également accéder à la création de rapports Demandbase dans la structure de menus d’Adobe Analytics - voir copies d’écran ci-dessous.
Ces données doivent apparaître dans les 24 à 48 heures suivant le déploiement.
Que signifie « [n/a] » ?
Le connecteur de données Demandbase indique quand un attribut est « Non disponible » en définissant cette valeur par défaut. Il existe deux scénarios courants dans lesquels la valeur par défaut est définie :
Pourquoi « [n/a]
» apparaît-il plus souvent pour certains attributs ?
Demandbase classe toutes les adresses IP et fournit les attributs audience et audience_segment même lorsque le visiteur ne provient pas d’une adresse IP d’entreprise. Lorsque l’audience renvoie des valeurs telles que « Résidentiel », « Sans fil » et « Hospitalité », les autres attributs ne sont probablement pas disponibles.
Parfois, l’audience d’un visiteur est « SMB », mais d’autres attributs affichent « [n/a]
». Cela signifie que Demandbase peut classer le visiteur comme une petite entreprise, mais le profil complet de l’entreprise n’est pas disponible. Cela se produit généralement pour les plus petites entreprises, lorsque plusieurs petites entreprises utilisent le même fournisseur de services ou bloc d’adresses IP.
Si vous devez ajuster la valeur par défaut dans votre implémentation, mettez à jour la ligne :
_db._nonOrgMatchLabel = "[n/a]";