awreporting tool introduction (russian)


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

Gustavo Moreira, Google IncDanial Klimkin, Google Inc.


● Что, как и зачем

● Описание

● Почему это важно?

● Первые шаги

● Что дальше?

План


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

AdWords API Workshops – All rights reserved Defining AwReporting

● Большое количество аккаунтов

● Много различной информации

● Трудности масштабирования

● Необходимость анализа

Проблема:


● Использование API

● Ежедневная загрузка

● Локальные данные

● База для расширений

Решение

Defining AwReporting


● Многопоточная загрузка

● Сохранение в SQL БД*

● … или в MongoDB

● Реализует работу с API

● Предоставляет Java объекты

* для сохранения используется Hibernate

AwReporting -- новый инструмент



● Open Source!

● Расширяем

● Выполняется из командной строки

● Интегрируется в вашу платформу

AwReporting -- новый инструмент



Описание AwReporting


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

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


● Описания отчетов

● “Хранители” объектов

● Основной модуль

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

DatabaseЛокальная БД

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

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

AwReporting main

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

A Quick Overview


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



@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

https://developers.google.com/adwords/api/docs/appendix/reports




AdWords API

Report (CSV) AwReporting

Report definition

DB

Java bean

Report definition

Persister

Combined

Java bean

Report definition

A Quick Overview


● Интерфейс для работы с объектами

● Методы для сохранения, удаления и загрузки

● Можно использовать для доступа в БД

“Хранители” объектов (1/2)

A Quick Overview


● Реализует интерфейс с БД

● Обрабатывает ошибки

● Type safe

“Хранители” объектов (2/2)

A Quick Overview


● Управляет выполнением

● Реализует параллелизм

● Запускается из командной строки

● Настраиваемый

● Использует /только/ OAuth 2.0

Основной модуль (1/3)

A Quick Overview


● Все настройки в конфигурационном файле


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


● Выполнение из командной строки


$ 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

● Построен на основе реальных практик

● Разработан и поддерживается Google DA

● Еще больше возможностей в будущем

Пример работы с API



● Можно забыть про отчеты

● Докальная информация более доступна

● Первые шаги в сторону автоматизации

● Автогенерация отчетов для клиентов?

Начальная точка



Первые шаги



● Исходный код доступен на GitHub:○ http://goo.gl/TQxIdN *

● Описание сборки в комплекте

● (еще раз) Open Source!

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

http://goo.gl/TQxIdN

http://goo.gl/TQxIdN


● Используется 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


● Работа с другими платформами

● Не обязательно использовать Java

● Инструмент как пример реализации

Использование AwReporting



● Для автоматизации нужны данные

● Управление кампаниями, ключевыми словами и т.д.

● Обратная связь для оптимизации

● История результатов

“Автоматизируй это”



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

https://github.com/googleads/aw-reporting

https://github.com/googleads/aw-reporting





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

awreporting tool introduction (russian)

Technology