メインコンテンツへスキップ
このドキュメントでは、In-App Messagesイベントの機能と使用法について説明します。ユーザーがこれらのメッセージをクリックまたは表示するたびに、ブロックレベルのクリックやページ固有の表示を含む重要なエンゲージメント統計を追跡できます。

​
アプリ内メッセージイベント

アプリ内メッセージイベントには3種類のevent.kindがあります：
  • In-app Impression - message.iam.impression
  • In-app Clicked - message.iam.clicked
  • In-app Page Displayed - message.iam.page_displayed
これらのイベントは、ユーザーがデバイス上でアプリ内メッセージを開いてインタラクションする際に発火されます。

​
アプリ内インプレッション

このイベントは、メッセージの読み込みが完了して画面に表示されるとすぐに発火されます。 carouselsを使用する場合、event.data.page_nameとevent.data.page_idを使用して、表示されている特定のページの名前とUUIDを取得できます。

​
アプリ内クリック

このイベントは、クリックアクション（「ターゲット」とも呼ばれます）を持つ任意の要素またはブロックに適用されます。event.data.target_nameとevent.data.target_idを使用してクリックされた特定のターゲットの名前とUUIDを取得でき、event.data.page_nameとevent.data.page_idを使用してターゲットが属するページを取得できます。 詳細については、In-app click actionsを参照してください。

​
アプリ内ページ表示

これはcarouselsにのみ適用されるイベントです。event.data.page_nameとevent.data.page_idを使用して、表示されている特定のページまたはカードの名前とUUIDを取得できます。最初のカードのインプレッションは、ドキュメントの読み込みが完了するとすぐに発火されます。その後のページインプレッションはスワイプ時に発火されます。

​
アプリ内メッセージイベントデータ

各event.kindは、アプリ内メッセージの作成方法に応じて追加のイベントデータを持つことができます。
​
event.data.page_name
string
event.kindがclickedまたはpage_displayedのときに表示されるページまたはカードの名前。impressionイベントでは利用できません。page_nameは、どのページが表示され、そのページで何がクリックされたかを知るのに役立ちます。ページ名はデフォルトで「Card 1」、「Card 2」などですが、ブロックエディター内で名前を変更できます。
​
event.data.page_id
string UUID v4
ページの一意の識別子。carouselを使用している場合で、古いカードが削除されたり新しいカードに置き換えられたりする場合に役立ちます。
​
event.data.target_name
string
ボタンまたは画像ブロック要素の名前。クリックアクションを設定する必要があります。
​
event.data.target_id
string UUID v4
ボタンまたは画像ブロック要素の一意の識別子。クリックアクションを設定する必要があります。これは、carouselを使用していて、古いカードが削除されたり新しいカードに置き換えられたりする場合に役立ちます。

​
アプリ内メッセージイベントストリームを作成する

​
イベントストリームをセットアップする

イベントストリームのセットアップとパーソナライズのガイダンスについては、Event Stream Setupの手順を参照してください。以下は、イベントストリームを構成するための IAM 固有のステップ（ステップ3）を提供します。

​
追跡したいターゲットが正しくセットアップされていることを確認する

イベントストリームリクエストの本文でカスタム名を活用するには、ブロックエディターまたは HTML エディターで新しいカスタム名を手動で指定する必要があります。カスタム名のリリース前に存在していたアプリ内メッセージは、各ページまたはブロックのカスタム名でアプリ内メッセージが更新されるまで、イベントストリームでpage_nameとtarget_nameの値を公開できません。 アプリ内メッセージが更新された後、その時点から発火されるイベントストリームリクエストはそれらの値にアクセスできます。いつでも、page_nameとtarget_nameの値はその時点でのアプリ内メッセージのカスタム名の状態を反映し、アプリ内メッセージが再度更新されると変更される可能性があります。
  • ブロックエディター
  • HTMLエディター
3つのイベントすべてをこのエディターで使用できます。ブロックエディターを使用する場合、ターゲットにアプリ内クリックアクションが含まれていることを確認してください。ターゲットには、画像、ボタン、閉じるボタン、および背景ブロックが含まれます。テキストブロックは現在クリックアクションをサポートしておらず、含まれていません。ダッシュボードエクスペリエンスでの混乱を避けるため、ターゲットのカスタム名は一意である必要があります。

​
一意のIDを活用する

ベストプラクティス：分析目的でイベントストリームを使用する場合、message.id、page_id、およびtarget_idを使用して一意性を検証してください。カスタム名は使用できますが、1つのIAM内の要素を人間が読める形式で区別するのに役立つことを意図しています。複数のアプリ内メッセージがある場合は、message.idを使用してそれらを区別してください。

​
ブロックエディターで明確な名前を使用する

データ分析を簡素化するために、すべてのアプリ内メッセージのタイトル、カード、およびブロックに意味のある一意の名前を使用してください。カルーセル内のカードの名前を変更するには、更新したいタブを選択し、カードタブの横にある「オプション」ドロップダウンを選択します。カードの名前を変更するオプションが表示されます。 ブロックの名前を変更するには、各ブロックの右上隅にある3つの点のオプションメニューを選択して、名前変更モーダルを開きます。すべてのカスタム名は、該当する場合、ダッシュボードレポートとイベントストリームに反映されます。カスタム名は、設定して保存しない限り、イベントストリームに表示されません。アクティブなIAMがあり、最近新しいIAMイベントストリームをセットアップした場合は、これらのIAMがより明確な分析のために意味のあるカスタム名を持っていることを確認する必要があります。