このドキュメントでは、MoEngage Personalize API で作成した API Experience のインプレッションとクリックをレポートするために、MoEngage Personalize SDK で利用できる新しいメソッドについて説明します。

前提条件

SDK の統合

MoEngage ワークスペースで Personalize を利用できるようになっていることを確認してください。Personalize API Experience の設定の詳細については、こちらの記事を参照してください。

SDK には、Experience の表示イベントをトラッキングするメソッドが用意されています。Experience のインプレッションをレポートするには、以下の SDK メソッドを使用します。

<script type="text/javascript">
MoEngage.personalize.trackImpression(experienceContext)
</script>

experienceContext は、Personalize API の Experience Fetch 呼び出しに対するレスポンスで返される JSON オブジェクトです。詳細はこちらを参照してください。

SDK には、Experience のクリックイベントをトラッキングするメソッドが用意されています。Experience のクリックをレポートするには、以下の SDK メソッドを使用します。

<script type="text/javascript">
MoEngage.personalize.trackClick(experienceContext,extraAttributes)
</script>

extraAttributes はオプションの JSON オブジェクトで、ユーザーが操作したリンクや CTA に関する追加情報を渡すことができます。

{
  "button_id": "<submit-form-btn>",
  "button_name": "<Add to Cart>",
  "button_type": "<primary>",
}

上記の JSON の例は、クリックに関する追加情報をトラッキングする際に含めることができるデータの種類を明確に理解していただくためのサンプル値です。具体的な実装のニーズに合わせて、これらの値を自由に調整してください。