Google предоставляет информацию о геолокации через объект Geo , общий для протоколов OpenRTB и Google. В этом документе описываются более подробные сведения о том, как Google заполняет геолокацию в запросах ставок, и предлагаются лучшие практики ее использования.
Как заполняется объект Geo
Google определяет местоположение устройств только на основе геолокации IP, а не на основе GPS или других источников. Хотя спецификация OpenRTB поддерживает отдельные геолокации для пользователя (например, домашний адрес) и устройства (где находится устройство в момент размещения рекламы), Google поддерживает только последнее. Следовательно, протокол Google содержит только один объект Geo — BidRequest.geo ; а для OpenRTB Google заполнит только поле Device.geo .
Поля Geo заполняются одинаково для обоих протоколов. Следующие поля существуют только в варианте OpenRTB объекта Geo , они никогда не заполняются Google ни в одном протоколе: regionfips104 , lastfix , type и ipservice . Большинство неподдерживаемых полей выше относятся к альтернативным источникам местоположений.
Защита конфиденциальности
Чтобы защитить конфиденциальность пользователей, Google предоставляет только приблизительную геолокацию, которой пользуется достаточно большое количество пользователей, при необходимости обобщая обнаруженное местоположение.
Представления местоположения
Объект Geo поддерживает два отдельных представления местоположения: гражданское местоположение и географические координаты.
Гражданские локации представлены следующими полями:
-
country -
region -
metro -
city -
zip
Географические координаты представлены следующими полями:
-
lat -
lon -
accuracy
В протоколах Google и OpenRTB оба представления содержат одинаковое местоположение и точность. Например, если запрос ставки заполняет Geo с точностью до уровня города, то поля lat и lon будут содержать широту и долготу центральной точки идентифицированного города, а accuracy будет равна радиусу круга той же площади, что и этот город. Google также ограничивает точность полей lat и lon до 0,01 градуса.
Рекомендации по геотаргетингу
Участникам торгов, которым необходимы специальные данные геолокации, мы рекомендуем использовать поля приблизительной lat , lon и accuracy для выполнения поиска пространственной геолокации. Мы не рекомендуем использовать поле ip для геолокации, поскольку Google передает IP-адрес только в усеченном виде; использование усеченных IP-адресов для геолокации может привести к несколько неточным результатам.
Географическая таблица
Поле geo_criteria_id представляет геолокацию в виде числового идентификатора, который сопоставляется с геолокацией в файле geo-table.csv , доступном для загрузки в разделе «Справочные таблицы» на странице «Прототипы и справочные данные». Это поле и соответствующая таблица больше не поддерживаются — вы можете использовать описанное выше поле Geo , чтобы получить аналогичную информацию о геолокации. Например, если в запросе ставки указан Geo регион с точностью до уровня города, то geo_criteria_id будет содержать код соответствующего города. Вы можете использовать этот идентификатор для поиска записи в географической таблице.
Столбцы
- Идентификатор критерия
- Уникальный и постоянный присвоенный идентификатор. В API эти критерии имеют тип
Location. - Имя
- Лучшее доступное английское название географической цели.
- Каноническое имя
- Созданное полное английское имя, состоящее из собственного имени цели, а также имени ее родителя и страны. Это поле предназначено только для устранения неоднозначности похожих целевых имен — оно не поддерживается в LocationCriterionService (вместо этого используйте имена местоположений или идентификаторы критериев).
- Идентификатор родителя
- Идентификатор критерия родителя. Это поле включено для поддержки устаревших версий, поэтому идентификаторы могут не совпадать в разных наборах данных. Канонические имена — предпочтительный метод построения иерархий.
- Код региона
- Код региона ISO 3166-2 для целевого штата или провинции, если таковой существует.
- Код страны
- Код страны ISO-3166-1 альфа-2, связанный с целью.
- Тип цели
Допустимые значения:
- Аэропорт
- округ
- Автономное сообщество
- район
- Кантон
- Город
- Город Регион
- Избирательный округ для выборов в конгресс
- Страна
- округ
- Отделение
- Округ
- регион DMA
- провинция
- метро
- Муниципалитет
- Национальный парк
- Район
- округ
- Другой
- Почтовый индекс
- Префектура
- Провинция
- Область
- Состояние
- Территория
- ТВ-регион
- Союзная территория
- Университет
Нецелевые местоположения
В соответствии с правилами и законами Китайской Народной Республики о рекламе вас могут попросить предоставить сертификаты и лицензии, если вы рекламируете определенные категории продуктов в Китае. Вам не нужно отправлять сертификаты до тех пор, пока ваша учетная запись не будет активирована. Как только ваша учетная запись станет активной, вам будет предоставлена информация о том, как отправить сертификаты в Google.