啟動條件動態饋給 (舊版)

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

建立動態饋給

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

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

   必要和建議使用欄位

   動態饋給	欄位名稱	說明	是否必要？
   商家	merchant_id	商家的專屬 ID	是
   商家	名稱	商家名稱	是
   商家	geo	商家的地址和地理座標	是
   商家	電話	商家電話	是
   商家	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. 匯出動態饋給：您需要使用 Protocol Buffers 第 3 版的語法來說明動態饋給的格式，不過您可以參考上述範例，查看 JSON 格式。建議你以 JSON 格式上傳動態饋給。

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

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

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

   如要判斷動態饋給的大小和放送頻率，請按照下列準則：

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

Google 對動態饋給進行評估

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

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

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