更新於 2023 年 12 月。

簡介

本文件是您實施Rakuten Advertising 商品目錄資料摘要的指南。它為您提供如何自動化從參與 Rakuten Advertising 並訂閱商品目錄計劃的廣告主合作夥伴獲取商品信息的過程。

商品目錄資料摘要的實施有兩個層次。首先，您需要獲得批准並設置商品資料摘要的技術實施，然後您需要獲得每個參與的廣告主合作夥伴的批准，以便在您的網站或博客上使用他們的商品目錄資料摘要。更多信息請參見入門指南。

使用商品目錄的技術要求

要自動化獲取商品信息的過程，您必須能夠：

• 從 SFTP 帳戶下載文件。
• 處理包含商品信息的 XML 或管道分隔文本文件。

文件部分

商品文件有三個部分：標頭、商品數據和尾部；點擊 + 獲取每個部分的更多信息：

文件格式

商品目錄文件有兩種格式：管道分隔文本和 XML：

檔案名稱

商品目錄檔案名稱有三個部分，每個部分以底線分隔：廣告主 ID、推廣商頻道 ID 和檔案類型。

1. 廣告主 ID 或 商家編號 是樂天廣告聯盟網用來識別廣告主的唯一 ID。這總是數字。
2. 推廣商頻道 ID 或 網站識別碼 是樂天廣告聯盟網用來識別推廣商頻道的唯一 ID。這總是數字。
3. 檔案類型 “mp” 定義該檔案為商品目錄檔案。

檔案名稱的副檔名指定了商品目錄檔案的類型。管道分隔檔案有 .txt 副檔名，XML 格式檔案有 .xml 副檔名。所有檔案都已壓縮，因此在檔案類型副檔名後有 .gz。

範例： 2385_112_mp.txt.gz，其中：

• 2385 是廣告主計畫 ID。
• 112 是推廣商頻道 ID。
• mp 表示這是一個商品目錄檔案。
• .txt 表示這是一個管道分隔的商品目錄檔案。

檔案類型

樂天廣告商品目錄功能允許廣告主上傳其產品資訊給我們。我們處理上傳的資訊，為每個產品創建相應的推廣商追蹤 URL，並通過 SFTP 向推廣商提供產品資訊。您可以為每個廣告主下載多種檔案類型；點擊 + 以了解更多關於每種檔案類型的資訊：

增量檔案

增量檔案允許您下載僅包含產品更新的小檔案，包括新、更改和刪除的產品記錄。這對於更新具有特別大商品目錄的廣告主的提要非常有用。更改的類型反映在一個名為修改的附加欄位中。在管道分隔檔案中，這是每個產品記錄的最後一個欄位。在 XML 檔案中，這由 <modification> 標籤表示。請參閱附錄 A中的修改欄位以獲取支持的值。

檔案包含在廣告主的最後一次提要處理時所做的所有更改。廣告主可以每天多次處理提要，因此建議您經常檢查伺服器以獲取更新，參考檔案上的時間戳以確定自上次提取檔案以來是否有更改。此外，建議您定期提取完整檔案以確保擁有完整的商品目錄。

增量檔案名稱與用於下載完整商品目錄檔案的名稱相同，只是附加了單詞 delta。

範例：

• .txt 檔案： 2385_112_mp_delta.txt.gz
• .xml 檔案： 2385_112_mp_delta.xml.gz

增量檔案的標頭與完整檔案的標頭相同，包括商家編號、廣告主名稱和時間戳，格式如商品目錄檔案部分中所示。

類別檔案

按類別的商品目錄是一項功能，允許您下載特定廣告主產品類別的檔案，而不是下載完整的產品檔案。這意味著如果您只需要電子產品類別中的產品，您可以僅下載該類別的提要。

對於每個已批准您訪問其商品目錄提要的廣告主，您將看到一個資料夾。資料夾名稱將是廣告主的商家編號。資料夾將包含兩種類型的文件：商品類別列表文件和特定類別的商品目錄文件；點擊 + 以獲取每個文件的更多信息：

全球和附加文件

Rakuten Advertising允許廣告主每個帳戶提交多個文件。如果廣告主選擇提供多於一個的商品目錄文件，您將在SFTP帳戶的根目錄中找到這些文件，分別嵌套在“GLOBAL”資料夾或“ADDITIONAL”資料夾下。“Global”文件包含與主提要文件不同語言和/或貨幣的產品。“Additional”文件與主提要文件具有相同的語言和貨幣。點擊 + 以獲取有關下載全球或附加文件的信息：

root

GLOBAL (folder)

FR-FR_EUR (folder – language-locale_currency)

12345 (folder – the number here is the Advertiser ID, or MID)

12345_678_mp_FR-FR_EUR.txt.gz

12345_678_mp_delta_FR-FR_EUR.txt.gz

FR-CA_CAD (folder – language-locale_currency)

12345 (folder)

12345_678_mp_FR-CA_CAD.txt.gz

12345_678_mp_delta_FR-CA_CAD.txt.gz

root

ADDITIONAL (folder)

12345 (folder – the number here is the Advertiser ID, or MID)

2017Summer (folder – name of the Additional file, as specified by the Advertiser)

12345_678_mp_2017Summer.txt.gz

12345_678_mp_delta_2017Summer.txt.gz

Back2School (folder – name of the Additional file, as specified by the Advertiser)

12345_678_mp_Back2School.txt.gz

12345_678_mp_delta_Back2school.txt.gz

下載商品目錄文件

您可以使用任何SFTP客戶端軟件從您的帳戶下載商品目錄文件。請參閱入門指南以請求啟用。

範例： get 2385_112_mp.txt.gz

產品文件在檢索時動態生成。這確保所有推廣商在檢索廣告主的商品目錄文件時獲得最新的產品信息。產品信息的及時性取決於廣告主更新其商品目錄數據庫信息的頻率。

入門指南

所有商品目錄推廣商必須先註冊成為樂天聯盟的會員。如果您的公司尚未註冊，請前往註冊，網址為https://rakutenadvertising.com/，然後點擊成為推廣商。註冊後，您將收到一封電子郵件，內含註冊批准和您的新推廣商帳戶資訊，以及您的網站識別碼。

接下來，您需要按照以下步驟獲取FTP訪問權限（步驟1）和獲得廣告主批准以使用他們的商品目錄供應（步驟2）。

步驟1：技術設置過程

SFTP設置

商品目錄供應可通過SFTP獲得。樂天聯盟的SFTP伺服器主機名為aftp.linksynergy.com。

要開始，請使用您的樂天聯盟用戶名和網站識別碼（SID）聯繫客戶支持。當您提交商品目錄申請時，將執行以下步驟：

• 我們在我們的伺服器上建立一個獨特的SFTP帳戶，您可以從中下載文件。
• 為SFTP帳戶分配用戶名和密碼。

在一個工作日內，客戶支持代表將回覆您的請求，提供您的用戶名、密碼和SFTP帳戶的URL。

SFTP訪問

您可以使用任何SFTP客戶端訪問您的SFTP帳戶。您也可以自動化下載文件的過程或手動進行。在開始下載文件之前，應將傳輸模式設置為二進制，因為文件是以壓縮格式存儲的。使用ASCII模式會損壞文件中的數據，使其無法使用。如果您使用腳本自動化下載文件的過程，請確保一次不打開超過五個連接到SFTP伺服器。

請注意：

• 當使用普通FTP連接到aftp.linksynergy.com時，始終使用被動連接。
• 在使用普通FTP下載文件之前，始終將模式設置為二進制。
• 每個推廣商SFTP帳戶最多允許五個並發連接。
• 顯示的文件大小為估計值。實際文件大小會有所不同。因此，建議不要使用文件大小作為檢查成功下載的依據。下載應被視為成功，如果文件正確提取並以指示文件中產品數量的尾記錄結尾。
• 如果您使用腳本檢索文件，建議使用Wget而不是cURL。如果使用cURL，必須使用--ignore-content-length選項。
• 雖然目前支持普通FTP，但強烈建議使用SFTP。對普通FTP的支持將在未來被淘汰。

SFTP帳戶內容

在您的SFTP帳戶的根目錄中，您將看到每個已批准您訪問其商品目錄供應的廣告主的文件和文件夾。如果您的廣告主合作夥伴有多個產品供應，您可能還會看到名為“GLOBAL”和“ADDITIONAL”的文件夾。

根目錄中的文件是您的商品目錄文件，編號文件夾包含為您提供單個產品類別的產品數據的文件。文件夾名稱對應於廣告主的商家編號（MID），文件有兩種格式：管道分隔文本和XML。

您可以在推廣商控制面板中按照以下步驟選擇您偏好的格式：

1. 在導航標頭中轉到鏈接，然後點擊產品供應。
2. 向下滾動到偏好供應格式以進行選擇：

   點擊圖片以查看更大版本。

如果您未選擇格式，您的SFTP帳戶將包含兩個文件和一個文件夾，供每個已批准您訪問其商品目錄供應的廣告主使用。

步驟2：廣告主商品目錄批准過程

完成商品目錄的技術設置後，您需要向已合作的參與廣告主申請訪問權限。

要在推廣商控制面板中查看提供商品目錄的廣告主合作夥伴列表，請轉到導航標頭中的鏈接，然後點擊產品供應。向下滾動以查看列表並按名稱搜索廣告主。從那裡，您可以申請訪問、移除訪問並查看您的申請狀態：

點擊圖片以查看更大版本。

當您申請新的參與廣告主的計劃時，可以自動申請商品目錄批准，使用我們的自動註冊選項。您可以在產品供應頁面的供應設置部分開啟或關閉自動註冊：

點擊圖片以查看更大版本。

常見問題

我的腳本僅在檔案日期變更時下載檔案。這適用於商品目錄嗎？

是的，您應該可以使用目錄中檔案的日期戳記，該日期戳記顯示了以 UTC 創建的時間，以查看已更改的內容並僅提取最新的項目。

為什麼我的帳戶中有多個廣告主檔案？

您可以選擇使用管道分隔的文字檔案和 XML 格式的檔案。您可以在推廣商控制面板中選擇您偏好的格式，如上文 SFTP 帳戶內容 中所述。如果您未選擇格式，您的 SFTP 帳戶將包含每種檔案類型的 .txt 和 .xml 版本。

我在 SFTP 帳戶中看到的資料夾是什麼？

您的 SFTP 帳戶中的資料夾是為每個您有資格獲取商品目錄檔案的廣告主而設置的。這些資料夾包含廣告主的特定類別商品目錄檔案。

我是否需要每個廣告主的批准才能使用他們的商品目錄產品資料摘要？

是的，商品目錄有兩個層級的批准。首先，您會獲得技術批准，然後您需要廣告主的批准。當您申請新的廣告主計劃時，或從現有的廣告主合作夥伴中單獨申請時，您需要請求商品目錄的批准，如上文 步驟 2 中所述。

如果廣告主的商品目錄資料過時，我應該怎麼辦？

最好直接告知廣告主。您可以在推廣商控制面板中找到廣告主的聯絡資訊：在導航標題中轉到廣告主，點擊我的廣告主，然後點擊相關的廣告主以訪問他們的詳細頁面。

如果您不確定您所關心的問題是否是過時的資料問題，請聯絡客戶支援。

附錄 A：商品目錄檔案欄位定義

請參閱附錄 A以獲取欄位定義。

附錄 B：屬性檔案類別定義

請參閱附錄 B以獲取屬性檔案類別定義。

附錄 C：XML 格式標準

請參閱附錄 C以獲取 XML 格式標準。

附錄 D：範例記錄

請參閱附錄 D以獲取管道分隔和 XML 檔案的範例記錄。