awreporting tool introduction (russian)
DESCRIPTION
TRANSCRIPT
![Page 1: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/1.jpg)
AdWords API Workshops – All rights reserved
![Page 2: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/2.jpg)
AdWords API Workshops – All rights reserved
AwReportingНовый инструмент для разработчиков
Gustavo Moreira, Google IncDanial Klimkin, Google Inc.
![Page 3: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/3.jpg)
AdWords API Workshops – All rights reserved
● Что, как и зачем
● Описание
● Почему это важно?
● Первые шаги
● Что дальше?
План
![Page 4: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/4.jpg)
AdWords API Workshops – All rights reserved
Что, как и зачемЧто на самом деле делает AwReporting
![Page 5: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/5.jpg)
AdWords API Workshops – All rights reserved Defining AwReporting
● Большое количество аккаунтов
● Много различной информации
● Трудности масштабирования
● Необходимость анализа
Проблема:
![Page 6: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/6.jpg)
AdWords API Workshops – All rights reserved
● Использование API
● Ежедневная загрузка
● Локальные данные
● База для расширений
Решение
Defining AwReporting
![Page 7: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/7.jpg)
AdWords API Workshops – All rights reserved
● Многопоточная загрузка
● Сохранение в SQL БД*
● … или в MongoDB
● Реализует работу с API
● Предоставляет Java объекты
* для сохранения используется Hibernate
AwReporting -- новый инструмент
Defining AwReporting
![Page 8: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/8.jpg)
AdWords API Workshops – All rights reserved
● Open Source!
● Расширяем
● Выполняется из командной строки
● Интегрируется в вашу платформу
AwReporting -- новый инструмент
Defining AwReporting
![Page 9: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/9.jpg)
AdWords API Workshops – All rights reserved
Описание AwReporting
![Page 10: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/10.jpg)
AdWords API Workshops – All rights reserved
Как это работает?
Properties file
AwReporting
Downloaders
DBAwReporting
Model
AdWords API
Custom platform
Custom Java code
In the cloud
Part of the tool
Internal to the tool
User-specific
Local file
Java
Any language
![Page 11: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/11.jpg)
AdWords API Workshops – All rights reserved
● Описания отчетов
● “Хранители” объектов
● Основной модуль
Составные части
DatabaseЛокальная БД
Report definitionsГенерирует объекты из отчетов
Entity persistersРеализует хранение объектов
AwReporting main
Следит за выполнением
A Quick Overview
![Page 12: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/12.jpg)
AdWords API Workshops – All rights reserved
Описания отчетов (1/3)
@Entity @Table(name = "AW_ReportAd")
@CsvReport(value = AD_PERFORMANCE_REPORT) // CSV Reportpublic class ReportAd extends Report {
// Field annotations@Column(name = "AD_ID")
@CsvField(value = "Ad ID", reportField = "Id") public Long adId;
Java
● Java Beans with annotations
A Quick Overview
![Page 13: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/13.jpg)
AdWords API Workshops – All rights reserved
Описания отчетов (2/3)
@CsvReport(value = AD_PERFORMANCE_REPORT)
@CsvField(value = "Ad ID", reportField = "Id")
● Название отчета из документации:○ https://developers.google.com/adwords/api/docs/appendix/reports *
* Resources will be available in the final slides
● Отображаемое имя (display name) и имя поля в запросе (report field name)
A Quick Overview
![Page 14: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/14.jpg)
AdWords API Workshops – All rights reserved
Описания отчетов (3/3)
AdWords API
Report (CSV) AwReporting
Report definition
DB
Java bean
Report definition
Persister
Combined
Java bean
Report definition
A Quick Overview
![Page 15: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/15.jpg)
AdWords API Workshops – All rights reserved
● Интерфейс для работы с объектами
● Методы для сохранения, удаления и загрузки
● Можно использовать для доступа в БД
“Хранители” объектов (1/2)
A Quick Overview
![Page 16: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/16.jpg)
AdWords API Workshops – All rights reserved
● Реализует интерфейс с БД
● Обрабатывает ошибки
● Type safe
“Хранители” объектов (2/2)
A Quick Overview
![Page 17: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/17.jpg)
AdWords API Workshops – All rights reserved
● Управляет выполнением
● Реализует параллелизм
● Запускается из командной строки
● Настраиваемый
● Использует /только/ OAuth 2.0
Основной модуль (1/3)
A Quick Overview
![Page 18: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/18.jpg)
AdWords API Workshops – All rights reserved
● Все настройки в конфигурационном файле
Основной модуль (2/3)
mccAccountId=<MCC>developerToken=<Developer Token>...aw.report.model.db.mysql.driver=com.mysql.jdbc.Driver...aw.report.downloader.num.threads=20...// Define the reports fields to be selectedKEYWORDS_PERFORMANCE_REPORT=ExternalCustomerId,Date,...
Properties
A Quick Overview
![Page 19: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/19.jpg)
AdWords API Workshops – All rights reserved
● Выполнение из командной строки
Основной модуль (3/3)
$ java -Xmx512m -jar aw-report-tool.jar -startDate <some date> \-endDate <some date> \-file <properties-location>/configuration.properties
● startDate, endDate: yyyyMMdd (формат даты)● file: файл_настроек
A Quick Overview
![Page 20: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/20.jpg)
AdWords API Workshops – All rights reserved
Область примененияПочему это важно?
![Page 21: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/21.jpg)
AdWords API Workshops – All rights reserved
Меньше “время вхождения”
● Готовое решение для работы с отчетами
● Легко настроить и запустить
● Используется последняя версия API
● Легко расширять
Possible Applications
![Page 22: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/22.jpg)
AdWords API Workshops – All rights reserved
● Следует всем рекомендациям по работе с API
● Построен на основе реальных практик
● Разработан и поддерживается Google DA
● Еще больше возможностей в будущем
Пример работы с API
Possible Applications
![Page 23: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/23.jpg)
AdWords API Workshops – All rights reserved
● Можно забыть про отчеты
● Докальная информация более доступна
● Первые шаги в сторону автоматизации
● Автогенерация отчетов для клиентов?
Начальная точка
Possible Applications
![Page 24: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/24.jpg)
AdWords API Workshops – All rights reserved
Первые шаги
![Page 25: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/25.jpg)
AdWords API Workshops – All rights reserved
Первые шаги
● Исходный код доступен на GitHub:○ http://goo.gl/TQxIdN *
● Описание сборки в комплекте
● (еще раз) Open Source!
* Список материалов собран на последнем слайдеGetting Started
![Page 26: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/26.jpg)
AdWords API Workshops – All rights reserved
● Используется Maven
$ mvn eclipse:eclipse
● Два модуля (проекта)
Первые шаги
Getting Started
![Page 27: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/27.jpg)
AdWords API Workshops – All rights reserved
● AdWords developer token
● БД (MySQL)
● Java 6
Системные требования
Getting Started
![Page 28: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/28.jpg)
AdWords API Workshops – All rights reserved
● Java 6 - Annotations, Generics, etc.
● Maven - build
● Spring framework, Hibernate - beans and database
Что нужно знать (для модификации)
Getting Started
![Page 29: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/29.jpg)
AdWords API Workshops – All rights reserved
● Для добавления нового отчета -- описание отчета
● Настройка -- файл конфигурации
● Поля отчетов -- аннотации классов
● Доступ к данным -- через “хранители”
Расширение AwReporting
Getting Started
![Page 30: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/30.jpg)
AdWords API Workshops – All rights reserved
Что дальше?Now what?
AdWords API Workshops – All rights reserved
![Page 31: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/31.jpg)
AdWords API Workshops – All rights reserved
Локальные данные
● Создание собственных отчетов
● Оптимизация на основе данных
● Авто-генерация отчетов в PDF
● Интеграция с вашей системой
Taking the Extra Step
![Page 32: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/32.jpg)
AdWords API Workshops – All rights reserved
● Работа с другими платформами
● Не обязательно использовать Java
● Инструмент как пример реализации
Использование AwReporting
Taking the Extra Step
![Page 33: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/33.jpg)
AdWords API Workshops – All rights reserved
● Для автоматизации нужны данные
● Управление кампаниями, ключевыми словами и т.д.
● Обратная связь для оптимизации
● История результатов
“Автоматизируй это”
Taking the Extra Step
![Page 34: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/34.jpg)
AdWords API Workshops – All rights reserved
Полезные ресурсыAwReporting:https://github.com/googleads/aw-reportingДокументация по отчетам: https://developers.google.com/adwords/api/docs/appendix/reports
![Page 35: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/35.jpg)
AdWords API Workshops – All rights reserved
Вопросы?Спасибо!
![Page 36: AwReporting tool introduction (russian)](https://reader034.vdocuments.site/reader034/viewer/2022051514/54bf19df4a7959db3a8b45d8/html5/thumbnails/36.jpg)
AdWords API Workshops – All rights reserved