Alias de link

Use o alias de link para criar nomes reconhecíveis e gerados pelo usuário para identificar links enviados em mensagens de e-mail da Braze. Esses links ficam disponíveis para redirecionamento de segmentação, disparo baseado em ação e análise de dados de links.

Sobre a criação de alias de links

Com a criação de alias de links, você pode criar nomes gerados pelo usuário para identificar e rastrear links enviados em e-mails. Dessa forma, é possível usar esses alias de link reconhecíveis nos seus e-mails para rastrear o engajamento e analisar o desempenho de campanhas, sem precisar referenciar o link completo.

Com a criação de alias de links, você pode:

• Redirecionar usuários que clicaram em links específicos: identificar e direcionar usuários que clicaram em um link.
• Criar disparadores baseados em ações: enviar um e-mail quando um usuário clicar em um link.
• Analisar métricas: comparar quantos usuários clicaram no Link A em relação ao Link B.

Como funciona

A Braze identifica links de forma única dentro dos e-mails adicionando um parâmetro extra chamado lid (também conhecido como identificador de link) a cada URL de link. Esse valor lid permite que a Braze rastreie, monitore e agregue as interações do usuário com o link, mesmo que os demais parâmetros da URL sejam diferentes. Isso ajuda a fornecer insights sobre como os usuários interagem com o conteúdo nas suas campanhas de e-mail.

Os identificadores de link também são atualizados se uma campanha de e-mail, um Canvas com uma mensagem de e-mail ou um Content Block for duplicado.

Ativar o link aliasing

O link aliasing é ativado para toda a sua empresa pela Braze, não no dashboard. Para solicitá-lo, entre em contato com o gerente de conta da Braze. Ativar o link aliasing também ativa os modelos de link para a sua empresa. Somente a Braze pode ativar ou desativar o link aliasing para a sua empresa.

Para verificar se o link aliasing já está ativo, acesse a guia Link Aliasing Settings em Configurações > Preferências de e-mail. Se você não conseguir abrir Preferências de e-mail, você não tem a permissão “View Email Settings”. Se você conseguir abrir a página, mas a guia não estiver lá, o link aliasing não está ativo para a sua empresa. Para outras páginas ou configurações ausentes, consulte Uma página ou configuração de gerenciamento de links está ausente.

Depois que o link aliasing estiver ativo, você poderá fazer o seguinte no dashboard:

Para saber o que muda quando o aliasing é desativado, consulte Destinos que não aceitam o parâmetro lid. Para saber mais sobre as permissões nesta tabela, consulte Permissões de usuário da empresa.

Criar um alias de link

O editor de arrastar e soltar e o editor de HTML usam a mesma barra lateral do criador, então as etapas são as mesmas em ambos.

1. Abra o corpo do seu e-mail na Campaign ou no componente do Canvas. No editor de arrastar e soltar, selecione Edit Email Body.
2. Na barra lateral do criador, selecione Content (ao lado de Sending Settings e Preview & Test). Para saber mais sobre esse layout, consulte Criar um e-mail com arrastar e soltar.
3. No submenu Content, selecione Link Management em Design and Build. Se o submenu estiver recolhido, expanda-o usando o controle de seta na barra lateral.
4. Dê um nome a cada alias. A Braze gera um alias padrão exclusivo para cada link, e os aliases devem ter nomes exclusivos por variante de campanha de e-mail ou componente do Canvas.

Use o alias para referenciar um link específico em relatórios e segmentação.

Nota

O aliasing de links é compatível apenas com atributos href dentro de tags de âncora HTML em que é seguro adicionar um parâmetro de consulta. A prática recomendada é incluir um ponto de interrogação (?) no final do seu link para que a Braze possa facilmente adicionar o valor lid. Sem a adição do valor lid, a Braze não reconhece a URL para aliasing de links.

Importante

No editor de arrastar e soltar, seu link deve incluir um ponto de interrogação (?) antes do símbolo de cerquilha (#) na sua URL para que o alias de link apareça na guia Link Management.

Gerenciando aliases de links

Para visualizar todos os seus aliases de links rastreados, faça o seguinte:

1. Acesse Configurações > Preferências de e-mail em Configurações do espaço de trabalho.
2. Selecione a guia Configurações de alias de links.

Aqui, você pode classificar, pesquisar e desativar o rastreamento de aliases de links.

Dica

Use os endpoints Listar alias de link para Campaign e Listar alias de link para Canvas para extrair o alias definido em cada variante de mensagem em uma Campaign ou em um componente de Canvas específico de e-mail.

A Braze recomenda avaliar os links dentro do e-mail, adicionar modelos de link e fornecer uma convenção de nomenclatura que funcione para fins de segmentação e relatórios. Isso ajuda a manter o controle de todos os links.

Quando o alias de link está ativado, mensagens, Content Blocks e modelos de link não são modificados. As mensagens existentes que usam modelos de link ou Content Blocks permanecem as mesmas. No entanto, quando você atualiza uma mensagem, a marcação de alias de link se aplica a todos os links, então reaplique os modelos de link para que os links fiquem visíveis.

Como os links são atualizados com alias de link

As tabelas a seguir fornecem exemplos de links no corpo de um e-mail, resultados do alias de link e explicações de como o link original é atualizado com o alias de link.

Permalink

Lógica: A Braze insere um ponto de interrogação (?) e adiciona o primeiro parâmetro de consulta à URL.

Link com mais parâmetros de consulta

Lógica: A Braze detecta outros parâmetros de consulta e acrescenta lid= ao final da URL.

Link HTML

Lógica: A Braze reconhece que o link é uma URL e que já possui um ponto de interrogação (?) presente, então o parâmetro de consulta lid é acrescentado após o ponto de interrogação.

Link com âncora

Lógica: A Braze espera que a URL use uma estrutura padrão em que as âncoras (#) estejam presentes após um ponto de interrogação (?). Como a Braze lê da esquerda para a direita, o ponto de interrogação e o valor lid são acrescentados antes da âncora.

Link com âncora e tag de captura

Lógica: Ao usar alias de link com URLs que contêm âncoras (#), a Braze espera que a âncora seja posicionada após os parâmetros de consulta. Isso significa que o valor lid deve ser acrescentado antes da âncora para o rastreamento adequado. Como a Braze lê a URL da esquerda para a direita, o ponto de interrogação (?) e o lid devem vir antes da âncora.

Rastreamento de alias de link

Na barra lateral do criador, selecione Conteúdo > Gerenciamento de links (em Design e Build) e, em seguida, selecione quais alias você deseja rastrear. Os alias rastreados ficam disponíveis nos filtros de segmentação que fazem referência a alias de link (consulte Filtros de segmentação). Você também pode enviar mensagens baseadas em ação ou mover usuários por um Canvas quando eles clicam em um alias de link no e-mail — consulte Filtros baseados em ação. A configuração de rastreamento não altera se os cliques nesse link são contabilizados nos relatórios de desempenho de e-mail.

Dica

Para rastrear métricas de engajamento de links, certifique-se de que seu link comece com HTTP ou HTTPS. Para desativar o rastreamento de cliques em links específicos, consulte Links universais e App Links.

A Braze permite que você selecione links ilimitados para rastrear, embora só seja possível redirecionar usuários com base nos links mais recentes que eles abriram. Os perfis de usuário incluem os 100 links clicados mais recentemente. Por exemplo, se você rastrear 500 links e um usuário clicar em todos os 500, você pode redirecionar ou criar Segments com base nos 100 links clicados mais recentemente.

Filtros baseados em ação

Quando o alias de link está ativado para a sua empresa, você pode criar mensagens baseadas em ação direcionadas a qualquer link (rastreado ou não rastreado) ou redirecionar usuários com base em se eles clicaram em um alias em qualquer Campaign de e-mail ou componente do Canvas.

• Se uma Campaign for arquivada, o rastreamento de links será desativado e esse alias de link não poderá ser usado em um filtro diferente.
• Se um link tiver o rastreamento ativado e tiver sido clicado em uma Campaign, você poderá encontrar essa Campaign como uma opção disponível no filtro de segmentação, mesmo que o rastreamento de links tenha sido desativado desde então, desde que pelo menos um link nessa mensagem ainda esteja sendo rastreado.
• Você só pode selecionar um link rastreado como filtro se ele estiver em um Canvas ativo (lançado), usando o menu suspenso do filtro Clicked Alias in Canvas Step. Se o link estiver sendo rastreado em um rascunho de Canvas, você não poderá selecionar o link rastreado como filtro.

Para definir links como não rastreados, consulte Gerenciando alias de link.

Filtros de segmentação

Na Braze, se você tiver um alias de link no seu e-mail e um usuário clicar nele, o evento será registrado no perfil do usuário com o alias.

Se você usar o filtro de segmentação “Clicked Alias in Any Campaign or Canvas Step” e depois decidir renomear esse alias de link, os dados de cliques anteriores no perfil do usuário não serão atualizados, ou seja, eles ainda aparecerão como o alias de link anterior. Portanto, se você direcionar usuários com base no novo alias de link, ele não incluirá os dados do alias de link anterior.

Se você usar o filtro de segmentação “Clicked Alias in Campaign” ou “Clicked Alias in Canvas”, ele filtrará seus usuários com base em se eles clicaram em um alias específico em uma Campaign ou Canvas específico. Se vários usuários compartilharem o mesmo endereço de e-mail e o alias de link for clicado, todos os outros usuários que compartilham esse endereço de e-mail terão seus perfis de usuário atualizados. Esses perfis também são atualizados por eventos de entrega e abertura, não apenas por eventos de clique.

Os seguintes filtros de segmentação se aplicam a eventos de clique que são rastreados no momento em que o evento é processado. Isso significa que links não rastreados não removerão dados existentes e rastrear um link não preencherá retroativamente os dados. Para mais detalhes, consulte Filtros de segmentação.

Desrastreando links

Desrastrear um link não realocará Segments existentes com o filtro para o alias não rastreado. Os dados antigos permanecerão nos perfis de usuário até serem substituídos por dados mais recentes.

Links em mensagens arquivadas são automaticamente desrastreados. No entanto, se mensagens arquivadas forem desarquivadas, os links precisarão ser rastreados novamente. Quando os alias de link estão sendo rastreados, os relatórios de links são indexados pelo alias em vez de domínios de nível superior ou URLs completas.

Para visualizar todos os links na sua Campaign de e-mail e seus respectivos cliques totais, acesse Message Analytics > Email Performance > Preview & Heatmap e selecione o botão de alternância Show Heatmap.

Evento de cliques de e-mail

Se você exportar seus dados de engajamento com o Currents, um evento de clique de e-mail será ligeiramente diferente se você tiver o alias de link ativado. Ele terá dois campos adicionais para o evento de cliques de e-mail quando o alias de link estiver ativado: link_id e link_alias.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

// Email Click: users.messages.email.Click
{
  "id": (string) unique ID of this event,
  "user_id": (string) Braze user ID of the user,
  "external_user_id": (string) External ID of the user,
  "time": (int) 10-digit UTC time of the event in seconds since the epoch,
  "timezone": (string) IANA time zone of the user at the time of the event,
  "campaign_id": (string) ID of the campaign if from a campaign,
  "campaign_name": (string) name of the campaign,
  "message_variation_id": (string) ID of the message variation if from a campaign,
  "message_variation_name": (string) the name of the message variation if from a campaign,
  "canvas_id": (string) ID of the Canvas if from a Canvas,
  "canvas_name": (string) name of the Canvas,
  "canvas_variation_id": (string) ID of the Canvas variation the user is in if from a Canvas,
  "canvas_variation_name": (string) name of the Canvas variation the user is in if from a Canvas,
  "canvas_step_id": (string) ID of the step for this message if from a Canvas,
  "canvas_step_name": (string) name of the step for this message if from a Canvas,
  "send_id": (string) ID of the message if specified for the campaign (See Send Identifier under API Identifier Types),
  "dispatch_id": (string) ID of the message dispatch (unique ID for each 'transmission' sent from the Braze platform). Users who are sent a schedule message get the same dispatch_id. Action-based or API-triggered messages get a unique dispatch_id per user.,
  "email_address": (string) email address for this event,
  "url": (string) the URL that was clicked (Email Click events only),
  "user_agent": (string) description of the user's system and browser for the event (Email Click and Open events only),
  "ip_pool": (string) IP pool used for message sending,
  "link_id": (string) unique value generated by Braze for the URL,
  "link_alias": (string) alias name set when the message was sent
}

Atualização

O comportamento do dispatch_id difere entre Canvas e Campaigns porque a Braze trata etapas do Canvas (exceto etapas de entrada, que podem ser agendadas) como eventos disparados, mesmo quando são “agendadas”. Saiba mais sobre o comportamento do dispatch_id em Canvas e Campaigns.

Atualização registrada em agosto de 2019.

Aliasing de links em Content Blocks

Novos Content Blocks terão seus links modificados, e a Braze adicionará um lid= a cada link quando aplicável. Esse valor de placeholder é resolvido quando inserido em uma variante de mensagem de e-mail.

Para modificar os links em Content Blocks existentes que foram criados antes da Braze ativar o aliasing de links, duplique os Content Blocks existentes e, em seguida, modifique os links nos Content Blocks duplicados.

Quando um Content Block sem um valor lid é inserido em uma nova mensagem, os links desse Content Block não são rastreados com um alias. Quando um novo Content Block é inserido em uma variante de mensagem “antiga”, os links dessa variante de mensagem serão reconhecidos pelo aliasing de links. Os links do Content Block também são reconhecidos. No entanto, Content Blocks “antigos” não podem aninhar Content Blocks “novos”.

Dica

Para Content Blocks, a Braze recomenda criar cópias dos Content Blocks existentes para usar em novas mensagens. Isso pode ser feito por meio de duplicação em massa para evitar cenários em que você possa referenciar um Content Block que não foi habilitado para aliasing de links em uma nova mensagem.

Aliasing de links para URLs geradas por Liquid

Para URLs geradas por Liquid (por exemplo, assign no HTML, valores extraídos de um Content Block ou Liquid em um atributo personalizado), a Braze precisa de um local claro para inserir o parâmetro de consulta lid. Na maioria dos casos, quando o Liquid permanece na URL, a Braze não infere se deve iniciar uma nova query string com ? ou unir a uma consulta existente com &, a menos que você adicione esse delimitador.

Faça o seguinte:

• Se a URL não inclui uma query string, adicione ? após o Liquid (por exemplo, ?).
• Se a URL já inclui ? e parâmetros de consulta, adicione & após o Liquid (por exemplo, &).

Nota

Quando você usa modelos de link com URLs geradas por Liquid, a Braze pode normalizar de forma conservadora a URL renderizada após a execução do Liquid quando ela contém exatamente dois caracteres ? usados como separadores de consulta. O segundo ? pode ser reescrito como & para que a Braze altere o mínimo possível da URL.

A Braze não tenta corrigir todos os padrões com ? duplicado, e o tratamento de URLs mais complexas permanece intencionalmente limitado. Adicione o ? ou & correto na sua marcação primeiro e trate qualquer normalização como uma proteção limitada — não como um substituto para URLs bem formadas ou para que os links sejam reconhecidos em Link Management quando nenhum delimitador está presente.

Sem um ? ou & no final (ou outro ponto de inserção suportado), o aliasing de links não reconhece a URL, o Link Management não a lista e os modelos de link não são aplicados.

Fragmentos de URL (#) e parâmetros de rastreamento

O fragmento (# e tudo depois dele) não é enviado ao servidor em uma solicitação de link normal. A Braze insere lid na query string, que deve aparecer antes do #. Se o seu href tem Liquid e um fragmento #, mas nenhum ? ou & antes do #, a Braze não pode adicionar lid com segurança, então o link pode não aparecer no Link Management ou ser rastreado como um alias de link.

Isso é especialmente comum no editor de arrastar e soltar quando uma URL de botão mistura Liquid com um padrão baseado em hash (por exemplo, um caminho estático, seguido de # e depois pares chave-valor adicionais). Nesse caso, adicione ? imediatamente antes do # para que a query string (incluindo lid) seja analisada antes do fragmento.

1

https://example.com/campaign/to/abc123?#user_id={{${user_id}}}&source=email

No exemplo anterior, o ? antes do # fornece à Braze um segmento de consulta para adicionar lid. Se você vir erros como “failed to be assigned an LID” para uma URL dinâmica, confirme que o href usa o padrão ? ou & mostrado nos exemplos desta seção.

Considerações sobre o editor de arrastar e soltar

No editor de arrastar e soltar, os campos que contêm um link (como a URL de um botão) validam o href subjacente antes da execução do Liquid. Espaços, quebras de linha e outros caracteres que não são seguros para URLs podem causar comportamentos inesperados quando a Braze adiciona modelos de link ou parâmetros de aliasing de links. Quando você precisar de Liquid condicional para o destino, defina a URL em um bloco HTML (veja a seção a seguir) e referencie uma única variável no campo de URL do editor de arrastar e soltar, em vez de colocar Liquid complexo diretamente nesse campo.

Exemplo com Content Block

Se um Content Block contém um link como https://www.braze.com/{{custom_attribute.${offer_id}}} sem ? ou & no final, a Braze não sabe onde adicionar lid, então o link não é capturado pelo Link Management. Adicione ? ou & no final da URL no Content Block (dependendo se uma query string já existe), salve o Content Block e o link poderá ser reconhecido.

Relatórios quando a URL varia por usuário

Cada href distinto na mensagem é mapeado para um ID de link e um alias de link para o Link Management e relatórios baseados em alias. Quando os aliases de links são rastreados, os relatórios de e-mail no dashboard são indexados pelo alias, e não por cada URL resolvida possível.

Use as seguintes abordagens na Braze primeiro:

• Análise de e-mail de Campaign e Canvas: Revise os cliques agregados por link em Message Analytics > Email Performance > Preview & Heatmap com Show Heatmap ativado, conforme descrito em Links sem rastreamento.
• Cliques por destinatário no Query Builder: Execute o modelo do Query Builder Email URLs clicked para uma Campaign ou Canvas. O modelo apresenta links despersonalizados para contagens resumidas; a exportação CSV inclui os IDs de usuário dos clicadores, o link que clicaram e um registro de data e hora. (URLs despersonalizadas removem tags Liquid para a visualização resumida; consulte a descrição do modelo para mais detalhes.)
• Detalhamento por alias no criador: Se você precisa que cada destino (por exemplo, cada offer_id) apareça como sua própria linha no Link Management e nos relatórios baseados em alias, use valores de href separados (e, portanto, aliases separados) — por exemplo, links distintos por ramificação — em vez de um único link cujo caminho muda por usuário.

Se você também usa exportações de engajamento por streaming, os eventos de clique em e-mail incluem um campo url; consulte Evento de cliques em e-mail nesta página para saber como essa carga útil se relaciona com o aliasing de links.

Exemplo

Use este padrão quando a URL atribuída não possui parâmetros de consulta:

1
2
3

{% assign link1 = "https://www.braze1.com" %}

<a href="{{link1}}?">Visit Braze</a>

Se a URL atribuída já contém ? e parâmetros de consulta, adicione & após o Liquid em vez de ?:

1
2
3

{% assign link_with_params = "https://www.braze1.com?campaign=test" %}

<a href="{{link_with_params}}&">Visit Braze</a>

URLs com Liquid condicional

Quando tags Liquid condicionais são usadas dentro de um href (por exemplo, para definir uma URL com {% if %}, {% elsif %} ou {% unless %}), o aliasing de links não se aplica a esses links. Isso significa que esses links não aparecem no Link Management e não recebem um lid para rastreamento de cliques.

Recomendado: Construa a URL final em um bloco HTML com assign (ou {% capture %}), depois referencie essa variável onde precisar do link. No editor de arrastar e soltar, cole a variável no campo de URL do botão com um ? ou & no final, conforme apropriado — por exemplo, ?.

1
2
3
4
5

{% if {{custom_attribute.${account_tier}}} == "pro" %}
{% assign url = "https://example.com/pro/verify" %}
{% else %}
{% assign url = "https://example.com/retail/account" %}
{% endif %}

No campo de URL do botão (arrastar e soltar) ou no HTML, aponte o href para a variável com um delimitador:

1

<a href="{{ url }}?">Go to account</a>

Como alternativa, você pode capturar a URL em uma única variável:

1
2
3
4
5
6
7
8
9

{% capture url %}
  {%- if condition -%}
    https://example.com/url1
  {%- else -%}
    https://example.com/url2
  {%- endif -%}
{% endcapture %}

<a href="{{ url }}?">Go to account</a>

Solução de problemas

Uma página ou configuração de gerenciamento de links está ausente

Se o dashboard não corresponder à navegação deste artigo, use a tabela a seguir para descobrir o motivo.

Destinos que não aceitam o parâmetro lid

Quando você envia uma mensagem de teste pelo editor de e-mail, a Braze anexa lid={{placeholder}} aos seus links (o placeholder se torna um valor exclusivo no momento do envio). Se o site ou a API de destino não tolerar parâmetros de consulta adicionais, o link pode funcionar no editor, mas falhar ao ser aberto a partir do e-mail.

Sem o valor lid, a Braze não trata a URL como link-aliased para rastreamento e segmentação. Recomendamos atualizar seu backend ou site para que ele ignore o parâmetro de consulta lid quando presente. Isso preserva o link aliasing, os relatórios e os casos de uso de Segment descritos neste artigo.

Enquanto você planeja uma mudança no backend, é possível desativar o rastreamento dos aliases afetados em Settings > Email Preferences > Link Aliasing Settings. Desativar o rastreamento não remove o parâmetro lid. Para saber como a desativação do rastreamento afeta Segments e filtros, consulte Desativar o rastreamento de links.

Para impedir que a Braze anexe o lid, entre em contato com o suporte da Braze para desativar o link aliasing da sua empresa. Observe as seguintes considerações caso o link aliasing seja desativado:

• Novas mensagens de e-mail e Content Blocks normalmente não receberão nova marcação de link-alias (como o parâmetro de consulta lid).
• Mensagens existentes que foram criadas enquanto o link aliasing estava ativado ainda podem conter marcação de link-alias no HTML. Pode ser necessário remover manualmente os parâmetros lid remanescentes onde você não os deseja mais.
• Se você editar uma Campaign existente, uma etapa de e-mail do Canvas ou um Content Block, pode ser necessário adicionar modelos de link novamente para que os links com modelo sejam exibidos corretamente.
• Os relatórios de cliques para envios que ocorreram enquanto o link aliasing estava ativado podem não corresponder de forma precisa aos relatórios após a desativação do recurso.
• Segments que usam filtros baseados em link-alias (por exemplo, filtros Clicked Alias) podem parar de retornar os públicos esperados.