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:
country
region
metro
city
zip
Współrzędne geograficzne są reprezentowane przez te pola:
lat
lon
accuracy
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.