以下是有關活動 API 和回傳應用程式介面的一些常見問題和解答。

活動 API 與媒體優化報表有何不同？

活動 API 利用經過優化的端到端系統，可以更快地處理數據，以確保可以在不到十分鐘的時間內完成交易通知。媒體優化報表在數據可用於報表之前使用傳統的數據流方法。

透過活動 API 可以進行哪些交易？

活動 API 包括向我們的聯盟網報表的所有交易。由於我們讓廣告主能夠使用企業網絡服務、像素和批量上傳的方法報告交易，因此處理通過批量流程上傳的交易所花費的時間將影響數據在應用程式介面中變為可用的時間。

活動 API 提供哪些數據字段？

應用程式介面提供以下交易數據字段，單擊 + 以獲取說明和註釋：

etransaction_id

說明：此字段也稱為 TID，是訂單中每筆交易的唯一 ID。

備註：字母數字字段。如果消費者購買了包含三個不同 SKUs 的商品，則應用程式介面將返回三個記錄，每個 SKU（庫存量單位）一個。三個記錄將共享一個 order_id 值，但每個記錄的 etransaction_id 都是唯一的。

advertiser_id

說明：此字段也稱為商家編號，是唯一的廣告主 ID。

備註：數字字段

網站識別碼

說明：此字段是唯一的推廣商 ID。

備註：數字字段

order_id

說明：該字段為訂單提供唯一的廣告主訂單編號。

備註：數字字段

offer_id

說明：此字段也稱為 OID，提供給佣交易報價的報價 ID。

備註：數字字段

sku_number

說明：此字段為商品提供 SKU。

備註：字母數字字段。僅在廣告主報告它時可用。

銷售額

說明：該字段是消費者在訂單中為該商品支付的金額。

備註：數字字段

數量

說明：此字段包含所購買項目的數量。

備註：數字字段

佣金

說明：此字段提供此交易的總基本佣金。

備註：數字字段

transaction_date 交易日期

說明：該字段是在廣告主網站下訂單的日期和時間。

備註：時間格式字段

process_date 處理日期

說明：該字段是交易被 Rakuten Advertising處理的日期和時間。時區是 GMT。

備註：時間格式字段

transaction_type

說明：此字段會指明交易是實時的還是批量的。

備註：字母數字字段。

product_name

說明：此字段包含購買或退回商品的產品名稱。

備註：字母數字字段。

u1

說明：這是您定義的字段，允許您引用特定的活動或成員值。它指的是您的 &u1= 參數。

備註：字母數字字段。

貨幣

說明：交易金額的幣種。

備註：字母數字字段。

is_event

說明：該字段指定實時交易是事件還是交易。

注： Y 或 N 字段。

事件：這些交易旨在作為交易發生的指標，可以在廣告主審查後消除並通過批量上傳完成。您不應使用這些交易來確定最終支付給您的佣金。如果遺漏了這一點，您可能會收到報告錯誤。

交易：這些交易已經完成，因此您可以將這些交易記賬為在發生任何取消之前會支付的交易。

預期的數據延遲是多少？

通過活動 API 提供的交易的 SLA 是 10 分鐘。

「is_event」標識是什麼意思？

使用批處理上傳交易的廣告主可以使用樂天聯盟媒體優化像素為推廣商提供有關交易的定向資訊。透過媒體優化像素報表的交易在結果中會用 Y 值表示。您不應該使用這些交易來確定您將收到的佣金總額。請注意，此數據僅支持啟用了媒體優化報表的廣告主。

有關 is_event= 參數的用途以及如何解釋數據的更多資訊，請查看開發人員入口網站中的《活動 API 交易指南》。

我多久可以查詢該服務？

服務調用的頻率將由您在訂閱過程中在應用程式介面開發人員入口網站中所選定的層級決定。

我能否在交易和活動發生時收到推送通知（回發）？

是的，您可以通過回發應用程式介面註冊一個網頁地址。此數據和格式將與拉取應用程式介面中類似。

回發可以支持動態網頁地址，讓您自定義回發的輸出。在開發人員入口網站中了解有關可用字段和自定義回發 URL 的更多詳情。

為什麼活動 API 不報告某些交易？

活動 API 報表使用企業網絡服務和批處理的方法報表給樂天聯盟的交易和活動。您不會看到在通過企業網絡服務報表的相同時間線內使用任何批量上傳方法報告給樂天聯盟的交易。

為什麼活動 API 提供的數據與其他報表不同？

活動 API 報表使用企業網絡服務和處理報表給樂天聯盟的交易和活動。您不會看到在通過企業網絡服務報表的相同時間線內使用任何批量上傳方法報告給樂天聯盟的交易。此外，為確保速度，我們將存儲的點擊數據量限制為 30 天。因此，對於早於 30 天的點擊所產生的交易，活動 API 將沒有與交易關聯的 u1 值。

取消如何操作？ 它在活動 API 中會是什麼樣子？

活動 API 中的取消操作與其他報表工具中的操作類似。交易日和訂單編號將原始交易吻合。處理日期將是取消日期。某些值，如「佣金」和「銷售額」，將為負數。