Skip to content
Engage Studio
/
/
/
Supported Events and Fiel...
Last updated

モバイルIn-Appのイベントとフィールド

モバイルIn-Appキャンペーンの評価でEngage Mobile SDKが受け取るイベントとフィールドを確認する場合に使用します。SDKはトリガーAPIとキャンペーン計測イベントを提供し、ビジネスイベント名とフィールドは顧客が定義します。

計測レコードの詳細はDeveloper Guideで説明します。計測先とスキーマについては、モバイルIn-Appの計測を参照してください。

Beta

モバイルIn-Appのイベント契約はプレビュー機能の一部です。一般提供前に、イベント名、フィールド、SDKの動作が変更される場合があります。

SDKイベントのカテゴリ

SDKはモバイルIn-App向けに次の2種類のイベントを扱います。

カテゴリイベント担当
トリガー入力trackImmediatelyで送信するイベントマップ顧客のアプリとキャンペーン設定
キャンペーン計測impression、click、dismissEngage Mobile SDK

SDKはpurchase、add_to_cart、searchなどのビジネスイベントを固定リストとして定義しません。これらの名前とフィールドは顧客が定義し、Realtime Personalizationの設定と一致させます。

トリガーイベントの入力

trackImmediatelyは、アプリが設定された画面または操作に到達したときに、イベントマップをRealtime Personalizationへ送信します。

SDKが受け取るフィールドの役割は次のとおりです。

フィールドの役割代表的なキー定義
イベント名eventトリガーの顧客定義名。
画面またはページのコンテキストscreen_name顧客が定義する画面またはページの値。
顧客識別子customer_id、user_id、td_client_idターゲティングまたはID解決に使用する顧客定義の識別キー。
キャンペーン属性JSON化可能な任意のキーPersonalizationルールまたはメッセージコンテンツで使用する顧客定義の値。

フィールド名とデータ型は、Realtime Personalizationで設定した名前と一致させてください。SDKは顧客定義のフィールドを渡しますが、ビジネスフィールドを自動生成しません。

{
  "event": "<CUSTOMER_DEFINED_EVENT>",
  "screen_name": "<CUSTOMER_DEFINED_SCREEN>",
  "customer_id": "<CUSTOMER_DEFINED_ID>",
  "<CUSTOMER_DEFINED_FIELD>": "<VALUE>"
}

キャンペーンで必要なフィールドだけを使用してください。APIキー、Personalization token、パスワード、不要な個人データを含めないでください。

キャンペーン計測イベント

キャンペーン配信されたメッセージを表示または操作したとき、SDKは次の計測イベントを作成できます。

イベント意味
impressionキャンペーンメッセージを表示した。
click対応するリンクまたはBridgeアクションを使用した。
dismissキャンペーンエクスペリエンスを閉じた。

これらのイベントのメッセージメタデータとアクションフィールドはSDK契約で定義されます。Developer GuideのモバイルIn-Appの計測とEngage Mobile SDK APIとイベントリファレンスを参照してください。

アプリから直接openUrlを呼び出した場合はキャンペーンオファーではないため、これらのキャンペーン計測イベントは作成されません。

顧客定義のビジネスイベント

キャンペーンが業務上の操作に依存する場合、顧客のアプリからイベントとフィールドを明示的に送信します。次の名前は例であり、SDK標準イベントではありません。

  • purchase
  • add_to_cart
  • search
  • content_view
  • signup
  • 顧客が定義する任意のイベント名

キャンペーン担当者とイベント契約を定義し、Realtime Personalizationに対応するフィールドを設定してから、アプリにイベントを実装してください。

関連ドキュメント

Hosted Pages

Campaign Troubleshooting