リンクエイリアス
リンクエイリアスを使用して、Brazeから送信されるメールメッセージ内のリンクを識別するための、認識しやすいユーザー生成名を作成できます。これらのリンクは、セグメンテーションのリターゲティング、アクションベースのトリガー、およびリンク分析に利用できます。
リンクエイリアスについて
リンクエイリアスを使用すると、メールで送信されるリンクを識別・追跡するためのユーザー生成名を作成できます。これにより、完全なリンクを参照することなく、認識しやすいリンクエイリアスをメールで効率的に使用して、エンゲージメントを追跡し、Campaignのパフォーマンスを分析できます。
リンクエイリアスを使用すると、以下のことが可能です。
- 特定のリンクをクリックしたユーザーをリターゲティングする: リンクをクリックしたユーザーを特定してターゲティングします。
- アクションベースのトリガーを作成する: ユーザーがリンクをクリックしたときにメールを送信します。
- 指標を分析する: リンクAとリンクBのクリック数を比較します。
仕組み
Brazeは、すべてのリンクURLにlid(リンク識別子とも呼ばれる)という追加パラメーターを付加することで、メール内のリンクを一意に識別します。このlid値により、URLの他のパラメーターが異なる場合でも、Brazeはリンクに対するユーザーインタラクションを追跡、監視、集計できます。これにより、メールCampaignのコンテンツに対するユーザーのエンゲージメントに関するインサイトが得られます。
リンク識別子は、メールCampaign、メールメッセージを含むCanvas、またはContent Blocksが複製された場合にも更新されます。
リンクエイリアスの作成

リンク管理は、Brazeがアカウントのリンク管理を有効にすると、CampaignまたはCanvasのメールコンポーザーに表示されます。リンクエイリアスを作成・編集するには、リンクエイリアスをオンにする必要があります。リンク管理が表示されない場合は、アカウントマネージャーに連絡してリンクエイリアスをオンにしてください。
リンクエイリアスを作成するには、CampaignまたはCanvasコンポーネントでメール本文を開き、コンテンツエリアからリンク管理を開きます。ドラッグ&ドロップエディターとHTMLエディターは同じサイドバーレイアウトを使用します。
ドラッグ&ドロップエディター
- メール本文を編集を選択して、ドラッグ&ドロップコンポーザーを開きます。
- コンポーザーのサイドバーで、コンテンツ(送信設定およびプレビューとテストの横)を選択します。このレイアウトの詳細については、ドラッグ&ドロップでメールを作成するを参照してください。
- コンテンツサブメニューで、リンク管理(デザインとビルドの下に表示)を選択します。サブメニューが折りたたまれている場合は、サイドバーの矢印コントロールを使用して展開します。
HTMLエディター
- コンポーザーでメール本文に移動します。
- コンポーザーのサイドバーで、コンテンツを選択します。
- コンテンツサブメニューで、デザインとビルドの下にあるリンク管理を選択します。
リンク管理では以下の操作を行います。
- Brazeが各リンクに対して一意のデフォルトリンクエイリアスを自動的に生成します。
- エイリアスに名前を付けます。エイリアスは、メールCampaignバリアントまたはCanvasコンポーネントごとに一意の名前を付ける必要があります。
レポートやセグメンテーションで特定のリンクを参照するために使用するエイリアスを設定することもできます。


リンクエイリアスは、クエリパラメーターを安全に付加できるHTMLアンカータグ内のhref属性でのみサポートされています。Brazeがlid値を簡単に付加できるように、リンクの末尾に疑問符(?)を含めることがベストプラクティスです。lid値を付加しないと、BrazeはリンクエイリアスのためにそのURLを認識しません。
リンクエイリアスの管理
追跡されているすべてのリンクエイリアスを表示するには、以下の手順に従います。
- 設定 > ワークスペース設定のメール設定に移動します。
- リンクエイリアス設定タブを選択します。

旧ナビゲーションを使用している場合、これらの設定は設定の管理にあります。
ここでは、リンクエイリアスの並べ替え、検索、およびトラッキングのオン/オフを切り替えることができます。


Campaignのリンクエイリアス一覧およびCanvasのリンクエイリアス一覧エンドポイントを使用して、CampaignまたはメールのCanvasコンポーネントの各メッセージバリアントに設定されたaliasを抽出できます。
Brazeでは、メール内のリンクを評価し、リンクテンプレートを追加し、セグメンテーションやレポートに適した命名規則を設定することを推奨しています。これにより、すべてのリンクを把握しやすくなります。
リンクエイリアスがオンになっている場合、メッセージ、Content Blocks、およびリンクテンプレートは変更されません。リンクテンプレートやContent Blocksを使用している既存のメッセージはそのままです。ただし、メッセージを更新すると、リンクエイリアスのマークアップがすべてのリンクに適用されるため、リンクを表示するにはリンクテンプレートを再適用する必要があります。
リンクエイリアスによるリンクの更新方法
以下の表は、メール本文内のリンク、リンクエイリアスの結果、および元のリンクがリンクエイリアスによってどのように更新されるかの説明の例を示しています。
パーマリンク
ロジック: Brazeは疑問符(?)を挿入し、URLに最初のクエリパラメーターを追加します。
| メール本文内のリンク | エイリアス付きリンク |
|---|---|
https://www.braze.com |
https://www.braze.com?lid=slfdldtqdhdk |
追加のクエリパラメーターを含むリンク
ロジック: Brazeは他のクエリパラメーターを検出し、URLの末尾にlid=を付加します。
| メール本文内のリンク | エイリアス付きリンク |
|---|---|
https://www.braze.com?utm_campaign=retention&utm_source=email |
https://www.braze.com?utm_campaign=retention&utm_source=email&lid=0goty30mviyz |
HTMLリンク
ロジック: Brazeはリンクがすでに疑問符(?)を含むURLであることを認識し、疑問符の後にlidクエリパラメーターを付加します。
| メール本文内のリンク | エイリアス付きリンク |
|---|---|
<a href="{{custom_attribute.{product_url}}}?"> |
<a href="{{custom_attribute.{product_url}}}?lid=ac7a548g5kl7"> |
アンカー付きリンク
ロジック: Brazeは、アンカー(#)が疑問符(?)の後に配置される標準的なURL構造を想定しています。Brazeは左から右に読み取るため、疑問符とlid値はアンカーの前に付加されます。
| メール本文内のリンク | エイリアス付きリンク |
|---|---|
https://www.braze.com#bookmark1?utm_source=email |
https://www.braze.com?lid=eqslgd5a9m3y#bookmark1?utm_source=email |
アンカーとキャプチャタグ付きリンク
ロジック: リンクエイリアスをアンカー(#)を含むURLで使用する場合、Brazeはアンカーがクエリパラメーターの後に配置されることを想定しています。つまり、適切なトラッキングのためにlid値はアンカーの前に付加される必要があり、Brazeは左から右にURLを読み取るため、疑問符(?)とlidはアンカーの前に配置されます。
| メール本文内のリンク | エイリアス付きリンク |
|---|---|
<a href="https://www.braze.com/promotions#special-offer">Check out our special offer!</a> |
<a href="https://www.braze.com/promotions?lid={{link_alias}}#special-offer">Check out our special offer!</a> |
リンクエイリアスのトラッキング
コンポーザーのサイドバーで、コンテンツ > リンク管理(デザインとビルドの下)を選択し、追跡するエイリアスを選択します。追跡されたエイリアスは、リンクエイリアスを参照するセグメンテーションフィルターで利用できます(セグメンテーションフィルターを参照)。また、ユーザーがメール内のリンクエイリアスをクリックしたときに、アクションベースのメッセージを送信したり、Canvas内でユーザーを移動させたりすることもできます(アクションベースのフィルターを参照)。追跡設定は、そのリンクのクリックがメールパフォーマンスレポートでカウントされるかどうかには影響しません。

リンクのエンゲージメント指標を追跡するには、リンクがHTTPまたはHTTPSで始まることを確認してください。特定のリンクのクリックトラッキングをオフにするには、ユニバーサルリンクとアプリリンクを参照してください。
Brazeでは無制限のリンクを追跡できますが、リターゲティングできるのはユーザーが最近開いたリンクのみです。ユーザープロファイルには、最近クリックされた100件のリンクが含まれます。たとえば、500件のリンクを追跡し、ユーザーがそのすべてをクリックした場合、最近クリックされた100件のリンクに基づいてリターゲティングまたはSegmentを作成できます。


Brazeは、プロファイルレベルで最後にクリックされた100件のリンクエイリアスのみを追跡します。
アクションベースのフィルター
任意のリンク(追跡または未追跡)をターゲットとするアクションベースのメッセージを作成したり、メールCampaignまたはCanvasコンポーネント全体でエイリアスをクリックしたかどうかに基づいてユーザーをリターゲティングしたりできます。

セグメンテーションフィルター
Brazeでは、メールにリンクエイリアスがあり、ユーザーがそれをクリックすると、そのイベントがエイリアスとともにユーザーのプロファイルに記録されます。
「任意のCampaignまたはキャンバスステップでエイリアスをクリック」セグメンテーションフィルターを使用し、後でこのリンクエイリアスの名前を変更した場合、ユーザープロファイル内の以前のクリックデータは更新されません。つまり、以前のリンクエイリアスとして表示されたままです。そのため、新しいリンクエイリアスに基づいてユーザーをターゲティングしても、以前のリンクエイリアスのデータは含まれません。
「Campaignでエイリアスをクリック」または「Canvasでエイリアスをクリック」セグメンテーションフィルターを使用すると、特定のCampaignまたはCanvasで特定のエイリアスをクリックしたかどうかでユーザーをフィルタリングします。複数のユーザーが同じメールアドレスを共有しており、リンクエイリアスがクリックされた場合、そのメールアドレスを共有する他のすべてのユーザーのプロファイルも更新されます。これらのプロファイルは、クリックイベントだけでなく、配信イベントや開封イベントによっても更新されます。
以下のセグメンテーションフィルターは、イベントが処理された時点で追跡されるクリックイベントに適用されます。つまり、未追跡のリンクは既存のデータを削除せず、リンクの追跡はデータをバックフィルしません。詳細については、セグメンテーションフィルターを参照してください。
リンクの追跡解除
リンクの追跡を解除しても、フィルターを使用している既存のSegmentが追跡解除されたエイリアスに再割り当てされることはありません。古いデータは、新しいデータに置き換えられるまでユーザープロファイルに残ります。
アーカイブされたメッセージ内のリンクは自動的に追跡解除されます。ただし、アーカイブされたメッセージがアーカイブ解除された場合、リンクを再度追跡する必要があります。リンクエイリアスが追跡されている場合、リンクレポートはトップレベルドメインや完全なURLではなく、エイリアスによってインデックスされます。
メールCampaign内のすべてのリンクとそれぞれの合計クリック数を表示するには、メッセージ分析 > メールのパフォーマンス > プレビューとヒートマップに移動し、ヒートマップを表示トグルを選択します。

メールクリックイベント
エンゲージメントデータをCurrentsでエクスポートする場合、リンクエイリアスが有効になっていると、メールクリックイベントは若干異なります。リンクエイリアスがオンの場合、メールクリックイベントにlink_idとlink_aliasの2つの追加フィールドがあります。
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
}

dispatch_idの動作は、CanvasとCampaignで異なります。Brazeは、Canvasステップ(エントリステップを除く。エントリステップはスケジュール可能)を、「スケジュール済み」であってもトリガーイベントとして扱います。CanvasおよびCampaignにおけるdispatch_idの動作の詳細をご覧ください。
2019年8月に更新。
Content Blocksでのリンクエイリアス
新しいContent Blocksでは、該当する場合、各リンクにlid=が付加されるようにリンクが変更されます。このプレースホルダー値は、メールメッセージバリアントに挿入されたときに解決されます。
Brazeがリンクエイリアスを有効にする前に作成された既存のContent Blocks内のリンクを変更するには、既存のContent Blocksを複製し、複製されたContent Blocks内のリンクを変更してください。
lid値のないContent Blocksが新しいメッセージに挿入された場合、そのContent Blocksのリンクはエイリアスで追跡されません。新しいContent Blocksが「古い」メッセージバリアントに挿入された場合、そのメッセージバリアントのリンクはリンクエイリアスによって認識されます。Content Blocksのリンクも認識されます。ただし、「古い」Content Blocksは「新しい」Content Blocksをネストできません。

Content Blocksについては、新しいメッセージで使用するために既存のContent Blocksのコピーを作成することをBrazeは推奨しています。これは一括複製で行うことができ、リンクエイリアスが有効になっていないContent Blocksを新しいメッセージで参照するシナリオを防ぐことができます。
Liquidで生成されるURLのリンクエイリアス
HTMLのassignステートメント、Content Blocksから取得した値、カスタム属性内のLiquidなど、Liquidで生成されるURLの場合、Brazeはlidクエリパラメーターを挿入する明確な場所を必要とします。ほとんどの場合、LiquidがURL内に残っていると、Brazeは?で新しいクエリ文字列を開始するか&で既存のクエリに結合するかを推測しません(デリミタを自分で追加しない限り)。
以下の手順に従ってください。
- URLにまだクエリ文字列が含まれていない場合は、Liquidの後に
?を追加します(例:?)。 - URLにすでに
?とクエリパラメーターが含まれている場合は、Liquidの後に&を追加します(例:&)。

Liquidで生成されたURLでリンクテンプレートを使用する場合、Brazeは、Liquid実行後にレンダリングされたURLがクエリセパレーターとして使用される?を正確に2つ含む場合、保守的にURLを正規化することがあります。2つ目の?は&に書き換えられ、BrazeはURLをできるだけ変更しないようにします。
Brazeはすべての重複?パターンを修正しようとするわけではなく、より複雑なURLの処理は意図的に制限されています。まずマークアップで正しい?または&を追加し、正規化は限定的なセーフガードとして扱ってください。整形されたURLの代替や、デリミタがない場合にリンク管理でリンクを認識させるための代替手段ではありません。
末尾に?または&(またはその他のサポートされている挿入ポイント)がない場合、リンクエイリアスはURLを認識せず、リンク管理にリストされず、リンクテンプレートも適用されません。
URLフラグメント(#)とトラッキングパラメーター
フラグメント(#とそれ以降のすべて)は、通常のリンクリクエストではサーバーに送信されません。Brazeはlidをクエリ文字列に挿入しますが、これは#の前に配置される必要があります。hrefにLiquidと#フラグメントがあるが、#の前に?または&がない場合、Brazeは安全にlidを付加できないため、リンクがリンク管理に表示されなかったり、リンクエイリアスとして追跡されなかったりする場合があります。
これは、ドラッグ&ドロップエディターでボタンURLがLiquidとハッシュベースのパターンを組み合わせている場合(たとえば、静的パスの後に#、その後にキーと値のペアが続く場合)に特によく見られます。その場合、#の直前に?を追加して、クエリ文字列(lidを含む)がフラグメントの前に解析されるようにします。
1
https://example.com/campaign/to/abc123?#user_id={{${user_id}}}&source=email
上記の例では、#の前の?により、Brazeがlidを付加するクエリセグメントが提供されます。これがないと、リンクがリンク管理に表示されない場合があります。
ドラッグ&ドロップエディターに関する注意事項
ドラッグ&ドロップエディターでは、リンクを保持するフィールド(ボタンのURLなど)は、Liquidが実行される前に基になるhrefを検証します。スペース、改行、およびURLセーフでないその他の文字は、Brazeがリンクテンプレートやリンクエイリアスパラメーターを付加する際に予期しない動作を引き起こす可能性があります。送信先に分岐Liquidが必要な場合は、HTMLブロックでassignを使用してURLを設定し(次のセクションを参照)、複雑なLiquidを直接そのフィールドに入力する代わりに、ドラッグ&ドロップのURLフィールドで単一の変数を参照してください。
Content Blocksの例
Content Blocksにhttps://www.braze.com/}のようなリンクが含まれており、末尾に?または&がない場合、Brazeはlidを付加する場所がわからないため、リンクはリンク管理に取得されません。Content Block内のURLの末尾に?または&を追加し(クエリ文字列がすでに存在するかどうかに応じて)、Content Blocksを保存すると、リンクが認識されるようになります。
ユーザーごとにURLが異なる場合のレポート
メッセージ内の各固有のhrefは、リンク管理およびエイリアスベースのレポートにおいて、1つのリンクIDと1つのリンクエイリアスにマッピングされます。リンクエイリアスが追跡されている場合、ダッシュボード内のメールレポートは、解決される可能性のあるすべてのURLではなく、エイリアスによってインデックスされます。
まず、Brazeで以下のアプローチを使用してください。
- CampaignおよびCanvasのメール分析: リンクの追跡解除で説明されているように、メッセージ分析 > メールのパフォーマンス > プレビューとヒートマップでヒートマップを表示をオンにして、リンクごとの集計クリック数を確認します。
- クエリビルダーでの受信者ごとのクリック: CampaignまたはCanvasのメールURLクリッククエリビルダーテンプレートを実行します。テンプレートは、サマリーカウント用に非パーソナライズされたリンクを表示します。CSVエクスポートには、クリックしたユーザーのユーザーID、クリックしたリンク、およびタイムスタンプが含まれます。(非パーソナライズされたURLは、サマリービュー用にLiquidタグを除去します。詳細はテンプレートの説明を参照してください。)
- コンポーザーでのエイリアスレベルの内訳: 各送信先(たとえば、各
offer_id)をリンク管理およびエイリアスベースのレポートで個別の行として表示する必要がある場合は、ユーザーごとにパスが変わる1つのリンクではなく、個別のhref値(したがって個別のエイリアス)を使用してください。たとえば、ブランチごとに異なるリンクを使用します。
ストリーミングエンゲージメントエクスポートも使用している場合、メールクリックイベントにはurlフィールドが含まれます。そのペイロードとリンクエイリアスの関係については、このページのメールクリックイベントを参照してください。
例
割り当てられたURLにクエリパラメーターがない場合は、このパターンを使用します。
1
2
3
{% assign link1 = "https://www.braze1.com" %}
<a href="{{link1}}?">Visit Braze</a>
割り当てられたURLにすでに?とクエリパラメーターが含まれている場合は、?の代わりにLiquidの後に&を追加します。
1
2
3
{% assign link_with_params = "https://www.braze1.com?campaign=test" %}
<a href="{{link_with_params}}&">Visit Braze</a>
条件付きLiquidを含むURL
条件付きLiquidタグがhref内で使用されている場合(たとえば、{% if %}、{% elsif %}、または{% unless %}を使用してURLを設定する場合)、リンクエイリアスはそれらのリンクに適用されません。つまり、これらのリンクはリンク管理に表示されず、クリックトラッキング用のlidも付与されません。
推奨: HTMLブロックでassign(または{% capture %})を使用して最終URLを構築し、リンクが必要な場所でその変数を参照します。ドラッグ&ドロップエディターでは、ボタンのURLフィールドに末尾の?または&を適切に付けて変数を貼り付けます。たとえば、?のようにします。
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 %}
ボタンのURLフィールド(ドラッグ&ドロップ)またはHTMLで、デリミタ付きの変数にhrefを向けます。
1
<a href="{{ url }}?">Go to account</a>
または、URLを1つの変数にキャプチャすることもできます。
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>