Show Menu
SUJETS×

Déploiement de l’intégration

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

Fin de l’assistant d’intégration Adobe

Pour activer l’intégration, vous devez exécuter l’assistant de configuration dans l’interface des connecteurs de données.
  1. Accédez à la zone Connecteurs de données (anciennement Genesis) dans Adobe Experience Cloud.
  2. Lancez l’assistant d’intégration Demandbase 2.0.
  3. Choisissez une suite de rapports et nommez l’intégration.
  4. Configurez 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.
Dimension de base de demande personnalisée #N Il s’agit des ID des 8 dimensions facultatives. Pour plus d’informations, voir Demandbase Custom Dimensions.
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 suivants de mappage des variables :
    Élément
    Description
    Dimensions Demandbase
    Choisissez une variable eVar disponible dans votre suite de rapports.
    Demandbase Custom Dimensions (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 d’associer 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 dimensions standard 8 (SID de base de la demande, nom de la société, industrie, 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).
Si vous avez utilisé Adobe TagManager ou la gestion dynamique des balises pour déployer Adobe Analytics, vous pouvez facilement ajouter le code d’intégration à l’aide de l’un de ces outils.
  1. Accédez à l’onglet Assistance et téléchargez et enregistrez la integration code v2_0_1 ressource 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 la gestion dynamique des balises pour ajouter le code.
    • Vous pouvez également diffuser le code à la ressource d’organisation responsable de la mise à jour du code de déploiement Adobe Analytics.
Vérifiez que vous testez le déploiement de cette intégration dans un environnement de développement/test avant de le déployer dans un environnement de production.

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 Connector 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 base de demande 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 valeurs de dimension Demandbase lorsqu’elles sont envoyées à 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 "industrie" sera envoyée à Adobe Target sous la forme "db_industrie".
_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 AppMeasurement.js fichier principal.
    Collez-le juste avant le commentaire DO NOT ALTER ANYTHING BELOW This LINE dans le fichier.

Pour le code hérité (code H)

  1. Téléchargez le module Integrate à partir de la zone "Resources" de l’interface utilisateur des connecteurs de données (sous l’onglet Support).
  2. Copiez et collez le contenu de ce fichier dans votre s_code fichier.
    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 capture 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.
Les rapports et analyses (anciennement SiteCatalyst) incluent 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 (Etape 7).
Vous pouvez également accéder aux rapports Demandbase dans la structure de menus d’Adobe Analytics - voir captures d’écran ci-dessous.
Ces données doivent apparaître dans les 24 à 48 heures suivant le déploiement.

Questions fréquentes

Que signifie " #" ?
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]";