アプリ内メッセージアクションでキーと値のペアを使用する
キー・バリュー (KV) ペアは、アプリ内メッセージングキャンペーン内の特定のアクションにリンクできる追加のデータ要素です。各KVペアにはキーと値が含まれています。キーはデータを説明し、値はデータ自体です。KVペアを使用すると、ユーザーがキャンペーンと対話する際にアプリにより多くの情報を送信できます。これにより、よりパーソナライズされた、ダイナミックで追跡可能なユーザーエクスペリエンスを作成できます。
マーケターと開発者は、ユーザーインタラクションを強化し、ダイナミックコンテンツを可能にし、キャンペーントラッキングを改善するためにKVペアを使用します。開発者は、特定のアクションのためにアプリのコードにカスタムパラメータを渡すためにKVペアも使用します。
始める前に
- アプリが異なるアクションに対して期待する特定のデータ(キーと値)を理解してください。
アプリ内メッセージアクションにキー-バリューペアを追加する
KVペアを追加するには、以下の手順を実行します:
-
In the
Content
section of your In-App Message campaign, select a widget from the
Preview
area.
-
下にスクロールして
アクション
セクションに移動します。
+ アクション
をクリックします。
- カスタム リストからアクションを選択してください。
-
このアクションにキーとバリューのペアを追加するには、
+ 新しい KV ペア
をクリックします。
- キー値ペア の下に、 名前を入力 フィールドにキーを、 データ フィールドに値を入力してください。
さまざまなアクションタイプに対してキーと値のペアを使用する方法は次のとおりです:
ナビゲーションアクションのキー-バリューペア
ナビゲーションアクションを使用すると、KV ペアがアプリの宛先画面または URL に追加情報や指示を送信します。
ナビゲーションにキー-バリューペアを使用する理由は何ですか?
-
パーソナライズ:
ユーザーの興味や行動に基づいて特定のコンテンツに案内します。例えば、
productId
を渡して、ユーザーを特定の製品ページに誘導します。次のページでユーザーのメールアドレスでフォームを自動入力するには、email
アドレスを渡してください。 - 動的コンテンツ: アプリがコンテンツを動的に読み込み、表示できるようにし、ユーザーエクスペリエンスを向上させます。
-
トラッキングと分析:
source
のようなパラメータを含めて、ナビゲーションがどこから来たのかを追跡します。これはキャンペーンのパフォーマンスを理解するのに価値があります。
例:
-
キー:
productId
, 値:12345
-
キー:
source
, 値:inAppCampaign
-
キー:
email
, 値:{{UserAttribute['u_em']}}
トラックイベントアクションのキー・バリューペア
イベントを追跡する際、KVペアはイベント属性として機能します。彼らはイベントについての詳細を提供します。
イベント追跡にキーとバリューのペアを使用する理由は何ですか?
- 強化された分析: ユーザーの行動に関するより深い洞察のためにイベントデータを豊かにします。
- オーディエンスセグメンテーション: 詳細なイベント属性を使用して、今後のキャンペーンのために正確なユーザーセグメントを作成します。
- 自動アクションをトリガー: MoEngage内でフォローアップメッセージを送信するなど、自動マーケティングアクションをトリガーするための特定のKVペアを設定します。
例:
イベント名:
ButtonClicked
-
キー:
buttonType
, 値:SubscribeButton
-
キー:
campaignId
, 値:promo_2024
カスタムアクションにおけるキー-バリューペア
カスタムアクションには、開発者がカスタムパラメータとしてキーと値のペアを使用できます。これらのパラメータは、特定の機能を実行するためにアプリのコードに渡されます。
カスタムアクションにキー-バリューペアを使用する理由は何ですか?
- 柔軟性: 開発者はKVペアを使用して柔軟なアクションを定義し、アプリのコードを変更することなくそれらを更新できます。
- パーソナライズされたユーザー体験: 個々のユーザーや特定のキャンペーン目標に合わせてアプリの動作を調整するために、異なるパラメーターを渡します。
- 動的更新: アプリが最新の情報でアプリ内メッセージに応答できるようにし、エンゲージメントを向上させます。
例:
アクション名:
OpenFeature
-
キー:
featureName
, 値:AugmentedRealityViewer
-
キー:
accessLevel
, 値:premium
トラブルシューティング
- 不正なデータ型: 入力する値が、対応するキーに対してアプリが期待するデータ型と一致していることを確認してください。不正な型は、アクションの失敗やデータの誤解釈を引き起こす可能性があります。
- 不一致なキー: MoEngageで使用するキー名が、アプリのコードが期待するものと正確に一致していることを確認してください。タイプミスや大文字小文字の違いは、アプリがデータを認識できなくなる原因となります。
- アプリ側の実装: キーと値のペアは、モバイルアプリのコード内で適切に処理する必要があります。アクションが期待通りに動作しない場合は、開発者がこれらのペアを受信して使用するためのロジックを正しく実装していることを確認してください。