Google dostarcza dane geolokalizacyjne za pomocą obiektu Geo
wspólnego z protokołami OpenRTB i Google. W tym dokumencie znajdziesz bardziej szczegółowe informacje o tym, jak Google wypełnia dane geolokalizacyjne w pytaniach o stawkę i jakie są sprawdzone metody jej stosowania.
Sposób wypełniania obiektu Geo
Google pobiera lokalizację urządzeń wyłącznie na podstawie geolokalizacji na podstawie adresu IP, a nie z GPS-a ani innych źródeł. Specyfikacja OpenRTB obsługuje oddzielne geolokalizacje dla użytkownika (np. adresu domowego) i urządzenia (na którym urządzenie jest umieszczane podczas wyświetlania reklamy), jednak Google obsługuje tylko tę drugą lokalizację. Dlatego protokół Google zawiera tylko 1 obiekt Geo
w metodzie BidRequest.geo
, a w przypadku OpenRTB Google wypełnia tylko pole Device.geo
.
W przypadku obu protokołów pola obiektów Geo
są wypełniane identycznie. Te pola występują tylko w wariancie OpenRTB obiektu Geo
i nigdy nie są wypełniane przez Google w żadnym z protokołów: regionfips104
, lastfix
, type
i ipservice
. Większość nieobsługiwanych pól powyżej odnosi się do alternatywnych źródeł lokalizacji.
Ochrona prywatności
Aby chronić prywatność użytkowników, Google udostępnia tylko przybliżoną geolokalizację, która jest udostępniana wystarczająco dużej liczbie użytkowników, w razie potrzeby uogólnia wykrytą lokalizację.
Reprezentacja lokalizacji
Obiekt Geo
obsługuje 2 oddzielne reprezentacje lokalizacji – lokalizację cywilną i współrzędne geograficzne.
Lokalizacje cywilne są reprezentowane przez te pola:
country
region
metro
city
zip
Współrzędne geograficzne są reprezentowane przez te pola:
lat
lon
accuracy
W protokołach Google i OpenRTB obie reprezentacje obejmują tę samą lokalizację i dokładność. Jeśli np. pytanie o stawkę wypełni pole Geo
z dokładnością na poziomie miasta, pola lat
i lon
będą zawierać szerokość i długość geograficzną wskazanego miasta, a accuracy
będzie promieniem okręgu o tym samym obszarze co to miasto. Google ogranicza też dokładność pól lat
i lon
do 0,01 stopnia.
Sprawdzone metody kierowania geograficznego
W przypadku licytujących, którzy potrzebują niestandardowych danych geolokalizacji, do wyszukiwania geolokalizacji przestrzennej zalecamy użycie pól lat
, lon
i accuracy
.
Nie zalecamy używania pola ip
do geolokalizacji, ponieważ Google udostępnia adres IP tylko w skróconej formie. Używanie obciętych adresów IP do geolokalizacji może skutkować niedokładnymi wynikami.
Tabela geograficzna
Pole geo_criteria_id
reprezentuje geolokalizację jako identyfikator numeryczny, który jest zmapowany na geolokalizację w pliku geo-table.csv. Można go pobrać w
sekcji Tabele referencyjne na stronie Protos i dane referencyjne. To pole i odpowiadająca mu tabela zostały wycofane. Możesz użyć opisanego powyżej pola Geo
, aby uzyskać podobne dane geolokalizacji. Jeśli np. pytanie o stawkę zawiera pole Geo
z dokładnością na poziomie miasta, pole geo_criteria_id
będzie zawierać kod odpowiedniego miasta. Możesz użyć tego identyfikatora do znalezienia rekordu w tabeli geograficznej.
Kolumny
- Identyfikator kryteriów
- Unikalny i trwały przypisany identyfikator. W interfejsie API te kryteria mają typ
Location
. - Nazwa
- Najlepsza dostępna nazwa geograficzna lokalizacji docelowej.
- Nazwa kanoniczna
- Stworzona pełna i jednoznaczna nazwa w języku angielskim składająca się z nazwy własnej oraz nazwy podmiotu nadrzędnego i kraju. To pole służy tylko do rozróżniania podobnych nazw celów – nie jest obsługiwane w usłudze LocationCriterionService (zamiast tego użyj nazw lokalizacji lub identyfikatorów kryteriów).
- Identyfikator nadrzędny
- Identyfikator kryteriów elementu nadrzędnego. To pole znajduje się w ramach obsługi starszej wersji, a identyfikatory mogą nie być spójne we wszystkich zbiorach danych. Nazwy kanoniczne to preferowana metoda tworzenia hierarchii.
- Kod regionu
- Kod regionu w formacie ISO 3166-2 odpowiadający stanowi lub prowincji, jeśli taki istnieje.
- Kod kraju
- Kod kraju w formacie ISO-3166-1 alpha-2 powiązany z lokalizacją docelową.
- Typ lokalizacji docelowej
Dozwolone wartości:
- Port lotniczy
- Okręg
- Wspólnota autonomiczna
- Dystrykt
- Kanton
- Miasto
- Strefa miejska
- Dystrykt kongresowy
- Kraj
- Hrabstwo
- Departament
- Dystrykt
- Region DMA
- Gubernatorstwo
- Metro
- Gmina
- Park narodowy
- Dzielnica
- Okręg
- Inne
- Kod pocztowy
- Prefektura
- Prowincja
- Region
- Stan
- Region
- Region TV
- Terytorium związkowe
- Uniwersytet
Lokalizacje, na które nie można kierować reklam
Ze względu na przepisy i prawo reklamowe Chińskiej Republiki Ludowej, aby reklamować niektóre kategorie produktów w Chinach możesz potrzebować zaświadczeń i licencji. Nie musisz ich przesyłać, dopóki konto nie zostanie aktywowane. Po aktywowaniu konta otrzymasz informacje o tym, jak przesłać zaświadczenie do Google.