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

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

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

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

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

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

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

• Поля, которые нужно включить:

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

• Пример запроса GAQL. В GeoX рекламодатели получают показатели расходов с помощью 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 возвращает строки только для географических сегментов, в которых были зарегистрированы показы или расходы в определенную дату. Чтобы включить в хронологический ряд GeoX дни и регионы с нулевыми расходами, выполните левое внешнее соединение в конвейере данных с полным декартовым произведением дат и целевых регионов.

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

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

• Сопоставление географических сегментов. API не возвращает в представлениях отчетов названия в виде обычного текста (например, "Нью-Йорк") или короткие коды (например, "501" или "ES"). Поля, такие как 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)	Устаревший формат (не используйте)
Регион DMA	Идентификатор 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 отслеживается чистый доход с отрицательными значениями для возвратов, вам необходимо использовать валовые показатели для эксперимента и применить коэффициент возврата позже.