Liquid でアクションとメディアの URL をパーソナライズする

ボタン、リンク、画像、動画の URL に Liquid 変数を追加することで、メッセージを受信する各ユーザーに合わせてリンク先やコンテンツをパーソナライズできます。

アプリ内コンテンツへのディープリンク

ヒント

開発者向け: カスタムスキーム、ユニバーサルリンク、その他のオプションの選択に関するガイド（AASAファイルが必要な場合、実装すべきアプリデリゲートメソッド、デバッグ方法など）については、iOSディープリンクガイドおよびディープリンクのトラブルシューティングを参照してください。

ディープリンクとは

ディープリンクとは、ネイティブアプリを起動し、特定のアクションを実行したり特定のコンテンツを表示したりするための追加情報を提供する方法です。

これには3つの要素があります。

1. 起動するアプリを特定する。
2. 実行するアクションをアプリに指示する。
3. アクションに必要な追加データを提供する。

ディープリンクは、アプリの特定の部分にリンクするカスタムURIであり、これら3つの要素をすべて含んでいます。重要なのはカスタムスキームを定義することです。http: はほぼすべての人が知っているスキームですが、スキームは任意の単語で始めることができます。スキームは文字で始まる必要がありますが、その後は文字、数字、プラス記号、マイナス記号、またはドットを含めることができます。実際には、競合を防ぐための中央レジストリは存在しないため、スキームにドメイン名を含めることがベストプラクティスです。たとえば、twitter:// は旧Twitter（現X）のモバイルアプリを起動するためのiOS URIです。

ディープリンク内のコロン以降はすべて自由形式のテキストです。その構造と解釈はユーザーが定義します。ただし、一般的な慣例として、先頭の // やクエリパラメータ（例：?foo=1&bar=2）を含む http: URLをモデルにすることがあります。前述の例では、twitter://user?screen_name=[id] を使用してアプリ内の特定のプロファイルを起動します。

重要

ラッパーフレームワーク（FlutterやCordovaなど）で構築されたアプリの場合、Brazeはラッパー固有のディープリンクサポートを提供していません。ネイティブのiOSおよびAndroidレイヤーでディープリンクを設定する必要があります。Cordovaについては、プッシュ通知でのディープリンクを参照してください。

システムURIスキーム

iOSおよびAndroidでネイティブに処理される標準URIスキーム（tel:、mailto:、sms: など）は、アプリにカスタムディープリンク統合を必要とせず、ディープリンクURLフィールドに直接入力できます。

これらはプッシュ通知のクリック時の動作やアプリ内メッセージのボタンアクションで機能します。追加のSDK設定やアプリコードの変更は必要ありません。

UTMタグとキャンペーンアトリビューション

UTMタグとは

UTM（Urchin Traffic Manager）タグを使用すると、キャンペーンアトリビューションの詳細をリンクに直接含めることができます。UTMタグはGoogle Analyticsがキャンペーンアトリビューションデータを収集するために使用され、以下のプロパティをトラッキングするために使用できます。

• utm_source: トラフィックのソースの識別子（例：my_app）
• utm_medium: キャンペーンメディア（例：newsfeed）
• utm_campaign: キャンペーンの識別子（例：spring_2016_campaign）
• utm_term: ユーザーをアプリやWebサイトに誘導した有料検索キーワードの識別子（例：pizza）
• utm_content: ユーザーがクリックした特定のリンクまたはコンテンツの識別子（例：toplink または android_iam_button2）

UTMタグは通常のHTTP（Web）リンクとディープリンクの両方に埋め込むことができ、Google Analyticsでトラッキングできます。

UTMタグの計算

Brazeはキャンペーンまたはキャンバスステップ内のすべてのリンクについて「合計クリック数」をレポートしますが、これにはUTMタグのないリンクも含まれる場合があります。そのため、Google Analyticsのキャンペーントラッキングリンクでは、キャンペーンパフォーマンスやレポートビルダーに表示される「合計クリック数」と比較して、異なる（多くの場合低い）結果が表示されることがあります。

BrazeでのUTMタグの使用

通常のHTTP（Web）リンクでUTMタグを使用する場合（例：メールキャンペーンのキャンペーンアトリビューションを行う場合）、組織がすでにGoogle Analyticsを使用しているなら、GoogleのURLビルダーを使用してUTMリンクを生成できます。これらのリンクは、他のリンクと同様にBrazeキャンペーンのコピーに簡単に埋め込むことができます。

アプリへのディープリンクでUTMタグを使用するには、アプリに関連するGoogle Analytics SDKが統合され、ディープリンクを処理するように正しく設定されている必要があります。不明な場合は開発者に確認してください。

Analytics SDKが統合および設定された後、BrazeキャンペーンのディープリンクでUTMタグを使用できます。キャンペーンにUTMタグを設定するには、送信先URLまたはディープリンクに必要なUTMタグを含めます。以下の例は、プッシュ通知とアプリ内メッセージでUTMタグを使用する方法を示しています。

UTMタグによるプッシュ開封とアプリ内メッセージクリックのアトリビューション

• プッシュ開封
• アプリ内メッセージクリック

1
myapp://products/20-gift-card?utm_source=my_app&utm_medium=push&utm_campaign=spring2016giftcards&utm_content=ios_deeplink

1
myapp://products/20-gift-card?utm_source=my_app&utm_medium=iam&utm_campaign=spring2021giftcards&utm_content=web_link

URLでのLiquidパーソナライゼーションの使用

Brazeコンポーザー内でURLを動的に構築できるため、URLにダイナミックなUTMパラメーターを追加したり、ユーザーにユニークなリンクを送信したりできます（放棄カートや再入荷した特定の商品にユーザーを誘導するなど）。

サポートされているLiquidパーソナライゼーションタグを使用してURLを作成する

サポートされているLiquidパーソナライゼーションタグを使用して、URLを動的に生成できます。

1
https://example.com/?campaign_utm={{campaign.${api_id}}}&user_attribute={{custom_attribute.${attribute1}}}

また、以下の例のように、カスタム定義のLiquid変数の短縮もサポートしています。

Liquid変数を使用してURLを作成する

1
2
{% assign url_var = {{event_properties.${url_slug}}} %}
https://example.com/{{url_var}}

Liquid変数でレンダリングされたURLを短縮する

サポートされているチャネル： KakaoTalk、LINE、SMS、RCS、WhatsApp

APIトリガープロパティに含まれるものも含め、LiquidによってレンダリングされたURLを短縮します。たとえば、{{api_trigger_properties.${url_value}}}が有効なURLを表す場合、メッセージを送信する前にそのURLを短縮してトラッキングします。

/messages/sendエンドポイントでURLを短縮する

リンク短縮は、/messages/sendエンドポイントを介したAPIのみのメッセージでも有効になります。リクエストパラメーターの完全なリストについては、リクエストパラメーターを参照してください。