Resposta direta
As variáveis de URL de destino são espaços reservados como {host}, {host.domain}, {host.sub}, {path} e {qs} que você digita no destino de um redirecionamento. Quando um visitante chega, o RedirHub substitui cada variável pela parte correspondente da solicitação recebida, para que uma única regra de redirecionamento possa enviar muitos nomes de host, subdomínios e caminhos para o lugar certo.
Um redirecionamento normal sempre envia os visitantes para a mesma URL fixa. As variáveis tornam o destino dinâmico: o destino é construído a partir do nome do host, do caminho e da string de consulta de cada solicitação. Isso é útil quando você move um domínio e quer manter seus caminhos, redirecionar muitos subdomínios com uma única regra curinga ou consolidar vários domínios antigos em um único site.
Manter apenas o caminho ou a string de consulta?
Você não precisa de variáveis para isso. Ao editar um redirecionamento, ative Encaminhamento de caminho ou Encaminhamento de consulta em Opções encaminhadas.
Use variáveis quando precisar de algo que as opções de switch não conseguem fazer, como inserir o nome do host ou o subdomínio, ou manter o caminho quando o destino já tiver sua própria string de consulta.
Variáveis disponíveis#
| Variable | O que ele insere | Valor de exemplo |
|---|---|---|
| {host} | O nome de host completo que foi solicitado | shop.example.co.uk |
| {host.domain} | O domínio registrado, sem nenhum subdomínio | example.co.uk |
| {host.sub} | A parte do subdomínio apenas (@ quando não há subdomínio) | shop |
| {path} | O caminho solicitado, com uma barra inicial | /sale/shoes |
| {uri} | O caminho solicitado, sem a barra inicial | sale/shoes |
| {qs} | A string de consulta, incluindo ? ou & (vazio quando não há) | ?color=red |
| {random_string} | Um valor aleatório de 6 caracteres (a–z, 0–9), novo em cada solicitação | k3x9a1 |
Alguns detalhes a ter em mente:
- Ortografia exata: as variáveis estão em minúsculas e entre chaves. Qualquer coisa que o RedirHub não reconheça, como {HOST}, é deixada na URL como está.
- Extensões de domínio com múltiplas partes: {host.domain} lida corretamente com terminações como .co.uk ou .com.au. Para a.b.example.com, {host.domain} é example.com e {host.sub} é a.b.
- Domínios sem subdomínios: numa solicitação para o domínio raiz (example.com), {host.sub} é @.
- Barra final: {path} e {uri} removem barras finais; assim, /blog/ vira /blog. Na página inicial, {path} é / e {uri} está vazio.
- Conector da string de consulta: {qs} adiciona ? quando o destino ainda não tem string de consulta e & quando já tem. Se a solicitação não tiver string de consulta, não adiciona nada.
Alternadores de encaminhamento ou variáveis?#
| O que você quer | Forma mais fácil | Example |
|---|---|---|
| Manter o caminho | chave Encaminhamento de caminho | a.com/one/two → b.com/one/two |
| Manter a string de consulta | chave Encaminhamento de consulta | a.com/?ref=chatgpt → b.com/?ref=chatgpt |
| Manter os dois | Ligue os dois interruptores | a.com/one?ref=x → b.com/one?ref=x |
| Mantenha o caminho quando o destino tiver a sua própria string de consulta | {path} | b.com{path}?lang=en |
| Use o nome do host, domínio ou subdomínio | {host}, {host.domain}, {host.sub} | b.com/team/{host.sub} |
| Adicione um valor único a cada visita | {random_string} | b.com/offer?ref={random_string} |
Variáveis e switches podem ser combinados. Por exemplo, um destino com {host.sub} mais encaminhamento de Path mantém tanto o subdomínio quanto o caminho (veja os exemplos abaixo).
Como adicionar uma variável a um redirecionamento#
- Abra seu redirecionamento no painel do RedirHub ou crie um novo.
- No URL de destino, digite a variável onde o valor deve ir; por exemplo, https://www.example.com/team/{host.sub}.
- Se você colocou {path}, {uri} ou {qs} no destino por conta própria, desative o encaminhamento de Path ou o encaminhamento de Query para esse redirecionamento (veja abaixo).
- Salve e teste alguns URLs reais, incluindo a página inicial. Se algo parecer errado, veja Solução de problemas de novos redirecionamentos.
Exemplos#
Mantenha o caminho quando o destino tiver sua própria string de consulta#
textDestino: https://www.new-domain.com{path}?lang=en
old-domain.com/blog/hello → https://www.new-domain.com/blog/hello?lang=en
old-domain.com/ → https://www.new-domain.com/?lang=enO encaminhamento de Path sempre adiciona o caminho ao final do destino, o que aqui resultaria em https://www.new-domain.com/?lang=en/blog/hello. Com {path} você decide para onde o caminho vai. Se seu destino não tiver string de consulta, basta ativar o encaminhamento de Path.
Envie cada subdomínio para a sua própria página#
textOrigem: *.example.com
Destino: https://www.example.com/team/{host.sub}
alice.example.com → https://www.example.com/team/alice
bob.example.com → https://www.example.com/team/bobUma origem com curinga cobre todos os subdomínios, e a variável decide para onde cada um vai. Saiba mais sobre subdomínios com curinga, incluindo disponibilidade do plano e SSL.
Mantenha o subdomínio, altere o domínio#
textOrigem: *.old-brand.com
Destino: https://{host.sub}.new-brand.com + Encaminhamento de caminho ativado
shop.old-brand.com/cart → https://shop.new-brand.com/cart
docs.old-brand.com/api → https://docs.new-brand.com/apiAtenção
No domínio sem prefixo, {host.sub} é @, então old-brand.com/cart viraria https://@.new-brand.com/cart.
Crie um redirecionamento separado para o domínio raiz (old-brand.com) com o destino https://new-brand.com e o Encaminhamento de caminho ativado.
Consolide muitos domínios e veja de onde vieram os visitantes#
textDestino: https://www.new-brand.com/?from={host.domain}
old-brand.co.uk/ → https://www.new-brand.com/?from=old-brand.co.uk
shop.old-brand.de/sale → https://www.new-brand.com/?from=old-brand.deQualquer domínio antigo pode usar o mesmo destino, e sua análise ainda consegue dizer qual domínio cada visitante digitou.
Mantenha a string de consulta#
textDestino: https://www.new-domain.com/landing?src=old + Encaminhamento de consulta ativado
old-domain.com/?utm_source=mail → https://www.new-domain.com/landing?src=old&utm_source=mail
old-domain.com/ → https://www.new-domain.com/landing?src=oldVocê não precisa de uma variável para isso. A opção de Encaminhamento de consulta adiciona a string de consulta do visitante e escolhe ? ou & por você, para que o rastreamento de campanhas continue intacto. Veja também como preservar parâmetros UTM durante redirecionamentos.
Adicione um valor aleatório#
textDestino: https://www.example.com/offer?ref={random_string}
example.com/promo → https://www.example.com/offer?ref=4k9zq1 (diferente em cada solicitação)Variáveis e as opções de encaminhamento#
As opções de Encaminhamento de caminho e Encaminhamento de consulta usam as mesmas variáveis nos bastidores. O Encaminhamento de caminho adiciona /{uri} ao final do seu destino, e o Encaminhamento de consulta adiciona {qs} . Se você já colocou {path}, {uri} ou {qs} no destino por conta própria, mantenha a opção correspondente desligada. Caso contrário, o valor é adicionado duas vezes:
textDestino: https://www.new-domain.com{path} + Encaminhamento de caminho ativado
old-domain.com/about → https://www.new-domain.com/about/aboutAs variáveis só mudam para onde um visitante é enviado. Qual redirecionamento lida com uma solicitação é decidido pelas regras de correspondência do RedirHub.
Resolução de problemas#
- A variável aparece literalmente na URL: verifique a ortografia, as letras minúsculas e as chaves encaracoladas.
- Acontece uma barra dupla (new-domain.com//about): {path} já começa com uma barra. Escreva https://new-domain.com{path} ou https://new-domain.com/{uri}.
- O caminho ou a string de consulta é repetido: desative o encaminhamento de caminho (Path forwarding) ou o encaminhamento de consulta (Query forwarding) para esse redirecionamento.
- Aparece um @ no nome do host: a solicitação foi feita para o domínio sem nada antes. Adicione um redirecionamento separado para o domínio raiz.
Perguntas frequentes
Não. Ative o encaminhamento de Path ou o encaminhamento de Query nas Opções Encaminhadas quando você editar o redirecionamento. Use variáveis apenas quando precisar de algo que os interruptores não podem fazer, como inserir o nome do host ou subdomínio, ou manter o caminho quando o destino já tiver sua própria string de consulta.
Sim. As variáveis devem ser escritas em letras minúsculas dentro de chaves, exatamente como listadas, por exemplo {host.domain}. Uma variável que o RedirHub não reconhece, como {HOST} ou {domain}, é deixada no destino inalterada.
Sim. Você pode combinar quantas variáveis precisar, e cada uma pode aparecer mais de uma vez. Por exemplo, https://{host.sub}.new-brand.com{path}{qs} mantém o subdomínio, o caminho e a string de consulta.
Ambos inserem o caminho solicitado sem barras finais. {path} começa com uma barra (/blog/hello), então coloque-o diretamente após o domínio. {uri} não tem barra inicial (blog/hello), então adicione a barra você mesmo: https://new-domain.com/{uri}.
{host.domain} entende terminações de domínio em várias partes. Um pedido para shop.example.co.uk retorna example.co.uk, e {host.sub} retorna shop.
Sim. As variáveis são a maneira mais fácil de dar a cada subdomínio coberto por uma fonte curinga, como *.example.com, seu próprio destino, por exemplo https://www.example.com/team/{host.sub}.
