Acompanhamento de conversões

Figura 1: visão geral do acompanhamento de conversões

Resumo

O acompanhamento de conversões é usado para acompanhar as conversões iniciadas pelo Google por meio de uma das nossas integrações do Action Center. Isso é vital para manter a integração funcionando e pode influenciar a classificação em determinadas páginas. Sempre que o Google mostra um action_link, esse URL é modificado para incluir um parâmetro de consulta exclusivo: rwg_token. Cabe a você armazenar esse token e retornar os valores apropriados quando um usuário concluir uma reserva.

Para concluir a integração, você precisa fazer o seguinte:

1. Colete e armazene o rwg_token.
2. Colete e armazene o comerciante.
3. Retorna os valores rwg_token e merchant_change.
4. Teste e verifique o acompanhamento de conversões.

Colete e armazene o rwg_token.

Para concluir essa integração, você precisa coletar e armazenar o rwg_token por até 30 dias após a referência inicial do Google. O valor rwg_token é uma string codificada que contém alguns metadados sobre o link e o comerciante que gerou esse link de ação. É importante observar que nenhum dado do usuário é armazenado ou criptografado no token.

Coleta de tokens

Quando um usuário é direcionado à sua página de agendamento, um novo parâmetro de consulta, rwg_token, é anexado ao URL fornecido. Na página de reserva, você precisa analisar o valor. Um exemplo de como esse token pode ser analisado para rastreamento no nível do dispositivo pelo navegador está incluído.

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;
  }
}

O parâmetro de consulta anexado ao URL será um token criptografado. Confira o exemplo a seguir de um rwg_token. Use este token de exemplo para garantir que ele seja analisado corretamente, incluindo caracteres especiais, como "=". Confira abaixo um exemplo de token típico.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Armazenamento de tokens

Ao armazenar o rwg_token, há dois níveis diferentes em que você pode implementar o acompanhamento de conversões: no nível do dispositivo e do usuário. Onde você decide armazenar o token é sua decisão, mas você precisa armazenar o token por 30 dias desde a referência inicial.

O próximo exemplo é o acompanhamento de conversões no nível do dispositivo, que armazena esses valores em um navegador da Web usando um cookie primário. Neste exemplo, presumimos que você tenha analisado o valor do token em uma variável, como no exemplo de armazenamento de tokens. Atualize rootdomain.com com seu domínio.

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

Considere o seguinte ao decidir onde armazenar o rwg_token.

Armazenamento no nível do dispositivo

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 por 30 dias. Como o token é armazenado localmente no dispositivo do usuário, se ele mudar o dispositivo que está usando, limpar o armazenamento local ou os cookies ou usar um modo de navegação anônima ou privada, o evento de conversão pode não ser atribuído corretamente. Ao usar o acompanhamento de conversões no nível do dispositivo, você precisa reimplementar esse recurso em todas as plataformas compatíveis, incluindo dispositivos móveis.

Armazenamento no nível do usuário

O nível do usuário inclui a persistência no banco de dados do aplicativo por meio de um sistema de análise no servidor ou outros sistemas no servidor. Como o token seria armazenado no lado do servidor, se o usuário mudar o dispositivo que está usando, limpar o armazenamento local ou cookies ou usar um modo de navegação particular ou anônimo, o evento de conversão ainda será atribuído quando o usuário fizer login novamente. Ao usar o acompanhamento de conversões no nível do usuário, dependendo da arquitetura do seu sistema, você poderá implementá-lo uma vez no lado do servidor e reutilizá-lo em todas as plataformas compatíveis.

Sempre que o Google mostra um action_link que você forneceu nos feeds, esse URL é modificado para incluir um parâmetro de consulta exclusivo: rwg_token. O valor rwg_token é uma string codificada que contém alguns metadados sobre o link em que o usuário clicou, mas sem dados do usuário. Armazene esse token e envie-o de volta como parte do evento de conversão.

Atualizar o token

Quando um usuário é indicado pelo Google para o mesmo comerciante, se um token existente for armazenado, ele será substituído pelo novo token da indicação mais recente. Quando o token é substituído, o período de 30 dias do armazenamento de token é redefinido e todas as novas conversões desse comerciante são atribuídas ao token mais recente.

Consulte os requisitos de atribuição de conversão para mais detalhes.

Colete e armazene o comerciante.

Quando um usuário é direcionado para sua página de reserva, você precisa implementar uma lógica que encontra e captura o comerciante. Normalmente, os parceiros adicionam metadados do comerciante ou merchant_id aos links de ação e usam isso para identificar e armazenar o comerciante. Recomendamos armazenar o merchant_id (ou o identificador selecionado) com o rwg_token para que, quando um usuário confirmar uma reserva, você possa se referir ao comerciante antes de enviar a solicitação de conversão concluída. Assim como na janela de armazenamento de tokens, o comerciante precisa ser salvo com o token por 30 dias após a referência inicial.

Os exemplos a seguir ajustam o rwg_token armazenado anteriormente. Isso pressupõe que você esteja analisando o comerciante a partir dos metadados no URL fornecido e salvando-o como merchant_id ou correspondendo-o a um merchant_id existente.

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

Retorna os valores rwg_token e merchant_change.

Quando um usuário concluir uma reserva iniciada por uma referência de link de ação, você precisará enviar uma solicitação HTTP POST para o endpoint de conversão. Há dois endpoints, um para o ambiente de 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

Ao enviar um evento de conversão, é necessário incluir o rwg_token armazenado e um valor merchant_change de 1 ou 2. Para mais detalhes sobre merchant_change, consulte Retornar o valor da mudança do comerciante.

O corpo do POST precisa ser um objeto codificado em JSON no formato:

{
  "conversion_partner_id": "<partnerId>",
  "rwg_token": "<rwg_token_val>",
  "merchant_changed": "1|2"
}

{
  "conversion_partner_id": "XXXXXXX",
  "rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==",
  "merchant_changed": "2"
}

O próximo exemplo inclui o acompanhamento de conversões no nível do dispositivo usando um cookie no dispositivo do usuário, escrito em JavaScript:

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,
      merchant_changed: merchantChanged
    })
  });
}

Atenção: o único tipo de conteúdo MIME aceito é text/plain. Não defina nenhum outro Content-Type no cabeçalho. Se você fizer isso, vai receber um erro CORS.

Aviso: como parte dos dados de conversão, verifique se as informações de identificação pessoal (PII) do usuário não são enviadas ao Google.

Observação: na produção, não envie eventos de conversão que não sejam atribuídos a essa integração. É recomendável verificar se há um valor rwg_token válido e não expirado antes de enviar o evento.

Retornar o valor da mudança do comerciante

O valor merchant_changed é usado para determinar se o comerciante foi alterado em relação ao comerciante de redirecionamento inicial. A troca de comerciantes é comum se a página de destino estiver em uma plataforma que inclui outros comerciantes. Nesse caso, se um usuário foi encaminhado para sua plataforma pelo Google e decidiu navegar para um comerciante diferente e concluir uma reserva, queremos saber que uma conversão aconteceu, mas com um comerciante diferente. Não precisamos saber o comerciante, apenas que um evento de conversão ocorreu e o comerciante era diferente. Usamos um booleano para identificar se um comerciante mudou ou não.

Ao decidir qual valor atribuir a merchant_change, você precisa pegar o comerciante original salvo em Coletar e armazenar o comerciante e verificar se o comerciante mudou. Em seguida, consulte a tabela a seguir ao atribuir o valor.

Se a página de reserva não estiver em uma plataforma ou se os usuários não conseguirem navegar para um comerciante diferente, você poderá codificar o valor dessas solicitações em 2. Isso é comum para parceiros que integram as páginas de reserva ao site do comerciante ou têm páginas de destino personalizadas para processar reservas.

Valor da mudança do comerciante	Requisito
1	Esse valor deve ser usado quando um usuário sai do site do comerciante original e faz uma compra pela sua plataforma com um comerciante diferente.
2	Esse valor deve ser usado quando o cliente concluir uma transação pela entidade original (merchant).

Teste e verifique o acompanhamento de conversões.

Para garantir que a implementação do acompanhamento de conversões está correta, você vai precisar executar o teste a seguir. Use links de ação vinculados aos seus comerciantes e faça as solicitações em uma janela anônima ou privada para garantir que todos os tokens anteriores associados a esse usuário sejam excluídos.

1. Concluir uma reserva usando apenas um link de ação
   • As reservas diretas sem referência ou tokens armazenados anteriores não devem resultar em nenhuma solicitação enviada ao Google.
2. Concluir uma reserva usando um link com um rwg_token anexado.
   • Verifique se a solicitação foi bem-sucedida e enviada com o valor rwg_token e merchant_change de 2.
   • Armazene o rwg_token por 30 dias
3. Conclua um novo agendamento com o mesmo comerciante usando um novo rwg_token.
   • Verifique se a solicitação foi bem-sucedida e enviada com o novo valor de rwg_token e merchant_change de 2.
   • Verifique se a janela de armazenamento de atribuição do token é atualizada por 30 dias.
4. Acesse diretamente a página de agendamento do comerciante que você está testando e faça um novo agendamento sem um rwg_token anexado.
   • Verifique se a solicitação é enviada com o rwg_token armazenado anteriormente e se o valor de merchant_change é 2.

Se você tiver uma plataforma que permite que os usuários concluam a compra usando um comerciante diferente, teste o seguinte.

1. Acesse a página de agendamento do comerciante usando um link com um rwg_token anexado, em seguida, navegue até outro comerciante e faça um agendamento.
   • Verifique se a solicitação é enviada com o valor rwg_token e merchant_change de 1.

Ao testar, envie a solicitação HTTP POST para o endpoint de conversão. Há dois endpoints, um para o ambiente de 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

Você vai precisar anexar o seguinte token ao seu link de ação ou URL:

rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D

Use o token abaixo para testes que exigem tokens adicionais.

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

Depois de enviar os eventos de conversão bem-sucedidos, eles vão aparecer agregados na Central de ações, no painel de acompanhamento de conversões. As conversões podem levar até uma hora para aparecer no painel.

Requisitos de atribuição de conversões

O padrão exigido pelo Google para atribuição de conversões é uma janela de atribuição de 30 dias para qualquer interação com um link de lugar em qualquer loja.

Essa janela de atribuição significa que o Google espera que um evento de conversão seja enviado em qualquer um dos seguintes cenários:

• Um usuário clica em um link de ação de lugar e faz um pedido para o mesmo comerciante na mesma sessão. (Merchant Change Value = 2 )
• Um usuário segue um link de ação de lugar e retorna de um canal diferente no período de 30 dias para fazer um pedido para o mesmo comerciante. (Merchant Change Value = 2 )
• Um usuário segue um link de ação de lugar e faz um pedido em uma loja diferente, seja na mesma sessão ou em uma diferente dentro de uma janela de 30 dias. ( Merchant Change Value = 1 )

Além disso, o Google espera que os eventos de conversão sejam enviados de todas as plataformas que um usuário pode acessar por um link de posicionamento de ação. como:

• Aplicativos da Web para computador ou dispositivos móveis
• Apps para dispositivos móveis, por um link direto de app ou uma intent de app registrada para seu domínio

Se o token for armazenado no nível do usuário (consulte a seção "Persistência do token"), é esperado que você forneça a atribuição entre dispositivos. Ou seja, um usuário que segue um link de ação no computador e depois conclui a transação em um dispositivo móvel (usando a mesma conta de usuário) precisa acionar um evento de conversão.

Se o token for armazenado exclusivamente no nível do dispositivo, como em cookies do navegador, não será possível fornecer atribuição entre dispositivos. Nesse caso, cada dispositivo teria um token separado se o usuário tivesse seguido um link de ação nesse dispositivo, e cada dispositivo seguiria as regras de atribuição separadamente.

Observação: esse modelo de atribuição pode ser diferente da forma como seu sistema de análise atribui conversões. Esse sistema foi projetado para operar independentemente de qualquer acompanhamento de conversões que você esteja fazendo nos seus sistemas e não afetar sua análise interna.