Vincular um anunciante do Search Ads 360 ao Adobe Analytics

A Adobe anunciou que pretende descontinuar o suporte ao OAuth 1.4 em 18 de agosto de 2021. Para evitar problemas com o Search Ads 360, os anunciantes que usam o OAuth 1.4 na integração com o Adobe Analytics precisam adotar o Adobe JWT para autenticação antes que o OAuth 1.4 seja descontinuado.

 

Embora os anunciantes que usam o OAuth 2.0 na integração com o Adobe Analytics não sejam afetados pela descontinuação do OAuth 1.4, recomendamos que todos migrem para o Adobe JWT se quiserem ter uma melhor experiência de autenticação.

Antes de começar

Configurações compartilhadas do Floodlight

Caso seu anunciante do Search Ads 360 faça parte de uma configuração compartilhada do Floodlight, somente o anunciante pai poderá ser vinculado ao Adobe Analytics. Isso ocorre porque só é possível criar atividades do Floodlight diretamente do pai. Todos os anunciantes filhos têm acesso às atividades do Floodlight criadas no anunciante pai.

No Search Ads 360, faça login no anunciante associado ao anunciante pai do Campaign Manager 360 e vincule-o ao Adobe Analytics.Você precisará das permissões de gerente de agência ou de anunciante para esse anunciante do Search Ads 360.

Se o anunciante pai do Campaign Manager 360 não estiver vinculado a um anunciante do Search Ads 360, faça o seguinte:

1. Crie um anunciante do Search Ads 360 e vincule-o ao anunciante pai do Campaign Manager 360.
   Saiba mais sobre as permissões necessárias para concluir essa etapa.
   
   O anunciante do Search Ads 360 que você criar não afetará os anunciantes filhos. É possível ignorar o anunciante depois de vincular ao Adobe Analytics.
    
2. Associe o novo anunciante do Search Ads 360 ao Adobe Analytics, conforme descrito abaixo.

Dois parâmetros de URL serão adicionados a todas as páginas de destino

Verifique se as páginas de destino processam a adição de dois parâmetros de URL: gclid e gclsrc. Quando você ativar a API Conversion, o Search Ads 360 anexará automaticamente os parâmetros gclid e gclsrc a todos os URLs das páginas de destino do anunciante. Saiba como esses parâmetros podem afetar outros parâmetros ou fragmentos de URL.

Associar um anunciante ao Adobe Analytics

O Search Ads 360 é compatível com os seguintes métodos de autorização ao vincular um anunciante ao Adobe Analytics.

• Adobe JWT (novo método de autorização). Recomendado para todos os anunciantes. Obrigatório para anunciantes que atualmente usam OAuth 1.4 e que estão configurando a integração do Adobe Analytics pela primeira vez.
• OAuth 2.0 (método clássico de autorização). Disponível apenas para anunciantes que estão usando este método de autorização.

Como vincular um anunciante ao Adobe Analytics com o Adobe JWT (novo método de autorização)

Se você estiver usando o OAuth 2.0 (método de autorização clássico), recomendamos migrar para o Adobe JWT (novo método de autorização) para uma melhor experiência. Para configurar a integração do Adobe Analytics pela primeira vez, use o JWT. Além disso, se você já usa o OAuth 1.4, mude para o JWT antes que a Adobe descontinue o OAuth 1.4.

Este é o processo geral de vinculação de um anunciante (veja mais detalhes em outras seções deste artigo):

1. Crie uma integração da conta de serviço (JWT) no Adobe Developer Console. O Search Ads 360 usará essa integração para receber autorização para o download de dados do Adobe Analytics.
2. No Search Ads 360, ative a API Conversion e a integração do Adobe Analytics (JWT).

Crie uma integração da conta de serviço (JWT) no Adobe Developer Console.

1. Faça login no Adobe Developer Console.
2. Siga as instruções no site da Adobe para Adicionar a API ao projeto usando a conta de serviço (JWT).
   1. Na etapa "Add an API", clique em Adobe Analytics.
   2. Na etapa "Configure API", clique em Service Account (JWT).
   3. Na etapa "Create a new service account (JWT) credential", clique em Option 1: Generate a key pair. Uma pasta config será salva no computador. Nela, haverá um arquivo chamado private.key. Você precisará das informações do arquivo mais adiante, ao inserir suas credenciais do Adobe Developer Console no Search Ads 360.
3. Após adicionar a API, clique no seu projeto no Adobe Developer Console e verifique se a API Adobe Analytics aparece em "Products & services".
   
    
   Verifique se o usuário que criou a integração com o JWT e a chave privada no Adobe Developer Console tem permissão para acessar os conjuntos de relatórios e as eVars que você gostaria que o Search Ads 360 importasse. Se o usuário que criar as credenciais no Adobe Developer Console não tiver as permissões adequadas, a integração do Search Ads 360 não terá acesso aos conjuntos de relatórios e às eVars da Adobe. O ideal é que o usuário que cria as credenciais da Adobe tenha permissões de administrador do sistema. No entanto, em alguns casos, as permissões da API de serviços da Web podem ser suficientes. Saiba mais.
4. No menu de navegação à esquerda, em "Credentials", clique em Service Account (JWT) para ver os seguintes detalhes de credenciais que você precisará copiar para o Search Ads 360:
   • Client ID
   • Client Secret
   • Technical Account ID
   • Organization ID

Ativar a API de conversão e a integração com o Adobe Analytics (JWT)

Permissões especiais necessárias

No Search Ads 360, sua Conta do Google precisa ter permissão de gerente de agência ou de anunciante.

Como ativar a integração

1. No Search Ads 360, acesse um anunciante.

   Etapas para acessar um anunciante

   1. Clique na barra de navegação para exibir as opções de navegação.

   2. Na lista Agência, clique na agência que inclui o anunciante. É possível pesquisar por nome ou usar a barra de rolagem para procurar na lista.

   3. Na lista Anunciante, clique no anunciante.

   4. Clique em Aplicar ou pressione a tecla Enter.

   O Search Ads 360 exibe a página do anunciante, que contém dados de todas as contas de mecanismo dele.

2. No painel de navegação à esquerda, clique em Configurações do anunciante.
   
   Não encontrou as "Configurações do anunciante"? Somente os gerentes de agência ou de anunciante do Search Ads 360 têm acesso às configurações do anunciante no painel de navegação à esquerda.

3. Ative a API Conversion. Isso é necessário para acionar o suporte do Adobe Analytics:

   1. Clique na guia Integrações▼ e selecione API de conversão.

   2. Alterne a opção Conversion API para Ativada.

   3. Clique em Salvar.

4. Vincule o Search Ads 360 a uma propriedade do Adobe Analytics:

   1. Clique na guia Integrações▼ e selecione Integração com o Adobe Analytics.

   2. Ao lado dessa integração, clique no ícone de configurações .

   3. Alterne Integração com o Adobe Analytics para Ativada.

   4. Se você usa o OAuth 2.0 atualmente e quer mudar para o JWT, clique em Novo método de autorização.
      Os anunciantes que estão configurando a integração do Adobe Analytics pela primeira vez precisam usar o JWT para não verem as opções "Novo método de autorização" ou "Método de autorização clássico". Além disso, os anunciantes que atualmente usam o OAuth 1.4 precisam mudar para o JWT. As opções "New authorization method" e "Classic authorization method" também não aparecerão para eles.

   5. Em ID do cliente, insira a informação que está em Client ID do Adobe Developer Console.

   6. Em Chave secreta do cliente, insira o conteúdo do campo Client Secret do Adobe Developer Console.

   7. Em Nome da empresa ou organização, insira o nome da sua empresa ou organização.

   8. Em ID da organização, insira a informação de Organization ID do Adobe Developer Console.

   9. Em ID da conta técnica, insira a informação de Technical Account ID do Adobe Developer Console.

   10. Em Chave privada, insira a informação do arquivo private.key que você baixou do Adobe Developer Console. Ao copiar as informações de private.key, não inclua a primeira linha (-----BEGIN PRIVATE KEY----) nem a última (-----END PRIVATE KEY-----).

   11. Clique em Salvar.

   12. Depois de ver a confirmação da autorização, feche a janela e clique em Salvar.

O Search Ads 360 começa a se conectar com sua integração do Adobe Developer Console. Quando isso ocorrer, o painel de edição será fechado, e uma observação aparecerá na central de notificações.

Se a conexão não funcionar, o painel de edição exibirá uma mensagem de erro. Verifique se você inseriu o ID e o secret do cliente corretos.

 

Próximas etapas

Adicione conjuntos de relatórios ao Search Ads 360.
After you link to Adobe Analytics, Search Ads 360 needs time to retrieve the list of report suites and report metrics you have access to.