Обзор отчетов

Видео: Семинар по GAQL

Благодаря объединению отчетов и запросов вам больше не нужно определять отчет. Вы можете напрямую запрашивать данные у ресурсов, используя SearchGoogleAdsStreamRequest или SearchGoogleAdsRequest .

Начните планирование переноса отчетов с просмотра соответствующих таблиц сопоставления полей . В этих таблицах показано название поля AdWords API и его эквивалент в Google Ads API.

Пример

Отчет об эффективности группы объявлений и отчет об эффективности кампании — два наиболее часто используемых отчета API AdWords. Мы предоставляем для сравнения эквивалентные запросы на языке запросов AdWords (AWQL) и языке запросов Google Ads (GAQL):

Отчет об эффективности группы объявлений
# AWQL
SELECT CampaignId, AdGroupId, Impressions, Clicks, Cost
FROM ADGROUP_PERFORMANCE_REPORT
DURING LAST_7_DAYS

# Google Ads Query Language
SELECT campaign.id, ad_group.id, metrics.impressions, metrics.clicks,
       metrics.cost_micros
FROM ad_group
WHERE segments.date DURING LAST_7_DAYS
Отчет об эффективности кампании
# AWQL
SELECT CampaignName, CampaignStatus, Device, Impressions, Clicks,
       Ctr, AverageCpc, Cost
FROM CAMPAIGN_PERFORMANCE_REPORT
DURING LAST_30_DAYS

# Google Ads Query Language
SELECT campaign.name, campaign.status, segments.device, metrics.impressions,
       metrics.clicks, metrics.ctr, metrics.average_cpc, metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

Одиночные и множественные отчеты по атрибуции

Во время переноса могут потребоваться специальные отчеты по определенным критериям в API AdWords, такие как отчет об эффективности ключевых слов или отчет об эффективности возрастного диапазона . Такие отчеты бывают двух видов:

В Google Ads API нет отдельных отчетов по атрибуции. Все отчеты Google Ads API на уровне критериев имеют множественную атрибуцию в том смысле, что каждый отчет относится к одной группе типов критериев и обобщает статистику в соответствии с критериями этого типа. Не добавляйте вместе статистику из разных ресурсов criteria_view , так как это приведет к двойному учету и неверным результатам.

HTTP-заголовок includeZeroImpressions

API AdWords

В API AdWords вы можете использовать заголовок includeZeroImpressions чтобы контролировать, должны ли возвращаться строки отчета, в которых все указанные поля метрик в запросе имеют нулевые значения .

Установите для заголовка значение true , вывод отчета включает такие строки; для false это не так.

Хотя в названии заголовка упоминается «Показы», ​​строка отчета должна иметь нулевое значение во всех указанных полях метрик в запросе (не только о показах), чтобы ее можно было исключить, если для заголовка задано значение false .

В Google Ads API такого заголовка нет, поэтому вы не можете напрямую сопоставлять запросы AdWords API с запросами в Google Ads API.

В качестве приближения можно указать в запросе предикат metrics.impressions > 0 , чтобы исключить строки отчета, показы которых равны нулю. В большинстве случаев это приводит к таким же результатам, как установка для заголовка includeZeroImpressions API AdWords значения false , поскольку, когда количество показов не равно нулю, значения других показателей также часто не равны нулю.

Однако помните о случаях, когда metrics.impressions равен нулю, а другие значения метрик (такие как metrics.search_impression_share на основе прогноза) могут быть разными, поэтому строка отчета все равно может быть возвращена.