Skip to main content
セルフハンドルカードを使用すると、MoEngage プラットフォームでカードキャンペーンを作成し、アプリケーション内の任意の場所にカードを表示できる柔軟性が得られます。SDK にはキャンペーンのデータを取得するための API が用意されており、そのデータを使用して独自のカードビューを作成できます。

カード情報の取得

特定のユーザーに表示可能なすべてのカードキャンペーンデータを取得します。データは CardsInfo として返されます。
CardsInfo で利用可能なデータの詳細については、Cards データペイロードを参照してください。

ウィジェットとウィジェット ID のマッピング

ベーシックカード/イラストレーションカード

カードの更新

ユーザーの要求に応じてカードを更新するには、refreshCards*()*** API を使用します。この API は、プルして更新する動作を再現するために使用できます。
SyncCompleteData で利用可能なデータの詳細については、Cards データペイロードを参照してください。

カードの取得

ユーザーのカードを取得するには、fetchCards*()*** API を使用します。この API は、最新のカードデータを同期するために使用できます。
CardsData で利用可能なデータの詳細については、Cards データペイロードを参照してください。
fetchCards() の同期タイミングとレート制限の詳細については、MoEngage SDK はいつカードデータを同期しますか?を参照してください。

インボックスの読み込み

カードは、別の画面または画面の一部のセクションに表示できます。カード画面/セクションが読み込まれたら、onCardSectionLoaded() を呼び出します。
SyncCompleteData で利用可能なデータの詳細については、Cards データペイロードを参照してください。

インボックスのアンロード

画面/セクションが表示されなくなったとき、またはバックグラウンドに移行するときに、onCardSectionUnloaded() を呼び出します。

カテゴリーの取得

カードが設定されているすべてのカテゴリーを取得するには、getCardsCategories() API を使用します。文字列の配列が返されます。

すべてのカードカテゴリーの有効化状態

カードが設定されているすべてのカテゴリーを取得するには、isAllCategoryEnabled() API を使用します。

カテゴリー別のカードの取得

特定のカテゴリーで表示可能なカードを取得するには、getCardsForCategory() API を使用します。
CardsData で利用可能なデータの詳細については、Cards データペイロードを参照してください。

新着カード数の取得

新着カードの数を取得するには、以下のように getNewCardsCount() メソッドを使用します。

カードの表示

カードがユーザーに表示されたことを通知するには、cardShown() API を呼び出します。

カードのクリック

カードがユーザーに表示されたことを通知するには、cardClicked() API を呼び出します。

カードの削除

カードを削除するには、deleteCard() API を呼び出します。

カードを配信済みとしてマーク

アプリケーションのカードセクションへの配信をトラッキングするには、アプリケーションのカードセクションが読み込まれたときに cardDelivered() API を呼び出します。

未クリックのカード数の取得

未クリックのカードの数を取得するには、以下のように getUnClickedCardsCount() メソッドを使用します。

カード同期リスナー

バージョン 4.0.0 以前

アプリ起動時のカード同期に関するコールバックを受け取るには、このリスナーを設定します。このリスナーは initialize() API を呼び出す前に設定する必要があります。ほとんどの場合、この API は必要ありません。

バージョン 5.0.0 以降

アプリの起動時またはユーザーのログイン時にカード同期に関するコールバックを受け取るには、このリスナーを設定します。このリスナーは initialize() API を呼び出す前に設定する必要があります。
SyncCompleteData で利用可能なデータの詳細については、Cards データペイロードを参照してください。