В API AdWords вы можете получать данные об эффективности (показатели) по различным критериям из различных отчетов (например, отчета об эффективности ключевых слов или отчета об эффективности возрастного диапазона ).
Чтобы обеспечить аналогичную функциональность в Google Ads API, каждый отчет о критериях представлен отдельным ресурсом. Например, данные, аналогичные отчету об эффективности ключевых слов , доступны в ресурсе keyword_view
. Если нет абсолютной необходимости, ресурсы *_view
будут содержать только поле resource_name
.
Клиенты Google Ads API должны будут указать соответствующие поля ad_group_criterion
или campaign_criterion
, если необходимо получить какие-либо данные, относящиеся к конкретным критериям. Это позволит клиентам Google Ads API запрашивать поля ad_group_criterion
или campaign_criterion
и ресурс *_view
в одном запросе к методу GoogleAdsService.SearchStream
.
Образец запроса запроса
SELECT
ad_group_criterion.keyword.text,
ad_group.name,
campaign.name,
metrics.impressions,
metrics.clicks,
metrics.ctr,
metrics.average_cpc
FROM keyword_view
WHERE segments.date DURING LAST_30_DAYS
Чтобы получить данные о производительности (метрики) для определенного типа критериев, укажите соответствующий ресурс представления в предложении FROM
. Например, используйте keyword_view
в предложении FROM
и некоторые поля metrics
в предложении SELECT
, чтобы получить метрики ключевых слов.
Вы можете выбирать поля из родительских ресурсов вплоть до customer
из представления критериев. Например, при выборе FROM
для keyword_view
вы можете запрашивать поля из всех следующих ресурсов:
-
ad_group_criterion
-
ad_group
-
campaign
-
customer
Вы можете проверить, какие ресурсы можно запрашивать указанным выше способом для данного ресурса, проверив строку Ресурсы атрибутов на его справочной странице. Например, для keyword_view
вы можете найти приведенную выше информацию на его справочной странице .
Следующие шаги
Узнайте больше о сервисе для получения метаданных ресурсов .
Подробнее о сегментации .
Узнайте, как включить или исключить строки для ресурсов без метрик .