Introdução
Cookies de terceiros estão perdendo eficácia — para comerciantes isso significa: rastreio e atribuição devem funcionar independentemente do cookie do navegador. Affilentra fornece, como solução self‑hosted, os blocos técnicos para redirecionar links de rastreio no servidor, registar conversões server‑to‑server e, em caso de troca de dispositivo, aplicar um fallback por fingerprint em conformidade com a proteção de dados. Este guia conduz você passo a passo pela configuração e implementação.
Visão geral: Arquitetura e princípios centrais
O objetivo é um rastreio robusto sem cookies, composto por três camadas:
- Redirecionamentos Server‑Side: os cliques passam pelo seu servidor, onde Click‑IDs são gerados e armazenados antes de redirecionar para o destino.
- Postbacks Server‑to‑Server: conversões são comunicadas diretamente do sistema de pedidos da sua loja para o Affilentra; cookies do navegador não são necessários.
- Fallback por Fingerprint: quando não há Click‑ID disponível ou os cookies foram perdidos, é utilizado um cotejo de assinatura do dispositivo com hash, com preocupação de privacidade, para atribuir conversões.
- Definir domínio ou subdomínio de rastreio (por exemplo, track.ihredomain.de) e apontar via DNS (A/CNAME) para o servidor Affilentra.
- Configurar SSL/TLS para o domínio de rastreio (letsencrypt/outro), pois postbacks e redirecionamentos devem usar HTTPS.
- Criar tokens de API para postbacks e armazená‑los de forma segura; esses tokens são usados para verificação de assinatura nas conversões.
- Preparar um ambiente de desenvolvimento para transações de teste.
Com o Affilentra self‑hosted você mantém o controlo sobre domínio, processamento de dados e modelo de licença.
Preparação: Requisitos e configuração
Antes de começar, assegure‑se de que a instância Affilentra self‑hosted está instalada (licença PRO ou NETWORK) e de que possui acesso de administrador. Passos adicionais de preparação:
Passo 1 — Configurar Redirecionamentos Server‑Side
Objetivo: cada clique de afiliado é registado no servidor e recebe uma Click‑ID antes de o utilizador ser redirecionado para a página da loja.
- Definir o formato do link de tracking: affiliate.example.com/clk?aid={partner}&pid={produkt}&dst={zielurl}
- Gerar a Click‑ID: Quando chega um clique, o seu servidor gera uma Click‑ID única (por ex. UUID) e a armazena com timestamp, User‑Agent hasheado, possivelmente IP‑truncado, parâmetros de origem e o hash opcional do fingerprint.
- Efetuar o redirect: Após o registo, o servidor faz um redirecionamento 302 para o destino (URL de destino sem alteração ou com o parâmetro adicional click_id={id} dependendo da integração da loja). Importante: o redirecionamento deve ser sempre server‑side para que não seja necessário um cookie de terceiro.
- Estratégia de cookies: Defina adicionalmente um cookie First‑Party (SameSite=Lax, Secure) no seu domínio de tracking com a Click‑ID; isto é útil quando a loja se encontra na mesma domínio principal.
Nota: O Affilentra pode servir como destino para captura e armazenamento de cliques; na sua instalação self‑hosted ative a gravação de cliques recebidos e a atribuição de Click‑IDs nas configurações de administrador.
Passo 2 — Registar conversões sem cookies de terceiros (Server‑to‑Server)
A metodologia mais fiável no contexto cookieless é um postback server‑side da loja para o Affilentra.
- Definir o endpoint de postback: A sua loja envia, após a conclusão de uma encomenda, um pedido HTTP(S) para a API do Affilentra com os parâmetros: click_id (se disponível), amount, conversion_status, timestamp e uma assinatura HMAC sobre os dados do utilizador com o seu API‑Token.
- Validação no Affilentra: A plataforma valida a assinatura, a existência da Click‑ID e a janela temporal (por ex. Click‑TTL) e grava a conversão na base de dados. Se faltar a click_id, recorre‑se ao fingerprint‑fallback (ver Passo 3).
- Gestão de erros: O lado da loja deve implementar mecanismos de retry para postbacks falhados e fornecer logs de failover. O Affilentra devolve nos Responses códigos de estado para processos bem‑sucedidos e falhados.
Importante: Utilize exclusivamente o seu API‑Token e configure whitelist de IPs ou limites de taxa no Affilentra para prevenir abusos.
Passo 3 — Fallback por fingerprint para atribuição em troca de dispositivos
Quando não existe uma Click‑ID (por ex. o utilizador muda de dispositivo ou os cookies foram apagados), uma correspondência por fingerprint, concebida com foco na privacidade, permite uma atribuição secundária.
- O que recolher: combinação de características não pessoais, como fingerprint do navegador (partes do User‑Agent hasheadas, resolução do ecrã, idioma, timezone), eventualmente IP parcialmente mascarada (ex.: apenas /24) e uma data/timestamp. Não armazenar campos PII diretos como IP completo, e‑mail ou nomes.
- Hashing e salt: antes do armazenamento, hashear todos os atributos com um salt server‑side e um algoritmo de hashing forte. Rodar o salt regularmente e configurá‑lo no Affilentra.
- Estratégia de matching: numa conversão, o Affilentra tenta primeiro o matching exato por click_id; se faltar, procura‑se dentro de uma janela temporal configurável (ex.: recomendado 7–30 dias) por hashes de fingerprint compatíveis. O matching deve ser probabilístico e usar limiares (similarity‑score); se houver vários candidatos, aplica‑se um algoritmo de priorização (último clique, maior correspondência).
- Transparência e opt‑out: informe os utilizadores na política de privacidade sobre o uso de fallback por fingerprint e ofereça opções de opt‑out.
Exemplo prático: fluxo de uma conversão
1) Clique no link de afiliado → redirecionamento server‑side para a loja, o click_id é guardado e definido como cookie de primeira‑parte.
2) Cliente efetua compra → a loja envia um postback com click_id e assinatura para o Affilentra.
3) O Affilentra verifica a assinatura, faz o match do click_id e regista a conversão. Se o click_id estiver em falta, dispara‑se o fingerprint‑matching e atribui‑se segundo regras definidas.
Testes, monitorização e faturação
Execute cenários de teste:
- Clique → conclusão de encomenda no mesmo dispositivo (Click‑ID disponível).
- Clique → mudança de dispositivo → conclusão de encomenda (apenas fingerprint‑matching possível).
- Postbacks com erro/atrasados e falhas de assinatura.
Registe logs de cliques e conversões separados por função (operador do software, comerciante, parceiro). Utilize os relatórios do Affilentra para conciliar pagamentos e cálculos de comissões; configure alarmes para anomalias.
Segurança, proteção de dados e operação
- Tokens e segredos: guardar API‑tokens em segurança, rodar periodicamente e restringir acessos aos sistemas de produção.
- Proteção de dados: armazenar fingerprints apenas hasheados, configurar prazos de retenção limitados e verificar a base legal (ex.: interesse legítimo). Consulte aconselhamento jurídico quando necessário.
- Configuração de cookies: cookies de primeira‑parte com SameSite=Lax/Secure e duração adequada; não depender de cookies de terceiros.
Recomendações práticas para comerciantes
- Use o seu próprio domínio de tracking para maximizar o contexto de primeira parte.
- Opte por postbacks server‑to‑server como canal primário para conversões; use o fingerprint apenas como fallback.
- Documente todos os formatos de postback e procedimentos de assinatura no seu Developer‑Guide, para que as integrações com parceiros sejam reprodutíveis.
- Realize testes e reconciliações regulares entre as encomendas da loja e os relatórios da Affilentra.
Conclusão e próximo passo
Com redirecionamentos server‑side, postbacks server‑to‑server e um fallback por fingerprint compatível com a proteção de dados, os comerciantes podem implementar tecnicamente o rastreio sem cookies com a Affilentra em self‑hosted, mantendo simultaneamente o controlo sobre dados e atribuição. A configuração descrita reduz a dependência de cookies de terceiros e fornece uma base transparente para o cálculo de comissões e faturação.
Escolher início: Informe‑se e inicie a implementação em https://affilentra.de
Próximo passo
Experimentar a Affilentra
Plataforma unificada que integra de forma transparente disponibilização de produto, tracking, validação de conversões, cálculo de comissões e pagamentos ao longo de papéis claramente separados; opção de instalação self‑hosted com licença perpétua sem participação de receitas; os comerciantes mantêm o controlo sobre produtos, condições e criativos; os parceiros recebem links de tracking pessoais e um histórico de pagamentos audível.