Как отслеживать места размещения и эффективность объявлений

Google Ads API предлагает несколько представлений, позволяющих анализировать, где показывались ваши объявления и насколько они эффективны: managed_placement_view, group_placement_view, detail_placement_view и performance_max_placement_view. Каждое представление позволяет по-разному взглянуть на данные о местах размещения. Готовые запросы на языке запросов Google Рекламы (GAQL) и curl, которые воспроизводят экраны мест размещения в интерфейсе Google Рекламы, можно найти в книге рецептов запросов.

Просмотр мест размещения, выбранных вручную

  • Что содержится в отчете. Ресурс managed_placement_view содержит данные об эффективности, агрегированные по критериям положительного таргетинга на места размещения, которые вы задали в группах объявлений. В этом представлении содержатся все пять типов критериев, которыми можно управлять в разделе Контент > Места размещения в интерфейсе Google Рекламы: сайты, каналы YouTube, видео YouTube, мобильные приложения и категории приложений.
  • Эквивалент в интерфейсе: Контент > Места размещения.
  • Конструктор запросов: изучить в конструкторе запросов.

Типы критериев целевых мест размещения

Каждая строка в ресурсе managed_placement_view заполняет поле AdGroupCriterion, которое соответствует значению ad_group_criterion.type, и оставляет другие поля места размещения незаполненными:

Тип места размещения в интерфейсе На сумму ad_group_criterion.type Поля сведений о критериях Примечания
Сайты PLACEMENT ad_group_criterion.placement.url URL целевого сайта или домена.
Каналы YouTube YOUTUBE_CHANNEL ad_group_criterion.youtube_channel.channel_id Идентификатор канала YouTube. Поле ad_group_criterion.display_name возвращает название канала.
Видео на YouTube YOUTUBE_VIDEO ad_group_criterion.youtube_video.video_id Идентификатор видео YouTube. Поле ad_group_criterion.display_name возвращает название видео.
Приложения MOBILE_APPLICATION ad_group_criterion.mobile_application.app_id, ad_group_criterion.mobile_application.name Идентификатор приложения в формате {platform}-{platform_native_id} (1- для iOS, 2- для Android) и название приложения.
Категории приложений MOBILE_APP_CATEGORY ad_group_criterion.mobile_app_category.mobile_app_category_constant Название ресурса в формате mobileAppCategoryConstants/{mobile_app_category_id}. Подробнее о названиях и иерархии категорий мобильных приложений…

Пример запроса

Чтобы получить показатели эффективности для всех типов целевых мест размещения за последние 30 дней, выберите поле ad_group_criterion.type вместе с полями, относящимися к определенным типам:

SELECT
  campaign.id,
  ad_group.id,
  managed_placement_view.resource_name,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.display_name,
  ad_group_criterion.placement.url,
  ad_group_criterion.youtube_channel.channel_id,
  ad_group_criterion.youtube_video.video_id,
  ad_group_criterion.mobile_application.app_id,
  ad_group_criterion.mobile_application.name,
  ad_group_criterion.mobile_app_category.mobile_app_category_constant,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS

Названия и иерархия категорий мобильных приложений

В интерфейсе Google Рекламы для категорий мобильных приложений, на которые настроен таргетинг, указывается полный путь в магазине приложений, например Категории приложений > Apple App Store > Образование. При отправке запросов в Google Ads API учитывайте следующее:

  • Константы категорий мобильных приложений. Ресурс mobile_app_category_constant не является атрибутированным ресурсом ресурса managed_placement_view. Вместо этого выберите поле ad_group_criterion.mobile_app_category.mobile_app_category_constant (например, mobileAppCategoryConstants/60503) или запросите ресурс ad_group_criterion, если вам не нужны показатели.
  • Отображаемые названия только конечных категорий. В полях ad_group_criterion.display_name и mobile_app_category_constant.name возвращается только название конечной категории, например "Education" или "Games". Ни в одном из полей не указывается путь к родительскому магазину приложений.
  • Определение пути к магазину приложений. В Google Play и Apple App Store названия конечных категорий могут совпадать, но идентификаторы критериев будут разными. Например, для идентификаторов критериев 60005 (/All Apps/Google Play/Education), 60060 (/All Apps/Google Play/Family/Education) и 60503 (/All Apps/Apple App Store/Education) в полях name и display_name возвращается значение "Education". Извлеките суффикс {mobile_app_category_id} из названия ресурса и найдите полный путь иерархии в таблице или CSV-файле Категории мобильных приложений.

Просмотр группы мест размещения

  • Что он показывает. Ресурс group_placement_view показывает, где фактически показывались ваши объявления в контекстно-медийной сети и на YouTube, независимо от того, были ли места размещения явно заданы в настройках таргетинга или обнаружены автоматически системой Google. Это могут быть сайты, каналы или видео YouTube, а также приложения.
  • Эквивалент в интерфейсе: Контент > Где показывается реклама.
  • Конструктор запросов: изучить в конструкторе запросов.

Пример запроса

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

SELECT
  campaign.id,
  ad_group.id,
  group_placement_view.display_name,
  group_placement_view.target_url,
  group_placement_view.placement_type,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM group_placement_view
WHERE segments.date DURING LAST_30_DAYS

Строка "Всего: другое"

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

  • В интерфейсе Google Рекламы. Места размещения, которые не соответствуют этому порогу активности, объединяются в строку Итого (другие).
  • В Google Ads API. Места размещения, не соответствующие пороговому значению активности, не включаются в отчеты. Строка со сводными данными, в которой поле group_placement_view.placement или detail_placement_view.placement имеет значение "Other", не возвращается.

В результате сумма строк отдельных мест размещения в ресурсах group_placement_view и detail_placement_view может быть ниже, чем общие показатели для группы объявлений или кампании. Подробнее об отчете "Где показывается реклама". Подробнее о том, как пороговые значения и отсутствие метаданных влияют на сравнение представлений, читайте в разделах Различия в показателях между представлениями мест размещения и Строки с недоступной информацией о местах.

Настройки таргетинга на места размещения

На поведение и полезность group_placement_view влияет TargetingSetting для параметра PLACEMENT на уровне группы объявлений. Эта настройка содержит список объектов target_restrictions, каждый из которых имеет логическое поле bid_only, определяющее, будут ли ваши объявления показываться только в целевых местах размещения или также в других местах размещения. Подробнее о параметрах "Таргетинг" и "Наблюдение"…

  • bid_only = false – это значение соответствует варианту Таргетинг в интерфейсе Google Рекламы для мест размещения. Если в группе объявлений выбран вариант "Таргетинг", объявления будут показываться только в местах размещения, которые вы добавили в качестве критериев. Вы можете применить корректировки ставок к этим местам размещения. В этом случае group_placement_view в основном отражает managed_placement_view, но по-прежнему зависит от минимальных пороговых значений активности.
  • bid_only = true – это значение соответствует варианту Наблюдение в интерфейсе Google Рекламы для мест размещения. Если в группе объявлений выбран вариант "Наблюдение", объявления могут показываться на любых подходящих местах размещения в контекстно-медийной сети и на YouTube. Вы также можете применять корректировки ставок к любым местам размещения, на которые настроен таргетинг. В этом случае group_placement_view – важный инструмент для поиска новых мест размещения, где показываются ваши объявления. Вы можете добавить их в качестве управляемых мест размещения или исключений.

Подробные сведения о местах размещения

  • Что он показывает. Ресурс detail_placement_view позволяет получить более подробную разбивку мест размещения, чем на уровне домена или канала. Например, в нем могут быть указаны URL или идентификаторы видео YouTube, в которых показывались ваши объявления.
  • Аналог в интерфейсе. Выберите строки в разделе Контент > Где показывается реклама и нажмите Подробнее.
  • Конструктор запросов: изучить в конструкторе запросов.
  • Важные примечания. Как и в случае с ресурсом group_placement_view, в этом представлении не показываются места размещения с низкой активностью, которые не соответствуют минимальным пороговым значениям (см. раздел Строка "Всего: другое").

Пример запроса

Чтобы ограничить объем результатов, в следующем запросе запрашиваются показатели мест размещения на уровне URL и видео за 7-дневный период. Если у вас большой аккаунт, вы можете отфильтровать данные по полю campaign.id или ad_group.id:

SELECT
  campaign.id,
  ad_group.id,
  detail_placement_view.display_name,
  detail_placement_view.target_url,
  detail_placement_view.group_placement_target_url,
  detail_placement_view.placement_type,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM detail_placement_view
WHERE segments.date DURING LAST_7_DAYS

Чтобы исключить строки, в которых метаданные мест размещения недоступны, добавьте AND detail_placement_view.target_url IS NOT NULL (см. раздел Строки с недоступными данными о местах размещения). Если вам не нужны возвращаемые поля resource_name, добавьте условие PARAMETERS omit_unselected_resource_names = true.

Различия в показателях между представлениями мест размещения

Минимальный порог активности оценивается независимо на каждом уровне детализации:

  • Ресурс group_placement_view оценивает пороговое значение по агрегированному домену, мобильному приложению или каналу YouTube.
  • Ресурс detail_placement_view оценивает пороговое значение отдельно для каждого URL страницы или видео YouTube.

Ресурс detail_placement_view не содержит URL отдельных страниц или видео YouTube, которые не соответствуют пороговому значению. В результате сумма значений в строках detail_placement_view для домена или канала YouTube (отфильтрованных по полю detail_placement_view.group_placement_target_url) может быть меньше, чем значение в соответствующей строке group_placement_view.

Строки с недоступной информацией о местах

Запрос к ресурсу group_placement_view или detail_placement_view может вернуть несколько строк в одной группе объявлений с незаданными полями placement, display_name и target_url и одинаковым значением resource_name (например, заканчивающимся на ~MTRf).

Это происходит по следующим причинам:

  • Группировка по внутренним местам размещения. В обоих представлениях показатели эффективности группируются по уникальному идентификатору внутреннего места размещения, а не по строковым полям resource_name или placement.
  • Недоступные метаданные мест размещения. В интерфейсе Google Рекламы места размещения без метаданных в таблицах поиска отображаются как Неизвестно, Канал больше недоступен или Видео больше недоступно. В API каждый отдельный идентификатор места размещения по-прежнему возвращает строку показателей, в которой поля placement, display_name и target_url не заданы.
  • Синтезированные названия ресурсов. Суффикс {base64_placement} в поле resource_name закодирован в Base64 из {type_id}_{placement}, где {type_id} – это внутренний идентификатор типа места размещения, а не номер перечисления PlacementType. Если поле placement_type имеет значение WEBSITE (внутренний идентификатор 14), а поле placement не задано, то строка "14_" кодируется как MTRf. Аналогично MOBILE_APPLICATION кодирует "55_" как NTVf, YOUTUBE_VIDEO кодирует "89_" как ODlf, а YOUTUBE_CHANNEL кодирует "90_" как OTBf. Таким образом, несколько мест размещения одного типа с недоступными метаданными в одной группе объявлений имеют одинаковое значение resource_name, но в отчетах для них создаются отдельные строки показателей.

При обработке результатов group_placement_view или detail_placement_view в коде клиента не дедуплицируйте строки только по полю resource_name, поскольку это может привести к перезаписи показателей по разным местам размещения с недоступными метаданными. Чтобы исключить строки с недоступными метаданными в GAQL, отфильтруйте поле target_url или display_name, поскольку поля placement и resource_name не поддерживают фильтрацию. Примеры: WHERE group_placement_view.target_url IS NOT NULL или WHERE detail_placement_view.target_url IS NOT NULL.

Кампания с максимальной эффективностью: представление мест размещения

  • Что он показывает. Ресурс performance_max_placement_view содержит данные о показах (metrics.impressions) в местах размещения, где показывались объявления из кампаний с максимальной эффективностью. В версии 24 и более поздних можно сегментировать performance_max_placement_view по segments.ad_network_type (не поддерживается в версии 23).
  • Эквивалент в интерфейсе: Статистика и отчеты > Редактор отчетов > Кампании с максимальной эффективностью: места размещения.
  • Конструктор запросов: изучить в конструкторе запросов.

Пример запроса

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

SELECT
  campaign.id,
  performance_max_placement_view.display_name,
  performance_max_placement_view.target_url,
  performance_max_placement_view.placement_type,
  segments.ad_network_type,
  metrics.impressions
FROM performance_max_placement_view
WHERE segments.date DURING LAST_30_DAYS

Выберите представление мест размещения

  • Используйте managed_placement_view, чтобы оценить эффективность мест размещения, на которые вы активно настраиваете таргетинг и назначаете ставки.
  • Используйте group_placement_view, чтобы узнать, где показываются ваши объявления, особенно если вы используете настройку "Наблюдение". Это поможет вам найти новые возможности для таргетинга или исключений.
  • detail_placement_view позволяет получить максимально подробные сведения об URL или видео, в которых показывались ваши объявления. Обычно этот отчет используют после того, как в group_placement_view был выявлен интересующий домен или канал.
  • Используйте performance_max_placement_view, чтобы проверить показы на местах размещения для кампаний с максимальной эффективностью.