Google memberikan informasi geolokasi melalui objek Geo
, yang umum untuk protokol OpenRTB dan Google. Dokumen ini menjelaskan detail secara lebih terperinci tentang cara Google mengisi geolokasi dalam permintaan bid dan menyarankan praktik terbaik untuk penggunaannya.
Cara objek Geo diisi
Google hanya mendapatkan sumber lokasi perangkat dari geolokasi IP, bukan dari GPS
atau sumber lainnya. Meskipun spesifikasi OpenRTB mendukung geolokasi
terpisah untuk pengguna (misalnya, alamat rumah) dan perangkat (tempat perangkat
saat iklan sedang ditempatkan), Google hanya mendukung lokasi yang kedua. Dengan demikian, protokol Google hanya berisi satu objek Geo
, di BidRequest.geo
; dan untuk OpenRTB, Google hanya akan mengisi kolom Device.geo
.
Kolom objek Geo
diisi secara identik untuk kedua protokol. Kolom berikut hanya ada dalam varian OpenRTB dari objek Geo
, dan tidak pernah diisi oleh Google di salah satu protokol: regionfips104
, lastfix
, type
, dan ipservice
. Sebagian besar kolom yang tidak didukung di atas terkait dengan sumber lokasi
alternatif.
Perlindungan privasi
Untuk melindungi privasi pengguna, Google hanya menyediakan geolokasi kasar yang digunakan oleh sejumlah besar pengguna, yang menggeneralisasi lokasi yang terdeteksi jika diperlukan.
Representasi lokasi
Objek Geo
mendukung dua representasi lokasi terpisah, yaitu lokasi sipil dan koordinat geografis.
Lokasi sipil diwakili oleh kolom-kolom berikut:
country
region
metro
city
zip
Koordinat geografis diwakili oleh bidang berikut:
lat
lon
accuracy
Dalam protokol Google dan OpenRTB, kedua representasi berisi lokasi dan akurasi yang sama. Misalnya, jika permintaan bid mengisi Geo
dengan presisi tingkat kota, kolom lat
dan lon
akan berisi lintang dan bujur titik tengah kota yang diidentifikasi, dan accuracy
akan menjadi radius lingkaran dengan area yang sama dengan kota tersebut. Google juga membatasi
presisi kolom lat
dan lon
hingga 0,01 derajat.
Praktik terbaik untuk penargetan geolokasi
Untuk bidder yang memerlukan data geolokasi kustom, sebaiknya gunakan kolom perkiraan
lat
, lon
, dan accuracy
untuk melakukan pencarian geolokasi spasial.
Kami tidak merekomendasikan penggunaan kolom ip
untuk geolokasi, karena Google hanya membagikan alamat IP dalam bentuk yang terpotong. Penggunaan alamat IP yang terpotong untuk geolokasi dapat memberikan hasil yang agak tidak akurat.
Tabel Geografis
Kolom geo_criteria_id
mewakili geolokasi sebagai ID numerik,
yang dipetakan ke geolokasi di geo-table.csv yang dapat didownload di
bagian Tabel referensi di halaman Protos & Reference Data. Kolom ini dan tabel terkait kini tidak digunakan lagi. Anda dapat menggunakan kolom Geo
yang dijelaskan di atas untuk mendapatkan informasi geolokasi serupa. Misalnya, jika permintaan bid
memiliki Geo
yang diisi dengan presisi tingkat kota, geo_criteria_id
akan
berisi kode untuk kota yang sesuai. Anda dapat menggunakan ID tersebut untuk
menemukan data di tabel geografis.
Kolom
- ID Kriteria
- ID yang ditetapkan unik dan persisten. Dalam API, kriteria ini adalah jenis
Location
. - Nama
- Nama target geografis terbaik dalam bahasa Inggris yang tersedia.
- Nama Kanonis
- Nama dalam bahasa Inggris yang telah disusun dan sepenuhnya memenuhi syarat yang berisi nama target itu sendiri, serta nama induk dan negaranya. Kolom ini dimaksudkan hanya untuk membedakan nama target yang serupa--kolom ini tidak didukung di LocationCriterionService (sebagai gantinya, gunakan nama lokasi atau ID kriteria).
- ID induk
- ID kriteria induk. Kolom ini disertakan untuk dukungan lama, dan ID-nya mungkin tidak konsisten di seluruh set data. Nama kanonis adalah metode yang lebih disukai dalam membangun hierarki.
- Kode Wilayah
- Kode wilayah ISO 3166-2 untuk target negara bagian atau provinsi, jika ada.
- Kode Negara
- Kode negara ISO-3166-1 alpha-2 yang terkait dengan target.
- Jenis Target
Nilai yang diizinkan:
- Bandara
- Arondisemen
- Komunitas Otonom
- Borough
- Canton
- Kota
- Wilayah Kota
- Distrik Kongres
- Negara
- County
- Departemen
- Distrik
- Wilayah DMA
- Provinsi
- Metro
- Kotamadya
- Taman Nasional
- Lingkungan
- Okrug
- Lainnya
- Kode Pos
- Prefektur
- Provinsi
- Region
- Negara Bagian
- Wilayah
- Wilayah TV
- Wilayah Persatuan
- Universitas
Lokasi yang tidak dapat ditargetkan
Karena peraturan dan hukum periklanan Republik Rakyat China, Anda mungkin diminta untuk memberikan sertifikat dan lisensi jika mengiklankan kategori produk tertentu di China. Anda tidak perlu mengirimkan sertifikat sampai akun Anda diaktifkan. Setelah akun aktif, Anda akan diberi informasi tentang cara mengirimkan sertifikat ke Google.