2. Отчеты: советы по использованию
Takeshi Hagikura, Google Inc.
Danial Klimkin, Google Inc.
AdWords API Workshops – All rights reserved
3. План
● Общие положения
● Советы по использованию
● Классификация отчетов
● Полезные примеры
● Последние изменения
AdWords API Workshops – All rights reserved
5. Отчеты
● Одна из важнейших частей API
● Необходима для полного цикла
Account
Creation
AdWords API Workshops – All rights reserved
Prepare
Creatives
Bidding
Check
Performance
6. Документация по отчетам
● Недокументированные особенности
● Обновление документации
https://developers.google.com/adwords/api/docs/guides/reporting
https://developers.google.com/adwords/api/docs/guides/reporting-concepts
https://developers.google.com/adwords/api/docs/guides/uireports
AdWords API Workshops – All rights reserved
8. Single vs Multiple attribution
● Определяет, каким образом показы фиксируются для
контекстно-медийной сети (Display Network)
AdWords API Workshops – All rights reserved
9. Как узнать вид отчета?
Определяется типом отчета
● Пример отчета “single attribution”:
○ Criteria Performance Report
● Примеры отчета “multi attribution report”:
○ Display Keyword Performance Report
○ Placement Performance Report
○ Display Topic Performance Report
Вид указан для каждого отчета в документации: goo.gl/592gj
AdWords API Workshops – All rights reserved
10. Пример фиксации показов
● Display Network
Допустим, настройки кампании:
- Возраст: 25-34
- Тематика: Books & Literature
- Ключевое слово: Science
AdWords API Workshops – All rights reserved
11. Single attribution
Показ будет зафиксирован только для одного из совпадающих
клитериев, в следующем порядке:
Placement (most specific)
Age
Gender
Topic
Interests and remarketing list
Keyword (least specific)
Criteria Performance
Criteria, Impressions
25 to 34, 3
AdWords API Workshops – All rights reserved
12. Multi attribution
Показ будет зафиксирован в каждом “измерении” (как в UI):
Age Range Performance
Criteria, Impressions
25 to 34, 3
Display Topic Performance
Criteria, Impressions
Books & Literature, 3
Display Keyword Performance
Criteria, Impressions
Science, 3
AdWords API Workshops – All rights reserved
13. Строки с нулевой статистикой
Строки с нулевым количеством показов
<selector>
<fields>CampaignId</fields>
<fields>CampaignName</fields>
<fields>Clicks</fields>
<fields>Impressions</fields>
</selector>
<includeZeroImpressions>true<includeZeroImpressions>
Campaign ID,Campaign,Clicks,Impressions
79373208,ZeroCampaign1,0,0
79533768,ZeroCampaign2,0,0
77934528,Test Campaign,110,6197
AdWords API Workshops – All rights reserved
14. Строки с нулевой статистикой
Чтобы не показывать:
<selector>
<fields>CampaignId</fields>
<fields>CampaignName</fields>
<fields>Clicks</fields>
<fields>Cost</fields>
<fields>Impressions</fields>
<predicates>
<field>Impressions</field>
<operator>GREATER_THAN</operator>
<values>0</values>
</predicates>
</selector>
AWQL
Select CampaignId, CampaignName
Clicks, Cost, Impressions from
CAMPAIGN_PERFORMANCE_REPORT
Where Impressions > 0
Campaign ID,Campaign,Clicks,Impressions
77934528,Test Campaign,110,6197
AdWords API Workshops – All rights reserved
15. Строки с нулевой статистикой
● Начиная с v201309 отчеты, не поддерживающие
includeZeroImpressions, возвращают ошибку
○
○
○
○
Keywordless Category Report
Keywordless Query Report
URL Performance Report
Search Query Performance Report
● Не совместимы с сегментацией (тоже ошибка)
● Частый случай применения -- получение структуры аккаунта
○ Все данные акканта в одном запросе (с SOAP -- постранично)
AdWords API Workshops – All rights reserved
16. Сегментация
Разделяет информацию по сегментам
<selector>
<fields>CampaignId</fields>
<fields>Clicks</fields>
<fields>Impressions</fields>
</selector>
<selector>
<fields>CampaignId</fields>
<fields>Clicks</fields>
<fields>Impressions</fields>
<fields>AdNetworkType1</fields>
</selector>
Campaign ID,Clicks,Impressions
79373208,2,20
79533768,3,40
Campaign ID,Clicks,Impressions,
AdNetworkType1
79373208,2,20,Search Network
79373208,0,0,Content Network
79533768,2,30,Search Nework
79533768,1,10,Content Network
AdWords API Workshops – All rights reserved
17. Сегментация
● Любое поле сегментации не совместимо с includeZeroImpressions.
● Для сегментации необходимо запросить как минимум одно поле типа
метрика (Impressions, Clicks, Cost …)
<selector>
<fields>CampaignId</fields>
<fields>CampaignName</fields>
<fields>AdNetworkType1</fields>
</selector>
Segment fields without Metric
fields
AdWords API Workshops – All rights reserved
Campaign ID,Campaign,Network
Total, --, --
No rows will be returned
18. “Особая” строка с ID 3000000
● Все ключевые слова КМС (display) отображаются как одно
ключевое слово с ID 3000000 в отчетах типа “single
attribution” (например в Keyword Performance Report)
Keyword Performance Report
Keyword ID,Impressions, Keyword
23458623485,2,flower
23458623815,4,health
3000000,4, Content
● Чтобы получить подробную информацию, используйте
Display Keyword Performance Report
AdWords API Workshops – All rights reserved
19. “Особая” строка с ID 3000006
● Строка с ID 3000006 обозначает статистику, связанную с
Оптимизаций таргетинга медийной рекламы
(Display Campaign Optimizer)
AdWords API Workshops – All rights reserved
21. Октябрь 2013
● Доступно 38 отчетов
Account Performance
Account Reach Frequency
Ad Performance
Ad Extensions Performance
Ad Group Performance
Ad Group Reach Frequency
Age Range Performance
Audience Performance
Automatic Placements Performance
Budget Performance
Call Metrics Call Details
Campaign Performance
Campaign Ad Schedule Target
Campaign Location Target
Campaign Negative Keywords Performance
Campaign Negative Locations
Campaign Negative Placements
Performance
Campaign Platform Target
Campaign Reach Frequency
Campaign Shared Set
Click Performance
Creative Conversion
AdWords API Workshops – All rights reserved
Criteria
Destination URL
Display Keyword Performance
Display Topics Performance
Gender Performance
Geo Performance
Keywordless Category
Keywordless Query
Keywords Performance
Managed Placements Performance
Placeholder Feed Item
Placement Performance
Search Query Performance
Shared Set Criteria
Shared Set
URL Performance
22. Отчеты для медийной сети
● Multi attribution (соответствуют AdWords UI)
● Display Keyword Performance Report
● Placement Performance Report
● Display Topics Performance Report
● Audience Performance Report
● Gender Performance Report
● Age Range Performance Report
● Single attribution
● Criteria Performance Report (включает так же Search Network)
AdWords API Workshops – All rights reserved
23. Отчеты для загрузки структуры аккаунта
● Campaign Performance Report
● Ad Group Performance Report
● Ad Performance Report
● Keywords Performance Report
SOAP запросы AdWords API имеют ограничение на количество
возвращаемых результатов
AdWords API Workshops – All rights reserved
24. Отчеты по “измерениям”
● (Campaign / Ad Group / Account) Reach Frequency Report
● Geo Performance Report
● Destination URL Report
● URL Performance Report
● Creative Conversions Report
● Search Query Performance Report
AdWords API Workshops – All rights reserved
25. Новые отчеты для расширенных кампаний
● Campaign Location Target Report
● Campaign Ad Schedule Target Report
● Campaign Platform Target Report
AdWords API Workshops – All rights reserved
26. Отчеты для расширений объявлений
● Расширения сервисов Feeds (Sitelinks, Call, App)
● Placeholder Feed Item Report
● “Старые” расширения (Other Extensions)
● Ad Extension Performance Report
AdWords API Workshops – All rights reserved
27. Другие отчеты
● Для Dynamic Search Ads
● Keywordless Category Report
● Keywordless Query Report
● Для Shared Sets (Beta feature)
● Shared Set Report
● Shared Set Criteria Report
● Campaign Shared Set Report
Все поля описаны в документации: goo.gl/592gj
AdWords API Workshops – All rights reserved
29. Структурные отчеты
● Позволяет получить всю структурную информацию об
аккаунте за один запуск
External CID: 2584197734, "Test Account".
Campaigns:
+-CampaignId: 103196054 "TestCampaign", (deleted).
+--With an Amount of 50.0, a Bidding Strategy of "cpc", showing 0
Impressions.
+-- AdGroupId: 4486349654, "AdGroup Test Account" (paused)
+-- AdGroupId: 4654290014, "AdGroup Test Account 3" (paused)
+-- AdId: 17462687174, "Free Wibbles" (enabled)
+-- AdId: 17462687294, "Free Wobbles" (enabled)
Keywords:
Criteria/KeywordId: 384251319 - [woozles] (+) - pending review.
Criteria/KeywordId: 384251319 - [woozles] (+) - pending review.
Пример находится здесь: goo.gl/Jt4gDZ
AdWords API Workshops – All rights reserved
30. AdWords API on Rails
Реализация всего цикла на Ruby on Rails
● Авторизация с помощью OAuth2.0 и
сохранение ключей
● Простой запрос к SOAP сервису
(CampaignService.get) с
отображением результатов
● Получение отчетов
Пример доступен здесь: goo.gl/HBzoMi
AdWords API Workshops – All rights reserved
31. Отчеты на AdWords App Engine (Python)
● Получение отчетов с использованием OAuth2 и App Engine
Пример доступен здесь: goo.gl/30Rhrq
AdWords API Workshops – All rights reserved
33. В версии v201309
● Новые отчеты:
○ Age Range Performance Report
○ Gender Performance Report
● Выведены из Beta
○ Keywordless Category Performance Report
○ Keywordless Query Performance Report
○ Campaign Location Target Report
AdWords API Workshops – All rights reserved
34. В версии v201309
● Новые поля
○ GCLID (Google Click ID) in Click Performance Report
● Placement Performance Report
○ Теперь включает automatic placements
AdWords API Workshops – All rights reserved
35. В версии v201309
● Сервисы не содержат данных по статистике
■ Необходимо использовать отчеты
■ Все поля, ранее доступные через сервисы, теперь есть
в отчетах
Более подробно в нашем блоге: goo.gl/CGkyC9
AdWords API Workshops – All rights reserved
36. Полезные ресурсы
Reporting Basic Guide - http://goo.gl/07KaHv
Reporting Concept - http://goo.gl/FoOIQ3
Structure Reports - http://goo.gl/Jt4gDZ
Demo applications - http://goo.gl/hMnsm5
AdWords API Workshops – All rights reserved