Skip to content

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

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

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

ディープリンクとは

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

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

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

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

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

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 タグによるプッシュ開封とアプリ内メッセージクリックのアトリビューション

プッシュ通知のディープリンクに UTM タグを含めるには、プッシュメッセージのクリック時の動作をディープリンクに設定し、ディープリンクアドレスを記述して、以下のように必要な UTM タグを含めます。

1

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

アプリ内メッセージのディープリンクに UTM タグを含めるには、以下を使用します。

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 を短縮する

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

/messages/send エンドポイントでの URL 短縮

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