Dashboard
推送仪表板为您提供所有注册活动的详细信息、交付状态和统计信息的单一视图。
搜索¶
您可以搜索当前连接的用户所拥有权限的游戏所发送的活动的状态和统计信息。
根据交付计划（保留）选择一个日期，然后选择一个应用程序和一个活动。交付计划默认设置为今天的日期。所有数据将以日为单位显示。然而，您还可以在各自的活动详细数据区间中查看重复活动的整体、国家和服务器的重复周期的趋势图。
Note
您可以搜索最多一年前的数据。
游戏状态¶
您可以查看特定游戏相应日期的整个数据图、令牌数量、交付、开启和注册的活动。
Note
开放次数代表当天的开放次数。请注意，不仅当天发送的活动的开放次数被计算在内，之前发送的活动的开放次数也可以被计算在内。例如，如果用户打开了昨天发送给该用户的推送，则该推送的开放次数被计为今天的。因此，可能会出现当天活动开放次数总和的不匹配。除了开放次数（例如令牌数量）以外的数字都代表当天的计数。（不过，Facebook的开放案例计数被排除在外。）
上面的地图显示了特定日期的全球交付数量。彩色部分是交付量较多的地方。如果将光标放在上面，您可以通过工具提示查看详细信息。
上面的图表显示了特定日期的令牌数量变化。图表每小时实时刷新，您可以根据累积的令牌数量预测交付量，特别是在您需要发送大量时。
活动信息¶
在顶部选择一个游戏和日期后，点击搜索以显示结果。 您可以点击特定的活动以查看其详细数据。
点击右上角的下载按钮，将数据以图表格式下载为Excel文件。
显示所选活动当天的交付总数、成功案例、未解决案例和失败案例。
如果所选的活动是仅发送一天的单一活动，它将显示为“点”图表。 当您点击图表区域时，您将看到该日期关于单一活动的案例成功/失败率的图表以及失败的原因。
如果所选的活动是一个在多个日期发送的重复活动，它将显示为“线”图。对于重复活动，您可以查看整个重复间隔的数据趋势，以及顶部的特定日期。顶部选择的日期将是标准日期，并且包含所选日期的整个投递间隔（默认值）将显示在此区域。单击图表区域中的特定日期以查看详细信息，例如相应日期的成功/失败率和底部的失败原因图。如果这是一个运行超过一周的活动，您可以单击标题区域右侧的[上周]或[下周]按钮按周查看结果。
对于所选活动当天的交付总金额，结果将显示成功率和失败率的饼图。(左)
右侧的图表显示了详细失败的原因和当天总失败数量的比例。在谷歌（FCM）和苹果（APNS）上，如果请求的推送通知出现失败，它将返回错误代码，以便您可以找出失败的原因。谷歌（FCM）提供了总共16个响应，而苹果（APNS）提供了28个错误响应。推送为用户提供了失败的原因，以便用户可以了解不是系统问题的错误。每个失败错误代码的概述如下。
FCM(Google)¶
| 错误 | 描述 | 等 |
|---|---|---|
| 缺失注册 | 检查请求是否包含注册令牌 （在纯文本消息中的 registration_id，或在 JSON 中的 to 或 registration_ids 字段）。 | 当在发送到 FCM 服务的负载中省略令牌时发生 |
| 无效注册 | 检查您传递给服务器的注册令牌的格式。 确保它与客户端应用从Firebase通知注册中接收到的注册令牌匹配。 请勿截断或添加额外字符。 | 当令牌无效时发生 |
| 未注册 | 现有的注册令牌可能在多种情况下失效，包括： 如果客户端应用程序与 FCM 注销。 如果客户端应用程序被自动注销，这可能发生在用户卸载应用程序时。 例如，在 iOS 上，如果 APNS 反馈服务报告 APNS 令牌无效。 如果注册令牌过期 （例如，Google 可能决定刷新注册令牌，或者 APNS 令牌已过期，适用于 iOS 设备）。 如果客户端应用程序已更新，但新版本未配置为接收消息。 对于所有这些情况，请从应用服务器中删除此注册令牌，并停止使用它发送消息。 | 如果应用程序已被删除，则会发生 |
| 无效的包名 | 确保消息是发送到与请求中传递的值匹配的注册令牌的包名。 | 当请求从服务器发送推送的应用与令牌应用不匹配时发生 |
| MismatchSenderId | 注册令牌与某一组发送者相关联。当客户端应用程序注册 FCM 时， 它必须指定哪些发送者被允许发送消息。 在向客户端应用程序发送消息时，您应该使用这些发送者 ID 中的一个。 如果您切换到不同的发送者，现有的注册令牌将无法使用。 | 当请求从服务器发送推送的发送者 ID 与用于创建令牌的发送者 ID 不匹配时发生 |
| 无效参数 | 检查提供的参数是否具有正确的名称和类型。 | 当发送到FCM服务的有效负载无效时发生 |
| 消息过大 | 检查消息中包含的有效负载数据的总大小是否超过FCM限制： 大多数消息为4096字节，或在发送到主题的消息情况下为2048字节。 这包括键和值。 | 当发送到FCM服务的有效负载大小超过4K时发生 |
| InvalidDataKey | 检查有效负载数据中是否包含 FCM 内部使用的键（例如 from、gcm 或任何以 google 为前缀的值）。 请注意，某些词（例如 collapse_key）也被 FCM 使用，但在有效负载中是允许的， 在这种情况下，有效负载值将被 FCM 值覆盖。 | 当发送到 FCM 服务的有效负载字段名称无效时发生 |
| 不可用 | 服务器无法及时处理请求。 | FCM服务错误 |
| 内部服务器错误 | 服务器在处理请求时遇到错误。 | FCM 服务错误 |
APNS(苹果)¶
| 错误 | 描述 | 等 |
|---|---|---|
| BadCollapsedId | 折叠标识符超过允许的最大大小。 | 当用于覆盖的折叠 ID 超过其允许的最大大小时发生 |
| 坏设备令牌 | 指定的设备令牌无效。请验证请求是否包含有效的令牌 并且令牌与环境匹配。 | 当推送令牌无效时发生 |
| MissingDeviceToken | 请求的 :path 中未指定设备令牌。 请验证 :path 头是否包含设备令牌。 | 当在发送到 APNS 服务的有效负载中省略令牌时发生 |
| 有效负载为空 | 消息有效负载为空。 | 当发送到 APNS 服务的有效负载被省略时发生 |
| 坏证书 | 证书无效。 | 推送证书错误 |
| 错误证书环境 | 客户端证书用于错误的环境。 | 应用证书错误 |
| 未注册 | 设备令牌对指定主题无效。 | 如果应用已被删除，则会发生此情况 |
| 负载过大 | 消息负载过大。 | 当发送到 APNS 服务的负载大小超过 4K 时发生 |
| 请求过多 | 对同一设备令牌连续发出了太多请求。 | 当使用相同令牌请求了太多推送交付时发生 |
| 内部服务器错误 | 发生了内部服务器错误。 | APNS 服务错误 |
| 服务不可用 | 该服务不可用。 | APNS 服务错误 |
| 关机 | 服务器正在关机。 | APNS服务错误 |
ADM(Amazon)¶
| 错误 | 描述 | 等 |
|---|---|---|
| 未注册 | 与注册 ID 关联的应用实例不再可用以接收消息。 | 当应用被删除时发生 |
| 无效的注册ID | 注册ID与提供的访问令牌所识别的发送者不对应。 | 当令牌无效时发生 |
| 无效数据 | - | 当发送到ADM服务的有效负载无效时发生 |
| 访问令牌已过期 | 提供的访问令牌无效。 发送者应刷新他们的访问令牌。 | 服务器认证令牌过期 |
| 消息过大 | 数据参数中提供的消息有效负载超出了最大允许的数据大小（6 KB）。 | 当发送到 ADM 服务的有效负载大小超过 6K 时发生 |
| MaxRateExceeded | 请求者已超过其最大允许的消息发送速率。 发送者可能会在稍后重试，遵循响应中包含的 Retry-After 头。 为了确保高可用性，ADM 限制在给定时间段内可以发送的消息数量。 | 当在同一时间请求了过多的推送交付时发生 |
| 内部服务器错误 | 发生了内部服务器错误。 | 由于ADM服务错误返回HTTP代码500 |
| 不可用 | 服务器暂时不可用。 | 由于ADM服务错误返回HTTP代码500 |
Facebook¶
| 错误代码 | 错误信息 | 其他 |
|---|---|---|
| 190 | 无效的OAuth访问令牌签名。 | 当在应用中心注册的app_secret和app_id值不正确时发生 |
| 100 | 参数主体必须至少为 10 个字符长。 | 当主体文本为 10 个字符或更少时发生的通知 |
| 参数标题必须最多为30个字符。 | 当标题为30个字符或更多时发生的通知 | |
| 参数主体长度必须最多为180个字符。 | 当主体文本为180个字符或更多时发生的通知 | |
| 参数媒体不是有效的URI。 | 当输入无效的图像URI时发生的通知 | |
| 613 | 自上次游戏以来，用户只能收到 5 条通知。 | 当超过通知 API 调用次数限制时发生的通知 |
请参考下面的URL，以获取Google、Apple、Amazon和Facebook提供的开发者指南。
Note
※由Google（FCM）、Apple（APNS）、Amazon（ADM）和Facebook提供的错误响应代码指南 来自FCM的下游消息错误响应代码 : 前往 来自APNs的HTTP/2响应 : 前往 来自ADM的响应格式 : 前往 来自Facebook的Graph API错误处理 : 前往
左侧图表显示了各国的交付信息，右侧图表显示了服务器的交付信息。
显示特定日期所选活动的每个服务器或国家的交付数量、成功案例、未解决案例和失败案例。默认情况下，将首先显示交付数量最多的服务器或国家，因为可能有多个国家或服务器进行交付。如果至少有一个服务器或一个国家进行了交付，您可以使用顶部的多选框同时显示两个或更多数据图表并进行比较。
任务信息¶
在顶部选择一个特定的活动以显示。 活动在实际工作对应的任务数量上有所不同，这取决于您是否选择批量交付。在批量交付的情况下，只有一个任务，因为案例是根据KST一次性发送的，而不考虑国家和时区之间的时差。相反，如果不选择批量交付，则最多可以存在24个任务，因为它们是根据国家和时区的指定时间顺序发送的。
在本节中，您可以查看所选活动每个任务的详细信息。您必须单击并选择某个任务以查看如下数据。
按国家或服务器向您显示所选任务的交付信息。
通过 AppID 显示所选 任务 的交付信息。
左侧饼图显示了所选任务的成功率和失败率，关于当天的总交付情况。
右侧的表格向您展示了所选日期的详细失败原因和总失败次数的百分比。失败原因的错误代码的详细描述与顶部整个活动的失败原因图表区间相同。
如果在一个活动中有10个失败案例，其中8个发生在特定的任务上，您可以在此部分检查并找出它们失败的原因。
如果您没有使用批量交付，并且任务被发送到韩国，而失败的原因主要是由于应用程序被删除，您可以假设在韩国删除应用程序的用户比其他国家的用户更多。