Skip to main content

概要

MoEngage Android SDK は、パーソナライズされたキャンペーンを配信するための安全なフレームワークを提供します。ユーザー ID と認証を内部で処理することで連携を簡素化し、API シークレットの管理や手動での HTTPS 呼び出しを不要にします。これにより、合理化されたネイティブインターフェースを通じて、パーソナライズされたキャンペーン情報を直接取得およびトラッキングできます。
前提条件パーソナライズされたエクスペリエンスを取得する前に、以下が完了していることを確認してください。
  • Android SDK に BOM を連携していることを確認してください。詳細については、BOM を使用したインストールを参照してください。
  • 初期化: アプリケーションのエントリーポイント(Android では onCreate())内で SDK の initialize() メソッドを呼び出します。初期化の詳細については、SDK の初期化を参照してください。

MoEngage Personalization の連携

BOM を設定したら、app/build.gradle に必要なアーティファクトを追加します。バージョン番号は BOM によって管理されます。

実装ワークフロー

MoEPersonalizeHelper SDK オブジェクトは、動的でパーソナライズされたコンテンツの取得と操作を簡素化するように設計されています。以下は、主な役割ごとに分けたコードの内訳です。

1. メタエクスペリエンスの取得

特定のペイロードまたはエクスペリエンスを取得する前に、必ずメタデータの呼び出しを実行してください。この呼び出しを使用すると、指定したステータスのすべてのエクスペリエンスキーを取得でき、後続のリクエストを適切に構成するために必要なコンテキストが得られます。
必要なエクスペリエンスキーを取得するために、最初に fetchExperiencesMeta を呼び出してください。 onSuccess コールバックは、メインスレッドでキャンペーンを実行するために必要なすべてのメタデータを含む ExperienceCampaignsMetadata オブジェクトを返します。一方、onFailure コールバックは、 RequestFailureReasonCode と、リクエストが失敗した具体的な理由を特定するためのオプションのメッセージを提供します。

2. パーソナライズされたコンテンツの取得

メタデータを取得したら、実際のパーソナライズされたペイロードを取得できます。SDK には、単一のエクスペリエンスまたは複数のエクスペリエンスを同時に取得するメソッドが用意されています。
EXPERIENCE_KEY は、MoEngage ダッシュボードでキャンペーンを作成する際にエクスペリエンスキャンペーンで使用される一意のキーです。これらのキーは fetchExperiencesMeta の呼び出しを使用して取得できます。
onSuccess コールバックは、メインスレッドでキャンペーンを実行するために必要なすべてのメタデータを含む ExperienceCampaignsResult オブジェクトを返します。一方、onFailure コールバックは、 RequestFailureReasonCode と、リクエストが失敗した具体的な理由を特定するためのオプションのメッセージを提供します。 以下を取得できます。
  • 単一のエクスペリエンス: 単一の experienceKey を使用して特定のペイロードを取得します。
  • 一括エクスペリエンス: experienceKeys の Set<String> を渡して、複数のペイロードを一度に取得します。
ユースケース: コンテキストに応じたターゲティング: 取得の呼び出し時に属性のマップ(例: current_page: “home”、cart_value: “500”)を渡すことができます。これにより、MoEngage SDK はリアルタイムで状態に応じたコンテンツ(カートの金額が十分に高い場合の「送料無料」バナーなど)を配信できます。

3. インプレッションのトラッキング

パーソナライズされたコンテンツを取得して UI にレンダリングした後は、キャンペーンのパフォーマンスを測定するためにユーザーのインタラクションをトラッキングすることが不可欠です。 パフォーマンスを測定するには、エクスペリエンスが表示されたタイミングをトラッキングする必要があります。これには campaignEntity が必要です。UI がコンテンツをレンダリングしたときに、以下のメソッドを使用して「インプレッション」(experienceShown / experiencesShown)を記録できます。

3a. エクスペリエンスキャンペーンのインプレッションのトラッキング

3b. オファリングキャンペーンのインプレッションのトラッキング

オファリングとは、キャンペーン内に含まれる特定のパーソナライズされたアイテム(商品のレコメンデーションやクーポンなど)です。

4. クリックのトラッキング

4a. エクスペリエンスキャンペーンのクリックのトラッキング

ユーザーがレンダリングされた UI 要素を操作したときに、以下のメソッドを使用して「クリック」(experienceClicked)を記録できます。

4b. オファリングキャンペーンのクリックのトラッキング

オファリングとは、キャンペーン内に含まれる特定のパーソナライズされたアイテム(商品のレコメンデーションやクーポンなど)です。
これらのオファリング固有の関数は、データがオファリングペイロードの一部である場合にのみ使用できます。その他のすべてのエクスペリエンスデータには、標準のエクスペリエンス表示/クリック関数を使用してください。
詳細については、API ドキュメントを参照してください。

よくある質問

いいえ。SDK は未加工の JSON ペイロードを返します。データの解析と UI コンポーネント(バナーやカルーセルなど)の構築はお客様の責任で行う必要があります。
いいえ。SDK はメディアアセットをダウンロードまたはキャッシュしません。JSON で参照されている画像、動画、フォントを処理するには、標準的なメディア読み込みライブラリを使用してください。
はい。1 回の呼び出しで最大 25 件のエクスペリエンスを取得できます。これを超えると、SDK は最近更新された 25 件のエクスペリエンスを返し、取得されなかったキーを通知します。
SDK は、標準化されたエラーコード(例: NETWORK_ERROR)とともに空のペイロードを返します。すべてのエラーの詳細については、こちらを参照してください。