Обзор API myTarget: - Основные возможности API; - Как получить доступ к API; - Частые ошибки работы с API и их решение; - Последнии новинки и планы на ближайшее будущее.

1. API

2. Что такое API myTarget
Программный интерфейс к рекламной платформе, объединяющей аудиторию
крупнейших в России и СНГ сервисов и социальных сетей.
• Более 400 клиентов получили собственные ключи.
• Более 50 из них – приложения, предоставляющие сервис сторонним
пользователям
• Более 60% денежного оборота проходит через API-пользователей
• Несколько миллиардов запросов к API ежемесячно

3. Основные возможности
• Создание объявлений:
– загрузка изображений и html5
– создание баннеров
– создание рекламных кампаний с учётом всех возможных таргетингов
– получение прогнозного охвата от уровня ставки
• Получение статистики в разных разрезах и разной детализации по
кампаниям и баннерам
• Загрузка и управление собственными аудиторными списками,
счётчиками
• Редактирование собственного профиля
• Для агентств:
– Управление клиентами
– Перевод денежных средств

4. Как получить доступ
1. Зайти в личный кабинет myTarget под необходимой учётной записью
2. Открыть форму службы поддержки
3. Отправить заявку, в которой указать:
– Контакты лица, отвечающего за техническое обеспечение
подключения и сопровождения работ с API: имя, e-mail и,
опционально, телефон
– Зачем будет использоваться API
4. Читать документацию: https://target.my.com/adv/api-marketing/
Доступ предоставляется только юридическим лицам – прямым
рекламодателям и агентствам.

5. Грабли №1. Обновление токенов
Получение токенов в простейшем виде:
grant_type=client_credentials&client_id={client_id}&client_secret=
{client_secret}
на target.my.com/api/v2/oauth2/token.json
Можно:
Получать новый токен перед каждым новым запросом
Получать новый токен когда захочется
Получать новый токен раз в минуту

6. Грабли №1. Обновление токенов
Получение токенов в простейшем виде:
grant_type=client_credentials&client_id={client_id}&client_secre
t={client_secret}
на target.my.com/api/v2/oauth2/token.json
Можно:
Получать новый токен перед каждым новым запросом
Получать новый токен когда захочется
Получать новый токен раз в минуту
Нужно смотреть expires_in и использовать обновление токена:
grant_type=refresh_token&refresh_token={refresh_token}&client_id
={client_id}&client_secret={client_secret}

7. Грабли №2. Подключение агентств
Можно:
1. Получить токен для агентства с помощью схемы Client Credentials Grant
2. Запросить с помощью него список кампаний какого-нибудь клиента
3. Получить ошибку Access denied и написать в службу поддержки

8. Грабли №2. Подключение агентств
Можно:
1. Получить токен для агентства с помощью схемы Client Credentials Grant
2. Запросить с помощью него список кампаний какого-нибудь клиента
3. Получить ошибку Access denied и написать в службу поддержки
Нужно:
1. Получить токен для агентства с помощью схемы Client Credentials Grant
2. Получить список клиентов (id, логины) – запрос GET /api/v1/clients.json
3. Получить токен для клиента с помощью Agency Client Credentials Grant
4. Не забывать про рефреш токена
5. …
6. PROFIT!!! * количество клиентов

9. Новинки 2015-2016
• Локальный геотаргетинг
• HTML5 баннеры
• Множество новых пакетов, в том числе с возможностью выбора
платформ
• Изменение utm-меток: вместо targetmailru – mytarget
• Загрузка и обновление пользовательских списков данных
• Параметры last_stat_updated и updated_gte в banners.json
• Внутренняя оптимизация запросов на banners и campaigns
• PROJECTION v2

10. Программа сертификации
Скорректировали правила сертификации API приложений
– Обязательное использование схемы Authorization Code Grant и
Agency Client Credentials Grant
– Обязательна работа с быстрой статистикой
__________________________________________________________
Добавлена программа сертификации технологичных агентств

11. Ближайшие планы
• Управление приложениями пользователем
• Изменения в троттлинге
• Управление списками данных
• Расширение таргетинга геолокации
• Документация

12. Группа в facebook:
https://www.facebook.com/groups
/targetmailapi/
Служба поддержки:
support_target@corp.my.com