API

Что такое API myTarget

Программный интерфейс к рекламной платформе, объединяющей аудиторию

крупнейших в России и СНГ сервисов и социальных сетей.

• Более 400 клиентов получили собственные ключи.

• Более 50 из них – приложения, предоставляющие сервис сторонним

пользователям

• Более 60% денежного оборота проходит через API-пользователей

• Несколько миллиардов запросов к API ежемесячно

Основные возможности

• Создание объявлений:

– загрузка изображений и html5

– создание баннеров

– создание рекламных кампаний с учётом всех возможных таргетингов

– получение прогнозного охвата от уровня ставки

• Получение статистики в разных разрезах и разной детализации по

кампаниям и баннерам

• Загрузка и управление собственными аудиторными списками,

счётчиками

• Редактирование собственного профиля

• Для агентств:

– Управление клиентами

– Перевод денежных средств

Как получить доступ

1. Зайти в личный кабинет myTarget под необходимой учётной записью

2. Открыть форму службы поддержки

3. Отправить заявку, в которой указать:

– Контакты лица, отвечающего за техническое обеспечение подключения и сопровождения работ с API: имя, e-mail и, опционально, телефон

– Зачем будет использоваться API

4. Читать документацию: https://target.my.com/adv/api-marketing/

Доступ предоставляется только юридическим лицам – прямым рекламодателям и агентствам.

Грабли №1. Обновление токенов

Получение токенов в простейшем виде:

grant_type=client_credentials&client_id={client_id}&client_secret={client_secret}

на target.my.com/api/v2/oauth2/token.json

Можно:

Получать новый токен перед каждым новым запросом

Получать новый токен когда захочется

Получать новый токен раз в минуту

Грабли №1. Обновление токенов

Получение токенов в простейшем виде:

grant_type=client_credentials&client_id={client_id}&client_secret={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}

Грабли №2. Подключение агентств

Можно:

1. Получить токен для агентства с помощью схемы Client Credentials Grant

2. Запросить с помощью него список кампаний какого-нибудь клиента

3. Получить ошибку Access denied и написать в службу поддержки

Грабли №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!!! * количество клиентов

Новинки 2015-2016

• Локальный геотаргетинг

• HTML5 баннеры

• Множество новых пакетов, в том числе с возможностью выбора

платформ

• Изменение utm-меток: вместо targetmailru – mytarget

• Загрузка и обновление пользовательских списков данных

• Параметры last_stat_updated и updated_gte в banners.json

• Внутренняя оптимизация запросов на banners и campaigns

• PROJECTION v2

Программа сертификации

Скорректировали правила сертификации API приложений

– Обязательное использование схемы Authorization Code Grant и

Agency Client Credentials Grant

– Обязательна работа с быстрой статистикой

__________________________________________________________

Добавлена программа сертификации технологичных агентств

Ближайшие планы

• Управление приложениями пользователем

• Изменения в троттлинге

• Управление списками данных

• Расширение таргетинга геолокации

• Документация

Группа в facebook:https://www.facebook.com/groups

/targetmailapi/

Служба поддержки: support_target@corp.my.com