概述

回发应用程序界面由 Rakuten Advertising 应用程序界面开发者入口提供。请访问门户网站，查看我们提供的 API 的完整列表。

应用

通过回发应用程序界面，您可以接收我们系统处理的交易事件。它旨在提供与活动 API 类似的数据，只不过我们会将这些数据推送给您，您无需通过活动 API 获取数据。

您可以使用应用程序界面：

• 为特定推广者 ID 设置回发。
• 更新回发的网址。
• 删除回发网址。
• 禁用或启用回发。

测试版功能

Postback应用程序界面目前处于测试阶段，因为我们正在征求用户的反馈意见以进行改进。回发的功能将不会受到未来任何增强功能的影响。增强功能只会影响用户与应用程序界面的交互。

访问入口

您可以在门户网站上查看使用回发应用程序界面的详细说明。使用渠道控制面板登录凭据登录。

在开始之前，您需要具备以下条件：

• 用于回发的网址。这个网址是可定制的，详见下文。
• 应用程序界面访问令牌。查看检索应用程序界面访问令牌的说明。

此外，您的用户账户必须与实施回发的推广者 ID 关联。

设置一个回发网址

Postback回发应用程序界面可以支持动态网址，允许您自定义输出。你的回发网址应该包括：

1. 您的网站URL。
2. is_event=<is_event> 字段。
3. 您想包括的任何其他字段的参数。这些字段可以自定义，详情请参见下面的可自定义字段部分。如果您包括了几个参数，这些参数应该用&分开。

例如，如果您的网站是 https://www.my-pretty-postback-URL.com，您想包含 transaction_date 和 sku_number 字段，则您的回发URL将是：

https://www.my-pretty-postback-URL.com?is_event=<is_event>& transaction_date=<transaction_date>&sku_number=<sku_number>

关于 is_event=<is_event> 字段的目的以及如何解释您数据的更多信息，请查看开发者入口中的活动 API事务指南。

可自定义字段

允许进行以下自定义：

• 重命名字段名称
• 仅接收某些字段
• 重新排序字段
• 使用静态值。

我们建议您查看开发者入口中的活动 API 常见问题和活动 API 推送/回发指南，以获取可用字段和回发自定义示例的列表。

自定义请求示例

• 例 1：将"u1"重命名为"unique_id"
• 例 2：只包括以下字段：
  • transaction_date
  • sku_number
  • 数量
  • 佣金
• 例 3：只包括以下字段并重命名：
  • transaction_date
  • sku_number
  • 数量
  • 佣金
  • 将 u1 重命名为 unique_id

故障排除

如果您的回发端点收到不正确的数据或根本没有数据，请：

• 确认您的端点符合我们的400毫秒超时限制。如果您的端点网址响应请求的时间超过400毫秒，我们的服务器将不发送数据。只进行一次连接尝试。如果一个连接尝试被取消或失败，数据不会被重新发送。
• 通过运行单个项目报表，检查数据是否存在，并对成员 ID（u1）字段进行检查。请注意，数据可能需要长达4个小时才能显示在报告中。
• 如果您的回帖被自动禁用，您将不会得到通知。我们建议您使用端点状态应用程序界面调用来检查回传是已禁用还是激活。

我们还在开发者入口指南中提供了具体错误信息及其含义的列表。如果您仍然遇到问题，请联系客户支持，提供未收到数据的具体订单 ID 或日期。