Google Ads API предлагает несколько представлений, позволяющих анализировать, где показывались ваши объявления и насколько они эффективны:
managed_placement_view,
group_placement_view,
detail_placement_view и
performance_max_placement_view. Каждое представление позволяет по-разному взглянуть на данные о местах размещения.
Просмотр мест размещения, выбранных вручную
- Что он показывает. Ресурс
managed_placement_viewсодержит данные об эффективности, агрегированные по местам размещения, на которые вы настроили таргетинг (выбранные места размещения). Она отражает эффективность ваших критериев (Placement). - Эквивалент в интерфейсе: Контент > Места размещения.
- Конструктор запросов: изучить в конструкторе запросов.
Пример запроса
Чтобы получить показатели эффективности мест размещения за последние 30 дней, выполните следующие действия:
SELECT
campaign.id,
ad_group.id,
managed_placement_view.resource_name,
ad_group_criterion.placement.url,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS
Просмотр группы мест размещения
- Что он показывает. Ресурс
group_placement_viewпоказывает, где фактически показывались ваши объявления в контекстно-медийной сети и на YouTube, независимо от того, были ли места размещения явно заданы в настройках таргетинга или обнаружены автоматически системой Google. Это могут быть сайты, каналы или видео YouTube, а также приложения. - Эквивалент в интерфейсе: Контент > Где показывается реклама.
- Конструктор запросов: изучить в конструкторе запросов.
Строка "Всего: другое"
Чтобы ускорить создание отчетов, ресурсы 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 может быть ниже, чем общие показатели для группы объявлений или кампании. Подробнее об отчете "Где показывается реклама". Подробнее о том, как пороговые значения и отсутствие метаданных влияют на сравнение представлений, читайте в разделах Различия в показателях между представлениями мест размещения и Строки с недоступной информацией о местах.
Параметры TargetingSetting
На поведение и полезность 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, в этом представлении не показываются места размещения с низкой активностью, которые не соответствуют минимальным пороговым значениям (см. раздел Строка "Всего: другое").
Различия в показателях между представлениями мест размещения
Минимальный порог активности оценивается независимо на каждом уровне детализации:
- Ресурс
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, поскольку это может привести к перезаписи показателей по разным местам размещения с недоступными метаданными.
Чтобы исключить строки с недоступными метаданными в Google Ads Query Language, отфильтруйте поле target_url или display_name (например, WHERE
detail_placement_view.target_url IS NOT NULL), поскольку поля placement и resource_name нельзя отфильтровать.
Кампания с максимальной эффективностью: представление мест размещения
- Что он показывает. Ресурс
performance_max_placement_viewсодержит данные о показах (metrics.impressions) в местах размещения, где показывались объявления из кампаний с максимальной эффективностью. В версии 24 и более поздних можно сегментироватьperformance_max_placement_viewпоsegments.ad_network_type(не поддерживается в версии 23). - Конструктор запросов: изучить в конструкторе запросов.
Какой режим просмотра выбрать?
- Используйте
managed_placement_view, чтобы оценить эффективность мест размещения, на которые вы активно настраиваете таргетинг и назначаете ставки. - Используйте
group_placement_view, чтобы узнать, где показываются ваши объявления, особенно если вы используете настройку "Наблюдение". Это поможет вам найти новые возможности для таргетинга или исключений. detail_placement_viewпозволяет получить максимально подробные сведения об URL или видео, в которых показывались ваши объявления. Обычно этот отчет используют после того, как вgroup_placement_viewбыл выявлен интересующий домен или канал.- Используйте
performance_max_placement_view, чтобы проверить показы на местах размещения для кампаний с максимальной эффективностью.