Redirecionar por país e aparelho ao mesmo tempo

Para redirecionar por país e aparelho, encadeie dois links. Uma Regra inteligente tem uma condição só, então você não consegue escrever "Estados Unidos e iPhone" em uma regra. Em vez disso, uma regra do primeiro código ou link envia um país para um segundo link curto, e as regras desse link escolhem pelo Dispositivo.

Veja se você precisa dos dois

As regras rodam de cima para baixo e vale a primeira que combinar. Isso muitas vezes dispensa o encadeamento. "Quem fala alemão vai para a página em alemão, e todos os outros seguem pelo aparelho" são duas regras na mesma lista: primeiro uma regra de Idioma para o alemão, depois as regras de Dispositivo abaixo dela. Nenhum segundo link entra.

Você precisa do encadeamento quando o destino de cada aparelho depende do país, por exemplo quando quem usa iPhone nos Estados Unidos e na Alemanha deve chegar a páginas diferentes. Uma lista só não diz isso, porque cada regra lê uma condição.

Disponibilidade

• Plano: as Regras inteligentes ficam no Business ou superior (preços). Para testar, escolha Business em PLANO PARA TESTAR, na etapa de plano do onboarding, e clique em Iniciar Teste Grátis. O seletor começa em Pro, e cada workspace tem um teste.
• Antes de imprimir: os códigos criados durante um teste sem cartão ficam nos domínios curtos gratuitos. Crie o código que vai para a impressão depois do checkout.
• Itens: o primeiro item pode ser um link curto ou um QR Code dinâmico do tipo URL. O segundo item é um link curto.

Monte o encadeamento

Neste exemplo, quem está nos Estados Unidos e na Alemanha recebe um segundo link próprio, cada um escolhendo pelo aparelho. Os demais vão para uma página global. A lista de países aparece em inglês na interface, então os nomes abaixo estão como você vai vê-los.

Crie primeiro os segundos links, porque o primeiro item precisa dos endereços deles. Estes passos montam o link dos Estados Unidos. Repita para a Alemanha com de-visitors.

1. Abra Links e clique em Adicionar Link.
2. Em URL de destino, cole a página para quem não se encaixa em nenhuma regra, por exemplo https://example.com/us. Em Link Curto, defina o endereço, por exemplo us-visitors.
3. Ative Regras inteligentes.
4. Na primeira regra, escolha Dispositivo, é, iOS, e cole o link da App Store em URL de destino.
5. Clique em Adicionar regra, escolha Dispositivo, é, Android, e cole o link do Google Play.
6. Clique em Criar link.

Agora crie o item que as pessoas vão ler ou clicar. Para um QR Code, abra QR Codes, clique em Criar QR Code, escolha Dinâmico e deixe URL em Selecione o tipo do QR. Para um link curto, use Adicionar Link de novo.

1. Em URL de destino, cole a página dos demais países, por exemplo https://example.com/global.
2. Ative Regras inteligentes.
3. Na primeira regra, escolha País, é, United States, e cole https://go.example.com/us-visitors em URL de destino.
4. Clique em Adicionar regra, escolha País, é, Germany, e cole https://go.example.com/de-visitors.
5. Clique em Criar QR Code ou Criar link.

O país vem do endereço IP do visitante. Uma VPN, uma rede de empresa ou uma operadora de celular pode colocar a pessoa em outro país.

O que o encadeamento custa

• Uma visita conta duas vezes. O primeiro item registra um clique ou uma leitura, e o segundo link registra outro. Os contadores do workspace sobem nos dois.
• Leia os destinos finais no segundo link. Na aba URLs da Análise, o primeiro item lista o endereço do segundo link como destino, e o segundo link lista a página final.
• Cada segundo link é um link do seu workspace como qualquer outro, então ele entra na conta de links do seu plano.

Os parâmetros da URL seguem junto: um ?utm_source=flyer no endereço do primeiro item chega ao segundo link e à página final.

O que observar

• Nunca aponte uma regra para o próprio link curto. A CodeQR aceita a regra ao salvar, e os visitantes caem em um loop de redirecionamento no navegador.
• Cada link ou código aceita até 20 regras, com uma condição por regra.
• Todo destino de uma regra passa pela mesma verificação de segurança do destino principal.

Faça o mesmo pela API

Crie o segundo link e depois o primeiro item, que aponta para ele:

curl -X POST https://api.codeqr.io/links \
  -H "Authorization: Bearer codeqr_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "go.example.com",
    "key": "us-visitors",
    "url": "https://example.com/us",
    "rules": [
      { "attribute": "device", "operator": "equals", "value": "iOS", "url": "https://apps.apple.com/us/app/example/id000000000" },
      { "attribute": "device", "operator": "equals", "value": "Android", "url": "https://play.google.com/store/apps/details?id=com.example.app" }
    ]
  }'

curl -X POST https://api.codeqr.io/qrcodes \
  -H "Authorization: Bearer codeqr_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "url",
    "static": false,
    "domain": "go.example.com",
    "key": "print",
    "url": "https://example.com/global",
    "rules": [
      { "attribute": "country", "operator": "equals", "value": "US", "url": "https://go.example.com/us-visitors" },
      { "attribute": "country", "operator": "equals", "value": "DE", "url": "https://go.example.com/de-visitors" }
    ]
  }'

Para um link curto como primeiro item, envie as mesmas rules para https://api.codeqr.io/links. No MCP, create_link e update_link aceitam rules. As ferramentas de QR Code não aceitam, então use a API ou o editor para um código.

Confira se funciona

Teste o segundo link do computador com o user agent de um celular e veja para onde ele redireciona:

curl -sI -A "Mozilla/5.0 (iPhone; CPU iPhone OS 18_0 like Mac OS X)" https://go.example.com/us-visitors | grep -i '^location'
# location: https://apps.apple.com/us/app/example/id000000000

O terminal não envia país, então teste o primeiro item de um celular no país que você definiu, ou peça a um colega de lá que leia o código ou clique no link. Depois abra a Análise dos dois itens e compare as abas URLs.

Artigos relacionados

• Envie cada visitante ao destino certo com Regras inteligentes
• Como as Regras inteligentes escolhem o destino
• Envie visitantes iOS e Android para a loja de apps certa
• Redirecione visitantes por país, região, cidade ou idioma