リンクエイリアス

リンクエイリアスを使用して、Brazeから送信されるメールメッセージ内のリンクを識別するための、認識しやすいユーザー生成名を作成できます。これらのリンクは、セグメンテーションのリターゲティング、アクションベースのトリガー、およびリンク分析に利用できます。

リンクエイリアスについて

リンクエイリアスを使用すると、メールで送信されるリンクを識別・トラッキングするためのユーザー定義の名前を作成できます。これにより、完全なリンクを参照することなく、わかりやすいリンクエイリアスをメール内で効率的に使用して、エンゲージメントをトラッキングし、キャンペーンのパフォーマンスを分析できます。

リンクエイリアスを使用すると、以下のことが可能です。

• 特定のリンクをクリックしたユーザーをリターゲティングする: リンクをクリックしたユーザーを識別してターゲティングします。
• アクションベースのトリガーを作成する: ユーザーがリンクをクリックしたときにメールを送信します。
• 指標を分析する: リンクAとリンクBをクリックしたユーザー数を比較します。

仕組み

Brazeは、すべてのリンクURLにlid（リンク識別子）と呼ばれる追加パラメーターを付加することで、メール内のリンクを一意に識別します。このlid値により、Brazeは他のURLパラメーターが異なる場合でも、リンクに対するユーザーインタラクションをトラッキング、モニタリング、集計できます。これにより、メールキャンペーンのコンテンツにユーザーがどのようにエンゲージしているかについてのインサイトが得られます。

リンク識別子は、メールキャンペーン、メールメッセージを含むキャンバス、またはContent Blocksが複製された場合にも更新されます。

リンクエイリアスを有効にする

リンクエイリアスは、ダッシュボードではなく、Braze が会社全体に対して有効にします。リクエストするには、Braze アカウントマネージャーに連絡してください。リンクエイリアスを有効にすると、会社のリンクテンプレートも有効になります。リンクエイリアスの有効化と無効化は、Braze のみが行えます。

リンクエイリアスがすでに有効になっているかどうかを確認するには、設定 > メール設定のリンクエイリアス設定タブに移動してください。メール設定を開けない場合は、「View Email Settings」権限がありません。ページは開けてもタブが表示されない場合は、リンクエイリアスが会社で有効になっていません。その他のページや設定が見つからない場合は、リンク管理ページまたは設定が見つからないを参照してください。

リンクエイリアスが有効になると、ダッシュボードで以下の操作を行えます。

エイリアスを無効にした場合の変更点については、lid パラメーターを受け付けない送信先を参照してください。この表の権限について詳しくは、会社のユーザー権限を参照してください。

リンクエイリアスの作成

ドラッグ＆ドロップエディターとHTMLエディターは同じコンポーザーサイドバーを使用するため、手順はどちらも同じです。

1. キャンペーンまたはキャンバスコンポーネントでメール本文を開きます。ドラッグ＆ドロップエディターでは、メール本文を編集を選択します。
2. コンポーザーサイドバーで、コンテンツ（送信設定やプレビュー＆テストと並んでいます）を選択します。このレイアウトの詳細については、ドラッグ＆ドロップでメールを作成するを参照してください。
3. コンテンツサブメニューで、デザインと構築の下にあるリンク管理を選択します。サブメニューが折りたたまれている場合は、サイドバーの矢印コントロールを使用して展開してください。
4. 各エイリアスに名前を付けます。Brazeはすべてのリンクに一意のデフォルトエイリアスを生成します。エイリアスはメールキャンペーンのバリアントまたはキャンバスコンポーネントごとに一意の名前を付ける必要があります。

エイリアスを使用して、レポートやセグメンテーションで特定のリンクを参照できます。

注

リンクエイリアスは、クエリパラメーターを安全に追加できるHTMLアンカータグ内のhref属性でのみサポートされています。リンクの末尾に疑問符（?）を含めることがベストプラクティスです。これにより、Brazeがlid値を簡単に追加できます。lid値を追加しないと、BrazeはそのURLをリンクエイリアスとして認識しません。

重要

ドラッグ＆ドロップエディターでは、リンクエイリアスがリンク管理タブに表示されるようにするために、URL内のハッシュ記号（#）の前に疑問符（?）を含める必要があります。

リンクエイリアスの管理

トラッキング対象のリンクエイリアスをすべて表示するには、以下の手順に従ってください。

1. ワークスペース設定の設定 > メール設定に移動します。
2. リンクエイリアス設定タブを選択します。

ここでは、リンクエイリアスの並べ替え、検索、トラッキングの無効化を行うことができます。

ヒント

キャンペーンのリンクエイリアス一覧およびキャンバスのリンクエイリアス一覧エンドポイントを使用して、キャンペーンの各メッセージバリアントまたはメール固有のキャンバスコンポーネントに設定されたaliasを抽出できます。

Brazeでは、メール内のリンクを評価し、リンクテンプレートを追加し、セグメンテーションやレポートの目的に適した命名規則を設定することを推奨しています。これにより、すべてのリンクを管理しやすくなります。

リンクエイリアスを有効にしても、メッセージ、Content Blocks、リンクテンプレートは変更されません。リンクテンプレートやContent Blocksを使用している既存のメッセージはそのまま維持されます。ただし、メッセージを更新すると、リンクエイリアスのマークアップがすべてのリンクに適用されるため、リンクを表示するにはリンクテンプレートを再適用してください。

リンクエイリアスによるリンクの更新方法

以下の表は、メール本文内のリンク、リンクエイリアスの結果、およびリンクエイリアスによって元のリンクがどのように更新されるかの説明例を示しています。

パーマリンク

ロジック: Brazeはクエスチョンマーク (?) を挿入し、最初のクエリパラメーターをURLに追加します。

複数のクエリパラメーターを含むリンク

ロジック: Brazeは他のクエリパラメーターを検出し、URLの末尾に lid= を追加します。

HTMLリンク

ロジック: Brazeはリンクがすでにクエスチョンマーク (?) を含むURLであることを認識し、lid クエリパラメーターをクエスチョンマークの後に追加します。

アンカー付きリンク

ロジック: Brazeは、URLがアンカー (#) がクエスチョンマーク (?) の後に配置される標準的な構造を使用することを想定しています。Brazeは左から右へ読み取るため、クエスチョンマークと lid 値がアンカーの前に追加されます。

アンカーとキャプチャタグ付きリンク

ロジック: アンカー (#) を含むURLでリンクエイリアスを使用する場合、Brazeはアンカーがクエリパラメーターの後に配置されることを想定しています。つまり、正しいトラッキングのために lid 値はアンカーの前に追加される必要があり、Brazeは左から右へURLを読み取るため、クエスチョンマーク (?) と lid はアンカーの前に配置されます。

リンクエイリアスのトラッキング

コンポーザーのサイドバーで、コンテンツ > リンク管理（デザインとビルドの下）を選択し、トラッキングしたいエイリアスを選択します。トラッキングされたエイリアスは、リンクエイリアスを参照するセグメンテーションフィルターで使用できます（セグメンテーションフィルターを参照）。また、ユーザーがメール内のリンクエイリアスをクリックしたときに、アクションベースのメッセージを送信したり、キャンバスを通じてユーザーを移動させたりすることもできます。アクションベースのフィルターを参照してください。トラッキング設定は、そのリンクのクリックがメールパフォーマンスレポートにカウントされるかどうかには影響しません。

ヒント

リンクエンゲージメント指標をトラッキングするには、リンクの先頭にHTTPまたはHTTPSが付いていることを確認してください。特定のリンクのクリックトラッキングをオフにするには、ユニバーサルリンクとApp Linksを参照してください。

Brazeでは無制限のリンクをトラッキング対象として選択できますが、リターゲティングできるのはユーザーが最近開いたリンクのみです。ユーザープロファイルには、最近クリックされたリンクが100件まで含まれます。たとえば、500件のリンクをトラッキングし、ユーザーがその500件すべてをクリックした場合、最近クリックされた100件のリンクに基づいてリターゲティングやセグメントの作成が可能です。

アクションベースのフィルター

リンクエイリアスが会社で有効になっている場合、任意のリンク（トラッキングされているかどうかに関わらず）をターゲットとするアクションベースのメッセージを作成したり、ユーザーがメールキャンペーンやキャンバスコンポーネントのエイリアスをクリックしたかどうかに基づいてリターゲティングしたりできます。

• キャンペーンがアーカイブされると、リンクトラッキングがオフになり、そのリンクエイリアスは別のフィルターで使用できなくなります。
• リンクのトラッキングが有効でキャンペーンでクリックされた場合、その後リンクトラッキングがオフになっても、そのメッセージ上の少なくとも1つのリンクがまだトラッキングされている限り、セグメントフィルターで利用可能なオプションとしてそのキャンペーンを見つけることができます。
• トラッキングされたリンクをフィルターとして選択できるのは、アクティブ（起動済み）のキャンバスにある場合のみで、キャンバスステップでエイリアスをクリックフィルタードロップダウンを使用します。リンクがキャンバスの下書きでトラッキングされている場合、そのトラッキングされたリンクをフィルターとして選択することはできません。

リンクをトラッキング解除に設定するには、リンクエイリアスの管理を参照してください。

セグメンテーションフィルター

Brazeでは、メールにリンクエイリアスがあり、ユーザーがそれをクリックすると、そのイベントはエイリアスとともにユーザープロファイルに記録されます。

「任意のキャンペーンまたはキャンバスステップでエイリアスをクリック」セグメンテーションフィルターを使用し、後でこのリンクエイリアスの名前を変更した場合、ユーザープロファイルの以前のクリックデータは更新されません。つまり、以前のリンクエイリアスとして表示されたままです。そのため、新しいリンクエイリアスに基づいてユーザーをターゲットにしても、以前のリンクエイリアスのデータは含まれません。

「キャンペーンでエイリアスをクリック」または「キャンバスでエイリアスをクリック」セグメンテーションフィルターを使用すると、特定のキャンペーンやキャンバスで特定のエイリアスをクリックしたかどうかでユーザーをフィルタリングします。複数のユーザーが同じメールアドレスを共有し、リンクエイリアスがクリックされた場合、そのメールアドレスを共有する他のすべてのユーザーのプロファイルも更新されます。これらのプロファイルは、クリックイベントだけでなく、配信イベントや開封イベントによっても更新されます。

以下のセグメンテーションフィルターは、イベントが処理された時点でトラッキングされているクリックイベントに適用されます。つまり、トラッキングされていないリンクは既存のデータを削除せず、リンクのトラッキングを開始してもデータは遡って補填されません。詳細については、セグメンテーションフィルターを参照してください。

リンクのトラッキング解除

リンクのトラッキングを解除しても、トラッキング解除されたエイリアスに対するフィルターを持つ既存のセグメントが再割り当てされることはありません。古いデータは、新しいデータに置き換えられるまでユーザープロファイルに残ります。

アーカイブされたメッセージ内のリンクは自動的にトラッキング解除されます。ただし、アーカイブされたメッセージがアーカイブ解除された場合、リンクを再度トラッキングする必要があります。リンクエイリアスがトラッキングされると、リンクレポートはトップレベルドメインや完全なURLではなく、エイリアスによってインデックスされます。

メールキャンペーン内のすべてのリンクとそれぞれの合計クリック数を表示するには、メッセージ分析 > メールパフォーマンス > プレビュー＆ヒートマップに移動し、ヒートマップを表示トグルを選択します。

メールクリックイベント

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の動作はキャンバスとキャンペーンで異なります。Brazeはキャンバスステップ（エントリステップを除く。エントリステップはスケジュール可能）を、「スケジュールされた」ものであってもトリガーイベントとして扱うためです。キャンバスとキャンペーンにおけるdispatch_idの動作について詳しくはこちらをご覧ください。

2019年8月に更新。

Content Blocksでのリンクエイリアス

新しいContent Blocksでは、リンクが変更され、Brazeが該当する各リンクに lid= を付加します。このプレースホルダー値は、メールメッセージバリアントに挿入される際に解決されます。

Brazeがリンクエイリアスを有効にする前に作成された既存のContent Blocks内のリンクを変更するには、既存のContent Blocksを複製してから、複製したContent Blocks内のリンクを変更してください。

lid 値のないContent Blocksが新しいメッセージに挿入された場合、そのContent Blocksのリンクはエイリアスでトラッキングされません。新しいContent Blocksが「古い」メッセージバリアントに挿入された場合、そのメッセージバリアントのリンクはリンクエイリアスによって認識されます。Content Blocksのリンクも認識されます。ただし、「古い」Content Blocksは「新しい」Content Blocksをネストすることはできません。

ヒント

Content Blocksについて、Brazeでは新しいメッセージで使用するために既存のContent Blocksのコピーを作成することを推奨しています。これは一括複製で行うことができ、リンクエイリアスが有効になっていないContent Blocksを新しいメッセージで参照してしまうシナリオを防ぐことができます。

Liquidで生成されるURLのリンクエイリアス

Liquidによって生成されるURL（例えば、HTML内のassign、コンテンツブロックから取得された値、カスタム属性内のLiquidなど）に対して、Brazeはlidクエリパラメーターを挿入する明確な場所を必要とします。ほとんどの場合、URLにLiquidが残っていると、デリミタを自分で追加しない限り、Brazeは新しいクエリ文字列を?で開始するか、既存のクエリに&で結合するかを推測しません。

次の操作を行ってください：

• URLにクエリ文字列がまだ含まれていない場合は、Liquidの後に?を追加します（例：?）。
• URLにすでに?とクエリパラメーターが含まれている場合は、Liquidの後に&を追加します（例：&）。

注

Liquidで生成されたURLでリンクテンプレートを使用する場合、クエリセパレーターとして使用される?文字がちょうど2つ含まれていると、Liquid実行後にBrazeがレンダリングされた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で「LIDの割り当てに失敗しました」などのエラーが表示される場合は、hrefがこのセクションの例で示されている?または&パターンを使用していることを確認してください。

ドラッグ＆ドロップエディターに関する考慮事項

ドラッグ＆ドロップエディターでは、リンクを保持するフィールド（ボタンのURLなど）は、Liquidが実行される前に基礎となるhrefを検証します。スペース、改行、その他のURL非対応文字は、Brazeがリンクテンプレートやリンクエイリアスパラメーターを追加する際に予期しない動作を引き起こす可能性があります。送信先に分岐Liquidが必要な場合は、HTMLブロックでURLをassignで設定し（次のセクションを参照）、複雑なLiquidを直接フィールドに入力する代わりに、ドラッグ＆ドロップのURLフィールドで単一の変数を参照してください。

コンテンツブロックの例

コンテンツブロックにhttps://www.braze.com/{{custom_attribute.${offer_id}}}のようなリンクが含まれていて、末尾に?または&がない場合、Brazeはlidを追加する場所がわからないため、そのリンクはリンク管理に認識されません。コンテンツブロック内のURLの末尾に?または&を追加し（クエリ文字列がすでに存在するかどうかに応じて）、コンテンツブロックを保存すると、リンクが認識されるようになります。

URLがユーザーごとに異なる場合のレポート

メッセージ内の個別のhrefはそれぞれ1つのリンクIDとリンク管理用の1つのリンクエイリアスにマッピングされ、エイリアスベースのレポートに使用されます。リンクエイリアスがトラッキングされている場合、ダッシュボード内のメールレポートは、解決されたすべてのURLではなく、エイリアスによってインデックスされます。

まず、Brazeで次のアプローチを使用してください：

• キャンペーンとキャンバスのメール分析：リンクのトラッキング解除で説明されているように、メッセージ分析 > メールパフォーマンス > プレビューとヒートマップでヒートマップを表示をオンにして、リンクごとの集計クリックを確認します。
• クエリビルダーでの受信者ごとのクリック：キャンペーンまたはキャンバスに対してメールクリック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>

トラブルシューティング

リンク管理のページや設定が見つからない

ダッシュボードの表示がこの記事のナビゲーションと一致しない場合は、以下の表で原因を確認してください。

lidパラメーターを受け付けない送信先

メールエディターからテストメッセージを送信すると、Brazeはリンクにlid={{placeholder}}を付加します（プレースホルダーは送信時に一意の値に置き換わります）。送信先のサイトやAPIが追加のクエリパラメーターを許容しない場合、エディターではリンクが正常に動作しても、メールから開いたときに失敗する可能性があります。

lidの値がないと、BrazeはそのURLをトラッキングやセグメンテーション用のリンクエイリアスとして扱いません。バックエンドやサイトを更新して、lidクエリパラメーターが存在する場合は無視するようにすることをお勧めします。これにより、この記事で説明しているリンクエイリアス、レポート、セグメントのユースケースが維持されます。

バックエンドの変更を計画している間は、設定 > メール設定 > リンクエイリアス設定で、対象のエイリアスのトラッキングをオフにできます。トラッキング解除してもlidパラメーターは削除されません。トラッキング解除がセグメントやフィルターに与える影響については、リンクのトラッキング解除を参照してください。

Brazeがlidを付加しないようにするには、Brazeサポートに連絡して、会社のリンクエイリアスをオフにしてください。リンクエイリアスをオフにした場合、以下の点に注意してください。

• 新しいメールメッセージやContent Blocksには、通常、新しいリンクエイリアスのマークアップ（lidクエリパラメーターなど）が付加されなくなります。
• リンクエイリアスが有効だったときに作成された既存のメッセージには、HTMLにリンクエイリアスのマークアップが残っている場合があります。不要な箇所のlidパラメーターは手動で削除する必要があるかもしれません。
• 既存のキャンペーン、キャンバスのメールステップ、またはContent Blockを編集する場合、テンプレート化されたリンクが正しく表示されるように、リンクテンプレートを再度追加する必要があるかもしれません。
• リンクエイリアスが有効だったときに送信されたメールのクリックレポートは、機能をオフにした後のレポートときれいに一致しない場合があります。
• リンクエイリアスベースのフィルター（例：Clicked Aliasフィルター）を使用しているセグメントは、期待するオーディエンスを返さなくなる可能性があります。