Acompanhamento de conversões

Resumo

O acompanhamento de conversões tem como objetivo 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ê vai armazenar o token é uma decisão sua, mas ele precisa ser armazenado 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 seria 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 os cookies ou estiver usando 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á implementar isso 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, é necessário 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
    })
  });
}

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 mudança 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 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.

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 limpos.

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, em seguida, 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 a 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.