動態饋給 (舊版)

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

建立動態饋給

1. 產生動態饋給。你需要透過動態饋給將大部分的庫存清單資料傳送給 Google。如要開始使用，請建立 Merchant 動態饋給 (如適用，也請建立服務動態饋給)：

   • 商家動態饋給：商家動態饋給用來說明商家和商家層級動作連結。
   • 服務動態饋給 (選用 / 不建議)： 不建議為新的入門整合項目導入服務動態饋給。 如要維護現有的整合服務，請參閱這份舊版說明文件。

   必要和建議使用欄位

   動態饋給	欄位名稱	說明	是否必要？
   商家	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 格式，如要瞭解如何使用通訊協定緩衝區產生 pb3 檔案的一般資訊，請參閱「Protocol Buffer Basics: Java」。

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

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

   請按照下列準則決定動態饋給的大小和放送頻率：

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

Google 對動態饋給進行評估

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

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

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