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, чтобы проверить показы на местах размещения для кампаний с максимальной эффективностью.