Androidネイティブ統合検証

概要

この 統合検証 機能は、MoEngage Android SDKを目的のアプリケーションに統合するプロセスを簡素化し、MoEngageダッシュボードを通じてAndroid SDK機能の実装を直接検証するためのインターフェースを提供します。
開発者は、複雑な手順や要件の誤解により、Android SDK機能の実装においてしばしば課題に直面します。たとえば、プッシュ通知を設定する際に、リッチ通知などの重要な設定を見落とすことがあります。
この機能により、開発者とマーケターは実装を独立してテストおよび検証できるようになり、正確性を確保し、サポートチームへの依存を減らすことができます。これにより、統合プロセスが強化され、エラーが最小限に抑えられ、シームレスなマーケティングコミュニケーションとユーザーエンゲージメントが保証されます。

アーリーアクセス

これは早期アクセス機能です。アカウントを有効にするには、CSMに連絡するか、サポートチケットを提出してください。

スコープ

統合検証機能は、次の機能を検証するのに役立ちます：

データ追跡
プッシュ通知
プッシュテンプレート

統合検証では、次の機能を検証することはできません:

アプリ内メッセージング
カード
プッシュ
- ロケーショントリガープッシュ
- プッシュ通知センター
- プッシュ増幅
- HMSプッシュ
データ
- カスタム属性: 属性名とその値の名前、構文、およびデータ型の検証は範囲外です。
- カスタムイベント: イベント名、イベント属性名、およびその値の名前、構文、およびデータ型の検証は範囲外です。

library_add_check

前提条件

統合検証機能は、13.4.00以降にリリースされたすべてのSDKバージョンをサポートしています。

デバイスを統合検証のために登録する

デバイスを統合検証に登録するには、以下の手順を実行してください：

MoEngageダッシュボードの左側のナビゲーションメニューで テスト & デバッグ をクリックし、次に 統合検証 をクリックします。
統合検証 ページで、モバイルデバイスのQRリーダーアプリを使用してQRコードをスキャンし、デバイスを登録します。

ランディングページで ここをクリック して進み、提案されたアプリからアプリケーションを選択できます。

info	情報お気に入りのアプリケーションを表示するには、正しいSDKバージョン、つまりバージョン13.4.00以上を含むバージョンであることを確認してください。 MoEngageシステムはシステムデバッガーページを表示し、アプリはデバッガーモードであり、検証の準備が整っています。

デバッガーモードエラーパス

お気に入りのアプリで システムデバッガー ページが表示されない理由は次のとおりです：

間違ったダッシュボードをスキャンしました。
ダッシュボードのテスト環境をスキャンしました。
不正なアプリIDまたはデータセンター(DC)を設定しました。詳細についてはこちらをご覧ください。

デバイスを登録すると、MoEngageシステムはMoEngageダッシュボードに セッションログ をロードします。

意図したアプリを開き、リフレッシュアイコンをクリックしてセッションログを更新できます

。ここでは、セッションに関連する情報を表示できます。 SDK Logger 機能を使用すると、セッションに関連する生データを表示できます。詳細については、こちらをご覧ください。

フィールド	説明
セッションの詳細	デバイスID、開始日、およびセッションの時間を指定します。
デバイス名	デバイス名を指定します。
ステータス	セッションのステータスを指定します：ライブ：セッションはライブで、セッションが期限切れになるまでの残り時間を表示できます。統合を検証することができます。タイムアウト：セッションは期限切れです。セッションの詳細を表示できますが、同じ検証アクションを実行することはできません。

info	情報アプリケーションをインストールしたばかりの場合、MoEngageシステムはユーザーデバイスの詳細を取得するために約5分のバッファ期間を必要とします。

関連するセッションをクリックすると、関連する s ession ページが開きます。

統合検証セッション

セッション ページでは、 User Info. をクリックすることでライブセッションに関連するユーザーの詳細を表示できます。これにより、 User Profile ページにリダイレクトされます。

「 アクティビティ情報 」をクリックして、現在のユーザーが実行したすべてのイベントの詳細な概要を取得します。

info	情報ユーザー情報とアクティビティ情報タブは、ダッシュボードユーザーではなく、現在のセッションユーザーに関する詳細を提供します。

セッション ページでは、次の情報が表示されます。

分野	説明
OSバージョン	デバイスのオペレーティングシステムのバージョンを指定します。
APIレベル	デバイスの Android API レベルを指定します。
モデル名	ユーザーデバイスのモデル名を指定します。
メーカー	デバイスの製造元を指定します。
Google 広告識別子 (GAID)	デバイス上の広告用の一意の識別子を指定します。詳細については、こちらをご覧ください。
デバイス密度	デバイスの画面密度を指定します。
デバイスの幅	デバイス画面の幅をピクセル単位で指定します。
デバイスの高さ	デバイス画面の高さをピクセル単位で指定します。
ネットワークタイプ	デバイスが接続されているネットワークの種類 (Wi-Fi、モバイルデータなど) を指定します。
デバイスのタイムゾーン	デバイスに設定されているタイムゾーンを指定します。
アプリバージョン	デバイスにインストールされているアプリのバージョンを指定します。
FCMプッシュトークン	プッシュ通知用のFirebase Cloud Messaging（FCM）トークンを指定します。詳細については、こちらをご覧ください。
プッシュ許可	デバイスでプッシュ通知の権限が有効になっているかどうかを指定します。

分野	説明
小さいアイコン	通知バーに表示される小さなアイコンを構成するかどうかを指定します。
大きいアイコン	拡張通知ビュー内に表示される大きいアイコンを構成するかどうかを指定します。
通知色	通知アイコンまたは背景に色を設定するかどうかを指定します。
複数の引き出しの統合が有効	ドロワー内で複数の統合を有効にするかどうかを指定します。
ビルディングバックスタックが有効かどうか	ナビゲーション用にバックスタックを構築するかどうかを指定します。
大きなアイコンの表示が有効	通知に大きなアイコンを表示するかどうかを指定します。

この実装の一部として統合されているすべてのモジュールは、 統合されたモジュール セクションで確認できます。

モジュール	バージョン
萌えAndroid SDK	13.05.01
コア	7.5.0
カードコア	2.3.1
カードUI	2.4.1
暗号化ストレージ	2.1.0
ジオフェンス	4.2.1
プッシュベース	8.3.0
リッチ通知	5.1.0
プッシュキット	5.1.1
萌えプッシュファイアベース	7.2.0
アプリ内	8.7.0
受信トレイコア	3.2.1
受信トレイUI	3.2.1
統合検証者	5.3.1
プッシュアンプ	5.2.1
リアルタイムトリガー	3.4.1
SDKデバッガー	1.2.0
安全	3.2.0
トリガー評価者	1.3.0
リッチ通知	5.1.1

検証手順

info	Information 「未受信」ステータスは、ログ生成が不十分であることが原因かもしれません。そのような場合は、アクションを再度実行するか、アプリをバックグラウンドとフォアグラウンドモードの間で切り替えてみてください。ステータスが未受信のままの場合、検証に失敗したことを示します。解決のためにステップ固有のエラーパスを参照してください。

各検証ステップの進捗を追跡するために、以下のステータスを表示できます:

ステータス	Description
始まっていない	このステップの検証が開始されていないことを示しています。
Processing	アプリでアクションが実行され、ステップが追跡されることを示します。タイマーが完了するのを待って、結果を表示してください。
Validated	このステップの検証が完了したことを示します。
受け取っていません	期待されるデータまたは応答が受信されていないことを示します。
失敗しました	このステップの検証が失敗したことを示しています。ご参考までに、このアーティクルでは各検証ステップのすべての可能なエラーパスをリストしています。

データ追跡

データトラッキングは、カスタム属性とカスタムイベントを意図したアプリで検証できる5つの検証ステップで構成されています。データトラッキングを検証するには、 データトラッキング のドロップダウンリストを展開し、次の操作を行います：

カスタム属性

カスタム属性は、カスタム属性の追跡を確認するのに役立ちます。たとえば、好みの言語、住所、会員ステータスを確認することができます。カスタム属性は、MoEngageシステムがユーザー定義のデータポイントを正確にキャプチャすることを保証します。

カスタム属性を検証するには、次の手順を実行します：

アプリを開いて、アプリにカスタム属性を設定します。
カスタム属性を設定した後、 はい、アクションを実行しました をクリックします。
MoEngageシステムがバックエンドでアクションを確認する60秒の待機時間があります。
検証が完了すると、ステータスは 未検証 から 検証済み に変更されます。
実装にエラーがある場合、ステータスは 未検証 から 未受信 に変更されます。その場合、次のエラーが発生した可能性があります。

カスタム属性の検証エラーパス

ステータス

条件

次のアクション

受け取っていません

アプリケーションで必要なアクションを実行していない場合は、トラッキングを有効にするためにアクションを完了してください。

カスタム属性の実装を確認してください。カスタム属性の追跡に関する詳細は、こちらをご覧ください。

アクションを実行したが、ステータスが更新されていない場合、カスタム属性トラッキングが統合されていない可能性があります。

カスタムイベント

カスタムイベントは、ボタンのクリックやビデオの再生など、ユーザー定義のインタラクションの追跡が正確に記録されていることを確認するのに役立ちます。例えば、 カートに追加された商品 イベントが正しい商品IDで追跡されるようにします。

カスタム属性を検証するには、次の手順を実行します:

対象のアプリを開き、アプリでカスタムイベントを設定します。
カスタム属性を設定したら、 はい、アクションを実行しました をクリックしてください。
60秒の待機時間があり、その間にMoEngageシステムがバックエンドでアクションを確認します。
検証が完了すると、ステータスが 未検証 から 検証済み に変更されます。
実装にエラーがある場合、ステータスは 未検証 から 未受領 に変更されます。その場合、次のエラーが発生した可能性があります：

カスタムイベント検証エラーパス

ステータス	条件	次のアクション
失敗しました	カスタムイベントが追跡されていません（Androidネイティブ）。	カスタムイベントで TrackEvent メソッドが呼び出されることを確認してください。
失敗しました	カスタムイベントが追跡されていません。	SDKの初期化前に TrackEvent メソッドが呼び出されます。まずSDKを初期化してください。

GAIDトラッキング

GAIDトラッキングは、ユニークな広告識別子がターゲット広告や分析のために正確にキャプチャされ、送信されることを保証します。GAIDトラッキングは、デバイスログを検査し、広告プラットフォームとの統合を検証することを含みます。
デバイス設定に基づいて、GAIDトラッキングのステータスは自動的に「検証済み」と表示されます。

GAIDトラッキング検証エラーパス

ステータス条件次のアクション

受け取っていません

Google 広告ライブラリが見つかりません。

Google Adsライブラリを統合に追加します。詳細については、こちらをご覧ください。

その


      enableAdIdTracking()

メソッドが呼び出されませんでした。

AD IDトラッキングを有効にするためのメソッド呼び出しを追加します。詳細については、こちらをご覧ください。

ログインするには、目的のアプリにアクセスしてください。
ログインした後、 はい、アクションを実行しました をクリックします。
60秒の待機時間があります。この間に、MoEngageシステムがバックエンドでアクションを検証します。
検証が完了すると、ステータスは 未検証 から 検証済み に変更されます。
実装にエラーがある場合、ステータスは 未検証 から 未受信 に変更されます。その場合、次のエラーが発生した可能性があります。

ログイン検証エラーパス

ステータス	条件	次のアクション
失敗しました	ログインメソッドが呼び出されませんでした。	コード内で `setUniqueId` を呼び出します。詳細については、ユーザー属性の追跡を参照してください。

ログアウト

ログアウトは、ユーザーのサインアウトイベントが正しく記録され、セッションが無効化されることを確実にします。ログアウトには、ログエントリのテスト、セッションのクリーンアップ、およびAPIレスポンスが含まれます。

ログアウトを検証するには、次の手順を実行します：

ログアウトする予定のアプリ。
ログアウトした後、 はい、アクションを実行しました をクリックしてください。
MoEngageシステムがバックエンドでアクションを確認する60秒の待機期間があります。
検証が完了すると、ステータスは 未検証 から 検証済み に変更されます。
実装にエラーがある場合、ステータスは 未検証 から 未受領 に変更されます。その場合、次のエラーが発生した可能性があります。

ログアウト検証エラーパス

ステータス	条件	次のアクション
失敗しました	ログアウトメソッドが呼び出されませんでした。	ログアウトメソッドが呼び出されることを確認してください。詳細については、ユーザー属性の追跡を参照してください。

プッシュ

プッシュは2つのセクションで構成されています：

基本プッシュ
プッシュテンプレート

基本プッシュ

Basic Pushは、アプリの小アイコン、大アイコン、プッシュ権限、さまざまなアプリ状態での通知の構成を検証できる6つの検証ステップで構成されています。Pushを検証するには、 Basic Push のドロップダウンリストを展開し、次の操作を行います:

小さなアプリアイコン

小さなアプリアイコンは、さまざまなデバイスの通知エリア内で小さなアプリアイコンが正しく表示されていることを確認するのに役立ちます。たとえば、小さなアプリアイコンは、アイコンが鮮明に表示され、ブランドガイドラインに沿って配置され、歪みなく適切にスケーリングされることを保証します。
ステータスは、デバイスの設定に基づいて小さなアプリアイコンのために自動的に 検証済み として表示されます。

小さなアプリアイコンの検証エラーパス

ステータス	条件	次のアクション
失敗しました	小さなアプリアイコンが設定されていません。	NotificationConfig をSDK初期化中に追加し、小さなアイコンを含めてください。詳細については、プッシュ設定を参照してください。
失敗しました	小さなアプリアイコンが期待通りに表示されていません。	小アイコンガイドラインに従った新しい小アイコンを追加してください。詳細については、プッシュ設定を参照してください。

大きなアプリアイコン

大きなアプリアイコンは、通知が展開されたときに大きなアプリアイコンが意図した通りに表示されることを確認するのに役立ちます。たとえば、アイコンが通知の視覚的な魅力を高めながら、明瞭さを維持し、サイズ要件に従っていることを確認します。
ステータスは、デバイスの構成に基づいて大きなアプリアイコンのために自動的に 検証済み として表示されます。

大きなアプリアイコンの検証エラーパス

ステータス	条件	次のアクション
失敗しました	大きなアプリアイコンが設定されていません。	SDKの初期化中に NotificationConfig を追加し、パラメータに大きなアイコンを含めてください。詳細については、 Push Configuration. を参照してください。

プッシュ通知の許可

プッシュ権限は、アプリがユーザーからプッシュ通知の権限をシームレスでユーザーフレンドリーな方法で要求していることを確認するのに役立ちます。例えば、権限プロンプトが適切にトリガーされ、アプリのフローに沿っていることを確認します。

プッシュ権限を検証するには、次の手順を実行します：

アプリを開いて、通知のランタイム権限をトリガーするアクションを実行し、リクエストを承認してください。
リクエストを受け入れた後、 はい、アクションを実行しました をクリックしてください。
60秒の待機時間があり、その間にMoEngageシステムがバックエンドでアクションを確認します。
検証が完了すると、ステータスは 未検証 から 検証済み に変更されます。
実装にエラーがある場合、ステータスは 未検証 から 未受信 に変更されます。その場合、次のようなエラーが発生した可能性があります。

プッシュ権限検証エラーパス

ステータス	条件	次のアクション
失敗しました	ユーザーからの許可を求めることに失敗しました。ダイアログが表示されませんでした。	実行時にユーザーからプッシュ許可を求めます。詳細については、通知ランタイム権限を参照してください。
失敗しました	ダイアログは表示されましたが、プッシュ許可はまだ更新されていません。	ユーザーが権限を付与したか拒否したかをSDKに通知します。詳細については、通知の実行時権限を参照してください。
失敗しました	ユーザーがプッシュ権限ダイアログを拒否したため、ダイアログはもう表示されません。	ユーザーを設定ページにリダイレクトして、手動で権限をリクエストします。詳細情報については、通知の実行時権限を参照してください。

アプリがフォアグラウンドにある状態でのプッシュテスト

アプリがフォアグラウンドにある状態でのテストプッシュは、アプリが開いて使用中にプッシュ通知が受信され、正しく表示されることを確認するのに役立ちます。たとえば、通知がユーザーの活動を妨げないようにし、さりげなくしかし目立つように表示されることを確認してください。

アプリがフォアグラウンドにある状態でプッシュ通知を検証するには、次の手順を実行してください：

対象のアプリを前面状態で開いてください。
ダッシュボードで テストプッシュを送信 をクリックしてください。
MoEngageシステムがバックエンドでアクションを確認する60秒の待機時間があります。
アプリが通知を受信したときにフォアグラウンドにあった場合は、 アプリをフォアグラウンドで確認 をクリックしてステップを検証してください。もしそうでない場合は、 リセット をクリックして再度検証を開始してください。
検証が完了すると、ステータスは 未検証 から 検証済み に変更されます。
実装にエラーがある場合、ステータスは 未検証 から 未受信 に変更されます。その場合、以下のエラーが発生した可能性があります。

アプリがフォアグラウンドにある状態でのテストプッシュバリデーションエラーパス

ステータス	条件	次のアクション
失敗しました	プッシュ通知が表示されません。	MoEngageペイロードを処理するFirebaseサービスが追加されていません。MoEngageサービスファイルを追加してください。詳細については、プッシュトークンの登録と表示を参照してください。
失敗しました	プッシュ通知が表示されません。	カスタムサービスファイルがペイロードをSDKに渡しませんでした。詳細については、プッシュトークンの登録と表示を参照してください。
失敗しました	プッシュ通知が表示されません。	アプリが通知を作成しましたが、SDKに通知しませんでした。詳細については、アプリケーションによって処理されるプッシュ表示を参照してください。

バックグラウンドでアプリを使用したテストプッシュ

バックグラウンドでアプリが実行されているときにプッシュ通知が正しく配信され、表示されることを確認するために、バックグラウンドでアプリを使ったプッシュのテストが役立ちます。例えば、アプリがバックグラウンドにある状態でテストプッシュを行うと、通知センターに正確なコンテンツとアイコンが表示されることが確認できます。

アプリがフォアグラウンドにある状態でプッシュ通知を検証するには、次の手順を実行します：

アプリをバックグラウンド状態で開いてください。
ダッシュボードで テストプッシュを送信 をクリックします。
MoEngageシステムがバックエンドでアクションを確認する60秒の待機時間があります。
通知を受信したときにアプリがバックグラウンドにあった場合は、ステップを検証するために バックグラウンドでアプリを確認 をクリックしてください。そうでない場合は、 リセット をクリックして再度検証を開始してください。
検証が完了すると、ステータスは 未検証 から 検証済み に変更されます。
実装にエラーがある場合、ステータスは 未検証 から 未受信 に変更されます。その場合、以下のエラーが発生した可能性があります。

バックグラウンドでのアプリによるテストプッシュ検証エラーパス

ステータス	条件	次のアクション
失敗しました	プッシュ通知が表示されません。	Firebaseサービスは、MoEngageペイロードを処理するために追加されていません。MoEngageサービスファイルを追加してください。詳細については、プッシュトークンの登録と表示を参照してください。
失敗しました	プッシュ通知が表示されません。	カスタムサービスファイルがSDKにペイロードを渡しませんでした。詳細については、プッシュトークンの登録と表示を参照してください。
失敗しました	プッシュ通知が表示されません。	アプリは通知を作成しましたが、SDKには通知しませんでした。詳細については、アプリケーションによって処理されるプッシュ表示を参照してください。

アプリが終了した状態でのプッシュテスト

アプリが終了した状態でのプッシュテストは、アプリが閉じているか実行されていない場合でもプッシュ通知が正常に配信されることを確認するのに役立ちます。例えば、通知がアプリと正しく対話したときにアラートを表示し、シームレスなユーザーエクスペリエンスを提供することを保証します。

アプリが終了した状態でプッシュを検証するには、次の手順を実行します:

デバイスのオープンアプリケーションリストからアプリをスワイプして終了させてください。
ダッシュボードで テストプッシュを送信 をクリックします。
MoEngageシステムがバックエンドでアクションを確認する60秒の待機時間があります。
アプリが通知を受信したときに終了状態にあった場合は、 終了状態のアプリを確認 をクリックしてステップを確認してください。もし違う場合は、 リセット をクリックして再度検証を開始してください。
検証が完了すると、ステータスは 未検証 から 検証済み に変更されます。
実装にエラーがある場合、ステータスは 検証されていない から 受信されていない に変更されます。その場合、次のエラーが発生した可能性があります。

アプリが終了した状態でのテストプッシュ検証エラーパス

ステータス	条件	次のアクション
失敗しました	プッシュ通知が表示されません。	MoEngageペイロードを処理するためのFirebaseサービスは追加されていません。MoEngageサービスファイルを追加してください。詳細については、プッシュトークンの登録と表示を参照してください。
失敗しました	プッシュ通知が表示されません。	カスタムサービスファイルがSDKにペイロードを渡しませんでした。詳細については、プッシュトークンの登録と表示を参照してください。
失敗しました	プッシュ通知が表示されません。	アプリは通知を作成しましたが、SDKには通知しませんでした。詳細については、アプリケーションによって処理されるプッシュ表示を参照してください。
失敗しました	プッシュ通知が表示されません。	アプリケーションクラスの onCreate() メソッドでSDKを初期化します。詳細については、 SDKの初期化を参照してください。
失敗しました	プッシュ通知が表示されません。	サードパーティライブラリがペイロードをSDKに渡すことに失敗しました。ライブラリが終了状態で期待通りに動作するか確認してください。

プッシュテンプレート

プッシュテンプレートは、正確なアラームの権限とプッシュテンプレートの統合を検証する2つの検証ステップで構成されています。プッシュテンプレートを検証するには、ドロップダウンを展開し、次の操作を行います：

テストプッシュテンプレート

テストプッシュテンプレートは、デプロイメント前にプッシュ通知テンプレートの構造と内容を検証するのに役立ちます。例えば、テストプッシュテンプレートは、すべての必須フィールドが正しく設定されていることを保証し、エラーを減らし、ユーザーエンゲージメント体験を向上させます。

プッシュテンプレートを検証するには、以下の手順を実行します：

検証が完了したら、 テストプッシュを送信 をクリックして通知を開始します。
通知が送信された後、インタラクションを追跡するために60秒待ちます。
アプリで通知を受け取った場合：
- 画像バナーテンプレートが表示された場合は、 はい、通知には画像バナーがあります をクリックして検証します。
- 基本テンプレートが表示された場合は、 いいえ、通知には基本テンプレートがあります をクリックします。

テストプッシュテンプレートの検証エラーパス

ステータス	条件	次のアクション
失敗	基本的なプッシュ通知が表示されています。	プッシュテンプレートライブラリはアプリに統合されていません。詳細については、プッシュテンプレートを参照してください。
失敗	基本的なプッシュ通知が表示されています。	ライブラリが追加された場合は、ネットワークの問題を確認し、ネットワークを変更して再試行してください。
失敗しました	プッシュ通知は、一部のデバイスでは白/黒のシステム境界があり、他のデバイスでは完全にカバーされています。	これはAndroid 12からの予期される動作の変更です。

タイマーの正確なアラームの許可を設定するかどうか

タイマーの正確なアラームの権限検証は、タイマーの正確なアラーム機能が設定されているかどうかを確認するのに役立ちます。例えば、時間に敏感なシナリオにおいてアラームが正確にトリガーされることを保証し、ユーザーの信頼性とスケジューリングの正確性を向上させることです。

タイマーの正確なアラーム権限を検証するには、次の手順を実行します：

統合ステータスは自動的に検証されます。
検証された場合は、 テストプッシュを送信 をクリックしてください。通知が試みられます。
成功した場合、インタラクショントラッキングのために60秒待機してください。
通知がプログレスバーテンプレート付きのタイマーを表示しているか確認してください：
- はいの場合は、 はい、通知にはプログレスバー付きのタイマーがあります をクリックしてください。
- いいえの場合、基本テンプレートが表示されている場合は、 いいえ、通知には基本テンプレートがあります をクリックしてください。

タイマー正確なアラーム権限設定検証エラーパス

ステータス	条件	次のアクション
失敗しました	プログレスバーがプッシュ通知に表示されない	権限を追加するのを忘れました。詳細については、プッシュテンプレートを参照してください。
失敗	プログレスバーがプッシュ通知に表示されない	ユーザーによってランタイムで権限を有効にします。詳細については、プッシュテンプレートを参照してください。

概要