Google 會透過 Geo
物件提供地理位置資訊,OpenRTB 和 Google 通訊協定皆通用。本文件將進一步說明 Google 如何在出價要求中填入地理位置,並提供最佳做法建議。
Geo 物件的填入方式
Google 只會從 IP 地理位置取得裝置位置資訊,絕對不會從 GPS 或其他來源取得。雖然 OpenRTB 規格支援使用者 (例如住家地址) 和裝置 (裝置在刊登廣告時) 的不同地理位置,Google 僅支援後者。因此,Google 的 OpenRTB 實作只會填入 BidRequest.device.geo
,而已淘汰的 Google RTB 通訊協定僅支援參照裝置位置的 BidRequest.geo
欄位。
隱私保護機制
為了保護使用者隱私,Google 僅提供有大量使用者分享的概略地理位置,並在必要時將偵測到的位置推估。
位置表示法
Geo
物件支援兩種不同的位置表示法:民治位置和地理座標。
民間地點以下列欄位表示:
country
region
metro
city
zip
地理座標是以下列欄位表示:
lat
lon
accuracy
在 Google 和 OpenRTB 通訊協定中,這兩種表示法都具有相同的位置和精確度。舉例來說,如果出價要求在 Geo
中填入城市層級精確度,lat
和 lon
欄位就會包含所識別城市中心點的經緯度,而 accuracy
則會是與該城市相同區域的圓形半徑。Google 也會將 lat
和 lon
欄位的精確度限制為 0.01 度。
指定地理區域的最佳做法
如果出價工具需要自訂地理位置資料,建議您使用概略的 lat
、lon
和 accuracy
欄位執行空間地理位置查詢。我們不建議使用 ip
欄位進行地理位置資訊,因為 Google 只會分享截斷的 IP 位址;如果使用截斷的 IP 位址來進行地理位置,可能會導致產生一些不準確的結果。
地理區域表格 (已淘汰)
已淘汰的 Google RTB 通訊協定的 BidRequest.geo_criteria_id
欄位會以數字 ID 表示地理位置,對應至 geo-table.csv 中的地理位置,可在 Protos 與參考資料資料頁面的參考表部分中下載。這個欄位和對應的資料表現已淘汰。您可以使用 Geo
欄位取得類似的地理位置資訊。
舉例來說,如果出價要求的 Geo
已填入城市層級精確度,geo_criteria_id
就會包含對應城市的程式碼。
您可以使用這個 ID,在地理位置表格中找出記錄。
欄
- 條件 ID
- 指派的不重複 ID 專屬 ID。在 API 中,這些條件的類型為
Location
。 - 名稱
- 地理目標最常見的英文名稱。
- 標準化名稱
- 建構完成的完整英文名稱,包含目標本身的名稱,以及父項和國家/地區的名稱。這個欄位只能用來區分相似目標名稱,不適用於 LocationCriterionService (改用位置名稱或條件 ID)。
- 父項 ID
- 父項的條件 ID。舊版支援包含在這個欄位中,且 ID 在資料集之間可能不一致。正規名稱是建議的階層結構方法。
- 區碼
- 州或省目標的 ISO 3166-2 區碼 (如有)。
- 國家/地區代碼
- 與目標相關的 ISO-3166-1 alpha-2 國家/地區代碼。
- 目標類型
允許的值:
- 機場
- 區
- 自治區
- 自治市鎮
- 坎吞
- 城市
- 城市區域
- 國會選區
- 國家/地區
- 縣
- 部門
- 區
- 指定行銷區域
- 郡
- Metro
- 市
- 國家公園
- 鄰
- 民族自治區
- 其他
- 郵遞區號
- 都/道/府/縣
- 州/省
- 區域
- 狀態
- 地域
- 電視收視地區
- 中央直轄區
- 大學
不可指定的地區
基於中華人民共和國的廣告法規和法律,要在中國宣傳特定類別的產品,您可能需要提供證書和執照。在帳戶還未啟用前,您不需要提交憑證。帳戶啟用後,您會收到有關如何向 Google 提交憑證的相關資訊。