新手動態饋給 (舊版)

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

建立動態饋給

1. 產生動態饋給：您需要透過動態饋給將大部分的商品目錄資料傳送給 Google。一開始請建立下列兩種動態饋給：

   • 商家動態饋給：「商家」動態饋給會說明商家和商家層級動作連結。
   • 服務動態饋給 (選填)：服務動態饋給說明商家提供給平台的服務和服務層級 action_link。

   必要和建議使用欄位

   動態消息	欄位名稱	說明	是否必要？
   商家	merchant_id	商家的專屬 ID	是
   商家	名稱	商家名稱	是
   商家	geo	商家的地址和地理座標	是
   商家	telephone	商家的電話	是
   商家	category	商家的地點類型	建議使用
   商家	action_link	商家專屬深層連結的相關資訊	如果已提供服務動態饋給，則為選用屬性；如果不是，則為必要欄位
   商家	brand_id	用來識別消費性品牌的字串	選用
   服務	service_id	商家所提供服務的專屬識別碼	是 (僅限有服務動態饋給的情況下)
   服務	merchant_id	連往提供這項服務商家的連結	是 (僅限有服務動態饋給的情況下)
   服務	localized_service_name	所提供服務的名稱	是 (僅限有服務動態饋給的情況下)
   服務	localized_description	向使用者顯示的服務說明	選用
   服務	action_link	提供與服務相關深層連結的相關資訊	是 (僅限有服務動態饋給的情況下)
   服務	類型	深層連結類型 (例如 SERVICE_TYPE_DINING_RESERVATION)	是 (僅限有服務動態饋給的情況下)

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

   首先請查看動態饋給範例

   • 餐飲預訂動態饋給
   • 訂餐外送動態饋給
   • 訂餐取貨動態饋給
   • 訂餐動態饋給和中繼資料
   • 零售訂購動態饋給
   • 包含中繼資料的零售訂購動態饋給
   • 現場預約動態饋給
   • 線上/虛擬預約動態饋給

   如果商家有多項服務，但使用單一動作連結來提供服務，您應在商家動態饋給中，為與商家相關聯的所有服務提供單一動作連結。

   如要進一步瞭解如何在舊版新手整合動態饋給中指定動作連結，請按這裡。

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

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

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

   注意：所有動態饋給都必須以 processing_instruction PROCESS_AS_COMPLETE 的形式上傳。PROCESS_AS_INCREMENTAL 已淘汰，無法使用。
   注意：舊版入門整合也可以與 Actions Center 端對端整合功能一併實作，或做為端對端整合的附加功能。為了支援這項功能，您也必須按照這份指南，導入供應情形動態饋給和端對端整合必要欄位。

2. 匯出動態饋給：動態饋給格式是以通訊協定緩衝區 3 語法說明，不過您還是可以參考上述範例來查看 JSON 格式。 建議以 JSON 格式上傳動態饋給。

   如果確實想使用 pb3 格式，如需如何使用通訊協定緩衝區產生 pb3 檔案的一般資訊，請參閱通訊協定緩衝區基本資訊：Java。

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

   上傳具有不重複名稱的檔案，例如加上時間戳記的名稱。使用不重複名稱有助於排解問題，也能讓您查詢動態饋給狀態。

   如要判斷動態饋給的大小和放送頻率，請遵守下列規範：

   • 動態饋給檔案和資料分割的大小：
     • 動態饋給檔案大小不得超過 200 MB (壓縮後)。使用 gzip 壓縮
     • 如果檔案壓縮後可能會超過 200 MB，請按照 分割動態饋給檔案 教學課程中的指示，將這些檔案分成多個資料分割。不過，單獨採用舊版入門整合不太可能達到 200 MB 的限制。
   • 完整更新的頻率：
     • 每天提供完整的商家動態饋給一次。
     • (如已導入) 每天提供完整的服務動態饋給一次。
   注意事項：動態饋給檔案上傳至 SFTP Dropbox 後，Google 就會立即處理這些檔案。如果動態饋給分割為多個檔案， 系統會在您上傳最後一個檔案後開始這項程序。如果動態饋給含有錯誤，您會收到內含動態饋給錯誤代碼的電子郵件。

Google 對動態饋給進行評估

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

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

注意：為確保整合作業順利進行，請在提交動態饋給前，先針對上述因素 (最後一個項目除外) 執行預先評估。