Botão de afiliado com contagem de cliques e eventos GA4 para PrestaShop - Venda o que não tem em stock

Apresente o que não consegue ter em stock e rentabilize à mesma o tráfego

Alguns produtos valem a pena ser mostrados mesmo quando não os consegue manter: o fornecedor expede diretamente, a margem é demasiado curta, o artigo é sazonal, ou está simplesmente a testar se alguém o quer.

Este módulo coloca um segundo botão nessas fichas de produto — Comprar no seu parceiro — ao lado do botão Adicionar ao carrinho do seu tema. O cliente clica, a sua loja regista o clique, e ele chega à página do parceiro.

O que este botão é na realidade

Uma simples ligação para o controlador de encaminhamento da sua própria loja, não para o parceiro. É precisamente esse desvio que torna a contagem possível: o clique chega primeiro ao seu servidor, é escrito na sua base de dados e só depois é reencaminhado para o destino que configurou.

Surge ao lado dos botões já existentes no seu tema, em vez de os substituir, pelo que um produto pode estar simultaneamente em stock e afiliado, se assim o pretender.

Configure por produto, não por loja

Abra um produto, encontre o separador do módulo e preencha três campos: o URL de destino, o nome do fornecedor que aparece no botão e o valor por clique utilizado nos relatórios.

Num produto não acontece nada enquanto não o ativar aí. Os produtos em que nunca mexe permanecem intactos, e a folha de estilos e o ficheiro JavaScript do módulo não são de todo carregados neles — só são incluídos onde está efetivamente a ser visualizado um produto afiliado.

Duas formas de encaminhar o cliente

Encaminhamento direto. O clique passa pelo seu controlador de encaminhamento e segue imediatamente para o parceiro.

Ecrã intermédio com contagem decrescente. Primeiro surge um pequeno painel que faz a contagem decrescente — três segundos por predefinição, sendo o número escolhido por si — e mostra uma ligação «Continuar agora» para quem não quiser esperar. Útil quando pretende um instante para dizer: está a sair da nossa loja.

Sendo franco quanto a um ponto: no modo de ecrã intermédio o cliente espera pela contagem decrescente da janela e depois ainda encontra o breve atraso próprio da página de encaminhamento. Se isso lhe parecer um intersticial a mais, use o encaminhamento direto.

O seu próprio registo de cliques

Cada clique escreve uma linha: que produto, que loja, quando, o valor por clique, uma referência de transação gerada e o endereço IP do visitante.

O back office soma isto em cliques por produto e num valor total, para que veja em que produtos afiliados as pessoas realmente carregam e quais é que ficam apenas parados.

Duas coisas que deve saber antes de ativar isto. O endereço IP é armazenado tal como está, em texto simples, e o módulo não inclui qualquer definição de retenção, qualquer rotina de limpeza nem qualquer gancho de apagamento para o RGPD — as linhas acumulam-se até desinstalar. Se opera sob o RGPD, trate esta tabela como dados pessoais e planeie a sua própria retenção. Além disso, o token de encaminhamento é fixo por produto e não por sessão, pelo que consta no HTML público da sua página e pode ser reproduzido novamente: trate a contagem de cliques como um indicador, não como um número auditado.

Sobre esse valor monetário — leia isto

O número que o módulo apresenta não é lucro nem uma comissão que lhe tenha sido paga. É uma aritmética que controla: o seu próprio preço de catálogo sem impostos × uma percentagem que escreve no produto.

Trata-se de uma estimativa de valor por clique, e vale a pena ser preciso quanto ao que isso significa:

• Utiliza o seu preço, não o do parceiro.
• Cada clique conta como se tivesse convertido. Não é aplicada qualquer taxa de conversão em parte alguma, porque o módulo não dispõe de dados de conversão — não há API de rede, não há fluxo de pagamentos, nada que volte do parceiro.
• Se deixar a percentagem por definir, assume 100 por predefinição — ou seja, um produto não configurado reporta o preço integral em cada clique.

Use isto como sinal relativo para comparar produtos entre si. Não o inclua na sua contabilidade e não o interprete como faturação.

Google Analytics 4, com a mesma honestidade

Defina um ID de medição GA4 e cada encaminhamento dispara, através do gtag.js, um evento de comércio eletrónico que transporta valor, moeda e uma referência de transação.

Três ressalvas, todas elas mais importantes do que a própria funcionalidade:

São eventos sintéticos. Um clique não é uma compra, mas o evento é enviado como tal. Nada no módulo os identifica ou isola, pelo que se vão misturar nos mesmos relatórios das suas encomendas reais. Utilize uma propriedade GA4 separada ou, no mínimo, um filtro configurado por si, a não ser que queira faturação inventada na sua análise de comércio eletrónico.

A matriz de artigos é enviada, mas verifique-a na sua própria propriedade. O evento transporta item_id, item_name, item_category, preço e quantidade, a par dos campos ao nível do evento. Não lhe prometemos uma repartição ao nível do produto a funcionar no GA sem a termos confirmado numa propriedade real — confronte-a portanto com os seus próprios relatórios antes de construir seja o que for sobre ela.

O ficheiro de rastreio não está atrás de uma barreira de consentimento. É carregado assim que um ID de medição esteja definido, antes de qualquer verificação de gestão de consentimento. Se utiliza uma CMP, faça você mesmo a integração.

Existe também um campo Universal Analytics. Deixe-o vazio. A Google desligou o UA em 2023, pelo que não transmite para lado nenhum — o próprio ecrã de administração do módulo di-lo. Continua a custar um pedido à Google.

Verificações de estado no back office

A página de configuração verifica cinco pontos e indica quais estão a falhar: se o ID de rastreio parece válido, se é um ID GA4 e não um antigo Universal Analytics, se pelo menos um produto está efetivamente afiliado, se os URL de destino estão bem formados e se os ganchos do front office estão registados.

Este último merece o seu lugar — um gancho em falta é a razão habitual para um botão de compra não aparecer.

Uma coisa que este módulo não fará por si

Não acrescenta uma declaração de afiliação. Em muitas jurisdições — a FTC nos Estados Unidos, a ASA no Reino Unido e regras equivalentes noutros locais — uma ligação de saída paga ou comissionada tem de ser divulgada ao leitor, e rel="sponsored" é a marcação que a Google designou exatamente para isso.

O módulo aplica rel="nofollow" nas principais variantes do botão, mas não rel="sponsored", e a ligação «Continuar agora» do ecrã intermédio não tem qualquer rel. Em nenhum dos seus textos existe uma frase de divulgação.

Se utilizar isto comercialmente, acrescente a sua própria declaração à página e fale com quem o aconselha em matéria de regras de publicidade. Preferimos dizer-lho com clareza a deixar que o descubra através de um regulador.

Compatibilidade e idiomas

PrestaShop 1.7 a 9. Nove ganchos, com uma proteção contra duplicação para que o PrestaShop 8 e 9 mostrem um botão e não dois.

Traduzido para alemão, espanhol, francês, inglês, italiano, neerlandês, polaco e turco — 109 textos em cada idioma.

Uma nota para o multiloja: a tabela de definições por produto está indexada apenas ao produto, pelo que o URL de destino, o valor por clique e a contagem decrescente de um produto são partilhados por todas as lojas que o vendem. A posição do botão e a abertura em novo separador são igualmente globais em vez de definidas por loja.

Frequently asked questions

Isto paga-me alguma coisa ou liga-me a uma rede de afiliados?

Nem uma coisa nem outra. É um botão e um contador de cliques que vivem inteiramente na sua loja. Não há integração com redes, não há API, não há fluxo de pagamentos e nada reporta de volta a partir do parceiro. A sua relação comercial com o parceiro — e receber o pagamento — é da sua responsabilidade e trata-se em separado.

Então o que é o valor monetário que me mostra?

O seu próprio preço sem impostos multiplicado por uma percentagem que escreve em cada produto, contado uma vez por cada clique. É uma estimativa de valor por clique configurada por si, útil para comparar produtos uns com os outros. Não é lucro nem faturação, porque o módulo não tem forma de saber se algum clique se converteu numa venda. Se deixar a percentagem por definir, assume 100, pelo que um produto não configurado reporta o preço integral por clique.

Aplica uma taxa de conversão?

Não. Cada clique é contado como se tivesse convertido. Não existem dados de conversão em parte alguma do módulo.

Onde aparece o botão?

Ao lado do botão Adicionar ao carrinho do seu tema na ficha de produto, através dos ganchos de produto padrão do PrestaShop — acrescenta em vez de substituir. Pode escolher a posição do gancho, e uma proteção faz com que o PrestaShop 8 e 9 apresentem um botão em vez de dois.

Vai tornar mais lentos os produtos que não são afiliados?

Não. A folha de estilos e o ficheiro JavaScript só são incluídos quando está a ser visualizado um produto afiliado. Os produtos que não ativou não carregam nada deste módulo.

Qual é a diferença entre os dois modos de encaminhamento?

O encaminhamento direto envia o cliente para o parceiro de imediato. O ecrã intermédio mostra primeiro uma breve contagem decrescente — três segundos por predefinição — com uma ligação «Continuar agora» para os impacientes. Convém saber: no modo de ecrã intermédio o cliente espera primeiro pela janela e depois pelo breve atraso próprio da página de encaminhamento.

Guarda alguma coisa sobre os meus visitantes?

Sim, e deve ler isto antes de o ativar. Cada clique guarda o endereço IP do visitante em texto simples, juntamente com o produto, a loja, a data e hora e o valor por clique. Não existe definição de retenção, nem rotina de limpeza, nem gancho de apagamento para o RGPD — as linhas permanecem até desinstalar. Ao abrigo do RGPD, um endereço IP é um dado pessoal: planeie a sua própria retenção e declare-a na sua política de privacidade.

Os números de cliques são fiáveis?

Trate-os como um indicador. O token de encaminhamento é fixo por produto e não por sessão e aparece no HTML público da sua página, pelo que pode ser recolhido e reproduzido novamente, o que inflacionaria tanto a contagem de cliques como o total do valor por clique. Serve perfeitamente para perceber que produtos captam atenção; um número auditado é que não é.

O que chega exatamente ao Google Analytics 4?

Um evento de comércio eletrónico por cada encaminhamento, enviado do lado do cliente através do gtag.js, transportando valor, moeda, uma referência de transação, o fornecedor como affiliation e uma matriz de artigos com o ID, o nome, a categoria e o preço do produto. A limitação que importa não é a carga de dados mas o seu significado: são eventos sintéticos — um clique é enviado como se fosse uma compra, e nada os separa das suas encomendas reais. Utilize uma propriedade separada ou um filtro seu, e confirme a repartição ao nível do produto nos seus próprios relatórios antes de depender dela.

Devo preencher o campo Universal Analytics?

Não. A Google desligou o Universal Analytics em 2023, pelo que tudo o que for enviado para lá não chega a lado nenhum. Deixe-o vazio e use o campo GA4.

O ficheiro de rastreio do GA está atrás de um aviso de cookies?

Por si só, não. É carregado assim que um ID de medição esteja definido, antes de qualquer verificação de gestão de consentimento. Se utiliza uma CMP, terá de fazer a integração você mesmo.

Acrescenta uma declaração de afiliação?

Não, e esta é a lacuna mais importante do módulo. Aplica rel="nofollow" nas principais variantes do botão mas não rel="sponsored" — o valor designado pela Google para ligações pagas — e a ligação «Continuar agora» do ecrã intermédio não tem qualquer rel. Não é fornecido texto de divulgação em nenhum idioma. Se está a ser pago por estas ligações, acrescente a sua própria declaração e verifique o que a sua jurisdição exige.

Funciona com multiloja?

Funciona, com uma ressalva. As definições por produto estão indexadas apenas ao produto, sem coluna de loja, pelo que o URL de destino, o valor por clique e a contagem decrescente de um produto são partilhados por todas as lojas que o vendem. A posição do botão e a abertura em novo separador também são globais.

Que versões do PrestaShop são suportadas?

Da 1.7 à 9. Abaixo da 1.7.0.0 a instalação é bloqueada.

Que idiomas fala?

Oito: alemão, espanhol, francês, inglês, italiano, neerlandês, polaco e turco, com 109 textos em cada um.