Отчеты

Как и в случае с другими типами кампаний, вы можете использовать GoogleAdsService.SearchStream, чтобы получать атрибуты и показатели эффективности умных кампаний.

Показатели умных кампаний доступны в ресурсе campaign, а показатели, относящиеся к поисковым запросам, – в ресурсе smart_campaign_search_term_view. В объекте smart_campaign_search_term_view поле search_term содержит все подходящие запросы, по которым были получены результаты. Чтобы получить информацию о статусе и соответствии требованиям умной кампании (например, статус проверки, причины несоответствия требованиям или временные метки показов), используйте SmartCampaignSettingService.GetSmartCampaignStatus, как описано в статье Статус кампании.

Показы и клики в умных кампаниях за последние 30 дней

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

SELECT
  campaign.id,
  campaign.name,
  segments.date,
  metrics.impressions,
  metrics.clicks,
  smart_campaign_search_term_view.search_term
FROM smart_campaign_search_term_view
WHERE segments.date DURING LAST_30_DAYS

10 самых популярных поисковых запросов по количеству показов

Следующий запрос позволяет получить 10 самых популярных поисковых запросов, которые привели к наибольшему количеству показов за последние 30 дней, а также их стоимость. Обратите внимание, что в предложении SELECT отсутствует параметр segments.date, чтобы показы и расходы агрегировались по всему 30-дневному диапазону дат для каждого поискового запроса.

SELECT
  campaign.id,
  campaign.name,
  metrics.impressions,
  metrics.cost_micros,
  smart_campaign_search_term_view.search_term
FROM smart_campaign_search_term_view
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 10

Как получить атрибуты объекта KeywordThemeConstant

Поскольку объекты KeywordThemeConstants извлекаются из большого набора данных, который не относится к определенному клиенту, сканировать весь ресурс keyword_theme_constant за один раз невозможно. Чтобы получить отдельные объекты KeywordThemeConstants, необходимо отправить запрос к ресурсу campaign_criterion, чтобы найти названия ресурсов тем ключевых слов, связанных с вашими кампаниями, а затем использовать эти названия ресурсов для запроса к ресурсу keyword_theme_constant.

SELECT
  campaign.id,
  campaign_criterion.type,
  campaign_criterion.status,
  campaign_criterion.criterion_id,
  campaign_criterion.keyword_theme.keyword_theme_constant
FROM campaign_criterion
WHERE campaign_criterion.type = 'KEYWORD_THEME'

Затем используйте название ресурса в поле campaign_criterion.keyword_theme.keyword_theme_constant в следующем запросе:

SELECT
  keyword_theme_constant.resource_name,
  keyword_theme_constant.display_name,
  keyword_theme_constant.country_code
FROM keyword_theme_constant
WHERE keyword_theme_constant.resource_name = 'keywordThemeConstants/40804~0'

Требования к функциональности отчетности

Чтобы реализовать умные кампании, ваше приложение должно соответствовать требованиям к минимальной функциональности (RMF).

Для создания отчетов конечным пользователям необходимо предоставить доступ к ряду полей. Вот как получить необходимые поля из элемента номер R.20 "Эффективность кампании" в RMF:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  metrics.clicks,
  metrics.cost_micros,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM campaign
WHERE campaign.advertising_channel_type = 'SMART'

Ниже показано, как получить необходимые поля из элемента R.70 Smart Campaign Search Term View, а также связанную с ним кампанию и поисковый запрос:

SELECT
  campaign.id,
  campaign.name,
  smart_campaign_search_term_view.search_term,
  metrics.clicks,
  metrics.cost_micros
FROM smart_campaign_search_term_view

Показатели для каждого магазина

Ниже приведен запрос, который включает все доступные показатели для умных кампаний на уровне магазина. Эти поля также можно комбинировать с другими полями в одном запросе:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  metrics.all_conversions_from_click_to_call,
  metrics.all_conversions_from_directions,
  metrics.all_conversions_from_menu,
  metrics.all_conversions_from_order,
  metrics.all_conversions_from_other_engagement,
  metrics.all_conversions_from_store_visit,
  metrics.all_conversions_from_store_website
FROM campaign
WHERE campaign.advertising_channel_type = 'SMART'

Звонки, сегментированные по часам

Чтобы получить все показатели звонков за период с 12:00 до 17:00, используйте следующие значения: segments.hour, 12, 16 (каждое целое число соответствует часовому интервалу, начинающемуся в указанное время).

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  segments.hour,
  metrics.phone_calls
FROM campaign
WHERE campaign.advertising_channel_type = 'SMART'
  AND segments.hour BETWEEN 12 AND 16