Show Menu
TÓPICOS×

Implantação da integração

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

Concluindo o Assistente de integração da Adobe

Para ativar a integração, você deve concluir o assistente de configuração na interface dos Conectores de dados.
  1. Navegue até a área Conectores de dados (anteriormente Genesis) na Adobe Experience Cloud.
  2. Inicie o assistente de integração 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 para esta configuração de integração.
Chave da API Demandbase Você pode obter isso do representante do Demandbase.
Dimensão Demandbase Personalizada #N Essas são as IDs das 8 dimensões opcionais. Para obter mais informações, consulte Dimensões personalizadas da Base de Demanda.
Enviar para o Adobe Target Se "true", as dimensões 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 seguintes itens de Mapeamentos de variável:
    Item
    Descrição
    Dimensões Demandbase
    Escolha uma variável eVar disponível no conjunto de relatórios.
    Dimensões personalizadas Demandbase (opcional)
    Escolha uma variável eVar disponível no conjunto de relatórios.
  2. Configure os nomes para a 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, você deverá alterar a caixa que contém "Dimensão 1" para "Contador de ações".
    2. Não modifique os nomes das dimensões padrão 8 (ou seja, SID demandbase, Nome da empresa, Indústria 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ê deve 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 Gerenciamento dinâmico de tags para implantar o Adobe Analytics, é possível adicionar facilmente o código de integração usando uma dessas ferramentas.
  1. Vá para a guia Suporte e baixe salve o integration code v2_0_1 recurso 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 Gerenciamento dinâmico de tags 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/armazenamento temporário 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 Conector de dados.
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 disparada para o servidor de coleta do Analytics.
Observação: Esta 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 Demandbase.
_db._apiURL O modelo de URL para a API Demandbase.
_db._delim O delimitador usado para separar os valores de dimensão Demandbase quando eles 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 verdadeiro, o código de integração tentará usar uma mbox oculta para enviar as dimensões 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 string é anexada a cada nome de dimensão Demandbase antes de enviar para o Adobe Target. Por exemplo, se essa configuração tiver o valor "db_", a dimensão "setor" será enviada para o Adobe Target como "db_setor".
_db._dimensionArray As dimensões padrão do Demandbase enviadas para o Adobe Analytics. É recomendável que você não modifique essa configuração. A propriedade "max_size" é o número de caracteres permitidos para a dimensão antes que ocorra o truncamento.
_db._dimensionArrayCustom As dimensões personalizadas do Demandbase enviadas para o Adobe Analytics. A propriedade "max_size" é o número 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 Demandbase.
_db._contextName O nome da variável contextData usada para enviar as dimensões padrão ao Adobe Analytics. É recomendável que você não modifique essa configuração.
_db._contextNameCustom O nome da variável contextData usada para enviar as dimensões personalizadas para o Adobe Analytics. É recomendável que você não modifique essa configuração.

Incluindo 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 você ainda não tiver o Módulo de integração como parte de sua implantação, complete as etapas a seguir, dependendo do tipo de implementação que você tiver.

Para AppMeasurement v1.0+

  1. Descompacte o arquivo zip do AppMeasurement que você baixou do Analytics > Admin > CodeManager .
  2. Abra o arquivo nomeado AppMeasurement_Module_Integrate.js.
  3. Copie e cole o conteúdo desse arquivo no seu AppMeasurement.js arquivo principal.
    Cole-o antes de NÃO ALTERAR NADA ABAIXO DESTE comentário de LINHA dentro do arquivo.

Para código herdado (código H)

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

Verificação da integração

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

Acompanhamento ao vivo

Use a ferramenta DigitalPulse Debugger para verificar se os dados de dimensão 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 seu IP atual mapeie para uma organização reconhecida pela Demandbase, você deverá ver resultados semelhantes aos seguintes.
Relatórios e análises (antigo SiteCatalyst) inclui as duas variáveis de dados de contexto Demandbase:
A mbox de destino inclui os parâmetros de perfil 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

Revise seus relatórios de 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, você pode navegar até o relatório 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 Conector de dados Demandbase indica quando um atributo é "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 Account Watch (começando com "watch_list"), mas a empresa não está na lista Account Watch.
Por que " [n/a] " aparece com mais frequência para determinados atributos?
A 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 a 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 você precisar ajustar o valor padrão em sua implementação, atualize a linha:
_db._nonOrgMatchLabel = "[n/a]";