ダッシュボード
プッシュダッシュボードは、すべての登録されたキャンペーンの詳細、配信状況、および統計を一元的に表示します。
検索¶
現在接続しているユーザーが権限を持つゲームのキャンペーンのステータスと統計を検索できます。
配信スケジュール（予約）に基づいて日付を選択し、その後アプリとキャンペーンを選択してください。配信スケジュールはデフォルトで今日の日付に設定されています。すべてのデータは日単位で表示されます。ただし、繰り返しキャンペーンのみのそれぞれのキャンペーン詳細データの間隔で、全体、国、サーバーごとの繰り返し期間のトレンドグラフを表示することもできます。
Note
あなたは1年前までのデータを検索できます。
ゲームのステータス¶
特定の日の対応するゲームの全データグラフ、トークン数、配信、オープンおよび登録されたキャンペーンを確認できます。
Note
開封数は、その日の開封数を示します。その日のキャンペーンの開封数だけでなく、以前に配信されたものもカウントされることに注意してください。たとえば、ユーザーが昨日このユーザーに送信されたプッシュ通知を開封した場合、そのプッシュの開封数は今日のものとしてカウントされます。したがって、その日のキャンペーンの開封数の合計と不一致が生じる可能性があります。開封数以外の数字（トークン数など）はすべてその日のカウントを示します。（ただし、Facebookの開封ケースのカウントは除外されます。）
上記の地図は、特定の日の配達数（世界的に）を示しています。色の付いた部分は、配達が多い場所です。カーソルを合わせると、ツールチップを介して詳細情報を表示できます。
上記のグラフは、特定の日のトークン数の変化を示しています。グラフはリアルタイムで毎時更新され、特に大量の送信が必要な場合に、蓄積されたトークン量に基づいて配信量を予測できます。
キャンペーン情報¶
ゲームと日付を上部で選択した後、検索をクリックして結果を表示します。 特定のキャンペーンをクリックすると、その詳細データを表示できます。
右上のダウンロードボタンをクリックして、データをチャート形式のExcelファイルとしてダウンロードしてください。
選択した日のキャンペーンの配信総数、成功したケース、オープンケース、および失敗したケースの数を表示します。
選択したキャンペーンが1日のみを送信する単一キャンペーンである場合、それは「ドット」グラフとして表示されます。 グラフエリアをクリックすると、その日付に関する単一キャンペーンのケースの成功/失敗率と失敗の理由のグラフが表示されます。
選択したキャンペーンが複数日間にわたって送信される定期キャンペーンである場合、それは「ライン」グラフとして表示されます。繰り返しキャンペーンの場合、全体の繰り返し期間のデータトレンドと、上部に特定の日を表示できます。上部で選択された日付が標準日付となり、選択された日を含む週が全体の配信期間（デフォルト値）からこの領域に表示されます。 グラフエリア内の特定の日付をクリックすると、該当の日付の成功/失敗率や、下部の失敗理由グラフなどの詳細を表示できます。1週間以上実施されているキャンペーンの場合、タイトルエリアの右側にある[前の週]または[次の週]ボタンをクリックして、週ごとの結果を表示できます。
選択したキャンペーンの日の配達の合計金額について、結果は成功率と失敗率の円グラフを表示します。(左)
右のグラフは、詳細な失敗の理由とその日の総失敗数の比率を示しています。Google (FCM) と Apple (APNS) では、要求されたプッシュ通知に関して失敗が発生した場合、エラーコードが返されるため、失敗の理由を特定できます。Google (FCM) は合計16のレスポンスを提供し、Apple (APNS) は28のレスポンスをエラーに提供します。プッシュはユーザーに失敗の理由を提供し、ユーザーがシステムの問題ではないエラーを特定できるようにします。各失敗したエラーコードの概要は以下に示されています。
FCM(Google)¶
| エラー | 説明 | その他 |
|---|---|---|
| MissingRegistration | リクエストに登録トークンが含まれていることを確認してください (プレーンテキストメッセージのregistration_id内、またはJSONのtoまたはregistration_idsフィールド内)。 | FCMサービスに送信されるペイロードにトークンが省略されると発生します。 |
| 無効な登録 | サーバーに渡す登録トークンの形式を確認してください。 Firebase Notifications に登録する際にクライアントアプリが受け取る登録トークンと一致していることを確認してください。 文字を切り詰めたり、追加の文字を加えたりしないでください。 | トークンが無効な場合に発生します |
| 未登録 | 既存の登録トークンは、以下のようなシナリオで無効になる可能性があります: クライアントアプリがFCMから登録解除された場合。 クライアントアプリが自動的に登録解除される場合、これはユーザーがアプリケーションをアンインストールした場合に発生する可能性があります。 例えば、iOSでは、APNSフィードバックサービスがAPNSトークンを無効として報告した場合。 登録トークンが期限切れになった場合 （例えば、Googleが登録トークンを更新することを決定した場合、またはiOSデバイスのAPNSトークンが期限切れになった場合）。 クライアントアプリが更新されたが、新しいバージョンがメッセージを受信するように設定されていない場合。 これらすべてのケースについて、この登録トークンをアプリサーバーから削除し、メッセージを送信するために使用するのを停止してください。 | アプリが削除された場合に発生します |
| 無効なパッケージ名 | メッセージがリクエストで渡された値と一致するパッケージ名の登録トークンに宛てられていることを確認してください。 | サーバーからプッシュを送信するリクエストを行うアプリとトークンアプリが一致しない場合に発生します |
| MismatchSenderId | 登録トークンは特定の送信者グループに結び付けられています。クライアントアプリがFCMに登録する際、 どの送信者がメッセージを送信することを許可されているかを指定する必要があります。 クライアントアプリにメッセージを送信する際は、それらの送信者IDのいずれかを使用する必要があります。 異なる送信者に切り替えると、既存の登録トークンは機能しなくなります。 | サーバーからプッシュを送信するために要求されたSender IDと、トークンを作成するために使用されたSender IDが一致しない場合に発生します |
| 無効なパラメータ | 提供されたパラメータが正しい名前とタイプであることを確認してください。 | FCMサービスに送信されるペイロードが無効な場合に発生します |
| メッセージが大きすぎます | メッセージに含まれるペイロードデータの合計サイズがFCMの制限を超えないことを確認してください: ほとんどのメッセージの場合は4096バイト、またはトピックへのメッセージの場合は2048バイトです。 これにはキーと値の両方が含まれます。 | FCMサービスに送信されるペイロードのサイズが4Kを超えると発生します |
| InvalidDataKey | ペイロードデータに、FCMによって内部的に使用されるキー（from、gcm、またはgoogleでプレフィックスされた任意の値など）が含まれていないことを確認してください。 collapse_keyのような単語はFCMによっても使用されますが、ペイロード内で許可されています。 この場合、ペイロードの値はFCMの値によって上書きされます。 | FCMサービスに送信されるペイロードのフィールド名が無効な場合に発生します |
| 利用不可 | サーバーはリクエストを時間内に処理できませんでした。 | FCMサービスエラー |
| 内部サーバーエラー | サーバーはリクエストを処理中にエラーに遭遇しました。 | FCMサービスエラー |
APNS(Apple)¶
| エラー | 説明 | その他 |
|---|---|---|
| BadCollapsedId | コラプス識別子が許可された最大サイズを超えています。 | 上書き用のコラプスIDが許可された最大サイズを超えたときに発生します |
| BadDeviceToken | 指定されたデバイストークンが無効です。リクエストに有効なトークンが含まれていることを確認し、 トークンが環境と一致していることを確認してください。 | プッシュトークンが無効な場合に発生します |
| MissingDeviceToken | リクエストの :path にデバイストークンが指定されていません。 :path ヘッダーにデバイストークンが含まれていることを確認してください。 | APNS サービスに送信されるペイロードでトークンが省略されたときに発生します |
| ペイロードが空です | メッセージペイロードが空でした。 | APNSサービスに送信されるペイロードが省略された場合に発生します |
| BadCertificate | 証明書が無効です。 | プッシュ証明書エラー |
| 不正な証明書環境 | クライアント証明書が誤った環境用でした。 | アプリ証明書エラー |
| 未登録 | デバイストークンは指定されたトピックに対して非アクティブです。 | アプリが削除された場合に発生します |
| ペイロードが大きすぎる | メッセージのペイロードが大きすぎました。 | APNSサービスに送信されるペイロードのサイズが4Kを超えると発生します。 |
| TooManyRequests | 同じデバイストークンに対して連続してリクエストが多すぎます。 | 同じトークンでプッシュ配信が多すぎるときに発生します |
| 内部サーバーエラー | 内部サーバーエラーが発生しました。 | APNSサービスエラー |
| サービス利用不可 | サービスが利用できません。 | APNSサービスエラー |
| シャットダウン | サーバーはシャットダウンしています。 | APNSサービスエラー |
ADM(Amazon)¶
| エラー | 説明 | その他 |
|---|---|---|
| 未登録 | 登録IDに関連付けられたアプリインスタンスは、メッセージを受信するためにもはや利用できません。 | アプリが削除されたときに発生します |
| 無効な登録ID | 登録IDは、提供されたアクセストークンによって特定された送信者に対応していません。 | トークンが無効な場合に発生します |
| 無効なデータ | - | ADMサービスに送信されるペイロードが無効な場合に発生します |
| AccessTokenExpired | 提供されたアクセストークンは無効です。 送信者はアクセストークンを更新する必要があります。 | サーバー認証トークンの有効期限切れ |
| MessageTooLarge | データパラメータに提供されたメッセージペイロードが最大許容データサイズ（6 KB）を超えました。 | ADMサービスに送信されるペイロードのサイズが6Kを超えたときに発生します。 |
| 最大レート超過 | リクエスターは許可された最大メッセージレートを超えました。 送信者は、応答に含まれるRetry-Afterヘッダーを尊重して、後で再試行することができます。 高可用性を確保するために、ADMは特定の期間内に送信できるメッセージの数を制限します。 | 同時に要求されたプッシュ配信が多すぎると発生します |
| 内部サーバーエラー | 内部サーバーエラーが発生しました。 | ADMサービスエラーによりHTTPコード500を返します |
| 利用不可 | サーバーは一時的に利用できません。 | ADMサービスエラーによりHTTPコード500を返します |
フェイスブック¶
| エラーコード | エラーメッセージ | その他 |
|---|---|---|
| 190 | 無効なOAuthアクセストークンの署名。 | App Centerに登録されたapp_secretとapp_idの値が不正な場合に発生します |
| 100 | パラメータ本文は10文字以上でなければなりません。 | 本文が10文字以下のときに発生する通知 |
| パラメータのタイトルは最大30文字でなければなりません。 | タイトルが30文字以上のときに発生する通知 | |
| パラメータの本文は最大180文字である必要があります。 | 本文が180文字以上のときに発生する通知 | |
| パラメータメディアは有効なURIではありません。 | 無効な画像URIが入力されたときに発生する通知 | |
| 613 | ユーザーが最後にプレイしてから、5件の通知のみが送信できます。 | 通知API呼び出しの制限を超えたときに発生する通知 |
Google、Apple、Amazon、Facebookが提供する開発者ガイドについては、以下のURLを参照してください。
Note
※Google (FCM)、Apple (APNS)、Amazon (ADM)、およびFacebookによって提供されたエラー応答コードガイド FCMからの下流メッセージエラー応答コード : Go APNsからのHTTP/2応答 : Go ADMからの応答形式 : Go FacebookからのGraph APIエラー処理 : Go
左のグラフは国別の配信情報を示し、右のグラフはサーバー別の配信情報を示しています。
選択したキャンペーンの特定の日における、サーバーまたは国別の配信数、成功したケース、オープンケース、失敗したケースを表示します。デフォルトでは、配信が行われた国やサーバーが多数あるため、最も配信数の多いサーバーまたは国が最初に表示されます。配信が行われたサーバーまたは国が少なくとも1つある場合、上部のマルチセレクトを使用して、同時に2つ以上のデータグラフを表示し、比較することができます。
タスク情報¶
特定のキャンペーンを上部で選択して表示してください。 キャンペーンは、バルク配信を選択するかどうかに応じて、実際の作業に対応するタスクの数が異なります。バルク配信の場合、ケースはKSTに基づいて一度に送信されるため、国とタイムゾーンの時差を考慮せず、1つのタスクしかありません。対照的に、バルク配信が選択されていない場合、国とタイムゾーンによって指定された時間に従って順次送信されるため、最大24のタスクが存在する可能性があります。
このセクションでは、選択したキャンペーンの各タスクの詳細を表示できます。特定のタスクをクリックして選択する必要があります。以下のデータを表示するために。
選択したタスクの国またはサーバーによる配信情報を表示します。
選択したタスクのAppIDによる配信情報を表示します。
左の円グラフは、選択したタスクに関する、当日の総配信に対する成功率と失敗率を示しています。
右の表は、選択した日の詳細な失敗の理由と、総失敗数の割合を示しています。失敗原因のエラーコードの詳細な説明は、キャンペーン全体の失敗原因グラフの間隔と同じです。
キャンペーンに10件の失敗ケースがあり、そのうち8件が特定のタスクで発生した場合、このセクションで確認し、なぜ失敗したのかを見つけることができます。
バルク配信を使用していない場合、タスクが韓国に送信され、失敗の理由が主に削除されたアプリによるものであった場合、他の国と比較して韓国でアプリを削除したユーザーがより多くいると考えることができます。