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