Как получать геоданные для экспериментов

Для автоматического или крупномасштабного извлечения данных для геоэкспериментов необходимо использовать Google Ads API. Затем вы объединяете эти данные с необработанными, нефильтрованными и неатрибутированными данными о конверсиях или доходах из вашей внутренней CRM, точки продаж (POS) или внутренних баз данных продаж.

Рекомендуемая архитектура рабочего процесса API

Чтобы точно извлекать данные о кампаниях и расходах по географическим сегментам, используйте следующую архитектуру:

• Сервис. Используйте GoogleAdsService, в частности методы Search или SearchStream.

• Ресурс. Выполните запрос geographic_view, чтобы узнать, где физически находился пользователь или каким местоположением он интересовался. Обычно это стандартный подход для геоэкспериментов. Вы также можете запросить location_view, чтобы посмотреть эффективность по определенным местоположениям, на которые настроен таргетинг в кампании.

  Примечание. Не используйте campaign_location_target_report, так как поддержка этого устаревшего отчета AdWords API прекращена.

• Необходимые поля:

  • campaign.id
  • segments.date
  • segments.geo_target_city (или регион, или страна в зависимости от детализации геоэксперимента)
  • metrics.cost_micros

• Пример запроса GAQL. Для геоэкспериментов рекламодатели получают показатели расходов с помощью Google Ads API, а не атрибутированных конверсий (которые должны поступать из внутренней CRM или сторонних систем). Вы можете использовать следующий запрос:

  SELECT
    campaign.id,
    segments.date,
    segments.geo_target_city,
    metrics.cost_micros
  FROM geographic_view
  WHERE segments.date DURING LAST_30_DAYS
  

  Примечание. geographic_view возвращает только строки для географических сегментов, в которых были зарегистрированы показы или расходы на определенную дату. Чтобы включить в временной ряд геоэксперимента дни и регионы с нулевыми расходами, выполните левое внешнее соединение в конвейере данных с полным декартовым произведением дат и целевых регионов.

Примечание. Если вы получаете показатели конверсий из Google Рекламы, то вы получаете атрибутированные конверсии. Это значит, что вы видите только те продажи, которые алгоритм Google уже связал с рекламой. Использовать атрибутированные данные в геоэкспериментах настоятельно не рекомендуется, поскольку логика атрибуции искажает результаты причинно-следственного анализа.

Постобработка и извлечение данных

• Сопоставление географических сегментов. API не возвращает названия в виде обычного текста (например, "Москва") или короткие коды (например, "501" или "RU") в представлениях отчетов. Поля, такие как segments.geo_target_city или segments.geo_target_country, возвращают строку названия ресурса, указывающую на GeoTargetConstant (например, geoTargetConstants/1023191). Извлеките числовой идентификатор (1023191) и запросите ресурс geo_target_constant:

  SELECT
    geo_target_constant.id,
    geo_target_constant.name,
    geo_target_constant.canonical_name
  FROM geo_target_constant
  WHERE geo_target_constant.id = 1023191
  

  Чтобы выполнить объединение локально в коде, скачайте CSV-файл со статическими областями геотаргетинга на странице Геотаргетинг.

• Конвертация стоимости. API возвращает значения стоимости в микроединицах. Чтобы получить стандартное значение валюты,которое требуется указать в файле загрузки,разделите metrics.cost_micros на 1 000 000.

Идентификаторы местоположений для изменения таргетинга

При изменении геотаргетинга на уровне кампании или группы объявлений рекламодатели должны найти и передать точный идентификатор GeoTargetConstant (geoTargetConstants/ID) для выбранных регионов. Нельзя передавать необработанные коды ISO или Nielsen.

Тип региона	Обязательный идентификатор API (GeoTargetConstant)	Устаревший формат (не использовать)
Регион медиарынка	ID 200501 (для Нью-Йорка)	Код Nielsen (например, 501 для Нью-Йорка)
Страна	Идентификатор 2724 (для Испании)	Код ISO (например, "ES" для Испании)

Рекомендации и распространенные ошибки форматирования

• Формат даты. Поле segments.date возвращает строки даты ISO-8601 в формате YYYY-MM-DD. В конвейере ETL сериализуйте поля дат в виде строк YYYY-MM-DD и не открывайте экспортированные CSV-файлы в приложениях для работы с таблицами, которые автоматически меняют формат столбцов с датами.
• Нули в начале почтовых индексов. Обрабатывайте почтовые индексы (например, 01234) как строковые типы (VARCHAR или STRING) во всем конвейере данных, а не как целые числа, чтобы нули в начале не удалялись.
• Агрегирование. Если вы проводите исследование с несколькими группами, вам нужно предоставить отдельные показатели расходов для каждой экспериментальной группы.
• Объединение данных о конверсиях. При объединении данных о конверсиях из внутренней CRM-системы или внутренней базы данных продаж убедитесь, что данные о конверсиях имеют следующие свойства, чтобы обеспечить бесперебойную обработку данных с помощью Google Ads API и GeoX:
  • Временной ряд по дням. Данные должны быть агрегированы по дням.
  • Географический уровень. Каждая конверсия должна быть сопоставлена с точными географическими единицами, которые вы тестируете (например, сопоставление почтового индекса доставки клиента с медиарынком или почтовым кластером, используемым в дизайне).
  • Валовые значения. Данные должны быть неотрицательными абсолютными значениями, такими как валовой доход или валовое количество конверсий. Если в вашей CRM-системе чистый доход отслеживается с отрицательными значениями для возвратов, то для эксперимента нужно использовать валовые значения, а затем применить коэффициент возврата.