以下是关于活动API 和回发应用程序界面的一些常见问题和答案。

活动API与媒体优化报表有什么不同？

活动API利用一个端到端的系统，对数据的处理速度进行了优化，以确保在10分钟内完成交易通知。媒体优化报表在数据可用于报告之前，采用传统的数据流方式。

通过活动API可以进行哪些交易？

活动API包括向我们联盟报告的所有交易。由于我们让广告主使用企业网络服务、像素和批量上传的方法报告交易，因此处理通过批量流程上传的交易所耗时间将影响数据何时可用于应用程序界面。

可以通过活动API获取哪些数据字段？

应用程序界面提供以下交易数据字段；点击“+”查看说明和注释：

etransaction_id

说明：此字段也称为TID，是订单中每笔交易的唯一ID。

注释：字母数字字段。如果一个消费者的购买包含了三个不同的SKU，应用程序界面将返回三条记录，每个SKU一条记录。三条记录将共享一个order_id值，但每条记录的etransaction_id都是唯一的。

advertiser_id

说明：此字段也被称为商家编号(MID)，是唯一的广告主ID。

注释：数字字段。

sid

说明：此字段是唯一的渠道ID。

注释：数字字段。

order_id

说明：此字段提供订单的唯一广告主订单号。

注释：数字字段。

offer_id

说明：此字段也称为OID，提供了获佣交易报价的报价ID。

注释：数字字段。

sku_number

描述：此字段提供项目的SKU。

注释：字母数字字段。仅在广告主报告时才可用。

sale_amount

说明：此字段是消费者为订单中此项目支付的金额。

注释：数字字段。

数量

说明：此字段包含所购项目的数量。

注释：数字字段。

commissions

说明：此字段提供了此交易的基本佣金总额。

注释：数字字段。

transaction_date

说明：此字段是在广告主网站上下订单的日期和时间。

注释：时间格式字段。

process_date

说明：此字段是Rakuten Advertising处理此交易的日期和时间。时区为格林尼治标准时间。

注释：时间格式字段。

transaction_type

说明：此字段指定该交易为实时还是批处理。

注释：字母数字字段。

product_name

说明：此字段包含购买或退回项目的产品名称。

注释：字母数字字段。

u1

说明：这是您定义的一个字段，允许您引用特定的活动或成员值。它指的是您的 &u1=parameter 。

注释：字母数字字段。

currency

说明：交易销售金额的货币。

注释：字母数字字段。

is_event

说明：此字段指定了实时交易是活动还是交易。

注释： Y或N字段。

活动：这些交易旨在作为发生交易的指标，在广告主审查后可以删除，并通过批量上传最终确定。请务必不要使用这些交易来确定最终支付给您的佣金。如果未填写此字段，则可能会报告错误。

交易：这些交易已最终确定，所以您可以将这些交易计为在取消前待支付的交易。

预期的数据延迟是多少？

通过活动API提供交易的SLA是10分钟。

“is_event”标志是什么意思？

使用批处理上传交易的广告主可以使用乐天联盟媒体优化像素为渠道提供交易的方向信息。通过媒体优化像素报告的交易在结果中显示为Y值。您不应使用这些交易来确定将收到的佣金总额。务请注意，只有启用了媒体优化报表的广告主才支持此数据。

关于is_event=<is_event>参数的用途以及如何解释您的数据的更多信息，请查看开发者入口中的活动API交易指南。

我多久可以查询一次服务？

服务调用的频率取决于您在订阅过程中在应用程序界面开发者入口中选择的层级。

我能否在交易和活动发生时收到推送通知（回发）？

是的，您可以通过回发应用程序界面注册一个网址。此数据和格式将与拉取应用程序界面中提供的相同。

回发可以支持动态网址，让您自定义回发的输出。请访问开发者入口，了解关于可用字段和自定义回发网址的更多信息。

为什么活动API没有报告某些交易？

活动API报告使用企业网络服务和批处理上报乐天联盟的交易和事件。在与通过企业网络服务上报的交易同一时间线内，您不会看到任何使用批量上传方式向乐天联盟报告的交易。

为什么活动API提供的数据与其他报告不同？

活动API报告使用企业网络服务和批处理上报乐天联盟的交易和事件。在与通过企业网络服务上报的交易同一时间线内，您不会看到任何使用批量上传方式向乐天联盟报告的交易。此外，为了确保速度，我们将点击数据的存储量限制为30天。因此，对于点击时间超过30天的交易，活动API不会有与该交易关联的u1值。

取消如何运作？ 它在活动API中会是什么样子？

活动API中的取消与其他报告工具中的操作类似。交易日期和订单号将与原始交易匹配。处理日期将是取消日期。一些值，如“commissions”和“sales_amount”，将是负数。