動態饋給已準備就緒

動態饋給會將商品目錄資料提供給 Actions Center。這項每日安全檔案傳輸通訊協定 (SFTP) 上傳功能，會更新所有商家、服務和供應情形時段資料。動態饋給會指定你支援的商家、供應情形，以及確認 Google 能正確顯示商品目錄所需的任何特殊功能。動態饋給會上傳至安全檔案傳輸通訊協定 Dropbox，這是您在設定中提供 SSH 金鑰時設定的。

請務必先完成下列「動態饋給準備就緒」工作，再移至預訂伺服器：

成功上傳動態饋給後，工作就會標示為完成並變成綠色。請參閱連結的說明文件，完成各個里程碑工作。

如要確保訂位端對端整合功能正常運作，你必須每天自動上傳商家動態饋給、服務動態饋給和供應情形動態饋給。自動動態饋給基礎架構必須提供完整目錄。

動態饋給類型

餐飲預訂端對端整合需要下列動態饋給和上傳頻率：

動態消息 說明 頻率 範例
商家 說明商家。 每 24 小時一次 商家動態饋給範例
服務 說明商家提供的服務。 每 24 小時一次 服務動態饋給範例
適用情形 說明商家服務的可預訂時段。必須提供至少 30 天的保險。如要將保障期限延長至 90 天，請填寫「動作中心」的聯絡表單，與 Google 支援團隊聯絡。 每 24 小時一次 供應情形動態饋給範例

動態饋給格式會以 Protocol Buffers 第 3 版的語法說明，但你可以按照對應的 JSON 格式上傳動態饋給。請參閱 JSON 格式的動態饋給範例。建議你上傳 JSON 格式的動態饋給。

命名慣例和中繼資料

檔案名稱

如果使用分片，上傳的動態饋給必須有專屬名稱，並指定動態饋給類型和數量。動態饋給產生時間戳記符合動態饋給檔案命名不重複的規定。

結構：{feed_name}_{timestamp_epoch}_{shard_nunber}_{total_shard}.json

範例：availability_feed_1574117613_001_of_002.json.gz

定義 ID

為商家或其他需要 ID 的屬性定義 ID 時，強烈建議使用 UID 或 UUID。只要 ID 在平台中保持不重複，您就可以提供自己的英數解決方案。

中繼資料

建立動態饋給時，generation_timestamp 必須反映從資料庫提取資料的時間。在不同動態饋給中重複使用這個值可能會導致處理錯誤。

隨機或不重複的 Nonce 值不得重複使用，且在不同動態饋給類型中必須是唯一值。特定分片動態饋給中的所有檔案，這個值都必須相符。

動態饋給檔案大小

資料分割動態饋給檔案

視商品目錄而定，可能需要將動態饋給分割或拆分為多個檔案。在下列情況下，你可能需要將動態饋給分片：

  • 壓縮後的 gzip 動態饋給檔案超過 200 MB。
    • 示例：產生的供應情形動態饋給為 1 GB。這必須分片為五個或更多獨立分片。
  • 合作夥伴廣告空間分散在各個系統或區域，因此難以調解廣告空間。
    • 範例：合作夥伴的美國和歐盟廣告空間位於不同系統。 動態消息可能會以兩個分片產生。一個用於美國，另一個用於歐盟，兩者使用相同的隨機值和 generation_timestamp。

詳情請參閱「分片動態消息檔案教學課程和最佳做法」。

動態饋給可以由多個「資料分片」檔案組成。請按照下列準則決定動態饋給的大小：

  • 建議的動態饋給資料分割方式：
    • 商家動態饋給：一個分片。
    • 服務動態饋給：1 個分片。
    • 預訂情形動態饋給：少於 20 個資料分片。如有業務需求，需要超過指定金額的退款，請與支援團隊聯絡，瞭解進一步指示。
  • 動態饋給檔案和資料分片的大小：
    • 壓縮後，資料分片檔案大小不超過 200 MB；請視需要使用多個分片。
    • 已透過單一資料分片傳送的個別記錄，在日後的動態饋給中不需要再透過同一個資料分片傳送。
    • 為提升效能，請將資料平均分配給資料分片，讓所有資料分片檔案的大小都相似。
    • 可視需要使用 gzip 壓縮每個動態饋給分片的純文字 JSON 動態饋給。

壓縮動態饋給檔案

上傳前，您可以使用 gzip 壓縮任何 JSON 或 PB3 檔案。這可大幅減少每日動態饋給的位元組大小。

每個分片檔案都必須經過 gzip 壓縮，並個別上傳，例如 gzip*.json。 壓縮後的動態饋給分片必須以 .json.gz 或 .pb3.gz 結尾。

將動態饋給上傳至 SFTP dropbox

產生商家、服務和供應情形動態饋給後，即可透過 SFTP Dropbox 將動態饋給上傳至沙箱或正式環境。在「設定」中提供 SSH 金鑰時，系統會設定 SFTP Dropbox。Google 安全檔案傳輸通訊協定伺服器位在通訊埠 19321 上，位址為 sftp://partnerupload.google.com。

動態饋給檔案上傳至安全檔案傳輸通訊協定 Dropbox 後，Google 會立即審查及驗證。如果是分割成多個檔案的動態饋給，Google 會在您上傳最後一個檔案後進行處理。若動態饋給中有錯誤，系統會傳送內含動態饋給錯誤代碼的電子郵件通知您。 錯誤會導致系統無法擷取已定義的商家、服務或供應情形。動態饋給通過驗證後，最慢會在 24 小時內顯示在前端。