Russian Intraoperative Naming Test: a Standardized Tool to ...
AwReporting tool introduction (russian)
-
Upload
marcwan -
Category
Technology
-
view
135 -
download
1
description
Transcript of AwReporting tool introduction (russian)
AdWords API Workshops – All rights reserved
AdWords API Workshops – All rights reserved
AwReportingНовый инструмент для разработчиков
Gustavo Moreira, Google IncDanial Klimkin, Google Inc.
AdWords API Workshops – All rights reserved
● Что, как и зачем
● Описание
● Почему это важно?
● Первые шаги
● Что дальше?
План
AdWords API Workshops – All rights reserved
Что, как и зачемЧто на самом деле делает AwReporting
AdWords API Workshops – All rights reserved Defining AwReporting
● Большое количество аккаунтов
● Много различной информации
● Трудности масштабирования
● Необходимость анализа
Проблема:
AdWords API Workshops – All rights reserved
● Использование API
● Ежедневная загрузка
● Локальные данные
● База для расширений
Решение
Defining AwReporting
AdWords API Workshops – All rights reserved
● Многопоточная загрузка
● Сохранение в SQL БД*
● … или в MongoDB
● Реализует работу с API
● Предоставляет Java объекты
* для сохранения используется Hibernate
AwReporting -- новый инструмент
Defining AwReporting
AdWords API Workshops – All rights reserved
● Open Source!
● Расширяем
● Выполняется из командной строки
● Интегрируется в вашу платформу
AwReporting -- новый инструмент
Defining AwReporting
AdWords API Workshops – All rights reserved
Описание AwReporting
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
AdWords API Workshops – All rights reserved
● Описания отчетов
● “Хранители” объектов
● Основной модуль
Составные части
DatabaseЛокальная БД
Report definitionsГенерирует объекты из отчетов
Entity persistersРеализует хранение объектов
AwReporting main
Следит за выполнением
A Quick Overview
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
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
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
AdWords API Workshops – All rights reserved
● Интерфейс для работы с объектами
● Методы для сохранения, удаления и загрузки
● Можно использовать для доступа в БД
“Хранители” объектов (1/2)
A Quick Overview
AdWords API Workshops – All rights reserved
● Реализует интерфейс с БД
● Обрабатывает ошибки
● Type safe
“Хранители” объектов (2/2)
A Quick Overview
AdWords API Workshops – All rights reserved
● Управляет выполнением
● Реализует параллелизм
● Запускается из командной строки
● Настраиваемый
● Использует /только/ OAuth 2.0
Основной модуль (1/3)
A Quick Overview
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
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
AdWords API Workshops – All rights reserved
Область примененияПочему это важно?
AdWords API Workshops – All rights reserved
Меньше “время вхождения”
● Готовое решение для работы с отчетами
● Легко настроить и запустить
● Используется последняя версия API
● Легко расширять
Possible Applications
AdWords API Workshops – All rights reserved
● Следует всем рекомендациям по работе с API
● Построен на основе реальных практик
● Разработан и поддерживается Google DA
● Еще больше возможностей в будущем
Пример работы с API
Possible Applications
AdWords API Workshops – All rights reserved
● Можно забыть про отчеты
● Докальная информация более доступна
● Первые шаги в сторону автоматизации
● Автогенерация отчетов для клиентов?
Начальная точка
Possible Applications
AdWords API Workshops – All rights reserved
Первые шаги
AdWords API Workshops – All rights reserved
Первые шаги
● Исходный код доступен на GitHub:○ http://goo.gl/TQxIdN *
● Описание сборки в комплекте
● (еще раз) Open Source!
* Список материалов собран на последнем слайдеGetting Started
AdWords API Workshops – All rights reserved
● Используется Maven
$ mvn eclipse:eclipse
● Два модуля (проекта)
Первые шаги
Getting Started
AdWords API Workshops – All rights reserved
● AdWords developer token
● БД (MySQL)
● Java 6
Системные требования
Getting Started
AdWords API Workshops – All rights reserved
● Java 6 - Annotations, Generics, etc.
● Maven - build
● Spring framework, Hibernate - beans and database
Что нужно знать (для модификации)
Getting Started
AdWords API Workshops – All rights reserved
● Для добавления нового отчета -- описание отчета
● Настройка -- файл конфигурации
● Поля отчетов -- аннотации классов
● Доступ к данным -- через “хранители”
Расширение AwReporting
Getting Started
AdWords API Workshops – All rights reserved
Что дальше?Now what?
AdWords API Workshops – All rights reserved
AdWords API Workshops – All rights reserved
Локальные данные
● Создание собственных отчетов
● Оптимизация на основе данных
● Авто-генерация отчетов в PDF
● Интеграция с вашей системой
Taking the Extra Step
AdWords API Workshops – All rights reserved
● Работа с другими платформами
● Не обязательно использовать Java
● Инструмент как пример реализации
Использование AwReporting
Taking the Extra Step
AdWords API Workshops – All rights reserved
● Для автоматизации нужны данные
● Управление кампаниями, ключевыми словами и т.д.
● Обратная связь для оптимизации
● История результатов
“Автоматизируй это”
Taking the Extra Step
AdWords API Workshops – All rights reserved
Полезные ресурсыAwReporting:https://github.com/googleads/aw-reportingДокументация по отчетам: https://developers.google.com/adwords/api/docs/appendix/reports
AdWords API Workshops – All rights reserved
Вопросы?Спасибо!
AdWords API Workshops – All rights reserved