Google 會透過 Geo
物件提供地理位置資訊,這個物件與 OpenRTB 和 Google 通訊協定共用。本文將進一步說明 Google 如何在出價要求中填入地理位置,並提供使用建議的最佳做法。
地理區域物件的填入方式
Google 只會從 IP 地理位置取得裝置位置資訊,不會從 GPS 或其他來源取得位置資訊。雖然 OpenRTB 規格支援為使用者 (例如住家地址) 和裝置 (裝置刊登廣告時所在的裝置) 不同的地理位置,但 Google 僅支援後者。因此,Google 通訊協定在 BidRequest.geo
中只會包含一個 Geo
物件;如果是 OpenRTB,Google 只會填入 Device.geo
欄位。
兩種通訊協定的 Geo
物件欄位均填入相同值。下列欄位僅存在於 Geo
物件的 OpenRTB 變體中,Google 絕不會在以下任一通訊協定中填入這些欄位:regionfips104
、lastfix
、type
和 ipservice
。上方不支援的欄位大多與替代位置來源有關。
隱私保護機制
為保護使用者隱私,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 位址可能會導致結果不準確。
地理區域表格
geo_criteria_id
欄位是以數字 ID 表示地理位置,這個 ID 對應到 geo-table.csv 中的地理位置,可在「Protos & Reference Data」頁面的
參考表格部分下載。這個欄位和對應的資料表現已淘汰。您可以使用上述的 Geo
欄位取得類似的地理位置資訊。舉例來說,如果出價要求的 Geo
已填入城市層級的精確度,則 geo_criteria_id
會包含對應城市的程式碼。您可以使用這個 ID 在地理資料表中找出記錄。
欄
- 條件 ID
- 指派不重複的永久 ID。在 API 中,這些條件的類型屬於
Location
。 - 名稱
- 地理目標最常見的英文名稱。
- 標準化名稱
- 建構完成的完整英文名稱,包含目標本身的名稱,以及父項和國家/地區的名稱。這個欄位只能用於區分類似的目標名稱,LocationCriterionService 不支援這項功能 (請改用位置名稱或條件 ID)。
- 父項 ID
- 父項的條件 ID。舊版支援此欄位,且 ID 在各資料集間可能不一致。使用正規名稱是建構階層的建議方法。
- 區碼
- 州或省目標的 ISO 3166-2 區碼 (如果有的話)。
- 國家/地區代碼
- 與目標相關的 ISO-3166-1 alpha-2 國家/地區代碼。
- 目標類型
允許的值:
- 機場
- 區
- 自治區
- 自治市鎮
- 坎吞
- 城市
- 城市區域
- 國會選區
- 國家/地區
- 縣市
- 部門
- 區
- 指定行銷區域
- 郡
- Metro
- 市
- 國家公園
- 鄰
- 民族自治區
- 其他
- 郵遞區號
- 都/道/府/縣
- 州/省
- 區域
- 狀態
- 地域
- 電視收視地區
- 中央直轄區
- 大學
不可指定的地區
根據中華人民共和國的廣告規範和法律,要在中國刊登廣告宣傳某些類別的產品,您可能必須提供證明和執照。在帳戶啟用後,您不需要提交憑證。帳戶啟用後,您會收到有關如何向 Google 提交憑證的資訊。