Show Menu
TÓPICOS×

Implantar a integração

A implantação dessa integração é um processo simples que requer as seguintes ações.

Concluir o Assistente de integração da Adobe

Para ativar a integração, você deve concluir o assistente de configuração na interface do Data Connectors.
  1. Navegue até a área Data Connectors (anteriormente Genesis) na Adobe Experience Cloud.
  2. Inicie o assistente de integração do Demandbase 2.0.
  3. Escolha o Conjunto de relatórios desejado e forneça um nome para a integração.
  4. Configure os seguintes itens:
Item Descrição
Endereço de email O endereço de email do contato principal.
Descrição (Opcional) Descrição dessa configuração de integração.
Chave da API do Demandbase Obtenha isso do representante do Demandbase.
Dimensão do Demandbase personalizada #N Essas são as IDs das 8 dimensões opcionais. Para obter mais informações, consulte Dimensões personalizadas do Demandbase.
Enviar para o Adobe Target Se "true", as dimensões do Demandbase também serão enviadas para o Adobe Target usando uma mbox oculta.
Observação: um arquivo mbox.js configurado deve ser implementado na página da Web para que as dimensões sejam coletadas.
  1. Configure os itens de Mapeamentos de variável a seguir:
    Item
    Descrição
    Dimensões Demandbase
    Escolha uma variável eVar disponível no conjunto de relatórios.
    Dimensões personalizadas do Demandbase (opcional)
    Escolha uma variável eVar disponível no conjunto de relatórios.
  2. Configure os nomes da Dimensão personalizada (se aplicável).
    1. Se você optou por incluir Dimensões personalizadas na etapa 4 e mapeou a eVar opcional na etapa 5, é necessário fornecer nomes amigáveis para essas dimensões. Por exemplo, se você optar por inserir "stock_ticker" como Dimensão personalizada 1, deverá alterar a caixa que contém "Dimensão 1" para "Cotação de ações".
    2. Não modifique os nomes das dimensões padrão 8 (ou seja, SID Demandbase, Nome da empresa, Setor etc.).
  3. Marque a caixa para que o painel Integração Demandbase seja criado automaticamente para você (recomendado).
  4. Revise todos os itens de configuração e clique em Ativar agora .

Implantação do código de integração

Após concluir o assistente de integração, você deverá implantar o código de integração no código de implantação do Adobe Analytics (s_code).
Se você usou o Adobe TagManager ou o Dynamic Tag Management para implantar o Adobe Analytics, é possível adicionar facilmente o código de integração usando uma dessas ferramentas.
  1. Acesse a guia Suporte e baixe e salve o recurso integration code v2_0_1 da área Recursos da integração.
  2. Se aplicável, faça as modificações necessárias no código. Para obter mais informações, consulte Modificação do código de integração (nesta página).
  3. Inclua o Módulo de integração se ele ainda não estiver presente no código de implantação do Adobe Analytics.
  4. Implante o código usando um dos seguintes métodos:
    • Use o Adobe TagManager ou o Dynamic Tag Management para adicionar o código.
    • Ou forneça o código ao recurso organizacional responsável pela atualização do código de implantação do Adobe Analytics.
Certifique-se de testar a implantação dessa integração em um ambiente de desenvolvimento/preparo antes de implantá-la em um ambiente de produção.

Modificação do código de integração

Na maioria dos casos, não será necessário fazer modificações no código de integração produzido pelo assistente do Data Connector.
No entanto, se você precisar fazer ajustes, algumas das configurações de código são descritas abaixo.
Configuração de código Descrição
s.maxDelay O número máximo de milissegundos que a solicitação de imagem do Adobe Analytics aguardará pelos dados do Demandbase antes de ser acionada para o servidor de coleta do Analytics.
Observação: essa configuração se aplica a todas as integrações que podem estar sendo executadas pelo Módulo de integração.
_db._key Sua chave da API do Demandbase.
_db._apiURL O modelo de URL da API do Demandbase.
_db._delim O delimitador usado para separar os valores de dimensão do Demandbase quando são enviados para o Adobe Analytics. Alterar essa configuração pode fazer com que as Regras de classificação padrão não funcionem corretamente.
_db._setTnt Se true, o código de integração tentará usar uma mbox oculta para enviar as dimensões do Demandbase para o Adobe Target como Parâmetros de perfil.
Observação: isso requer que o código da mbox.js exista na página.
_db._tntVarPrefix Essa cadeia de caracteres é anexada a cada nome de dimensão do Demandbase antes de enviar para o Adobe Target. Por exemplo, se essa configuração tiver o valor "db_", a dimensão "industry" será enviada para o Adobe Target como "db_setor".
_db._dimensionsArray As dimensões padrão do Demandbase enviadas para o Adobe Analytics. É recomendável não modificar essa configuração. A propriedade "max_size" é a quantidade de caracteres permitidos para a dimensão antes que ocorra o truncamento.
_db._dimensionsArrayCustom As dimensões personalizadas do Demandbase enviadas para o Adobe Analytics. A propriedade "max_size" é a quantidade de caracteres permitidos para a dimensão antes que ocorra o truncamento.
_db._cName O nome do cookie de sessão usado para manter o estado da comunicação da API do Demandbase.
_db._contextName O nome da variável contextData usada para enviar as dimensões padrão ao Adobe Analytics. É recomendável não modificar essa configuração.
_db._contextNameCustom O nome da variável contextData usada para enviar as dimensões personalizadas para o Adobe Analytics. É recomendável não modificar essa configuração.

Inclusão o módulo de integração

O código de integração exige que o Módulo de integração exista na implantação do Adobe Analytics.
Se ainda não tiver o Módulo de integração como parte da implantação, complete as etapas a seguir, dependendo do tipo de implementação que tiver.

No AppMeasurement v1.0+

  1. Descompacte o arquivo zip do AppMeasurement baixado em Analytics > Admin > CodeManager .
  2. Abra o arquivo chamado AppMeasurement_Module_Integrate.js.
  3. Copie e cole o conteúdo desse arquivo no arquivo AppMeasurement.js principal.
    Cole-o antes do comentário NÃO ALTERAR NADA ABAIXO DESTA LINHA dentro do arquivo.

No código herdado (código H)

  1. Baixe o Módulo de integração da área "Recursos" na interface do usuário do Data Connectors (na guia Suporte).
  2. Copie e cole o conteúdo desse arquivo no arquivo s_code.
    Cole-o antes do comentário NÃO ALTERAR NADA ABAIXO DESTA LINHA dentro do arquivo.

Verificar a integração

Valide se a integração está capturando dados com êxito ao verificar o rastreamento em tempo real e os relatórios.

Rastreamento em tempo real

Use a ferramenta DigitalPulse Debugger para verificar se os dados de dimensão do Demandbase estão sendo enviados para o Adobe Analytics. Depois de excluir os cookies, recarregue uma página do site na qual o código de integração foi implantado. Supondo que o IP atual mapeie para uma organização reconhecida pelo Demandbase, você deverá ver resultados semelhantes aos seguintes.
O Reports & Analytics (antigo SiteCatalyst) inclui as duas variáveis de dados de contexto do Demandbase:
A Mbox o Target inclui os parâmetros de perfil do Demandbase: você verá isso somente se tiver o Target implementado na página E essa integração estiver configurada para o Adobe Target - consulte a Etapa 4 do Assistente de integração da Adobe.

Relatórios

Consulte os relatórios do Demandbase no Adobe Analytics usando o Painel que foi criado automaticamente para você usando o Assistente de integração da Adobe (Etapa 7).
Como alternativa, navegue até o relatório do Demandbase na estrutura de menu do Adobe Analytics - consulte as capturas de tela abaixo.
Esses dados devem aparecer entre 24 e 48 horas após a implantação bem-sucedida.

Perguntas frequentes

O que significa " #"?
O Demandbase Data Connector indica quando um atributo está "Não disponível" ao configurar esse valor padrão. Há dois cenários comuns em que o padrão é definido:
  • O Demandbase detecta que o visitante vem de um endereço IP que não pertence a uma empresa.
  • É usado um atributo Monitoramento de conta (começando com "watch_list"), mas a empresa não está na lista Monitoramento de conta.
Por que " [n/a] " aparece com mais frequência para determinados atributos?
O Demandbase classifica todos os endereços IP e fornece os atributos audience e audience_segment mesmo quando o visitante não vem de um IP da empresa. Quando o público-alvo retorna valores como "Residencial", "Sem fio" e "Hospitalidade", o restante dos atributos provavelmente não estarão disponíveis.
Às vezes, o público-alvo de um visitante será "SMB", mas outros atributos mostrarão " [n/a] ". Isso significa que o Demandbase pode classificar o visitante como uma pequena empresa, mas o perfil completo da empresa não está disponível. Isso normalmente acontece com as empresas menores, quando mais de uma pequena empresa está usando o mesmo provedor de serviços ou bloco de endereços IP.

Considerações do desenvolvedor

Se precisar ajustar o valor padrão na implementação, atualize a linha:
_db._nonOrgMatchLabel = "[n/a]";