Script Tracking Client-Side
Introdução
Graças à implementação do nosso script de tracking de conversões, o Click2Buy é capaz de recolher as vendas validadas geradas pelos utilizadores provenientes da nossa solução.
Este tracking permite às marcas medir com precisão o ROI do tráfego direcionado para os websites dos retalhistas através da solução Click2Buy Where to Buy.
Para configurar o tracking, vai precisar da sua Retailer Key, que será fornecida pelo seu Gestor de Conta Retalhista da Click2Buy. Este identificador será utilizado nos dois métodos de implementação disponíveis.
Estão disponíveis dois métodos de implementação:
🏷️ Via Google Tag Manager
Recomendado — o método mais simples e rápido de implementar.
💻 Via implementação nativa
Integração direta no código do website.
Implementação via Google Tag Manager
Desenvolvemos um template oficial do Google Tag Manager que permite uma implementação simples do tracking de conversões Click2Buy. Este template permite aos retalhistas configurar o tracking sem necessidade de escrever código personalizado. Para instalar a tag, basta consultar a nossa documentação no GitHub, que inclui:
- instruções detalhadas de instalação
- o ficheiro de template para importar no Google Tag Manager
- os passos necessários para configurar a tag
Durante a configuração da tag, só precisará de introduzir a sua Retailer Key, que será fornecida pelo seu contacto Click2Buy.
👉 Toda a documentação e ficheiros necessários estão disponíveis aqui: https://github.com/Click2Buy/gtm-web-template/tree/master?tab=readme-ov-file
Implementação Nativa (código direto)
Este guia descreve o método de implementação do nosso tag que permitirá recuperar a validação da venda e o conteúdo do carrinho. Para isso, será necessário executar um código específico na página de sucesso/confirmação com o conteúdo do pedido.
Quando a página de confirmação do pedido for carregada, será necessário carregar o seguinte script:
<!-- Click2Buy retailer script -->
<script>
(function(i,s,o,g,r,a,m){i[r]=i[r]||{q:[],validationProcess:function(){
i[r].q.push(arguments)}};a=s.createElement(o);m=s.getElementsByTagName(o)[0];
a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://rs.clic2buy.com/retailers/__KEY_RETAILER__.js','C2B');
C2B.validationProcess(__PARAMS__);
</script>KEY_RETAILER representa o ID que lhe foi fornecido pelo seu contacto Click2Buy.
PARAMS deve ser substituído pelas informações do pedido de acordo com o formato abaixo (ou de acordo com o seu datalayer).
Parâmetros da função C2B.validationProcess
A função deve receber como parâmetros um objeto com os seguintes campos:
| Campo | Tipo de valor | Obrigatório | Descrição |
|---|---|---|---|
totalAmount | Number | Sim | Valor total do carrinho |
currency | String | Sim | Moeda do carrinho (ISO4217) |
products | Array | Sim | Tabela contendo um objeto por produto do pedido - o formato é detalhado abaixo |
Campos dos objetos de produto
| Campo | Tipo de valor | Obrigatório | Descrição |
|---|---|---|---|
ean | String | Sim | Código EAN-13 do produto |
upc | String | Não | Código UPC do produto |
retailerReference | String | Sim | Referência do produto, específica do retalhista |
amount | Number | Sim | Preço unitário do produto |
quantity | Number | Sim | Quantidade do produto |
name | String | Sim | Nome do produto |
packaging | String | Não | Embalagem do produto |
brand | String | Sim | Marca do produto |
manufacturerReference | String | Não | Referência do produto (específica da marca) |
metadata | JSON | Não | Outros dados úteis do produto (estrutura livre) |
Para valorizar estes dados, precisaremos de ter pelo menos o código EAN ou UPC do produto. Se não tiver esta informação, pode enviar-nos a sua referência interna (retailerReference).
N.B.: Se não conseguir fornecer alguns campos, pode deixá-los vazios. Se a sua configuração exigir um valor para cada campo, pode usar "null" como variável padrão.
⚠️ Atenção : Ao copiar e colar o script em determinados editores de texto, as aspas (" ") podem ser automaticamente modificadas. Certifique-se de que estão corretamente formatadas para evitar erros na execução do script.
Domínios a colocar na lista de permissões
A nossa tag utiliza múltiplos subdomínios para funcionar corretamente. Se a sua política de segurança bloqueia o carregamento de scripts externos, é necessário autorizar os seguintes domínios.
Pode autorizar:
- *.clic2buy.com
- *.clic2drive.com
- *.click2buy.com
Ou autorizar os seguintes domínios específicos:
rs.clic2buy.com (obrigatório) Domínio onde o script de tracking está alojado.
t.clic2buy.com (obrigatório) Domínio utilizado para os nossos cookies de terceiros. Permite recuperar o ID anónimo atribuído aos utilizadores da nossa solução no seu site.
analytics.clic2drive.com (obrigatório) Domínio que permite recuperar as informações do carrinho através do ID do utilizador e registar a validação da venda.
Dados recolhidos
A nossa tag apenas recolhe confirmações de carrinho provenientes de redirecionamentos Click2Buy.
Nenhum dado pessoal é recolhido.
Quando um utilizador chega ao site do retalhista através da solução Where to Buy, é criado um cookie anónimo para identificar a fonte de tráfego e medir as conversões.
O Click2Buy é compatível com o RGPD.
Para qualquer questão relacionada com a proteção de dados, pode contactar o nosso DPO:
Artaches Kherounts📧 dpo@click2buy.com📞 +33 3 66 72 29 04