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

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

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

ヒント

開発者向け: 統合手順については、Android ディープリンクまたはSwift ディープリンクを参照してください。iOSリンクタイプの選択については、iOS ディープリンクガイドを参照してください。問題の診断については、ディープリンクのトラブルシューティングを参照してください。

ディープリンクとは

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

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

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

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

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

重要

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

システムURIスキーム

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

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

アプリケーションへのディープリンク

プッシュ通知、アプリ内メッセージ、バナー、またはContent Cardsを作成する際に、アプリケーションへのディープリンクを選択して、アプリ内の特定の画面やアクションを開くことができます。一部のコンポーザーでは、このオプションはDeep Link Into Appと表示されます。

このオプションを使用する前に、開発者と協力してURI形式を定義し、アプリがそれを開けるように設定してください。myapp:// などのカスタムスキームは、インストール済みのアプリを直接開きます。ユニバーサルリンク（iOS）およびApp Links（Android）は https:// URLを使用し、アプリがインストールされている場合はアプリを開き、インストールされていない場合はWebページにフォールバックします。

このクリック時動作を設定するには:

1. キャンペーンまたはキャンバスコンポーザーで、クリック時動作を見つけます。
   • プッシュ通知とContent Cardsの場合は、作成タブに移動します。
   • アプリ内メッセージの場合は、作成タブに移動します。ドラッグ＆ドロップエディターでは、ボタンまたは画像ブロックを選択し、そのプロパティパネルを開きます。
2. アプリケーションへのディープリンクまたはDeep Link Into Appを選択します。
3. URLフィールドにリンクを入力します。例えば、カスタムスキームの場合は myapp://products/12345、ユニバーサルリンクまたはApp Linkの場合は https://example.com/products/12345 です。
4. 物理デバイスにテストメッセージを送信します。テストが成功すると、アプリが開き、目的の画面またはアクションにルーティングされます。ユニバーサルリンクまたはApp Linkの場合は、アプリがインストールされていないデバイスでもテストして、期待されるWebフォールバックを確認してください。

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

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

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

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