Google, hem OpenRTB hem de Google protokollerinde yaygın olarak kullanılan Geo
nesnesi aracılığıyla coğrafi konum bilgileri sağlar. Bu belgede, Google'ın teklif isteklerinde coğrafi konumu nasıl doldurduğuyla ilgili üst düzey ayrıntılar açıklanmakta ve bu özelliğin kullanımıyla ilgili en iyi uygulamalar önerilmektedir.
Coğrafi nesne nasıl doldurulur?
Google, cihaz konumlarını yalnızca IP coğrafi konumundan alır, GPS veya diğer kaynaklardan hiçbir zaman almaz. OpenRTB spesifikasyonu kullanıcı (örneğin, ev adresi) ve cihaz (reklam yerleştirildiğinde cihazın bulunduğu yer) için ayrı coğrafi konumları desteklerken Google yalnızca ikincisini destekler. Sonuç olarak, Google protokolü BidRequest.geo
içinde yalnızca bir Geo
nesnesi içerir ve OpenRTB için Google yalnızca Device.geo
alanını doldurur.
Geo
nesne alanı her iki protokol için aynı şekilde doldurulur. Şu alanlar yalnızca Geo
nesnesinin OpenRTB varyantında bulunur ve Google tarafından hiçbir zaman iki protokolde de doldurulmaz: regionfips104
, lastfix
, type
ve ipservice
. Yukarıdaki desteklenmeyen alanların çoğu, alternatif konum kaynaklarıyla ilgilidir.
Gizlilik korumaları
Kullanıcı gizliliğini korumak için Google, algılanan konum bilgisini gerektiği gibi genelleştirerek, yeterince fazla sayıda kullanıcı tarafından paylaşılan yaklaşık coğrafi konum bilgisini sağlar.
Konum temsilleri
Geo
nesnesi, iki ayrı konum gösterimini destekler: sivil konum ve coğrafi koordinatlar.
Resmi yerler aşağıdaki alanlarla temsil edilir:
country
region
metro
city
zip
Coğrafi koordinatlar aşağıdaki alanlarla gösterilir:
lat
lon
accuracy
Hem Google hem de OpenRTB protokollerinde her iki temsil de aynı konum ve doğruluğu içerir. Örneğin, bir teklif isteği Geo
alanını şehir düzeyindeki hassasiyetle doldurursa lat
ve lon
alanları, tanımlanan şehrin merkez noktasının enlem ve boylamını içerir. accuracy
ise bu şehirle aynı alana sahip bir dairenin yarıçapı olur. Google, lat
ve lon
alanlarının hassasiyetini de 0,01 dereceyle sınırlandırır.
Coğrafi konum hedefleme için en iyi uygulamalar
Özel coğrafi konum verilerine ihtiyaç duyan teklif verenlerin, mekansal coğrafi konum aramaları yapmak için yaklaşık lat
, lon
ve accuracy
alanlarını kullanmalarını öneririz.
Google, IP adresini yalnızca kısaltılmış biçimde paylaştığından, coğrafi konum için ip
alanının kullanılmasını önermeyiz; coğrafi konum için kısaltılmış IP adreslerinin kullanılması biraz yanlış sonuçlara yol açabilir.
Coğrafi Tablo
geo_criteria_id
alanı, coğrafi konumu sayısal tanımlayıcı olarak temsil eder. Bu tanımlayıcı, Protos ve Referans Veriler sayfasının
Referans tabloları bölümünden indirilebilir geo-table.csv dosyasında bir coğrafi konumla eşlenir. Bu alan ve ilgili tablo artık kullanımdan kaldırılmıştır. Benzer coğrafi konum bilgilerini almak için yukarıda açıklanan Geo
alanını kullanabilirsiniz. Örneğin, bir teklif isteği şehir düzeyinde hassasiyetle doldurulmuş Geo
içeriyorsa geo_criteria_id
, ilgili şehrin kodunu içerir. Coğrafi tabloda bir kaydı bulmak için bu kimliği kullanabilirsiniz.
Sütunlar
- Ölçüt kimliği
- Benzersiz ve kalıcı atanan kimlik. API'de bu ölçütler
Location
türündedir. - Ad
- Coğrafi hedefin mevcut en iyi İngilizce adı.
- Standart Ad
- Hedefin kendi adı, üst kuruluşu ve ülkesinin adından oluşan, tamamen nitelikli İngilizce ad. Bu alan yalnızca benzer hedef adlarını ayırt etmek içindir. LocationCriterionService'te desteklenmez (bunun yerine konum adlarını veya ölçüt kimliklerini kullanın).
- Üst Öğe Kimliği
- Bir üst öğenin ölçüt kimliğidir. Bu alan, eski destek alanı için eklenmiştir ve kimlikler, veri kümelerinde tutarlı olmayabilir. Kurallı adlar, hiyerarşi oluştururken tercih edilen yöntemdir.
- Bölge Kodu
- Eyalet veya il hedefinin (varsa) ISO 3166-2 bölge kodu.
- Ülke Kodu
- Hedefle ilişkilendirilen ISO-3166-1 alfa-2 ülke kodu.
- Hedef Türü
İzin verilen değerler:
- Havalimanı
- Semt
- Özerk Topluluk
- Kaza
- Kanton
- Şehir
- Şehir Bölgesi
- Seçim Bölgesi
- Ülke
- İlçe
- Bölüm
- Semt
- DMA bölgesi
- Vilayet
- Metro
- Belediye
- Ulusal Park
- Mahalle
- Bölge
- Diğer
- Posta kodu
- Valilik
- Bölge
- Bölge
- Eyalet
- Bölge
- TV Bölgesi
- Birlik Bölgesi
- Üniversite
Hedeflenemez yerler
Çin Halk Cumhuriyeti'ndeki reklamcılık düzenlemelerine ve yasalarına göre, Çin'de belirli kategorilerdeki ürünlerin reklamını yapıyorsanız sertifika ve lisans sağlamanız istenebilir. Hesabınız etkinleştirilene kadar sertifika göndermenize gerek yoktur. Hesabınız etkinleştirildikten sonra, sertifikaları Google'a nasıl göndereceğinizle ilgili bilgiler sağlanır.