Acompanhamento de conversões

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

Resumo

O acompanhamento de conversões tem como objetivo acompanhar as conversões iniciadas pelo Google em uma das integrações da Central de ações. Isso é vital para manter a integração funcionando e pode influenciar a classificação em determinadas páginas. Sempre que o Google exibe 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, faça o seguinte:

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

Colete e armazene o rwg_token.

Para concluir a integração, você precisa coletar e armazenar o rwg_token por até até 30 dias após a indicação 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 agendamento de horário, 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 seu URL será um token criptografado. Consulte o a seguir, um exemplo de rwg_token. Use este token de amostra para garantir sua análise o token corretamente, incluindo quaisquer caracteres especiais como "=". O seguinte é uma amostra de como será um 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.

Importante: quando um usuário é encaminhado para sua página de reserva pelo Google, se houver um token rwg_token persistente de uma visita anterior, o token anterior será substituído e o período de 30 dias para armazenamento será redefinido. Consulte os requisitos de atribuição de conversões para mais detalhes.

O próximo exemplo é o acompanhamento de conversões no nível do dispositivo, em que esses valores são armazenados 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 nível do dispositivo acompanhamento de conversões, é necessário implementá-lo novamente em todos os (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 do lado do servidor ou outros sistemas do lado do servidor. Como o token seria armazenado no lado do servidor, se o usuário alterar o dispositivo que estão usando, limpam o armazenamento local ou os cookies ou usam um de navegação ou 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 seu sistema, talvez seja possível implementar isso uma vez no lado do servidor e reutilizá-lo em todas as plataformas com suporte.

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 nenhum dado do usuário. Armazene esse token e envie-o de volta como parte do evento de conversão.

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 use isso para identificar e armazenar o comerciante. Recomendamos que você armazene o merchant_id (ou o identificador selecionado) ao lado do rwg_token. Assim, quando um usuário confirmar uma reserva, você poderá consultar o 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ê analisar o comerciante a partir dos metadados no URL fornecido e salvá-lo como um merchant_id ou a correspondência com 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=/";
}

Retorne os valores rwg_token e merchant_change.

Quando um usuário conclui uma reserva iniciada por uma referência de link de ação, é necessário 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 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 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. É uma prática recomendada verificar se um endereço valor de rwg_token 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. É comum mudar os comerciantes se os a página de destino está 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 merchant_change, você vai precisar comerciante original salvo em Coletar e armazenar o comerciante e confirmar que houve alteração. Consulte a tabela a seguir quando atribuindo 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 páginas de reserva o site do comerciante ou 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 concluiu uma transação por meio da entidade Entity original (comerciante).

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 merchants e faça as solicitações em uma janela particular ou anônima para garantir que todos os tokens anteriores associados a esse usuário sejam limpos.

1. Finalize um agendamento 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 de horário do comerciante que está testando e Fazer um novo agendamento sem um rwg_token anexado.
   • Verifique se a solicitação foi enviada com o rwg_token armazenado anteriormente e o valor merchant_change for 2

Se você oferece uma plataforma que permite aos usuários finalizar a compra usando uma comerciante, teste o seguinte:

1. Acesse a página de agendamento de horário do comerciante usando um link com o anexo rwg_token. Em seguida, navegue até outro comerciante e faça uma reserva.
   • 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ê precisa anexar o seguinte token ao seu link de ação ou URL:

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

Use o seguinte token para testes que exigem tokens adicionais.

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

Depois de enviar os eventos de conversão bem-sucedidos, você poderá vê-los agregados na Central de ações, no painel "Acompanhamento de conversões". Lembre-se de que 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 acessa um link de posicionamento de ação e faz um pedido para o mesmo comerciante na mesma sessão. (Valor da mudança do comerciante = 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 posicionamento de ação e faz um pedido em uma na mesma sessão ou em uma sessão diferente no período de 30 dias janela. ( 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 estiver armazenado no nível do usuário (consulte "Como persistir o token"), ele será espera 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. Neste caso, cada dispositivo teria um token separado persistido se o usuário tivesse seguido um link de ação naquele dispositivo, e cada dispositivo seguiria a 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 de modo independente acompanhamento de conversões que você faz nos seus sistemas e não deve afetar análises internas.