Your SlideShare is downloading. ×
0
AdWords API Workshops – All rights reserved
AwReporting
Новый инструмент для разработчиков

Gustavo Moreira, Google Inc
Danial Klimkin, Google Inc.
AdWords API Worksh...
План
● Что, как и зачем
● Описание
● Почему это важно?
● Первые шаги
● Что дальше?

AdWords API Workshops – All rights res...
Что, как и зачем
Что на самом деле делает AwReporting

AdWords API Workshops – All rights reserved
Проблема:
● Большое количество аккаунтов
● Много различной информации
● Трудности масштабирования
● Необходимость анализа
...
Решение
● Использование API
● Ежедневная загрузка
● Локальные данные
● База для расширений

AdWords API Workshops – All ri...
AwReporting -- новый инструмент
● Многопоточная загрузка
● Сохранение в SQL БД*
● … или в MongoDB
● Реализует работу с API...
AwReporting -- новый инструмент
● Open Source!
● Расширяем
● Выполняется из командной строки
● Интегрируется в вашу платфо...
Описание AwReporting

AdWords API Workshops – All rights reserved
Как это работает?

In the cloud

Custom Java
code

AdWords
API

Java

AwReporting

Properties
file
Local file
AdWords API ...
Составные части

Следит за
выполнением

AwReporting
main

● Описания отчетов
● “Хранители” объектов
● Основной модуль

Реа...
Описания отчетов (1/3)
● Java Beans with annotations
Java

@Entity
@Table(name = "AW_ReportAd")
@CsvReport(value = AD_PERF...
Описания отчетов (2/3)
@CsvReport(value = AD_PERFORMANCE_REPORT)

● Название отчета из документации:
○ https://developers....
Описания отчетов (3/3)
AdWords
API

Report
(CSV)

Report
definition

Java
bean
AwReporting

Report
definition

Persister

...
“Хранители” объектов (1/2)
● Интерфейс для работы с объектами
● Методы для сохранения, удаления и загрузки
● Можно использ...
“Хранители” объектов (2/2)
● Реализует интерфейс с БД
● Обрабатывает ошибки
● Type safe

AdWords API Workshops – All right...
Основной модуль (1/3)
● Управляет выполнением
● Реализует параллелизм
● Запускается из командной строки
● Настраиваемый
● ...
Основной модуль (2/3)
● Все настройки в конфигурационном файле
Properties
mccAccountId=<MCC>
developerToken=<Developer Tok...
Основной модуль (3/3)
● Выполнение из командной строки
$ java -Xmx512m -jar aw-report-tool.jar
-startDate <some date> 
-en...
Область применения
Почему это важно?

AdWords API Workshops – All rights reserved
Меньше “время вхождения”
● Готовое решение для работы с отчетами
● Легко настроить и запустить
● Используется последняя ве...
Пример работы с API
● Следует всем рекомендациям по работе с API
● Построен на основе реальных практик
● Разработан и подд...
Начальная точка
● Можно забыть про отчеты
● Докальная информация более доступна
● Первые шаги в сторону автоматизации
● Ав...
Первые шаги

AdWords API Workshops – All rights reserved
Первые шаги
● Исходный код доступен на GitHub:
○

http://goo.gl/TQxIdN *

● Описание сборки в комплекте
● (еще раз) Open S...
Первые шаги
● Используется Maven
$ mvn eclipse:eclipse

● Два модуля (проекта)

AdWords API Workshops – All rights reserve...
Системные требования
● AdWords developer token
● БД (MySQL)
● Java 6

AdWords API Workshops – All rights reserved

Getting...
Что нужно знать (для модификации)
● Java 6 - Annotations, Generics, etc.
● Maven - build
● Spring framework, Hibernate - b...
Расширение AwReporting
● Для добавления нового отчета -- описание отчета
● Настройка -- файл конфигурации
● Поля отчетов -...
Что дальше?
Now what?

AdWords API Workshops – All rights reserved
Локальные данные
● Создание собственных отчетов
● Оптимизация на основе данных
● Авто-генерация отчетов в PDF
● Интеграция...
Использование AwReporting
● Работа с другими платформами
● Не обязательно использовать Java
● Инструмент как пример реализ...
“Автоматизируй это”
● Для автоматизации нужны данные
● Управление кампаниями, ключевыми словами и т.д.
● Обратная связь дл...
Полезные ресурсы
AwReporting:
https://github.com/googleads/aw-reporting
Документация по отчетам: https://developers.google...
Вопросы?
Спасибо!

AdWords API Workshops – All rights reserved
AdWords API Workshops – All rights reserved
Upcoming SlideShare
Loading in...5
×

AwReporting tool introduction (russian)

184

Published on

Published in: Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total Views
184
On Slideshare
0
From Embeds
0
Number of Embeds
0
Actions
Shares
0
Downloads
4
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Transcript of "AwReporting tool introduction (russian)"

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

    Clipping is a handy way to collect important slides you want to go back to later.

×