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-адресов для геолокации может привести к несколько неточным результатам.
Географическая таблица (устарела)
Поле BidRequest.device.geo.ext.geo_criteria_id представляет геолокацию в виде числового идентификатора, который сопоставляется с геолокацией в файле geo-table.csv, доступном для скачивания в разделе «Справочные таблицы» на странице «Прототипы и справочные данные». Это поле и соответствующая таблица больше не используются . Вы можете использовать BidRequest.device.geo для получения аналогичной информации о геолокации.
Например, если запрос ставки заполняет geo с точностью до уровня города, то geo_criteria_id будет содержать код соответствующего города. Вы можете использовать этот идентификатор для поиска записи в географической таблице.
Столбцы
- Идентификатор критерия
- Уникальный и постоянный присвоенный идентификатор. В API эти критерии имеют тип
Location. - Имя
- Лучшее доступное английское название географической цели.
- Каноническое имя
- Созданное полное английское имя, состоящее из собственного имени цели, а также имени ее родителя и страны. Это поле предназначено только для устранения неоднозначности похожих целевых имен — оно не поддерживается в LocationCriterionService (вместо этого используйте имена местоположений или идентификаторы критериев).
- Идентификатор родителя
- Идентификатор критерия родителя. Это поле включено для поддержки устаревших версий, поэтому идентификаторы могут не совпадать в разных наборах данных. Канонические имена — предпочтительный метод построения иерархий.
- Код региона
- Код региона ISO 3166-2 для целевого штата или провинции, если таковой существует.
- Код страны
- Код страны ISO-3166-1 альфа-2, связанный с целью.
- Тип цели
Допустимые значения:
- Аэропорт
- округ
- Автономное сообщество
- район
- Кантон
- Город
- Город Регион
- Избирательный округ для выборов в конгресс
- Страна
- Графство
- Отделение
- Округ
- регион DMA
- провинция
- Метро
- Муниципалитет
- Национальный парк
- Район
- округ
- Другой
- Почтовый индекс
- Префектура
- Провинция
- Область
- Состояние
- Территория
- ТВ-регион
- Союзная территория
- Университет
Нецелевые местоположения
В соответствии с правилами и законами Китайской Народной Республики о рекламе вас могут попросить предоставить сертификаты и лицензии, если вы рекламируете определенные категории продуктов в Китае. Вам не нужно отправлять сертификаты до тех пор, пока ваша учетная запись не будет активирована. Как только ваша учетная запись станет активной, вам будет предоставлена информация о том, как отправить сертификаты в Google.