メインコンテンツへスキップ

プッシュクリックのコールバック

MoEngage の Flutter プラグインは、プッシュクリック時のコールバックをオプションで提供します。 コールバックを登録するには、Dart コード内の MoEngageFlutter オブジェクトで setPushClickCallbackHandler() を呼び出します。
この API は、typedef が PushClickCallbackHandler(PushCampaignData data). であるメソッドを入力として受け取ります。
アプリケーションが初期化されたらすぐにこのコールバックが設定されるようにしてください。アプリケーションウィジェットの initState() 内で設定することをお勧めします。 MoEngage プラグインの initialize () を呼び出す前に、コールバックが設定されていることを確認してください。

ペイロード

コールバックで受信される NotificationPayload は、次の定義を持つ PushCampaignData インスタンスです。
platform - コールバックがトリガーされたネイティブプラットフォームです。有効な値は android、ios です。data - PushCampaignData オブジェクトです。
isDefaultAction - このキーは Android プラットフォームでのみ存在します。ユーザーがデフォルトのコンテンツをクリックしたかどうかを示すブール値です。ユーザーがデフォルトのコンテンツをクリックした場合は true、それ以外の場合は false になります。 clickedAction - 通知のクリック時に実行されるアクションです。 clickedAction マップのペイロード構造
clickedAction.type - クリックアクションの種類です。有効な値は navigation と customAction です。現在、customAction は Android でのみサポートされています。
clickAction.payload - クリックされたアクションのアクションペイロードです。
clickedAction.payload.type - 定義されたナビゲーションアクションの種類です。有効な値は screenName、deepLink、richLanding です。
現在、iOS の場合、リッチランディングとディープリンクの URL は SDK によって内部で処理され、このコールバックには渡されません。そのため、iOS の場合に有効な値は screenName のみです。
clickAction.value - ナビゲーションアクションまたはカスタムペイロードに入力された値です。
clickAction.kvPair - MoEngage プラットフォームで入力されたカスタムのキーと値のペアです。
payload - キャンペーンの完全なペイロードです。

Android のペイロード

ユーザーが通知のデフォルトのコンテンツをクリックした場合、キーと値のペアとキャンペーンのペイロードは payload キー内にあります。ユーザーがアクションボタンまたはプッシュテンプレートのアクションをクリックした場合、アクションペイロードは clickedAction 内にあります。
isDefaultAction キーを使用して、ユーザーがデフォルトのコンテンツをクリックしたかどうかを確認し、それに応じてペイロードを解析できます。

iOS のペイロード

iOS の場合、クリックされたアクションのキーと値のペアは常に clickedAction プロパティで受信されます。iOS の通知ペイロードの構造については、こちらのリンクを参照してください。

Android でのセルフハンドルのプッシュクリック(オプション)

デフォルトでは、ユーザーが通知をクリックすると、SDK はユーザーを定義された Activity にリダイレクトし、特定の Flutter コンポーネントを読み込むためにコールバックをアプリケーションに渡します。 アプリケーションがフォアグラウンドにある場合、アプリケーションが再読み込みされているように見え、あまり良いユーザー体験とは言えません。ユーザーを特定の Flutter コンポーネントに移動させるだけにしたい場合もあるでしょう。アプリケーションがフォアグラウンドにあるときにプッシュクリックを自分で処理するには、以下の手順に従ってください。 Flutter プラグインを初期化する際に、PushConfig オブジェクトでフォアグラウンドクリックのコールバックを有効にします。
Android の設定 以下のように、Application クラスでの SDK の初期化時に lifecycleAwareCallback フラグを有効にします。
アプリのルートウィジェットに WidgetsBindingObserver を追加して、アプリケーションがフォアグラウンドに移行するたびに initialize() を呼び出す必要があります。 そのため、initialise() を 2 か所で呼び出す必要があります。1 つは通常どおり initState() 内で、もう 1 つはアプリのルートウィジェットの didChangeAppLifecycleState() 内です。
以下のようにリダイレクトを処理します。
AndroidManifest.xml の application タグ内に、以下の Activity を追加します。