Déploiement de l’intégration

Le déploiement de cette intégration est un processus simple qui nécessite les actions suivantes.

Finalisation de l’assistant d’intégration Adobe

Pour activer l’intégration, vous devez exécuter l’assistant de configuration dans l’interface des Data Connectors.

1. Accédez à la zone des Data Connectors (anciennement Genesis) dans Adobe Experience Cloud.
2. Lancez l’assistant d’intégration Demandbase 2.0.
3. Choisissez une suite de rapports et attribuez un nom à l’intégration.
4. Renseignez les éléments suivants :

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

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

2. Configurez les noms de la dimension personnalisée (le cas échéant).

   1. Si vous avez choisi d’inclure des dimensions personnalisées à l’étape 4 et de mapper l’eVar facultative à l’étape 5, vous devez fournir des noms conviviaux pour ces dimensions. Par exemple, si vous avez choisi de saisir « stock_ticker » comme dimension personnalisée 1, vous devez modifier la zone contenant « Dimension 1 » en « Stock Ticker ».
   2. Ne modifiez PAS les noms des 8 dimensions standard (c’est-à-dire le code SID Demandbase, le nom de la société, le secteur industriel, etc.).

3. Cochez la case pour que le tableau de bord d’intégration Demandbase soit automatiquement créé (recommandé).

4. Vérifiez tous les éléments de configuration et cliquez sur Activer maintenant.

Déploiement du code d’intégration

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

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

2. 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).

3. Incluez le module Integrate s’il n’est pas déjà présent dans votre code de déploiement Adobe Analytics.

4. Déployez le code à l’aide de l’une des méthodes suivantes :

   • Utilisez Adobe TagManager ou Dynamic Tag Management pour ajouter le code.
   • Vous pouvez également envoyer le code à la ressource d’organisation responsable de la mise à jour du code de déploiement Adobe Analytics.

Modification du code d’intégration

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.

Inclusion du module Integrate

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.

Pour AppMeasurement v1.0+

1. Décompressez le fichier zip AppMeasurement que vous avez téléchargé depuis Analytics > Admin > CodeManager.

2. Ouvrez le fichier nommé AppMeasurement_Module_Integrate.js.

3. Copiez et collez le contenu de ce fichier dans votre fichier principal AppMeasurement.js.

   REMARQUE

   Collez-le juste avant le commentaire DO NOT ALTER ANYTHING BELOW THIS LINE dans le fichier.

Pour le code hérité (H-code)

1. Téléchargez le module Integrate à partir de la zone « Resources » de l’interface utilisateur des Data Connectors (sous l’onglet Assistance).

   

2. Copiez et collez le contenu de ce fichier dans votre fichier s_code.

   REMARQUE

   Collez-le juste avant le commentaire DO NOT ALTER ANYTHING BELOW THIS LINE dans le fichier.

Vérification de l’intégration

Vérifiez que l’intégration collecte correctement les données en vérifiant le suivi en direct et la création de rapports.

Suivi en direct

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.

Création de rapports

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.

Questions fréquentes

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 :

• Demandbase détecte que le visiteur provient d’une adresse IP qui n’appartient pas à une entreprise.
• Un attribut de contrôle de compte (commençant par « watch_list ») est utilisé, mais l’entreprise ne figure pas dans votre liste de contrôle de compte.

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.

Points à prendre en compte pour les développeurs

Si vous devez ajuster la valeur par défaut dans votre implémentation, mettez à jour la ligne :

_db._nonOrgMatchLabel = "[n/a]";