介紹

回發應用程式介面（API）由 Rakuten Advertising API 開發人員入口網站提供。請造訪入口網站以取得我們提供的 API 的完整清單。

應用

交易活動在我們的系統中進行處理時，回發 API 讓您可以接收它們。 它旨在提供與活動 API 類似的數據，但是，是由我們將這些數據推送給您，所以您不需要通過活動 API 獲取它們。

您可以使用 API 進行以下操作：

• 為特定推廣商 ID 設置回發。
• 更新回發 URL。
• 刪除回發 URL。
• 停用或啟用回發。

測試版功能

回發應用程式介面目前處於測試階段，我們正在征求用戶反饋以進行改進。未來任何改進不會對回發功能造成任何影響。這些改進只會影響使用者與 API 的互動。

訪問

您可以在入口網站中查看有關使用回發 API 的詳細說明。 使用您的推廣商控制面板登入憑證進行登入。

在開始之前，您需要滿足以下條件：

• 回發的 URL。此 URL 是可自定義的，詳細內容如下。
• API 存取權杖。查看有關檢索 API 存取權杖的說明。

此外，您的使用者帳戶必須與執行回發的推廣商 ID 相關聯。

設置回發 URL

回發應用程式介面可以支持動態 URL，並且允許您自定義輸出。您的回發 URL 應包括：

1. 您的網站網址。
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

疑難排解

如果您的回發端點收到不正確的數據或根本沒有收到數據，請執行以下操作：

• 確認您的端點滿足我們的 400ms 逾時限制。如果您的端點 URL 響應請求的時間超過 400ms，我們的服務器將不會發送數據。僅進行一次連接嘗試。如果連接嘗試被取消或失敗，則不會重新發送數據。
• 透過運行帶有成員 ID（u1）字段的個別項目報表來檢查數據是否存在。請注意，數據最多可能需要四個小時才能顯示在報告中。
• 如果您的回發被自動禁用，則您將不會收到通知。我們建議您使用端點狀態 API 調用，來檢查回發是否已停用或處於活動狀態。

我們還在開發人員入口網站指南中，提供了特定錯誤訊息及其含義的清單。如果您仍然遇到問題，請聯絡客戶支援並提供未收到數據時的特定訂單 ID 或日期。