Postback 发送错误

当发生 postback 发送错误时,首先检查跟踪器中的信息——这会帮助你快速形成对问题原因的初步假设。 为了验证假设并进行深入分析,使用回传导出。

追踪器中的快速初步诊断

  1. 打开追踪器列表:在菜单栏中选择 追踪 → 追踪器列表。

  2. 启用过滤器 Postback 发送 → 有错误。

    设置过滤

    过滤“有错误”

  3. 点击行 — 您将进入带有错误标记的跟踪器。

在追踪器中,查看发送回传时出现的错误代码,以及该追踪器最常遇到的响应体之一的示例 (response_body)。 这会帮助您快速确定问题最可能的原因。

配置回传错误的跟踪器

跟踪器配置回传错误

响应体示例:

{"StoreId":"","AppId":"","Message":"clickId格式错误","Status":400,"EvType":0,"IsAttributed":1}

例如:

  • 格式错误的clickId — 可能表示click_id参数缺失或格式不正确;
  • 超时或5xx错误——可能表示伙伴服务器暂时不可用;
  • 400 错误 — 可能表示某些参数填写不正确。

在这个阶段,您可以形成关于错误原因的初步假设。

从追踪器列表中,您还可以复制追踪 URL 或查看 转换 报告。

追踪器列表中的操作

轨迹列表中的操作

通过Postback导出检查完整数据

为了验证假设并进行更深入的诊断,请前往导出 → 回传 部分。

Postback 导出功能让您可以:

  • 检查所有 postbacks 是否出现同一错误;
  • 了解是否存在几种不同类型的错误;
  • 确定问题是持续存在还是仅在部分请求中出现。

导出后传数据

要导出已发送的postback:

  1. 在AppMetrica界面中,点击数据导出 → 保存到文件。
  2. 转到 Postbacks 标签页。
  3. 在导出字段列表中勾选:
    • response_code
    • response_body
    • if necessary — 回传 URL,回传 URL 参数
  4. 在过滤器中指定跟踪器编号或名称。
  5. 下载导出文件。
导出postbacks

分析 response_code 和 response_body 字段,同时参考请求参数。

您也可以导出 postback 发送日志 使用 API。

分析导出的回传数据

在分析带有错误的postbacks时,请检查:

  • the postback_url 字段;
  • 传入的参数;
  • 必需值的存在。

例如,出现 格式错误的 clickId 错误时,您可以进一步检查:

  • 是否传递了 click_id 参数;
  • 是否已填写其值;
  • 格式是否符合伙伴的要求。

解决错误

4xx — 请求错误

错误代码 4xx 表示伙伴服务器已收到请求但拒绝了它。

错误的常见原因:

  • 缺少必需的参数;
  • 传递了不正确的参数值;
  • 数据格式不正确;
  • 使用了不支持的HTTP方法。

您可以做的事情:

  • 如果response_body指出特定问题(例如缺少参数)——请修正postback设置。
  • 如果原因不明显——联系支持团队 AppMetrica,并附上请求和响应的示例。

5xx — 伙伴侧错误

错误代码 5xx 表示请求格式正确,但伙伴服务器无法处理。

错误可能的原因:

  • 临时技术问题;
  • 服务器过载;
  • 合作伴争系统内部错误。

您可以做的事情:

  • 检查错误是否大规模且长时间出现。
  • 与合作伙伴联系,提供错误示例,并指明response_code、response_body以及postback发送的时间。

超时和网络错误

网络错误和超时会在伙伴服务器未在规定时间内响应或连接未建立时发生。

错误可能的原因:

  • 与合作伙伴相关的技术问题;
  • IP地址封禁;
  • 不稳定的网络操作。

您可以做的事情:

  • 检查错误的频率。
  • 与合作伙伴确认是否存在限制或技术问题。
  • 如果需要,联系支持 AppMetrica。

其他错误代码

其他错误代码(1xxx、6xxx、9xx)与合作伙伴服务器的特定设置有关。 要查明这样的 postback 响应的原因,请联系合作伙伴或AppMetrica支持以获得说明。

接下来要做什么

分析后,您可以通过将错误代码和响应体与合作伙伴的文档进行比较,初步确定问题的可能原因。

如果原因看起来明显:

  • 您可以调整跟踪器参数;
  • 更新 postback URL;
  • 检查深链中的参数传递。

如果原因仍不清楚:

  • 值得联系广告合作伴侣的支持;
  • 或 AppMetrica 支持,附上错误示例和 response_body。

如果您没有找到所需答案,可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能,请附上截图。

联系支持 为文档提出改进建议