Show Menu
TEMAS×

Implementación de la integración

Implementar esta integración es un proceso sencillo que requiere las siguientes acciones.

Finalización del Asistente para integración de Adobe

Para activar la integración, debe completar el asistente de configuración en la interfaz de Conectores de datos.
  1. Vaya al área Conectores de datos (anteriormente Genesis) dentro de Adobe Experience Cloud.
  2. Inicie el asistente de integración de Demandbase 2.0.
  3. Elija el grupo de informes deseado y proporcione un nombre para la integración.
  4. Configure los siguientes elementos:
Elemento Descripción
La dirección de correo electrónico La dirección de correo electrónico del contacto principal.
Descripción (Opcional) Descripción de esta configuración de integración.
Clave de API de Demandbase Puede obtenerlo de su representante de Demandbase.
Dimensión Demandbase personalizada #N Son los ID de las 8 dimensiones opcionales. Para obtener más información, consulte Dimensiones personalizadas de Demandbase.
Enviar a Adobe Target Si es "true", las dimensiones de Demandbase también se enviarán a Adobe Target mediante un mbox oculto.
Nota: Se debe implementar un archivo mbox.js configurado en la página web para que se recopilen las dimensiones.
  1. Configure los siguientes elementos de Asignaciones de variables:
    Elemento
    Descripción
    Dimensiones de Demandbase
    Elija una variable eVar disponible en el grupo de informes.
    Dimensiones personalizadas de Demandbase (opcional)
    Elija una variable eVar disponible en el grupo de informes.
  2. Configure los nombres de la dimensión personalizada (si corresponde).
    1. Si eligió incluir dimensiones personalizadas en el paso 4 y asignó la eVar opcional en el paso 5, deberá proporcionar nombres descriptivos para dichas dimensiones. Por ejemplo, si elige introducir "stock_ticker" como dimensión personalizada 1, debe cambiar la casilla que contiene "Dimension 1" a "Stock Ticker".
    2. NO modifique los nombres de las dimensiones estándar 8 (es decir, SID de Demandbase, Nombre de la empresa, Industria, etc.).
  3. Marque la casilla para que el tablero de Integración de Demandbase se cree automáticamente (recomendado).
  4. Revise todos los elementos de configuración y haga clic en Activar ahora .

Implementación del código de integración

Después de completar el asistente de integración, debe implementar el código de integración en el código de implementación de Adobe Analytics (s_code).
Si ha utilizado Adobe TagManager o la administración dinámica de etiquetas para implementar Adobe Analytics, puede añadir fácilmente el código de integración con una de estas herramientas.
  1. Vaya a la ficha Asistencia y descargue y guarde el integration code v2_0_1 recurso desde el área Recursos de la integración.
  2. Si procede, realice las modificaciones necesarias en el código. Para obtener más información, consulte Modificación del código de integración (en esta página).
  3. Incluya el módulo Integrate si no está presente en el código de implementación de Adobe Analytics.
  4. Implemente el código mediante uno de los siguientes métodos:
    • Utilice Adobe TagManager o la administración dinámica de etiquetas para agregar el código.
    • O bien, envíe el código al recurso de organización responsable de actualizar el código de implementación de Adobe Analytics.
Asegúrese de probar la implementación para esta integración en un entorno de desarrollo/ensayo antes de implementarla en un entorno de producción.

Modificación del código de integración

En la mayoría de los casos, no es necesario realizar ninguna modificación en el código de integración producido por el asistente del conector de datos.
Sin embargo, si necesita realizar ajustes, a continuación se describen algunos de los ajustes del código.
Configuración de código Descripción
s.maxDelay El número máximo de milisegundos que la solicitud de imagen de Adobe Analytics esperará a los datos de Demandbase antes de activarse en el servidor de recopilación de Analytics.
Nota: Esta configuración se aplica a todas las integraciones que se estén ejecutando a través del módulo Integrate.
_db._key La clave de API de Demandbase.
_db._apiURL Plantilla URL para la API de Demandbase.
_db._delim El delimitador utilizado para separar los valores de dimensión Demandbase cuando se envían a Adobe Analytics. Si se cambia esta configuración, es posible que las reglas de clasificación predeterminadas no funcionen correctamente.
_db._setTnt Si es true, el código de integración intentará usar un mbox oculto para enviar las dimensiones Demandbase a Adobe Target como parámetros de perfil.
Nota: Esto requiere que el código mbox.js exista en la página.
_db._tntVarPrefix Esta cadena se antepone a cada nombre de dimensión Demandbase antes de enviarla a Adobe Target. Por ejemplo, si esta configuración tiene el valor "db_", la dimensión "sector" se enviará a Adobe Target como "db_sector".
_db._dimensionArray Dimensiones estándar de Demandbase que se envían a Adobe Analytics. Se recomienda no modificar esta configuración. La propiedad "max_size" es el número de caracteres permitidos para la dimensión antes de que se produzca el truncamiento.
_db._dimensionArrayCustom Dimensiones de Demandbase personalizadas que se envían a Adobe Analytics. La propiedad "max_size" es el número de caracteres permitidos para la dimensión antes de que se produzca el truncamiento.
_db._cName Nombre de la cookie de sesión que se utiliza para mantener el estado de la comunicación de la API Demandbase.
_db._contextName Nombre de la variable contextData que se utiliza para enviar las dimensiones estándar a Adobe Analytics. Se recomienda no modificar esta configuración.
_db._contextNameCustom Nombre de la variable contextData que se utiliza para enviar las dimensiones personalizadas a Adobe Analytics. Se recomienda no modificar esta configuración.

Inclusión del módulo Integrate

El código de integración requiere que el módulo Integrate exista dentro de la implementación de Adobe Analytics.
Si todavía no tiene el módulo Integrate como parte de la implementación, complete los siguientes pasos según el tipo de implementación que tenga.

Para AppMeasurement v1.0+

  1. Descomprima el archivo zip de AppMeasurement que descargó de Analytics > Administración > AdministradorDeCódigos .
  2. Abra el archivo llamado AppMeasurement_Module_Integrate.js.
  3. Copie y pegue el contenido de este archivo en el AppMeasurement.js archivo principal.
    Pegarlo justo antes del comentario DO NOT ALTER ANYTHING BELOW THIS LINE (NO ALTERAR NADA DEBAJO DE ESTA LÍNEA) dentro del archivo.

Para código heredado (código H)

  1. Descargue el módulo Integrate desde el área "Recursos" de la interfaz de usuario de Conectores de datos (en la ficha Asistencia técnica).
  2. Copie y pegue el contenido de ese archivo en el s_code archivo.
    Pegarlo justo antes del comentario DO NOT ALTER ANYTHING BELOW THIS LINE (NO ALTERAR NADA DEBAJO DE ESTA LÍNEA) dentro del archivo.

Verificación de la integración

Valide que la integración está capturando datos correctamente mediante la comprobación del seguimiento activo y los informes.

Seguimiento en vivo

Utilice la herramienta de depuración DigitalPulse para comprobar que los datos de dimensión Demandbase se están enviando a Adobe Analytics. Después de eliminar las cookies, vuelva a cargar una página del sitio web en la que se haya implementado el código de integración. Suponiendo que la IP actual se asigna a una organización reconocida por Demandbase, debería ver resultados similares a los siguientes.
Informes y análisis (anteriormente SiteCatalyst) incluye las dos variables de datos de contexto de Demandbase:
Mbox de Target incluye los parámetros de perfil de Demandbase: Solo verá esto si tiene Target implementado en la página Y tiene esta integración configurada para Adobe Target; consulte el paso 4 del asistente de integración de Adobe.

Creación de informes

Revise los informes de Demandbase en Adobe Analytics mediante el panel creado automáticamente con el asistente de integración de Adobe (paso 7).
También puede navegar hasta los informes de Demandbase dentro de la estructura de menú de Adobe Analytics; consulte las capturas de pantalla a continuación.
Estos datos deben aparecer entre 24 y 48 horas después de la implementación correcta.

Preguntas frecuentes

¿Qué significa " #"?
El conector de datos Demandbase indica cuándo un atributo está "No disponible" al establecer este valor predeterminado. Hay dos escenarios comunes en los que se establece el valor predeterminado:
  • Demandbase detecta que el visitante proviene de una dirección IP que no pertenece a una empresa.
  • Se utiliza un atributo de observación de cuenta (que comienza con "watch_list"), pero la empresa no está en la lista de observación de cuentas.
¿Por qué aparece " [n/a] " con más frecuencia para determinados atributos?
Demandbase clasifica todas las direcciones IP y proporciona los atributos audience y audience_segment incluso cuando el visitante no procede de una IP de la empresa. Cuando la audiencia devuelve valores como "Residencial", "Inalámbrico" y "Hospitalidad", es probable que el resto de atributos no estén disponibles.
A veces, la audiencia de un visitante será "SMB", pero otros atributos mostrarán " [n/a] ". Esto significa que Demandbase puede clasificar al visitante como una pequeña empresa, pero el perfil completo de la empresa no está disponible. Esto suele ocurrir en las empresas más pequeñas, cuando más de una pequeña empresa utiliza el mismo proveedor de servicios o bloque de direcciones IP.

Consideraciones sobre el desarrollador

Si necesita ajustar el valor predeterminado en la implementación, actualice la línea:
_db._nonOrgMatchLabel = "[n/a]";