myTarget API

Уважаемые пользователи API myTarget,22 июля в 11:00 по московскому времени планируются профилактические работы. В это время может быть недоступна статистика. Приносим извинения за доставленные неудобства.

Уважаемые пользователи API myTarget,мы планируем перейти на третью версию статистики к 1 сентября 2021 года (точную дату перехода объявим дополнительно)./api/v3/statistics/{banners|campaigns|users}/day.jsonОтличительная особенность – ресурс возвращает суммарную статистику за выбранный период по аккаунтам, кампаниям, баннерам с пагинацией.Новый метод уже доступен и вы можете начать им пользоваться. Документация по ссылке.

Уважаемые пользователи, завтра, 8 июня в 13:00 планируются профилактические работы. Приблизительная длительность составит один час, в это время может быть недоступна статистика. Приносим извинения за неудобства.

Теперь вы можете добавить существующего клиента в своё агентство используя username.Пример такого запроса: POST https://target.my.com/api/v2/agency/clients.json { "access_type":"full_access", "user": { "username":"client_username", "additional_emails": ["test@mail.ru"], "additional_info": { "client_info": "Заметка", "client_name": "Василий Иванов", } } }Документация: https://target.my.com/doc/api/ru/resource/AgencyClients

В ближайшее время добавим шаг при установке общего ограничения бюджета budget_limit в настройках кампании. Изменение должно быть кратно значению budget_limit_step из /api/v2/currencies.json для валюты пользователя.Документация: https://target.my.com/doc/api/ru/resource/Campaign

Напоминаем, что теперь создавать рекламные кампании в мультиформатах и тизерах можно только новым способом, с помощью вариантов формата (patterns) Подробная схема создания с примером: https://t.me/mytarget_api/24Мы подготовили для вас несколько инструкций "было-стало" для вашего удобства:Мультиформат https://pastebin.com/7dvrfXZsТизеры: https://pastebin.com/aKFVbsR8Мультиформат аппы: https://pastebin.com/ucALBpmCКарусель сайты: https://pastebin.com/aTfn10MeКарусель аппы: https://pastebin.com/24Gi7Zvq

Мы продолжаем переключение пакетов мультиформата на новую форму создания баннеров. В понедельник, 21 декабря, переключим следующие пакеты:807 tt_crossdevice_site_multiformat_cpm_goal_ReachTrafficOffline811 tt_crossdevice_site_multiformat_cpc_goal_TrafficOffline А в течение недели все остальные, включая тизерные пакеты 1029, 1030.Так же появилась возможность создавать карусельные баннеры, все соответствующие пакеты настроены на работу с новым API.

Работа по новому API для пакетов с флагом patterns_migration.Мы продолжаем переход с баннерного формата на варианты формата (pattern). С 13 ноября у пакетов появится флаг patterns_migration — эти пакеты вы можете переключить на работу по новому API. На переходный период необходимо отправлять ВСЕ обязательные роли всех паттернов. Для большинства пакетов еще некоторое время будет доступна работа и по старому, и по новому API.Для мультиформата будет доступна только работа по новому API, обратная миграция с текущими форматами перестанет работать. Это произойдет до конца ноября, точную дату переключения мультиформата мы сообщим позже.Мы рекомендуем перейти на новое API и отладить работу уже сейчас, чтобы быть готовыми к отключению старого API.

Обращаем ваше внимание, что с 21 октября прекращаем поддержку быстрой статистики по уникальным пользователям /api/v2/statistics/uniquestat/{banners|campaigns|users}.jsonВсе доступные виды статистики по-прежнему описаны в нашей документации по ссылке https://target.my.com/adv/api-marketing/doc/stat-v2

Уже сейчас вам доступен новый способ в нашей песочнице для отладки API запросов: https://target-sandbox.my.com/ (зарегистрируйтесь и присылайте запрос на выдачу доступа к API песочницы). Id пакетов с вариантами формата: 1995,1994 - для сайтов и 2408,2410 - для мобильных приложений. Ниже приведена инструкция:Создаем кампанию в пакете 1995, хотим таргетировать ее на все места размещения.1. Идем в API пакетов https://target.my.com/api/v2/packages.json?fields=id,name,description,options для пакета 1995Смотрим pads в options пакета:https://pastebin.com/GMS2JRJh2. В секции «паттерн» получаем для каждого места размещения список вариантов формата (patterns), которые поддерживаются на указанном месте размещения. Например, место размещения Десктоп Лента, pad:242743 — поддерживается только вариант формата id=34Для места размещения Десктоп-МРГ-Колонка, pad:146590 — поддерживаются варианты формата с id=2,3,64,513. Чтобы получить список полей для вариантов формата, идем в API паттернов:https://target.my.com/api/v2/banner_patterns.json?limit=50Например, для варианта формата 34 получаем список полей:https://pastebin.com/LsNGXcVK4. Требования к полям получаем в API полей, по имени ролиhttps://target.my.com/api/v2/banner_fields.jsonНапример, для роли image_1080x607 в поле format указаны минимальные/максимальные размеры картинки, тип картинки"max_height": 607,"max_width": 1080,"min_height": 607,"min_width": 1080,"type": "static"5. Далее создаем баннер и кампанию как обычно, передавая в запросе в поле banners список полей для вариантов формата (patterns). Например, так:https://pastebin.com/7Wa4eteNБудет создан баннер, соответствующий варианту формата 2 и 51, сможет показываться на местах размещения, где есть хотя бы один из этих вариантов формата: 146590, 242746, 242744, 242745, 242742, 242750, 242748

Мы обновили форму создания баннеров: с 26 октября вместо баннерного формата будут использоваться варианты формата (pattern) в пакетах содержащих флаг patterns.Вариант формата — это набор полей, необходимый для отображения баннера на площадках myTarget. Для некоторых типов баннеров, таких как HTML5 баннер, вариант формата совпадает с текущим форматом. В мультиформате формат разделяется на несколько вариантов формата.Например, сейчас мультиформат состоит из трех картинок (иконка 256х256, картинка 1080х607 и картинка 600х600), двух обязательных текстовых полей (Заголовок и Описание), кнопки call-to-action и опционального поля «Юр.инфо». Однако на большинстве площадок myTarget не используются все эти поля одновременно.Каждый вариант формата будет соответствовать именно тому набору полей, которые показываются на конкретной площадке. Для Ленты в «Одноклассниках» или «ВКонтакте» вариант формата будет содержать иконку 256х256, картинку 1080х607, заголовок, текст, кнопку и, опционально, юр.инфо. Картинка 600x600 для этой площадки не нужна. Для такой площадки, как Главная Mail.ru 300х300 не нужна иконка 256х256, соответственно, это поле не обязательно к заполнению для создания варианта формата, способного показываться на этой площадке.Таким образом, меняется состав полей, которые нужны для создания баннеров.В "options" пакета в "pads" дополнительно к id мест размещений пакета появляется секция "pattern". В ней для каждого места размещения указан список вариантов формата, которые поддерживаются на данном месте размещения.Например, для мультиформата, для размещения в ленте ОК/ВК используется вариант формата с id=34. Список ролей, которые необходимы для создания баннера по данному варианту формата, можно получить по API паттернов и полей.Для некоторых пакетов и мест размещения некоторые варианты формата могут быть обязательными. В таком случае чтобы создать баннер, нужно отправить поля для заполнения обязательного варианта формата.Если обязательные варианты формата в пакете не у

Обращаем ваше внимание, что с 29 апреля мы прекращаем поддержку следующих ресурсов: /api/v2/remarketing/user_geo.json/api/v2/remarketing/user_geo/<id>.jsonдля создания/редактирования списков георегионов. Рекомендуем использовать для тех же целей следующие ресурсы: /api/v2/regions.jsonДокументация: https://target.my.com/doc/api/ru/resource/Region/api/v2/geo/coverage.jsonДокументация: https://target.my.com/doc/api/ru/resource/GeoCoverage/api/v2/remarketing/local_geo.jsonДокументация: https://target.my.com/doc/api/ru/resource/LocalGeos

12 и 13 апреля мы проводим профилактические работы.В этот период будут доступны только основные метрики статистики: клики, показы, расход.

Теперь вы можете подписаться ещё и на изменения пользователя, используя ресурс USER. Документация/api/v3/subscription.json Пример запроса:{"resource": "USER","callback_url": "https://mydomain.ru/users_callback"}