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 o alias de link

Com o alias de link, você pode criar nomes gerados pelo usuário para identificar e rastrear links enviados em e-mails. Dessa forma, você pode usar esses aliases de link reconhecíveis nos seus e-mails para rastrear o engajamento e analisar a performance de Campaigns, sem precisar referenciar o link completo.

Com o alias de link, você pode:

• Redirecionar usuários que clicaram em links específicos: Identificar e direcionar usuários que clicaram em um link.
• Criar gatilhos baseados em ação: Enviar um e-mail quando um usuário clicar em um link.
• Analisar métricas: Comparar quantos usuários clicaram no Link A versus o 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 dos usuários 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 das suas campanhas de e-mail.

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

Criando um alias de link

Importante

Link Management aparece no criador de e-mail da campanha ou do Canvas quando a Braze ativa o gerenciamento de links para a sua conta. Para criar e editar aliases de link, o alias de link deve estar ativado. Se Link Management não estiver aparecendo, entre em contato com o seu gerente de conta para ativar o alias de link.

Para criar um alias de link, abra o corpo do e-mail na campanha ou no componente do Canvas e, em seguida, abra Link Management na área Content. Os editores de arrastar e soltar e de HTML usam o mesmo layout de barra lateral:

Editor de arrastar e soltar

1. Selecione Edit Email Body para abrir o editor de arrastar e soltar.
2. Na barra lateral do editor, selecione Content (ao lado de Sending Settings e Preview & Test). Para mais informações sobre esse layout, consulte Criar um e-mail com arrastar e soltar.
3. No submenu Content, selecione Link Management (aparece em Design and Build). Se o submenu estiver recolhido, expanda-o usando o controle de seta na barra lateral.

Editor de HTML

1. Acesse o corpo do e-mail no editor.
2. Na barra lateral do editor, selecione Content.
3. No submenu Content, selecione Link Management em Design and Build.

Em Link Management:

1. A Braze gera automaticamente aliases de link padrão exclusivos para cada um dos seus links.
2. Dê um nome ao alias. Os aliases devem ter nomes exclusivos por variante de campanha de e-mail ou componente do Canvas.

Você também pode definir um alias que será usado para referenciar um link específico ao lidar com relatórios ou segmentação.

Nota

O alias de link é suportado apenas em atributos href dentro de tags de âncora HTML onde é seguro adicionar um parâmetro de consulta. É uma boa prática 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 reconhecerá a URL para alias de link.

Gerenciando aliases de link

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

1. Acesse Settings > Email Preferences em Workspace Settings.
2. Selecione a guia Link Aliasing Settings.

Importante

Se você estiver usando a navegação antiga, essas configurações estão em Manage Settings.

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

Dica

Use os endpoints List link alias for campaign e List link alias for Canvas para extrair o alias definido em cada variante de mensagem em uma campanha ou em um componente do 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 você a manter o controle de todos os links.

Quando o alias de link está ativado, as mensagens, Content Blocks e modelos de link não são modificados. Quaisquer mensagens existentes que usem modelos de link ou Content Blocks permanecerão iguais. No entanto, quando você atualizar uma mensagem, a marcação de alias de link será aplicada a todos os links, então você precisará reaplicar os modelos de link para que os links fiquem visíveis.

Como os links são atualizados com o 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 na URL.

Link com mais parâmetros de consulta

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

Link HTML

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

Link com âncora

Lógica: A Braze espera que a URL use uma estrutura padrão onde as âncoras (#) estão 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 adicionados antes da âncora.

Link com âncora e tag de captura

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

Rastreando aliases de link

Na barra lateral do editor, selecione Content > Link Management (em Design and Build) e, em seguida, selecione quais aliases você deseja que sejam rastreados. Os aliases rastreados ficam disponíveis nos filtros de segmentação que referenciam aliases 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 clicarem em um alias de link no e-mail — consulte Filtros baseados em ação. A configuração de rastreado não altera se os cliques nesse link contam nos relatórios de performance de e-mail.

Dica

Para rastrear métricas de engajamento de link, 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 você só possa 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 segmentos com base nos 100 links clicados mais recentemente.

Nota

A Braze rastreia apenas os últimos 100 aliases de link clicados no nível do perfil.

Filtros baseados em ação

Você pode criar mensagens baseadas em ação direcionando qualquer link (rastreado ou não rastreado) ou redirecionar usuários com base em se eles clicaram em um alias em qualquer campanha de e-mail ou componente do Canvas.

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 é 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 mostrarão o alias de link anterior. Portanto, se você direcionar usuários com base no novo alias de link, isso 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 filtra 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 o 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 filtros de segmentação a seguir 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.

Cancelando o rastreamento de links

Cancelar o rastreamento de um link não realocará segmentos 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 aliases de link são rastreados, os relatórios de link são indexados pelo alias em vez de domínios de nível superior ou URLs completas.

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

Evento de cliques de e-mail

Se você exportar seus dados de engajamento com 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 as etapas do Canvas (exceto as 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.

Alias de link em Content Blocks

Novos Content Blocks terão seus links modificados, onde 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 dentro de Content Blocks existentes que foram criados antes da Braze ativar o alias de link, duplique os Content Blocks existentes e depois modifique os links dentro dos 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 alias de link. 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 duplicação em massa para evitar cenários em que você possa referenciar um Content Block que não foi habilitado para alias de link em uma nova mensagem.

Alias de link para URLs geradas por Liquid

Para URLs geradas por Liquid (por exemplo, instruções 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 query 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 de ? duplicados, 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 & final (ou outro ponto de inserção suportado), o alias de link não reconhece a URL, 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 requisição de link normal. A Braze insere o 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 o lid com segurança, então o link pode não aparecer em Link Management ou ser rastreado como alias de link.

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

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

No exemplo acima, o ? antes do # fornece à Braze um segmento de consulta para adicionar o lid. Sem ele, o link pode não aparecer em Link Management.

Considerações do 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 URL podem causar comportamento inesperado quando a Braze adiciona modelos de link ou parâmetros de alias de link. Quando você precisa de Liquid condicional para o destino, defina a URL em um bloco HTML (consulte a seção a seguir) e referencie uma única variável no campo de URL do arrastar e soltar, em vez de colocar Liquid complexo diretamente nesse campo.

Exemplo de Content Block

Se um Content Block contém um link como https://www.braze.com/} sem um ? ou & final, a Braze não sabe onde adicionar o lid, então o link não é capturado para Link Management. Adicione ? ou & no final da URL no Content Block (dependendo de já existir ou não uma query string), 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 Link Management e relatórios baseados em alias. Quando aliases de link são rastreados, os relatórios de e-mail no dashboard são indexados pelo alias em vez de cada URL resolvida possível.

Use as seguintes abordagens na Braze primeiro:

• Análise de dados 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 Cancelando o rastreamento de links.
• Cliques por destinatário no Criador de consultas: Execute o modelo Criador de consultas Email URLs clicked para uma Campaign ou Canvas. O modelo exibe links despersonalizados para contagens resumidas; a exportação CSV inclui os IDs de usuário dos que clicaram, o link clicado e um timestamp. (URLs despersonalizadas removem tags Liquid para a visualização resumida; consulte a descrição do modelo para detalhes.)
• Detalhamentos por alias no editor: Se você precisa que cada destino (por exemplo, cada offer_id) apareça como sua própria linha em Link Management e nos relatórios baseados em alias, use valores href separados (e, portanto, aliases separados) — por exemplo, links distintos por ramificação — em vez de um link cujo caminho muda por usuário.

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

Exemplo

Use este padrão quando a URL atribuída não tem 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 alias de link não se aplica a esses links. Isso significa que esses links não aparecem em 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 %}) e 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 & 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>

Alternativamente, você pode capturar a URL em uma 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>