Acompanhamento de conversões

.

Implementação

Resumo

A implementação do acompanhamento de conversões tem três partes:

  1. Como coletar o rwg_token da página de destino / ponto de entrada do aplicativo.
  2. Como persistir o rwg_token para a janela de atribuição apropriada
  3. Enviar um evento de conversão na finalização da compra

Essa implementação de acompanhamento de conversões não requer o uso de Google Analytics ou qualquer outro JavaScript de terceiros.

Antes de começar a implementar o acompanhamento de conversões, decida Se você for acompanhar conversões no nível do dispositivo ou do usuário:

  • O nível do dispositivo inclui o uso de cookies do navegador, armazenamento local do app ou qualquer outro método que possa persistir o token para a janela de atribuição de 30 dias. Como o token seriam armazenados localmente no dispositivo do usuário, se ele mudar o dispositivo que está usando, limpa os cookies/armazenamento local; ou está usando uma navegação privada ou o modo de navegação anônima, o evento de conversão podem não ser atribuídos corretamente. Ao usar o nível do dispositivo acompanhamento de conversões, é necessário reimplementá-lo em todas compatível (incluindo dispositivos móveis).
  • O nível do usuário inclui a persistência no aplicativo por um sistema de análise do lado do servidor ou outros do lado do servidor. Como o token seria armazenado lado do servidor, se o usuário alterar o dispositivo que está usando, limpa seus cookies/armazenamento local, ou usam um navegador privado ou no modo de navegação anônima, o evento de conversão ainda será atribuído uma vez o usuário fizer login novamente. Ao usar o acompanhamento de conversões no nível do usuário, dependendo da arquitetura do sistema, será possível implementá-los uma vez no servidor e reutilizá-los e plataformas compatíveis.

Como coletar o rwg_token

Sempre que o Google mostra um action_link que você forneceu pelo os feeds, esse URL será modificado para incluir uma consulta exclusiva parâmetro: rwg_token. O rwg_token é uma string codificada que contém alguns metadados sobre o link em que o usuário clicou. Você armazenará esse token e o enviará de volta como do evento de conversão.

Em cada página de destino / ponto de entrada do app, você precisa analisar o conjunto de valores para o parâmetro de consulta rwg_token e armazene-o. Requisitos para como armazenar esse parâmetro, são descritos na etapa Manter os rwg_token.

Um exemplo de como esse token pode ser analisado para rastreamento no nível do dispositivo por meio de do navegador está incluído abaixo. Como alternativa, colete esse token do lado do servidor ao responder à solicitação: 

<script>
  var query = location.search.substring(1);
  var params = query.split('&');
  var rwgToken = undefined;
  for (var i = 0; i < params.length; ++i) {
    var pair = params[i].split('=');
    if (pair[0] == 'rwg_token') {
      rwgToken = decodeURIComponent(pair[1]);
      break;
    }
  }
</script>

Como manter o rwg_token

Será necessário manter o parâmetro de URL rwg_token, que será anexado a todos os links de ação fornecidos por você, para um total de 30 dias. O valor do rwg_token precisa ser armazenados e devolvidos sem edições. Se houver um token de um acesso anterior, o o token antigo deve ser substituído, e o período de 30 dias para armazenamento deve ser redefinida.

Ao manter o token, você pode armazená-lo na do dispositivo ou do usuário:

  • O nível do dispositivo inclui o uso de cookies do navegador, armazenamento local, armazenamento local do app ou qualquer outro método que possa manter o token para a janela de atribuição de 30 dias.
  • O nível do usuário inclui a persistência no banco de dados do aplicativo, por um sistema de análise do lado do servidor ou outros sistemas do lado do servidor.

Confira abaixo um exemplo de acompanhamento de conversões do dispositivo. armazenar esse token em um navegador da Web por meio de uma cookie de terceiros. Este exemplo pressupõe que você analisou o valor do token em uma variável, como no exemplo acima. Para usar este exemplo, você precisa atualizar o "rootdomain" para seu domínio. 

<script>
  if (typeof rwg_token !== 'undefined') {
    document.cookie =
    "_rwg_token=" + rwg_token + ";max-age=2592000;domain=rootdomain.com;path=/";
  }
</script>

Ao usar o acompanhamento de conversões no nível do usuário, o rwg_token precisa: armazenados no servidor e associados ao usuário.

Enviar dados de conversão

Quando um usuário conclui uma transação que pode ser atribuída a um link de ação do Google Place, envie uma solicitação POST HTTP ao endpoint de conversão. Há dois endpoints, um para a produção e outro para o ambiente de sandbox.

  • Produção: https://www.google.com/maps/conversion/collect
  • Sandbox: https://www.google.com/maps/conversion/debug/collect

O corpo da postagem precisa ser um objeto codificado em JSON no formato: 

{
  'conversion_partner_id': partnerId,
  'rwg_token': <rwg_token_val>
}

Nos ambientes de sandbox e de produção, será solicitado que você informar um rwg_token válido ao enviar um evento de conversão. Para fins de teste no ambiente de sandbox, você pode usar os seguintes token de teste. 

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Um exemplo completo de acompanhamento de conversões no nível do dispositivo (usando um cookie em no dispositivo do usuário) em JavaScript sobre como fazer essa solicitação de postagem é incluído abaixo: 

const partnerId = XXXXXXXXXX;
const endpoint = `https://www.google.com/maps/conversion/collect`;

const rwgTokenCookie = document.cookie
  .split('; ')
  .find(row => row.startsWith('_rwg_token='));

if (typeof rwgTokenCookie !== 'undefined') {
  const rwgTokenVal = rwgTokenCookie.split('=')[1];
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: rwgTokenVal
    })
  });
}

Ao usar o acompanhamento de conversões no nível do usuário, você deverá recuperar o valor token associado ao usuário (independentemente da superfície estão ativadas) do mecanismo de armazenamento do lado do servidor e envie usando os mesmos endpoints de produção ou sandbox.

Requisitos de atribuição de conversão

O padrão exigido do Google para atribuição de conversão é um prazo de 30 dias janela de atribuição para qualquer interação com um link de lugar, a qualquer loja on-line.

Esta janela de atribuição significa que esperamos uma conversão seja enviado em qualquer um dos seguintes cenários:

  • Um usuário segue um link de posicionamento de ação e faz um pedido no mesma sessão
  • Um usuário segue um link de posicionamento de ação e retorna de uma canal diferente no período de 30 dias para fazer um pedido.
  • Um usuário segue um link de posicionamento de ação e faz um pedido em uma em uma loja diferente, seja na mesma sessão em um período de 30 dias.

Além disso, esperamos que os eventos de conversão sejam enviados de todas plataformas em que um usuário pode acessar a partir de um link de ação de lugar. como:

  • Aplicativos da Web para computadores ou dispositivos móveis
  • Aplicativos móveis, seja por meio de um link direto de aplicativo ou um registro app-intent para seu domínio

Se o token estiver armazenado no nível do usuário (consulte Como manter o token), espera-se que você forneça a atribuição entre dispositivos. Ou seja, um usuário que segue um link de ação na área de trabalho e conclui a transação em um dispositivo móvel (usando a mesma conta de usuário), deve ser acionada um evento de conversão.

Se o token for armazenado exclusivamente no nível do dispositivo, como em cookies do navegador, não é esperado que você forneça informações atribuição. Nesse caso, cada dispositivo teria um token separado persistiu se o usuário tivesse seguido um link de ação nesse dispositivo e cada dispositivo seguiria as regras de atribuição separadamente.