建立動態饋給
你必須定期向 Google 提供動態饋給,資料才能直接顯示在 Google 上。 你需要提供下列動態饋給。
動態消息 | 說明 | 頻率 |
---|---|---|
商家 | 說明商家。 | 每 24 小時一次 |
服務 | 說明商家提供的服務 | 每 24 小時一次 |
請在每個動態饋給中納入中繼資料,告知 Google 該如何解讀動態饋給。
您需要使用 Protocol Buffers 第 3 版的語法來說明動態饋給的格式,但您可以上傳動態饋給的對應 JSON 格式。請參閱動態饋給範例,瞭解 JSON 格式。建議你以 JSON 格式上傳動態饋給。
動態饋給檔案大小、分割和壓縮
請觀看以下教學課程,瞭解壓縮和分割:如要判斷動態饋給的大小,請參考下列指南 (動態饋給可由多個「資料分片」檔案組成):
- 建議的動態饋給資料分割方式如下:
- 商家動態饋給:1 個資料分片
- 服務動態饋給:1 個資料分片
- 動態饋給檔案和資料分片的大小:
- 資料分片檔案大小不超過 200 MB (壓縮後大小);視需要使用多個資料分片。
- 已透過單一資料分片傳送的個別記錄,在日後的動態饋給中不需要再透過同一個資料分片傳送。
- 為提升效能,請將資料平均分配給資料分片,讓所有資料分片檔案的大小都相似。
- 可視需要使用 gzip 壓縮純文字 JSON 動態饋給,但請為每個動態饋給資料分片分別進行這項作業。
將動態饋給上傳至安全檔案傳輸通訊協定 Dropbox
接下來請將動態饋給上傳至沙箱環境。進行這項作業時,請參考合作夥伴入口網站「動態饋給」設定頁面中的使用者名稱。Google 安全檔案傳輸通訊協定伺服器位在通訊埠 19321
上,位址為 sftp://partnerupload.google.com
。
我們建議為每一個上傳檔案取個專屬名稱,比方說在每個檔案名稱後面加上時間戳記,這有助於解決問題及查詢動態饋給的狀態。
確認資料正確無誤
登入合作夥伴入口網站。切換至「Sandbox」(沙箱) 環境,然後在「Dashboards」(資訊主頁) 部分找出下列頁面。
- 動態饋給
- 顯示動態饋給摘要統計資料,並列出上傳動態饋給時發生的錯誤。
請到「動態饋給」頁面查看有沒有任何動態饋給錯誤,確認初次上傳到沙箱環境中的資料是否正確。然後到「Inventory Summary」(庫存清單摘要) 頁面看看是否有任何資料相關問題;常見問題包括上傳沒有任何服務的商家,或是沒有任何未來可預訂時段的服務。
沙箱前端會模擬即時的使用者介面體驗,然後呈現使用者可能看到的資料樣貌;如要存取該頁面,請確認頂端的環境切換器已設為「沙箱」,然後前往「Inventory 」>「Inventory」>「Inventory」>「 」,找出狀態為「Ready」或「Live (in Sandbox)」的商家,然後點選最右欄的連結 (如有),或點選該列並點選「RwG - E2E」連結。如果沒有狀態為「Ready」或「Live (in Sandbox)」的商家,請開啟已停用的商家,並確實修正右側列出的所有問題 (例如確認已上傳未來可預訂的時段)。
如果您無法存取沙箱前端,請確認您登入的帳戶具備前端存取權限,而且您只登入了該帳戶。若您使用其他帳戶登入,然後使用「Switch User」(切換使用者) 功能登入已獲核准的 Google 帳戶,仍然無法存取沙箱前端。
將動態饋給上傳到正式環境
當您能夠持續將完整且正確的動態饋給上傳到沙箱環境時,就可以著手將動態饋給上傳至正式環境;這時您的整合功能「不會」啟用。
請盡快上傳完整的商家動態饋給 (至少在推出前 1 週),以便開始將商家與 Google 商家資訊相符。請確認比對結果是否正確。
當所有正式版動態饋給資料上傳一致且已連結至正式版系統後,動態饋給即可送審。
Google 對動態饋給進行評估
上傳動態饋給後,Google 會進行處理並評估其品質和完整性。我們會考量的因素如下:
- 動態饋給符合動態饋給規格。
- 動態饋給包含所有的必要欄位。
- 動態饋給中的商家總數跟先前與 Google 討論過的數目相符。
- 為每個商家分別定義至少一項服務。
- 動態饋給中的服務總數跟先前與 Google 討論過的數量相符。
- 每項服務都包含
waitlist_rules
。 - 我們會查看您提供的商家中,有幾家能與 Google 地圖上的項目達成比對。