8 min de leituraIntegrações

Encurtador de URLs do Brevo: short links de marca em campanhas

Use um encurtador de URLs do Brevo para e-mail e SMS: short links de marca, eventos link_click enviados de volta ao Brevo e por que as contagens de cliques do Elido e do Brevo são diferentes.

Ana Kowalska
Marketing solutions engineering
Capa sobre o encurtador de URLs do Brevo: um short link de marca em um e-mail e SMS do Brevo, com o clique retornando ao Brevo como um evento link_click

É simples descrever uma configuração de encurtador de URLs do Brevo: você cria um short link de marca no Elido, cola-o no seu e-mail ou SMS do Brevo, e cada clique nele é enviado de volta ao Brevo como um evento personalizado link_click por meio do endpoint trackEvent do Brevo. O evento leva o slug e o ID do link, o país e o dispositivo de quem clicou e o destino. Ele é registrado em um contato placeholder, não na pessoa que clicou, portanto são dados no nível da campanha, não um histórico por assinante.

Esse último ponto molda todo o restante deste guia. O link tracking do Brevo já sabe qual contato clicou; o Elido sabe o que aconteceu no redirect, inclusive os cliques que nunca vieram do e-mail. Usados em conjunto, eles cobrem mais do que qualquer um dos dois sozinho, e os short links em campanhas do Brevo também fazem duas coisas que o Brevo não consegue: colocam o seu próprio domínio na mensagem e economizam caracteres em SMS.

Se você ainda não decidiu como marcar as campanhas, comece pelo artigo principal sobre tracking de UTMs de ponta a ponta. Tudo o que o Brevo vê é o que o link carrega.

O que o Elido envia ao Brevo a cada clique

Um clique produz um POST para in-automate.brevo.com/api/v2/trackEvent, o endpoint que o Brevo documenta para rastrear eventos personalizados via REST. Ele é disparado depois que o visitante é redirecionado. Um Brevo lento nunca deixa o link lento.

Este é o corpo, com um link realista:

{
  "email": "[email protected]",
  "event": "link_click",
  "properties": {
    "workspace_id": 12,
    "link_id": 4711,
    "slug": "sept-sale",
    "country": "DE",
    "device": "mobile",
    "destination": "https://shop.example/sale?utm_source=brevo&utm_medium=email"
  }
}
CampoO que contémComo usar no Brevo
eventSempre link_clickO nome escolhido nos gatilhos de automação
emailUm placeholder por link ou um endereço definido por vocêConsulte a seção sobre identidade antes de confiar nele
slug / link_idQual short link foi clicadoDiferencie campanhas e CTAs
country, deviceResolvidos no redirectDivida os fluxos por mercado ou por celular e desktop
destinationA URL para a qual o visitante foi enviadoAs tags UTM ficam somente dentro desta string

O que está faltando é igualmente importante. Não há endereço IP nem user agent no payload, o que mantém o evento enxuto do ponto de vista do RGPD. Também não há timestamp, então o Brevo registra o horário em que recebeu o evento. E não há uma opção por link: depois que o Brevo é conectado, cada clique no workspace é encaminhado.

Por que o evento não consegue encontrar o assinante

O limite é a identidade. Quando alguém toca em go.yourbrand.com/sept-sale, o redirect vê um telefone e um país. Ele não vê um contato do Brevo. Nem um cookie.

Por isso, o campo email recorre a elido-link-<link ID>@noemail.elido.app, um endereço por link. Cada clique em sept-sale vai para o mesmo placeholder, não importa quem tenha clicado. Você pode substituir isso por um único endereço fixo para todo o workspace, mas ele também será um único endereço, não o de quem clicou.

Identidade do link tracking do Brevo: o próprio link de tracking do Brevo sabe qual contato clicou, enquanto o evento link_click do Elido é registrado em um endereço placeholder por link, então três assinantes que clicam no mesmo short link produzem três eventos em um único contato placeholder

Acho que essa é a compensação certa. Ela tem, porém, um efeito colateral. A documentação não diz se o trackEvent cria um contato para um endereço que ainda não conhece, então confira Contacts depois do seu primeiro clique de teste. Se aparecerem contatos placeholder, mantenha o domínio noemail.elido.app fora de todas as listas de envio. Nada deve ser enviado por e-mail para ele.

A atribuição por assinante já existe, aliás. É o próprio link tracking do Brevo. Deixe-o ativado.

A configuração usa uma credencial, e é fácil pegar a errada. O endpoint trackEvent se autentica com um header ma-key, e o guia do REST tracker do Brevo encaminha você às configurações de automação da sua conta para encontrá-la. A chave xkeysib- em SMTP & API é outra coisa.

  1. No Brevo, copie a chave do tracker na página de configurações de automação.
  2. No Elido, abra Integrations, escolha Brevo, clique em Connect, cole a chave e salve. Ela é criptografada em repouso e nunca volta a ser exibida por completo.
  3. Aguarde cerca de cinco minutos. O forwarder mantém as configurações do workspace em cache por esse período.
  4. Toque em um dos seus short links no celular, fora do Wi-Fi do escritório.

O botão Test connection ajuda com a chave: ele envia um evento de teste (marcado como elido_test: true) ao tracker do Brevo e mostra a resposta do Brevo, então uma chave REST colada no lugar da chave do tracker falha imediatamente. O evento não aparece em um contato, portanto o toque no celular continua sendo o teste que vale.

Se quiser que todos os eventos fiquem em um contato que você controla, por exemplo [email protected], configure-o pela API: PUT /v1/workspaces/{workspace_id}/event-integrations/brevo com Authorization: Bearer elido_... e um corpo contendo api_key e email. O formulário do dashboard tem apenas o campo da chave, e salvá-lo novamente substitui toda a configuração, então o e-mail vai junto.

A entrega é feita na melhor tentativa. Um POST com falha sofre retry uma vez após um segundo e depois é descartado.

É no SMS que o argumento a favor dos links de SMS do Brevo vira pura aritmética. A referência de campanhas de SMS diz que o máximo por SMS é de 160 caracteres e que qualquer texto maior "will be counted as more than one SMS". Os nomes dos remetentes têm limite de 11 caracteres alfanuméricos. A linha de cancelamento da inscrição consome parte dos mesmos 160.

Uma landing page com todas as tags UTM passa facilmente de 110 caracteres. go.yourbrand.com/sept tem 21. Em um envio para 40.000 destinatários, essa é a diferença entre um segmento cobrado por mensagem e dois.

A parte de marca importa tanto quanto o tamanho. Tanto as operadoras quanto os destinatários desconfiam de domínios genéricos de encurtadores em mensagens, e um link no seu próprio subdomínio parece ser seu. O guia de encurtadores para marketing por SMS aborda o texto de opt-in e as regras de opt-out; para SMS, a propriedade device no evento do Brevo é quase sempre mobile, então divida por country.

Domínios de marca nos e-mails do Brevo

No e-mail, o tamanho é gratuito. O motivo para usar short links em campanhas do Brevo é o domínio. Um domínio compartilhado e público de encurtador carrega consigo todos os spammers que já o usaram. Um domínio personalizado carrega apenas o seu histórico de envio. O explicador sobre entregabilidade aborda o que os filtros realmente analisam.

O outro motivo é o controle depois do envio. Um link em um boletim informativo enviado fica congelado em milhares de caixas de entrada. Um short link não; você pode redirecionar sept-sale para a página da promoção estendida na segunda-feira sem tocar no e-mail.

Coloque um link do Elido em um e-mail do Brevo e você terá um redirect envolto duas vezes. Seu short link é reescrito no próprio link de tracking do Brevo, então um toque vai primeiro para o Brevo, depois para o Elido e, por fim, para a página.

Clique envolto duas vezes em um e-mail do Brevo: o toque chega ao link de tracking do Brevo e é contado para o contato, depois o short link do Elido o conta por link e filtra bots óbvios, e então o visitante chega ao destino enquanto o Elido publica um evento link_click de volta ao Brevo

Cada salto conta segundo suas próprias regras, por isso os números não vão coincidir. O Elido descarta cliques cujo user agent anuncia um bot, o que inclui crawlers, ferramentas que buscam prévias de links e scripts como curl. Um scanner de segurança que se apresenta como um navegador normal passa, e os cliques que o redirect sinaliza como suspeitos ainda são encaminhados ao Brevo. Tudo o que o Brevo filtra no seu salto, o Elido nunca vê. Encaminhamentos e colagens em chats de grupo? Só o Elido.

Este ponto é fácil de ignorar. O Brevo pode adicionar valores UTM aos seus links de tracking de saída, mas, em um short link, eles chegam à URL curta, e o Elido redireciona para o destino armazenado no link. Marque o destino do Elido.

Quer a parte de redirect das suas campanhas no seu próprio domínio? Escolha um plano e envie o próximo boletim informativo por meio de links de marca.

A documentação de eventos lista dois usos relevantes aqui: disparar fluxos de automação e segmentar contatos por comportamento. link_click funciona como qualquer outro evento personalizado nesse contexto. A ressalva da seção sobre identidade determina o que é útil.

Um fluxo que envia um e-mail para "a pessoa que clicou" não funcionará com base nesse evento, porque o contato é um placeholder. Para isso, use as próprias condições de cliques do Brevo no e-mail. O que funciona é o uso interno: defina o endereço fixo como um contato da caixa de entrada da equipe e então dispare um alerta no Slack ou por e-mail quando um link de lançamento receber seu primeiro clique de um novo país ou quando uma reimpressão de um código QR antigo voltar à atividade.

Para relatórios, os eventos por link fornecem uma série de cliques por slug, sem os bots óbvios, que inclui compartilhamentos fora do Brevo. Compare-a com o dashboard de analytics de cliques, que também tem referenciador e navegador.

Uma observação fundamentada sobre a UE. A empresa controladora do Brevo, a Sendinblue SAS, está registrada em Paris, segundo sua política de privacidade. O evento que ela recebe do Elido não contém IP nem e-mail do assinante. Isso é fixo no forwarder, não uma configuração que você precise lembrar. A URL de destino, porém, é transmitida, então mantenha dados pessoais fora dos seus valores UTM.

Relacionados no blog

Perguntas frequentes

O Brevo tem um encurtador de URLs integrado?

O Brevo envolve os links dos seus e-mails nos próprios links de tracking, o que permite contar os cliques por contato, mas isso é tracking, não um short link de marca que você controla. Para SMS, em que cada caractere é cobrado, e para links que você quer no seu próprio domínio, crie o short link em uma ferramenta como o Elido e cole-o na mensagem do Brevo.

Que evento o Elido envia ao Brevo quando um short link é clicado?

Um evento personalizado chamado link_click, enviado ao endpoint trackEvent do Brevo a cada clique em um link no seu workspace. As propriedades são o ID do workspace, o ID do link, o slug, o país, o dispositivo e a URL de destino. Ele não contém endereço IP, user agent nem campos UTM separados.

O Brevo consegue associar um clique do Elido ao contato que clicou?

Não. O redirect não sabe qual contato do Brevo tocou no link, então o evento é registrado em um endereço placeholder por link ou em um único endereço fixo que você configura para todo o workspace. A atribuição por contato vem do próprio link tracking do Brevo, que você deve deixar ativado por esse motivo.

De qual chave do Brevo a integração de cliques em links precisa?

O endpoint trackEvent se autentica com um header ma-key, e a documentação do REST tracker do Brevo encaminha você às configurações de automação da sua conta para obter essa chave. A chave de API xkeysib- da página SMTP & API é uma credencial diferente e não é o que esse endpoint verifica.

Quantos caracteres um short link economiza em um SMS do Brevo?

O Brevo conta 160 caracteres por SMS e cobra qualquer texto maior como mais de uma mensagem. Uma URL de landing page com tags costuma passar de 100 caracteres sozinha, enquanto um short link de marca cabe em cerca de 20, o que normalmente mantém um texto promocional dentro de um único segmento.

Por que o Brevo e o Elido exibem números de cliques diferentes para a mesma campanha?

Eles contam em duas portas diferentes. O Brevo conta o acesso ao seu link de tracking e o associa a um contato; o Elido conta o acesso ao short link e descarta visitantes cujo user agent indica que são um bot. Cliques em links compartilhados fora do e-mail chegam apenas ao Elido, então é normal haver alguma diferença.

Experimente Elido

Cole uma URL, obtenha um link curto

Sem cadastro. O link vive 30 dias. Cadastre-se para mantê-lo para sempre.

Grátis, sem necessidade de registo · 2 por dia

Experimente o Elido

Encurtador de URL hospedado na UE: domínios personalizados, análises profundas e API aberta. Plano gratuito - sem cartão de crédito.

Tags
brevo url shortener
brevo link tracking
short links in brevo campaigns
brevo sms links
brevo custom events
branded short links

Continuar lendo