Благодаря объединению отчетов и запросов вам больше не нужно определять отчет. Вы можете напрямую запрашивать данные у ресурсов, используя 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 .
API Google Рекламы
В Google Ads API такого заголовка нет, поэтому вы не можете напрямую сопоставлять запросы AdWords API с запросами в Google Ads API.
В качестве приближения можно указать в запросе предикат metrics.impressions > 0 , чтобы исключить строки отчета, показы которых равны нулю. В большинстве случаев это приводит к таким же результатам, как установка для заголовка includeZeroImpressions API AdWords значения false , поскольку, когда количество показов не равно нулю, значения других показателей также часто не равны нулю.
Однако помните о случаях, когда metrics.impressions равен нулю, а другие значения метрик (такие как metrics.search_impression_share на основе прогноза) могут быть разными, поэтому строка отчета все равно может быть возвращена.