Um encurtador de URL para WordPress transforma os longos permalinks que o seu CMS gera em links curtos, com marca e rastreáveis que pode partilhar fora do site. O WordPress é excelente para publicar. Não está construído para lhe dizer quantas pessoas clicaram no link que colocou numa newsletter, num tweet ou num folheto impresso. Essa lacuna é a razão pela qual recorre a um encurtador.
Aqui está a versão resumida antes dos detalhes. Encurta e rastreia links do WordPress por quatro razões: partilhas sociais com marca que correspondem ao seu site em vez de um domínio genérico, links de saída e afiliados rastreados para saber o que é realmente clicado, códigos QR para impressão e embalagem que apontam para um link que pode alterar mais tarde, e análises de cliques que o seu CMS simplesmente não fornece. O WordPress sabe que uma publicação foi publicada. Não sabe que o link dentro dela recebeu 4.000 cliques da Alemanha numa terça-feira.
Há quatro formas de configurar isto, e trocam esforço por controlo. Um plugin é o menor trabalho se existir um compatível. A API REST do Elido é a mais flexível e o caminho que a maioria das equipas adota. O Zapier fica no meio como uma ponte sem código. E pode sempre colar links manualmente. O resto desta publicação percorre cada um, depois cobre as partes em que as pessoas erram: permalinks bonitos versus links curtos, substituição de plugins de redirecionamento frágeis, e onde o redirecionamento deve realmente acontecer para nunca abrandar o seu site.
O que um encurtador de URL para WordPress realmente faz#
Retire o marketing e um encurtador faz dois trabalhos. Mapeia um slug curto para um destino longo, e conta cada vez que alguém segue esse slug. O WordPress não faz nenhum dos dois para os links que partilha noutro lado.
As suas publicações já têm URLs. O WordPress constrói um permalink para cada uma, geralmente um slug legível no seu próprio domínio. Esse permalink é para as pessoas que leem o seu site. Não é curto, não tem marca para partilhar numa plataforma com um orçamento de caracteres, e o WordPress não regista quem clicou uma vez que o link deixa a sua página. Um link curto é um objeto separado: um URL compacto num domínio de redirecionamento, opcionalmente o seu próprio domínio com marca, que encaminha para o destino e regista o clique.
A distinção importa porque os dois são fáceis de confundir. Um permalink bonito e um link curto parecem semelhantes e ambos levam a algum lado. Só um deles é construído para ser partilhado e medido. Voltaremos a isto.
Caminho 1: Um plugin WordPress#
O caminho de plugin é o que a maioria das pessoas procura primeiro, e com razão. Um plugin instala-se a partir do diretório de plugins WordPress, conecta-se com um token de API e os links curtos começam a aparecer sem tocar numa linha de PHP.
Quero ser honesto sobre o estado disto, porque a disponibilidade de plugins muda e prefiro que conheça a forma do caminho do que confiar numa captura de ecrã desatualizada das configurações. O padrão geral que qualquer plugin de encurtador segue é o mesmo: instala-o, cola um token de API com escopo de workspace da sua ferramenta de links, e o plugin chama a API do encurtador em seu nome quando publica ou quando clica num botão no editor. Alguns plugins criam automaticamente um link curto na publicação e escrevem-no num campo personalizado. Outros adicionam uma meta box onde gera um a pedido. Os bons permitem escolher o domínio com marca e adicionar etiquetas para que o link atterisse no lugar certo nas suas análises.
Se existir um plugin Elido WordPress mantido listado, instale-o a partir do painel e conecte-o com um token de /settings/api. Se não conseguir confirmar um plugin atual e mantido para o seu encurtador, não force. Um plugin semi-abandonado que quebra na próxima versão WordPress é pior do que o caminho de API, que controla. Quando um plugin se adequa, é a opção de menor esforço disponível. Quando não se adequa, avance para a API.
Uma coisa a verificar antes de confiar em qualquer plugin: onde acontece o redirecionamento. Um plugin que apenas regista o link com um encurtador externo está bem. Um plugin que também instala um handler de redirecionamento local para que os links resolvam através do seu próprio servidor WordPress é o padrão lento que analisaremos mais tarde. Quer o link criado no WordPress e resolvido no edge, não resolvido em PHP.
Caminho 2: A API REST do Elido#
Este é o caminho com mais partes móveis e mais controlo, e é o que as equipas usam quando querem links curtos criados automaticamente e de forma fiável em cada publicação.
O WordPress dispara uma ação quando uma publicação muda de estado. A relevante é transition_post_status, que corre sempre que uma publicação se move entre estados, incluindo a mudança para publish. Associa um handler a ela, chama a API do Elido para criar um link para o permalink da publicação, e armazena o URL curto devolvido em post meta para poder renderizá-lo no template, no editor ou num widget de partilha. O manual de plugins WordPress documenta o sistema de hooks, e a referência da API REST WordPress cobre os endpoints de meta se quiser expor o link curto ao editor de blocos.
O lado do Elido são três linhas. Aqui está um handler de publicação em PHP que cria um link curto com marca na primeira vez que uma publicação é publicada e ignora as edições posteriores:
add_action( 'transition_post_status', 'elido_shorten_on_publish', 10, 3 );
function elido_shorten_on_publish( $new_status, $old_status, $post ) {
if ( $new_status !== 'publish' || $old_status === 'publish' ) {
return; // only on the first publish, not on every edit
}
if ( get_post_meta( $post->ID, '_elido_short_url', true ) ) {
return; // already has one
}
$res = wp_remote_post( 'https://api.elido.app/v1/links', array(
'headers' => array(
'Authorization' => 'Bearer ' . ELIDO_TOKEN,
'Content-Type' => 'application/json',
'Idempotency-Key' => 'wp-post-' . $post->ID,
),
'body' => wp_json_encode( array(
'destination_url' => get_permalink( $post ),
'tags' => array( 'wordpress', 'auto-publish' ),
) ),
) );
if ( is_wp_error( $res ) ) {
return; // log and move on; publish should never fail on this
}
$link = json_decode( wp_remote_retrieve_body( $res ), true );
if ( ! empty( $link['short_url'] ) ) {
update_post_meta( $post->ID, '_elido_short_url', $link['short_url'] );
}
}
Dois detalhes merecem o seu lugar. A Idempotency-Key é derivada do ID da publicação, para que se o hook de publicação disparar duas vezes, o que acontece, obtenha o mesmo link de volta em vez de um duplicado. E o handler absorve os seus próprios erros. Criar um link curto nunca deve bloquear uma publicação; se a chamada de API falhar, a publicação sai na mesma e cria o link mais tarde. O início rápido em API e SDKs percorre o modelo de idempotência e o tratamento de erros com mais profundidade em cinco linguagens, e a página de funcionalidades de API e SDKs lista a superfície completa de endpoints.
Se quiser que o link viva no seu próprio domínio em vez de um host genérico de encurtador, passe um domain_id e configure o domínio primeiro. O guia de domínios personalizados cobre o registo DNS e o TLS automático, e a funcionalidade de domínios personalizados explica por que um link com marca no seu próprio host tem melhor desempenho do que um genérico para confiança e taxa de cliques.
Caminho 3: Zapier, a ponte sem código#
Entre um plugin e um handler de código fica o Zapier. É a resposta certa quando quer automação, não quer enviar PHP e não consegue encontrar um plugin de confiança.
A configuração é um Zap de dois passos. O gatilho é "Nova publicação publicada no WordPress." A ação é "Criar link no Elido." Mapeia o permalink da publicação para o campo de destino, opcionalmente passa o título da publicação como etiqueta e ativa-o. A partir daí, cada publicação publicada cria um link curto sem que ninguém toque no editor. Pode encadear um terceiro passo para escrever o URL curto de volta numa folha Google, publicá-lo no Slack, ou enviá-lo para o seu agendador social.
O Zapier custa-lhe uma taxa por tarefa e alguns segundos de latência, e não obtém o controlo fino que a API lhe dá sobre idempotência e tratamento de erros. Em troca obtém uma integração funcional em dez minutos sem deploy. Para a maioria das equipas de publicação esse é o compromisso certo até que o volume ou a precisão as empurrem para a API. O guia de automação Zapier dedicado cobre os Zaps de múltiplos passos em detalhe.
Caminho 4: Manualmente#
Não descarte o caminho manual. Se publicar algumas publicações por semana e partilhar cada uma deliberadamente, criar o link curto manualmente no painel do Elido e colá-lo na sua publicação ou na sua ferramenta social é completamente razoável. Obtém links com marca e rastreio completo de cliques com zero integração para manter.
O caminho manual deixa de escalar quando publica frequentemente, quando várias pessoas partilham os mesmos links e precisam de consistência, ou quando quer o link no corpo da publicação antes de carregar em publicar. Esse é o momento de automatizar. Até lá, o painel mais copiar-colar é uma configuração legítima, não uma solução temporária.
Os permalinks bonitos não são links curtos#
Isto confunde as pessoas constantemente, por isso diga-se claramente. Os permalinks WordPress e os links curtos resolvem problemas diferentes e geralmente quer ambos.
Um permalink bonito é o URL legível por humanos de uma publicação no seu próprio domínio. Ajuda os leitores e os motores de busca a entender a página. Não é compacto, não foi concebido para ser partilhado numa plataforma que conta caracteres, e o WordPress não rastreia cliques nele uma vez que o link deixa o seu site. O WordPress também tem uma forma antiga de URL curto ?p=123 e um hook wp_shortlink, mas isso é apenas um alias no seu próprio domínio. Não tem marca e não é rastreado.
Um link curto é um objeto deliberado, partilhável e medido. Vive num domínio de redirecionamento, pode ter a sua marca, pode acrescentar parâmetros UTM no momento do redirecionamento, pode expirar e regista cada clique em análises que pode realmente consultar. Quando partilha uma publicação numa newsletter ou nas redes sociais, quer o link curto, não o permalink bruto, porque o link curto é o único que lhe diz o que aconteceu depois do clique. A publicação sobre links curtos com marca cobre a configuração do domínio com marca, e encurtadores de URL para editores aprofunda especificamente o fluxo de trabalho de publicação.
Substituir plugins de redirecionamento WordPress frágeis#
Muitos sites WordPress acumulam plugins de redirecionamento. Alguns são para higiene legítima de SEO, corrigindo um 301 depois de alterar um permalink. Outros são esticados para fazer algo em que são maus: gerir links de saída e afiliados que partilha e quer rastrear.
Esse segundo uso é onde falham. Um plugin de redirecionamento que resolve um link de saída "bonito" executa o redirecionamento através de PHP e da sua base de dados em cada clique. Sob qualquer tráfego real, isso adiciona carga ao host que serve o seu conteúdo real, e os dados de cliques que fornece, se algum, são escassos. O padrão parece organizado no painel e comporta-se mal sob carga.
A divisão limpa: mantenha os plugins de redirecionamento para 301s internos nos seus próprios URLs, onde pertencem, e mova os links de saída e afiliados partilháveis para um encurtador que resolve fora do site e rastreia corretamente. Para de pagar o imposto de redirecionamento PHP em links que nunca foram trabalho do seu site servir, e obtém análises reais nos que importam.
Faça o redirecionamento no edge, não em PHP#
Este é o ponto de desempenho que decide se um encurtador ajuda ou prejudica, e é a razão pela qual a arquitetura importa mais do que o plugin.
Quando um link curto resolve através do WordPress, o clique atinge a sua pilha PHP e a sua base de dados antes que alguém chegue ao destino. Isso está bem com um fluxo lento e é doloroso em escala, e acopla a velocidade dos seus links partilhados à carga no seu site de conteúdo. Quando um link curto resolve no edge, o clique nunca toca no WordPress de todo. Atinge um POP de redirecionamento próximo do utilizador, é respondido a partir de cache e encaminhado.
O Elido resolve redirecionamentos em pontos de presença de edge multi-região com um p95 inferior a 15ms num acerto de cache. O seu host WordPress não está nesse caminho. Quer tenha usado o plugin, a API, o Zapier ou as suas próprias mãos para criar o link, o clique em si é servido fora do site, por isso uma publicação viral não arrasta o seu CMS com ela. A publicação sobre um p95 de redirecionamento abaixo de 15ms explica como esse orçamento de latência é mantido, e a página de funcionalidades de análises cobre o que é registado em cada um desses cliques.
Esse é o argumento completo para resolver fora do site numa linha: o link em que os seus leitores clicam nunca deve partilhar um servidor com a página que quer que eles leiam.
Escolher um caminho#
Se quer o menor trabalho e existe um plugin mantido para o seu encurtador, use-o. Se quer automação sem código, use o Zapier. Se quer controlo total e links criados de forma fiável em cada publicação, use a API e o hook transition_post_status. Se publica raramente e partilha deliberadamente, faça-o manualmente. A maioria das equipas começa manual ou com Zapier e avança para a API assim que os links curtos se tornam parte da forma como cada publicação sai.
Seja qual for o caminho que escolher, acerte em duas coisas: crie o link com o seu próprio domínio com marca para que corresponda ao site de onde veio, e certifique-se de que o redirecionamento resolve no edge e não através do PHP do WordPress. Os links com marca é o que o lado de marketing quer, a resolução no edge é o que o lado de engenharia quer, e não estão em tensão. Pode ter ambos. Veja a página de soluções para profissionais de marketing para o lado do rastreio de campanhas e a página de preços para o que cada nível inclui.
Relacionado no blog#
- API de encurtador de URL: início rápido de 30 minutos em cinco linguagens
- Configurar links curtos com marca no seu próprio domínio
- Encurtadores de URL para editores: um fluxo de trabalho que escala
- Como um p95 de redirecionamento abaixo de 15ms é mantido no edge
- O que é um encurtador de URL e quando precisa de um