Os parâmetros de consulta de URL do Varify são removidos do URL
Como reconhecer o erro
Ao carregar o editor ou visualizar as variantes de pré-visualização através dos respetivos links de pré-visualização, parâmetros de consulta de URL importantes são adicionados ao URL.
Se estes forem removidos ou bloqueados pelo teu site, o editor ou outras funções, como os links de pré-visualização, podem deixar de funcionar corretamente.
Como corrigir o erro
Muitos sistemas de cache, CDNs (por exemplo, Cloudflare), gestores de tags ou ferramentas de consentimento normalizam URLs e removem parâmetros de consulta desconhecidos nesse processo—isto pode quebrar a funcionalidade do Varify se os parâmetros forem perdidos durante um redirecionamento, recarregamento ou consulta de cache. Por isso, os seguintes parâmetros devem ser explicitamente definidos como Whitelist (ou como „preserve query params“) na tua configuração de cache/redirecionamento.
Os Parâmetros do Varify em Detalhe
| parâmetros | Finalidade |
|---|---|
varify-editor | Ativa o Visual Editor na página—é definido quando uma experiência está a ser editada no editor. Sem este parâmetro, a página não carrega no modo editor. |
varify-preview | Gera uma pré-visualização de uma variante específica antes de a experiência entrar em produção. Usado, entre outras coisas, para fluxos de QA e aprovação. |
varify-force | Força a atribuição de uma variante específica, independentemente da distribuição normal de tráfego (por exemplo, para depuração ou teste direcionado de uma variante). |
varify-variation-id | Devolve o ID de uma variante específica—normalmente usado em conjunto com varify-force ou varify-preview para forçar ou apresentar essa variante específica. |
varify-variation-name | Semelhante a varify-variation-id, mas refere-se à variante pelo seu nome em vez de pelo seu ID—para links de pré-visualização e depuração mais legíveis. |
va-red | Usado para redirecionamentos no contexto de testes de URL divididos, para garantir que os visitantes permanecem corretamente atribuídos à variante alvo, mesmo após um redirecionamento. |
Recomendação para Whitelisting
- Adiciona os seis parâmetros (exatamente como mostrado, em minúsculas e com hífenes) à tua whitelist de parâmetros de URL—seja na chave de cache do CDN, no limpador de consentimento/tracking, ou nas regras de redirecionamento.
- Certifica-te de que são preservados tanto em redirecionamentos internos como em bypasses de cache, uma vez que
varify-previewevarify-forcecaso contrário perderão a sua função. - Se estiveres a usar Cloudflare Page Rules ou Cache Rules: Estes parâmetros devem ser incluídos na „Cache Key“ ou explicitamente excluídos, para que diferentes variantes não partilhem a mesma entrada de cache.