動態饋給 (舊版)

首先您必須建立動態饋給，然後交由 Google 評估。

建立動態饋給

1. 產生動態饋給：你需要透過動態饋給將大部分的商品目錄資料傳送給 Google。如要開始使用，請建立商家動態饋給 (以及適用的服務動態饋給)：

   • 商家動態饋給：「商家」動態饋給用來說明商家和商家層級動作連結。
   • 服務動態饋給 (選用 / 不建議)： 不建議為新的初始整合項目導入服務動態饋給。如果您想維護現有的整合，請按照這份舊版說明文件操作。

   必要和建議使用欄位

   動態饋給	欄位名稱	說明	是否必要？
   商家	merchant_id	商家的專屬 ID	是
   商家	名稱	商家名稱	是
   商家	geo	商家的地址和地理座標	是
   商家	電話	商家電話	是
   商家	category	商家的地點類型	建議使用
   商家	action_link	商家專屬深層連結的相關資訊	是
   商家	brand_id	用來識別要使用的消費性品牌的字串	選用

   注意：請忽略參考資料部分列出的所有其他欄位。
   重點：你只需要上傳商家動態饋給。

   首先請查看動態饋給範例

   • 個人預約動態饋給
   • 線上/虛擬預約動態饋給

   如要進一步瞭解如何在舊版入門整合動態饋給中指定動作連結，請參閱這篇文章。

   請在每個動態饋給中納入動態饋給中繼資料，指示 Google 該如何解讀動態饋給。

   下面是動態饋給中繼資料片段：

   "metadata": {
    "generation_timestamp": "1467993600",
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "total_shards": 1
   }

   注意：所有動態饋給的 processing_instruction 都必須設為 PROCESS_AS_COMPLETE。PROCESS_AS_INCREMENTAL 已淘汰，無法使用。

2. 匯出動態饋給：您需要使用 Protocol Buffers 第 3 版的語法來說明動態饋給的格式，不過您可以參考上述範例，查看 JSON 格式。建議你以 JSON 格式上傳動態饋給。

   如果您真的想繼續使用 pb3 格式，請參閱 Protocol Buffer 基本概念：Java，瞭解如何使用 Protocol Buffers 產生 pb3 檔案的一般資訊。

3. 將動態饋給上傳至安全檔案傳輸通訊協定伺服器：上傳動態饋給時，請使用 Google 提供給您的安全檔案傳輸通訊協定伺服器資訊，以及您在設定中建立的私密金鑰。Google 安全檔案傳輸通訊協定伺服器位在通訊埠 19321 上，位址為 sftp://partnerupload.google.com。

   您上傳檔案的名稱不能重複 (例如在名稱中加入時間戳記)；使用不重複名稱可加快疑難排解的速度，也方便您查詢動態饋給的狀態。

   如要判斷動態饋給的大小和放送頻率，請按照下列指南操作：

   • 動態饋給檔案和資料分片的大小：
     • 動態饋給檔案大小不超過 200 MB (壓縮後大小)；使用 gzip 壓縮
     • 如果檔案大小 (經壓縮後) 可能超過 200 MB，請按照「 動態饋給檔案分割 」教學課程，將檔案分割成多個資料分片。不過，舊版 Starter 整合功能本身不太可能達到 200 MB 的限制。
   • 進行完整更新的頻率：
     • 每天提供完整的商家動態饋給一次。
     • (如果已實作) 每天提供完整的服務動態饋給一次。
   注意：動態饋給檔案上傳至 SFTP 伺服器後，Google 會立即處理；如果是分割成多個檔案的動態饋給，Google 會在您上傳最後一個檔案後進行處理。如果動態饋給中有錯誤，系統會傳送內含動態饋給錯誤代碼的電子郵件通知您。

Google 對動態饋給進行評估

您上傳動態饋給後，Google 會進行處理並評估其品質和完整性。評估要點如下：

• 動態饋給符合規格。
• 動態饋給包含所有的必要欄位。
• 每個商家至少都有一個 action_link，或是至少有一個服務定義了 action_link。
• 您大部分的商家資料都與 Google 地圖上的地點比對相符。

注意：為確保整合作業順利進行，請先評估上述各項因素 (最後一點除外)，再提交動態饋給。