Rotear por país

Digamos que a mesma embalagem vai para a Alemanha, para a Áustria e para o resto do mundo. Um escaneamento alemão deveria cair na loja alemã; todos os outros pertencem à página internacional. Imprimir um código QR diferente por mercado multiplica suas tiragens - e uma caixa mal etiquetada envia o público errado para a página errada por toda a vida daquela caixa.

Um link da Kilo dissolve o problema, porque o código nunca codifica o seu destino - ele codifica o link, e o link decide. As regras geo são avaliadas na borda, dentro do mesmo redirecionamento de cerca de 50 milissegundos que encaminha o visitante, então ninguém espera enquanto a decisão acontece. E como as regras vivem no link e não no papel, você pode adicionar mercados, juntá-los ou reapontar qualquer um deles anos depois de imprimir. Imprima uma vez; reaponte para sempre.

A configuração inteira é um link e uma regra por mercado. No painel:

• Crie o link com a sua página internacional como destino. Esse destino padrão é a rede de segurança - todo visitante que nenhuma regra pegar cai ali, então faça dele uma página que funcione para qualquer um.
• Abra as regras de roteamento do link e escolha Adicionar regra.
• Adicione uma regra geo por mercado: escolha o país - ou vários países que compartilham um destino - e defina a URL que esses visitantes devem receber. Uma regra geo também pode casar com uma região ou uma cidade quando um país inteiro é grosseiro demais.

As regras são avaliadas em uma ordem fixa - a primeira correspondência vence, geo antes de dispositivo e A/B, com o destino padrão recolhendo todos os outros - e uma edição vale a partir do próximo escaneamento. A mecânica, incluindo como as regras se empilham, está no guia de regras de roteamento. Uma nota honesta antes de construir: as regras de segmentação são um recurso pago, aplicado na API tanto quanto no painel.

A Kilo é API-first - o painel que você acabou de usar é um cliente da mesma API HTTP. A montagem do cartaz impresso são duas chamadas com uma chave de escrita. Primeiro, gere o link com o destino mundial padrão:

curl https://qr2r.com/api/links \
  -H "Authorization: Bearer $KILO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "default_target": "https://example.com/global", "name": "Trade-fair poster" }'

A resposta carrega o slug permanente do link. Depois anexe uma regra geo por mercado - os países são códigos ISO-2, e a criação devolve 201 com a regra armazenada:

curl https://qr2r.com/api/links/aA3k9/rules \
  -H "Authorization: Bearer $KILO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "type": "geo", "condition": { "countries": ["DE", "AT"] }, "target_url": "https://example.com/de" }'

Repita a segunda chamada para cada mercado, e use PUT /api/links/aA3k9 sempre que um destino se mudar - o código impresso nunca muda. O passo a passo completo dos endpoints, incluindo listar, reordenar e apagar regras, está em análise e regras pela API. Como o painel, a API aplica o portão de plano: uma regra geo em um plano sem regras de segmentação é recusada com 402, nunca aceita em silêncio.

Abra a análise do link e leia o desmembramento por país contra as suas regras. Se o cartaz está pendurado em Viena mas um terço dos escaneamentos não vem nem da Alemanha nem da Áustria, ou a história do posicionamento é maior do que você pensava ou o tráfego não é o que parece - as duas coisas valem saber antes da próxima tiragem.

Para um código impresso há uma ferramenta mais afiada: fixe o posicionamento do link - o país ou a região onde o código vive fisicamente - e o painel geo ganha uma linha dentro-da-área / fora-da-área, contada só sobre tráfego classificado como humano. Ela responde a pergunta do encaixe num relance: os escaneamentos vêm de onde o papel realmente está?