Google udostępnia informacje geolokalizacyjne za pomocą obiektu Geo, które są wspólne dla protokołów OpenRTB i Google. W tym dokumencie opisujemy ogólniejsze informacje o tym, jak Google uzupełnia dane geolokalizacyjne w pytaniach o stawkę, i przedstawia sprawdzone metody korzystania z niej.
Sposób wypełniania obiektu Geo
Google pozyskuje dane o lokalizacji urządzeń wyłącznie na podstawie geolokalizacji na podstawie adresu IP. Nie jest to nigdy GPS ani inne źródła. Specyfikacja OpenRTB obsługuje oddzielne lokalizacje geograficzne dla użytkownika (np. adresu domowego) i urządzenia (gdzie urządzenie znajduje się w momencie umieszczania reklamy), ale Google obsługuje tylko te ostatnie. Dlatego implementacja Google OpenRTB wypełnia tylko wartość BidRequest.device.geo, a wycofany protokół Google RTB obsługuje tylko pole BidRequest.geo, które odnosi się do lokalizacji urządzenia.
Ochrona prywatności
Aby chronić prywatność użytkowników, Google udostępnia tylko przybliżoną geolokalizację, która jest udostępniana przez wystarczającą liczbę użytkowników. W razie potrzeby uogólniamy wykrytą lokalizację.
Przedstawienie lokalizacji
Obiekt Geo obsługuje 2 oddzielne reprezentacje lokalizacji – położenie cywilne i współrzędne geograficzne.
Lokalizacje cywilne są reprezentowane przez następujące pola:
countryregionmetrocityzip
Współrzędne geograficzne są przedstawiane w następujących polach:
latlonaccuracy
W przypadku protokołów Google i OpenRTB obie reprezentacje zawierają tę samą lokalizację i taką samą dokładność. Jeśli np. pytanie o stawkę wypełnia pole Geo z dokładnością do poziomu miasta, pola lat i lon będą zawierać szerokość i długość geograficzną punktu środkowego wybranego miasta, a accuracy – promień koła o tym samym obszarze co to miasto. Google ogranicza też precyzję pól lat i lon do 0,01 stopnia.
Sprawdzone metody kierowania na geolokalizację
W przypadku licytujących, którzy potrzebują niestandardowych danych geolokalizacji, do wyszukiwania geolokalizacji przestrzennej zalecamy użycie przybliżonych pól lat, lon i accuracy.
Nie zalecamy korzystania z pola ip do geolokalizacji, ponieważ Google udostępnia adres IP tylko w skróconej formie. Używanie skróconych adresów IP do geolokalizacji może sprawić, że wyniki będą nieco niedokładne.
Tabela danych geograficznych (wycofana)
Pole BidRequest.geo_criteria_id wycofanego protokołu Google RTB protokołu reprezentuje geolokalizację jako identyfikator numeryczny, który jest zmapowany na geolokalizację w pliku geo-table.csv, który jest dostępny do pobrania w sekcji Tabele referencyjne na stronie Protos i dane referencyjne. To pole i odpowiadająca mu tabela zostały wycofane. W polu Geo możesz uzyskać podobne dane geolokalizacyjne.
Jeśli np. pytanie o stawkę zawiera pole Geo z dokładnością do poziomu miasta, pole geo_criteria_id będzie zawierać kod odpowiedniego 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 są typu
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 wyłącznie do wskazywania podobnych nazw celów – nie jest obsługiwane w usłudze LocationCriterionService (użyj nazw lokalizacji lub identyfikatorów kryteriów).
- Identyfikator nadrzędny
- Identyfikator kryteriów elementu nadrzędnego. To pole jest uwzględnione w przypadku starszej wersji, a identyfikatory mogą być niespójne w różnych zbiorach danych. Nazwy kanoniczne są preferowaną metodą budowania hierarchii.
- Kod regionu
- Kod regionu w formacie ISO 3166-2 dla stanu lub prowincji docelowej (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
- Inny
- 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 przesyłać zaświadczeń do czasu aktywacji konta. Gdy Twoje konto będzie aktywne, otrzymasz informacje o sposobie przesyłania certyfikatów do Google.