AwReporting tool introduction (russian)

AwReporting
Новый инструмент для разработчиков

Gustavo Moreira, Google Inc
Danial Klimkin, Google Inc.

План
● Что, как и зачем
● Описание
● Почему это важно?
● Первые шаги
● Что дальше?


Что, как и зачем
Что на самом деле делает AwReporting


Проблема:
● Большое количество аккаунтов
● Много различной информации
● Трудности масштабирования
● Необходимость анализа


Defining AwReporting

Решение
● Использование API
● Ежедневная загрузка
● Локальные данные
● База для расширений



AwReporting -- новый инструмент
● Многопоточная загрузка
● Сохранение в SQL БД*
● … или в MongoDB
● Реализует работу с API
● Предоставляет Java объекты
* для сохранения используется Hibernate



AwReporting -- новый инструмент
● Open Source!
● Расширяем
● Выполняется из командной строки
● Интегрируется в вашу платформу



Описание AwReporting


Как это работает?

In the cloud

Custom Java
code

AdWords
API

Java

AwReporting

Properties
file
Local file

Downloaders

AwReporting
Model

Part of the tool
Internal to the tool
User-specific

DB

Custom
platform
Any language

Составные части

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

AwReporting
main

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

Реализует
хранение объектов

Entity persisters

Генерирует
объекты из отчетов

Report definitions

Локальная БД


Database

A Quick Overview

Описания отчетов (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;


A Quick Overview

@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

A Quick Overview

AdWords
API

Report
(CSV)

Report
definition

Java
bean
AwReporting

Report
definition

Persister

Java
bean

Report
definition
DB
Combined

A Quick Overview

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


A Quick Overview

“Хранители” объектов (2/2)
● Реализует интерфейс с БД
● Обрабатывает ошибки
● Type safe


A Quick Overview

Основной модуль (1/3)
● Управляет выполнением
● Реализует параллелизм
● Запускается из командной строки
● Настраиваемый
● Использует /только/ OAuth 2.0


A Quick Overview

● Все настройки в конфигурационном файле
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,...


A Quick Overview

● Выполнение из командной строки
$ 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

Область применения
Почему это важно?


Меньше “время вхождения”
● Готовое решение для работы с отчетами
● Легко настроить и запустить
● Используется последняя версия API
● Легко расширять


Possible Applications

Пример работы с API
● Следует всем рекомендациям по работе с API
● Построен на основе реальных практик
● Разработан и поддерживается Google DA
● Еще больше возможностей в будущем



Начальная точка
● Можно забыть про отчеты
● Докальная информация более доступна
● Первые шаги в сторону автоматизации
● Автогенерация отчетов для клиентов?



Первые шаги


● Исходный код доступен на GitHub:
○

http://goo.gl/TQxIdN *

● Описание сборки в комплекте
● (еще раз) Open Source!

* Список материалов собран на последнем слайде

Getting Started

● Используется Maven
$ mvn eclipse:eclipse

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


Getting Started

Системные требования
● AdWords developer token
● БД (MySQL)
● Java 6


Getting Started

Что нужно знать (для модификации)
● Java 6 - Annotations, Generics, etc.
● Maven - build
● Spring framework, Hibernate - beans and database


Getting Started

Расширение AwReporting
● Для добавления нового отчета -- описание отчета
● Настройка -- файл конфигурации
● Поля отчетов -- аннотации классов
● Доступ к данным -- через “хранители”


Getting Started

Что дальше?
Now what?


Локальные данные
● Создание собственных отчетов
● Оптимизация на основе данных
● Авто-генерация отчетов в PDF
● Интеграция с вашей системой


Taking the Extra Step

Использование AwReporting
● Работа с другими платформами
● Не обязательно использовать Java
● Инструмент как пример реализации



“Автоматизируй это”
● Для автоматизации нужны данные
● Управление кампаниями, ключевыми словами и т.д.
● Обратная связь для оптимизации
● История результатов



Полезные ресурсы
AwReporting:
https://github.com/googleads/aw-reporting
Документация по отчетам: https://developers.google.
com/adwords/api/docs/appendix/reports


Вопросы?
Спасибо!


AwReporting tool introduction (russian)

More Related Content

Similar to AwReporting tool introduction (russian) (20)

More from marcwan (20)

AwReporting tool introduction (russian)