Google udostępnia informacje o lokalizacji za pomocą obiektu Geo. W tym dokumencie opisujemy szczegółowo, jak Google wypełnia informacje o lokalizacji geograficznej w żądaniach stawek, oraz podajemy sprawdzone metody ich stosowania.
Sposób wypełniania obiektu Geo
Google obsługuje tylko informacje o lokalizacji opisujące lokalizację urządzenia, na którym ma być wyświetlana reklama, które są dostępne w pliku BidRequest.device.geo. Te informacje o lokalizacji są uzyskiwane tylko z geostratyfikacji adresu IP, nigdy z GPS-a ani z innych źródeł.
Ochrona prywatności
Aby chronić prywatność użytkowników, Google udostępnia tylko przybliżoną lokalizację geograficzną, która jest wspólna dla odpowiednio dużej liczby użytkowników, a w razie potrzeby ogólnie opisuje wykryte położenie.
Reprezentacje lokalizacji
Obiekt Geo obsługuje 2 oddzielne reprezentacje lokalizacji: cywilną i współrzędne geograficzne.
Miejsca cywilne są reprezentowane przez te pola:
countryregionmetrocityzip
Współrzędne geograficzne są reprezentowane przez te pola:
latlonaccuracy
Obie reprezentacje mają tę samą lokalizację i tą samą dokładność. Jeśli na przykład żądanie oferty wypełnia pole BidRequest.device.geo z dokładnością do miasta, pola lat i lon będą zawierać współrzędne geograficzne (długość i szerokość) centrum wskazanego miasta, a pole accuracy będzie równe promieniowi okręgu o tej samej powierzchni co to miasto. Google ogranicza też dokładność pól lat i lon do 0,01 stopnia.
Sprawdzone metody kierowania na lokalizację
W przypadku licytujących, którzy potrzebują niestandardowych danych geolokalizacyjnych, zalecamy używanie przybliżonych pól lat, lon i accuracy do wykonywania wyszukiwań geolokalizacji przestrzennej.
Nie zalecamy używania pola BidRequest.device.ip do geolokalizacji, ponieważ Google udostępnia adres IP tylko w okrojonej formie. Korzystanie z okrojonych adresów IP do geolokalizacji może prowadzić do niezbyt dokładnych wyników.
Tabela danych geograficznych (wycofana)
Pole BidRequest.device.geo.ext.geo_criteria_id reprezentuje geolokalizację jako identyfikator numeryczny, który jest mapowany na geolokalizację w pliku geo-table.csv, dostępnym do pobrania w sekcji tabel referencyjnych na stronie Protokoły i dane referencyjne. To pole i odpowiadająca mu tabela zostały wycofane. Aby uzyskać podobne informacje o lokalizacji, możesz użyć BidRequest.device.geo.
Jeśli np. żądanie dotyczące stawki wypełnia parametr geo z dokładnością do miasta, parametr geo_criteria_id będzie zawierać kod odpowiadającego mu miasta. Możesz użyć tego identyfikatora, aby znaleźć rekord 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 lokalizacji docelowych. Nie jest ono obsługiwane w LocationCriterionService (zamiast tego użyj nazw lokalizacji lub identyfikatorów kryteriów).
 - Identyfikator nadrzędny
 - Identyfikator kryteriów elementu nadrzędnego. To pole jest uwzględnione tylko w przypadku obsługi starszych wersji, a identyfikatory mogą nie być spójne w zbiorach danych. Nazwy kanoniczne to preferowana metoda tworzenia hierarchii.
 - Kod regionu
 - Kod regionu w formacie ISO 3166-2 odpowiadający stanowi lub prowincji docelowej (jeśli 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
 - Terytorium
 - Region TV
 - Terytorium związkowe
 - Uniwersytet
 
Lokalizacje, na które nie można kierować reklam
W związku z przepisami i prawami dotyczącymi reklamy w Chinach, jeśli reklamujesz w tym kraju określone kategorie produktów, możemy poprosić Cię o przedstawienie certyfikatów i licencji. Nie musisz przesyłać certyfikatów, dopóki Twoje konto nie zostanie aktywowane. Gdy Twoje konto będzie aktywne, otrzymasz informacje o tym, jak przesłać certyfikaty do Google.