Visão geral
A implementação do acompanhamento de conversões consiste em duas partes: armazenamento e retorno de rwg_token. Eles permanecem os mesmos, mas para estar em conformidade com o acompanhamento de conversões v2, agora você precisa retornar um novo valor: merchant_change.
Mudanças na persistência do token
Ao manter o token, agora você precisará armazenar o comerciante associado ao link de ação. Isso geralmente é feito fazendo a correspondência entre o comerciante e o merchant_id correspondente.
Confira a seguir um exemplo de acompanhamento de conversões no nível do dispositivo em que esses valores são armazenados em um navegador da Web usando um cookie próprio. Neste exemplo, presumimos que você analisou o valor do token em uma variável e implementou uma lógica que armazena o merchant_id. Para usar este exemplo, você precisa atualizar rootdomain com seu domínio. Essa abordagem sugerida pode não funcionar para todos. Por isso, os parceiros podem ajustar ou implementar a própria lógica como quiserem.
<script>
if (typeof rwg_token !== 'undefined') {
merchant_id = // Write your own logic here assigning the merchant id value
document.cookie =
"_rwg_token=" + rwg_token + ";_merchant_id=" + merchantid + ";max-age=2592000;domain=rootdomain.com;path=/";
}
</script>
Alterações no envio de dados de conversão
Quando um usuário conclui um evento de conversão, o corpo da postagem precisa ser um objeto codificado em JSON com um novo valor booleano merchant_change.
{
"conversion_partner_id": <partnerId>,
"rwg_token": <rwg_token_val>
"merchant_changed": 1|2
}
O merchant_id armazenado anteriormente é usado para determinar se o comerciante que acionou o evento de conversão é diferente do comerciante original. Depois de determinar se o comerciante mudou, retorne o valor merchant_change apropriado usando a tabela a seguir.
| Valor de mudança do comerciante | Requisito |
|---|---|
| 1 | Use esse valor quando um usuário sair do site do comerciante original e concluir uma compra na sua plataforma com outro comerciante |
| 2 | Esse valor deve ser usado quando o cliente conclui uma transação pela entidade (Merchant) original. |
É necessário informar um rwg_token válido ao enviar um evento de conversão.
Para fins de teste, use o seguinte token de teste nos dois ambientes até
que esteja pronto para o lançamento:
ADQ7psRE9YyDSVR6YpfD-fYdxoFYVKS1xeTvXdSxqF8a3bnk0W62eMEnUjoNPwjhNHG0elwBnM1awTjr9vXET8yOowCeuODjwA==
Ao fazer a solicitação, use os seguintes endpoints que correspondem ao seu ambiente:
- Produção: https://www.google.com/maps/conversion/collect
- Sandbox: https://www.google.com/maps/conversion/debug/collect
Requisitos da atribuição de conversões
O padrão obrigatório do Google para a 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 segue 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 dentro do prazo de 30 dias para fazer um pedido para o mesmo comerciante. ( Valor de alteração do comerciante = 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 outra sessão em um período de 30 dias. ( Valor de alteração do comerciante = 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 usando um link de ação de lugar. Incluindo:
- Aplicativos da Web para computadores ou dispositivos móveis
- Apps para dispositivos móveis, seja por um link direto ou uma intent de app registrada para seu domínio.
Se o token estiver armazenado no nível do usuário (consulte "Como manter o 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 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 é armazenado exclusivamente no nível do dispositivo, como em cookies do navegador, não é esperado que você forneça a atribuição em dispositivos diferentes. Nesse caso, cada dispositivo teria um token separado persistido caso o usuário tivesse seguido um link de ação nesse dispositivo, e cada dispositivo seguiria as regras de atribuição separadamente.