Encurtamento de links
Esta página aborda como ativar o encurtamento de links em suas mensagens SMS e RCS, testar links encurtados, usar seu domínio personalizado em links encurtados e mais.
A Braze está implementando gradualmente o encurtamento de links unificado, que consolida todos os links encurtados de SMS e RCS em um único formato de link personalizado (por exemplo, brz.ai/abcdefgh).
O encurtamento de links e o rastreamento de cliques permitem que você encurte automaticamente URLs contidos em mensagens SMS ou RCS e colete análise de dados de taxa de cliques, fornecendo métricas de engajamento adicionais para ajudar a entender como os usuários estão interagindo com suas campanhas.
O encurtamento de links e o rastreamento de cliques podem ser ativados no nível da variante de mensagem tanto em campanhas quanto em canvas.
O comprimento da URL é determinado pelo tipo de rastreamento que está ativado:
- Rastreamento básico ativa o rastreamento de cliques no nível da campanha. URLs estáticas terão um comprimento de 20 caracteres, e URLs personalizadas terão um comprimento de 25 caracteres.
- Rastreamento avançado ativa o rastreamento de cliques no nível da campanha e no nível do usuário, e permite o uso de recursos de segmentação e redirecionamento que dependem de cliques. Os cliques também gerarão um evento de clique de SMS enviado pelo Currents. URLs estáticas com rastreamento avançado terão um comprimento de 27-28 caracteres, permitindo que você crie segmentos de usuários que clicaram em URLs. URLs personalizadas terão um comprimento de 32-33 caracteres.
Os links são encurtados usando nosso domínio curto compartilhado (brz.ai) ou seu domínio personalizado de encurtamento de links. Um exemplo de URL pode ser algo como: https://brz.ai/8jshX (básico, estático) ou https://brz.ai/p/8jshX/2dj8d (avançado, personalizado). Consulte Testes para mais informações.
Quaisquer URLs estáticas que comecem com http:// ou https:// são encurtadas. URLs estáticas encurtadas são válidas por um ano a partir da data em que foram criadas. URLs encurtadas que contêm personalização com Liquid são válidas por dois meses.
Se você planeja usar o filtro de Canal Inteligente da BrazeAITM e deseja que os canais SMS e RCS sejam selecionáveis, ative o encurtamento de links com rastreamento avançado.
Usando o encurtamento de links
Para usar o encurtamento de links, certifique-se de que o botão de encurtamento de links no criador de mensagens esteja ativado. Em seguida, escolha usar o rastreamento básico ou avançado.

A Braze reconhece apenas URLs que começam com http:// ou https://. Quando uma URL é reconhecida, a seção Prévia é atualizada com uma URL de espaço reservado. A Braze estima o comprimento da URL após o encurtamento, mas um aviso solicita que você selecione um usuário teste e salve a mensagem como rascunho para uma estimativa mais precisa.

Adicionando parâmetros UTM
Embora o encurtamento de links permita rastrear seus URLs automaticamente, também é possível adicionar parâmetros UTM aos URLs para rastrear a performance das campanhas em ferramentas de análise de dados de terceiros, como o Google Analytics.
Para adicionar parâmetros UTM ao seu URL, faça o seguinte:
- Comece com seu URL de base. Esse é o URL da página que você deseja rastrear (como
https://www.example.com). - Adicione um ponto de interrogação (?) após o URL de base.
- Adicione cada parâmetro UTM separado por um e comercial (&).
Um exemplo é https://www.example.com?utm_source=newsletter&utm_medium=sms.
Personalização com Liquid em URLs
Você pode construir dinamicamente sua URL diretamente no criador da Braze, permitindo adicionar parâmetros UTM dinâmicos às suas URLs ou enviar links exclusivos aos usuários (como direcionar usuários ao carrinho abandonado ou a um produto específico que voltou ao estoque).
Criar uma URL com tags de personalização Liquid compatíveis
URLs podem ser geradas dinamicamente por meio do uso de quaisquer tags de personalização Liquid compatíveis.
1
https://example.com/?campaign_utm={{campaign.${api_id}}}&user_attribute={{custom_attribute.${attribute1}}}
Também oferecemos suporte ao encurtamento de variáveis Liquid definidas de forma personalizada. Vários exemplos são mostrados abaixo:
Criar uma URL usando variáveis Liquid
1
2
{% assign url_var = {{event_properties.${url_slug}}} %}
https://example.com/{{url_var}}
Encurtar URLs renderizadas por variáveis Liquid
Encurtamos URLs que são renderizadas por Liquid, mesmo aquelas incluídas em propriedades de gatilho de API. Por exemplo, se {{api_trigger_properties.${url_value}}} representa uma URL válida, encurtamos e rastreamos essa URL antes de enviar a mensagem.
Encurtar URLs no endpoint /messages/send
O encurtamento de links também é ativado para mensagens somente via API por meio do endpoint /messages/send. Para também ativar o rastreamento básico ou avançado, use os parâmetros de solicitação link_shortening_enabled ou user_click_tracking_enabled.
| Parâmetro | Obrigatória | Tipo de dados | Descrição |
|---|---|---|---|
link_shortening_enabled |
Opcional | booleano | Defina link_shortening_enabled como true para ativar o encurtamento de links e o rastreamento de cliques no nível da campanha. Para usar o rastreamento, um campaign_id e message_variation_id devem estar presentes. |
user_click_tracking_enabled |
Opcional | booleano | Defina user_click_tracking_enabled como true para ativar o encurtamento de links e o rastreamento de cliques no nível da campanha e do usuário. Você pode usar os dados rastreados para criar segmentos de usuários que clicaram em URLs.Para usar este parâmetro, link_shortening_enabled deve ser true, e um campaign_id e message_variation_id devem estar presentes. |
Para uma lista completa de parâmetros de solicitação, acesse parâmetros de solicitação.
Testes
Antes de lançar sua campanha ou canva, é uma prática recomendada visualizar e testar sua mensagem primeiro. Para isso, acesse a guia Teste para visualizar e enviar uma mensagem SMS ou RCS para grupos de teste de conteúdo ou um usuário individual.
Esta prévia é atualizada com a personalização relevante e a URL encurtada. O número de caracteres e os segmentos faturáveis também são atualizados para refletir a personalização renderizada e a URL encurtada.
Certifique-se de salvar a campanha ou canva antes de enviar uma mensagem de teste para receber uma representação da URL encurtada que é enviada na sua mensagem. Se a campanha ou canva não for salva antes de um envio de teste, o envio de teste incluirá uma URL de espaço reservado.
Para que os canvas apareçam no filtro “Clicou no link encurtado de SMS”, a etapa do canva que contém o link encurtado também deve estar ativada com rastreamento avançado, que permite o rastreamento de cliques no nível do usuário. Se o link encurtado estiver configurado com rastreamento básico, a opção de filtrar eventos de clique em links encurtados de SMS não estará disponível.
Se um rascunho for criado dentro de um canva ativo, uma URL encurtada não será gerada. A URL encurtada real é gerada quando o rascunho do canva é ativado.

A personalização com Liquid e as URLs encurtadas são processadas na guia Teste após um usuário ter sido selecionado. Certifique-se de que um usuário esteja selecionado para receber uma contagem precisa de caracteres.
Rastreamento de cliques
Quando o encurtamento de links está ativado, a tabela Performance de SMS/MMS/RCS inclui uma coluna intitulada Total de Cliques que mostra uma contagem de eventos de clique por variante e uma taxa de cliques associada. Para saber mais sobre métricas, consulte Performance da mensagem.

As tabelas Performance Histórica e Performance de SMS/MMS/RCS também incluem uma opção para Total de Cliques e mostram uma série temporal diária de eventos de clique. Os cliques são incrementados no redirecionamento (como quando um usuário visita um link) e podem ser incrementados mais de uma vez por usuário.
Redirecionamento de usuários
Para orientações sobre redirecionamento, visite Redirecionamento.
Domínios personalizados
O encurtamento de links também permite que você use seu próprio domínio para personalizar a aparência dos seus URLs encurtados, o que ajuda a transmitir uma imagem de marca consistente. Para saber mais, consulte Domínios personalizados.
Perguntas frequentes
Os links que recebo ao testar o envio são URLs reais?
Se a campanha tiver sido salva como rascunho antes do envio de teste, sim. Caso contrário, é um link de espaço reservado. Note que o URL exato enviado em uma campanha lançada pode ser diferente daquele enviado por meio de um envio de teste.
Posso adicionar parâmetros UTM a um URL antes de ele ser encurtado?
Sim. Podem ser adicionados parâmetros estáticos e dinâmicos.
Por quanto tempo os URLs encurtados permanecem válidos?
URLs personalizados são válidos por dois meses a partir do momento do registro do URL. Para o encurtamento de links unificado, que não possui distinção entre estático e personalizado, todos os links são válidos por nove semanas.
O SDK da Braze precisa ser instalado para encurtar links?
Não. O encurtamento de links funciona sem nenhuma integração de SDK.
Eu sei quais usuários individuais estão clicando em uma URL?
Sim. Quando o Rastreamento Avançado está ativado, você pode redirecionar usuários que clicaram em URLs aproveitando os filtros de redirecionamento de SMS ou os eventos de clique de SMS (users.messages.sms.ShortLinkClick) enviados pelo Currents.
O encurtamento de links funciona com deep links ou links universais?
O encurtamento de links não funciona com deep links. Alternativamente, você pode encurtar links universais de provedores terceiros como Branch ou Appsflyer, mas os usuários podem experimentar um breve redirecionamento ou efeito de “cintilação”. Isso ocorre porque o link encurtado passa pela web primeiro antes de resolver para o link universal que suporta a abertura do app. Além disso, a Braze não consegue solucionar problemas que possam surgir ao encurtar links universais, como quebrar a atribuição ou causar redirecionamentos inesperados.
Teste a experiência do usuário antes de implementar o encurtamento de links com links universais para confirmar que atende às suas expectativas.
Os send_ids estão associados a eventos de clique de SMS?
Não. No entanto, se você tiver o rastreamento avançado ativado, geralmente pode atribuir send_ids a eventos de clique usando o Query Builder para consultar dados do Currents com esta consulta:
1
2
3
4
5
6
SELECT c.*, s.send_id
FROM USERS_MESSAGES_SMS_SHORTLINKCLICK_SHARED AS c
INNER JOIN USERS_MESSAGES_SMS_SEND_SHARED AS s
ON s.user_id = c.user_id
AND (s.message_variation_id = c.message_variation_id OR s.canvas_step_message_variation_id = c.canvas_step_message_variation_id)
WHERE s.send_id IS NOT NULL;
Link shortening permite encurtar automaticamente URLs contidas em mensagens SMS ou RCS e coletar análise de dados de taxa de cliques, fornecendo métricas de engajamento adicionais para ajudar a entender como os usuários estão interagindo com suas campanhas.
O link shortening pode ser ativado no nível da variante de mensagem tanto em campanhas quanto em canvas. Quando o link shortening está ativado, os cliques geram um evento de clique de SMS enviado pelo Currents.
Os links são encurtados usando nosso domínio curto compartilhado (brz.ai) ou seu domínio personalizado de encurtamento de links, e são válidos por 9 semanas a partir da data em que foram criados. Um exemplo de URL pode ser algo como https://brz.ai/8jshX2dj.
Usando o link shortening
Para usar o link shortening, certifique-se de que a caixa de seleção de link shortening no criador de mensagens esteja selecionada.


A Braze reconhece apenas URLs que começam com http:// ou https://. Quando uma URL é reconhecida, a seção Prévia é atualizada com uma URL de espaço reservado. A Braze estima o comprimento da mensagem após o encurtamento, mas um aviso solicita que você selecione um usuário teste e salve a mensagem como rascunho para uma estimativa mais precisa.

Adicionando parâmetros UTM
Embora o encurtamento de links permita rastrear seus URLs automaticamente, também é possível adicionar parâmetros UTM aos URLs para rastrear a performance das campanhas em ferramentas de análise de dados de terceiros, como o Google Analytics.
Para adicionar parâmetros UTM ao seu URL, faça o seguinte:
- Comece com seu URL de base. Esse é o URL da página que você deseja rastrear (como
https://www.example.com). - Adicione um ponto de interrogação (?) após o URL de base.
- Adicione cada parâmetro UTM separado por um e comercial (&).
Um exemplo é https://www.example.com?utm_source=newsletter&utm_medium=sms.
Personalização com Liquid em URLs
Você pode construir dinamicamente sua URL diretamente no criador da Braze, permitindo adicionar parâmetros UTM dinâmicos às suas URLs ou enviar links exclusivos aos usuários (como direcionar usuários ao carrinho abandonado ou a um produto específico que voltou ao estoque).
Criar uma URL com tags de personalização Liquid compatíveis
URLs podem ser geradas dinamicamente por meio do uso de qualquer tag de personalização Liquid compatível.
1
https://example.com/?campaign_utm={{campaign.${api_id}}}&user_attribute={{custom_attribute.${attribute1}}}
Também oferecemos suporte ao encurtamento de variáveis Liquid definidas de forma personalizada. Vários exemplos são mostrados abaixo:
Criar uma URL usando variáveis Liquid
1
2
{% assign url_var = {{event_properties.${url_slug}}} %}
https://example.com/{{url_var}}
Encurtar URLs renderizadas por variáveis Liquid
Encurtamos URLs que são renderizadas por Liquid, mesmo aquelas incluídas em propriedades de gatilho de API. Por exemplo, se {{api_trigger_properties.${url_value}}} representa uma URL válida, encurtamos e rastreamos essa URL antes de enviar a mensagem.
Encurtar URLs no endpoint /messages/send
O link shortening também é ativado para mensagens somente via API por meio do endpoint /messages/send. Para uma lista completa de parâmetros de solicitação, acesse parâmetros de solicitação.
| Parâmetro | Obrigatória | Tipo de dados | Descrição |
|---|---|---|---|
link_shortening_enabled |
Sim | booleano | Defina link_shortening_enabled como true para ativar o link shortening. Para usar o rastreamento, um campaign_id e message_variation_id devem estar presentes. |
Testes
Antes de lançar sua campanha ou canva, a prática recomendada é visualizar e testar sua mensagem primeiro. Para isso, acesse a guia Teste para visualizar e enviar uma mensagem SMS ou RCS para grupos de teste de conteúdo ou um usuário individual.
Essa prévia é atualizada com a personalização relevante e a URL encurtada. O número de caracteres e os segmentos faturáveis também são atualizados para refletir a personalização renderizada e a URL encurtada.
Certifique-se de salvar a campanha ou canva antes de enviar uma mensagem de teste para receber uma representação da URL encurtada que é enviada na sua mensagem. Se a campanha ou canva não for salva antes de um envio de teste, o envio de teste incluirá uma URL de espaço reservado.
Se um rascunho for criado dentro de uma canva ativa, uma URL encurtada não será gerada. A URL encurtada real é gerada quando o rascunho da canva é ativado.

A personalização com Liquid e as URLs encurtadas são modeladas na guia Teste após um usuário ter sido selecionado. Certifique-se de que um usuário esteja selecionado para receber uma contagem precisa de caracteres.
Rastreamento de cliques
Quando o link shortening está ativado, a tabela Performance de SMS/MMS/RCS inclui uma coluna intitulada Total de Cliques que mostra uma contagem de eventos de clique por variante e uma taxa de cliques associada. Para mais informações sobre métricas, consulte Performance de mensagens.

As tabelas Performance Histórica e Performance de SMS/MMS/RCS também incluem uma opção para Total de Cliques e mostram uma série temporal diária de eventos de clique. Os cliques são incrementados no redirecionamento (como quando um usuário visita um link) e podem ser incrementados mais de uma vez por usuário.
Redirecionamento de usuários
Para orientações sobre redirecionamento, visite Redirecionamento.
Domínios personalizados
O encurtamento de links também permite que você use seu próprio domínio para personalizar a aparência dos seus URLs encurtados, o que ajuda a transmitir uma imagem de marca consistente. Para saber mais, consulte Domínios personalizados.
Perguntas frequentes
Os links que recebo ao testar o envio são URLs reais?
Se a campanha tiver sido salva como rascunho antes do envio de teste, sim. Caso contrário, é um link de espaço reservado. Note que o URL exato enviado em uma campanha lançada pode ser diferente daquele enviado por meio de um envio de teste.
Posso adicionar parâmetros UTM a um URL antes de ele ser encurtado?
Sim. Podem ser adicionados parâmetros estáticos e dinâmicos.
Por quanto tempo os URLs encurtados permanecem válidos?
URLs personalizados são válidos por dois meses a partir do momento do registro do URL. Para o encurtamento de links unificado, que não possui distinção entre estático e personalizado, todos os links são válidos por nove semanas.
O SDK da Braze precisa ser instalado para encurtar links?
Não. O encurtamento de links funciona sem nenhuma integração de SDK.
Eu sei quais usuários individuais estão clicando em uma URL?
Sim. Você pode redirecionar usuários que clicaram em URLs usando os filtros de redirecionamento de SMS ou os eventos de clique de SMS (users.messages.sms.ShortLinkClick) enviados pelo Currents.
O link shortening funciona com deep links ou links universais?
O link shortening não funciona com deep links. Alternativamente, você pode encurtar links universais de provedores terceiros como Branch ou Appsflyer, mas os usuários podem experimentar um breve redirecionamento ou efeito de “flickering”. Isso ocorre porque o link encurtado passa pela web primeiro antes de resolver para o link universal que suporta a abertura do app. Além disso, a Braze não consegue solucionar problemas que possam surgir ao encurtar links universais, como quebrar a atribuição ou causar redirecionamentos inesperados.
Teste a experiência do usuário antes de implementar o link shortening com links universais para confirmar que atende às suas expectativas.
Os send_ids estão associados a eventos de clique de SMS?
Não. No entanto, você geralmente pode atribuir send_ids a eventos de clique usando o Query Builder para consultar dados do Currents com esta consulta:
1
2
3
4
5
6
SELECT c.*, s.send_id
FROM USERS_MESSAGES_SMS_SHORTLINKCLICK_SHARED AS c
INNER JOIN USERS_MESSAGES_SMS_SEND_SHARED AS s
ON s.user_id = c.user_id
AND (s.message_variation_id = c.message_variation_id OR s.canvas_step_message_variation_id = c.canvas_step_message_variation_id)
WHERE s.send_id IS NOT NULL;