Мы реализовали новый сервис push-уведомлений о создании и изменении объектов пользователя.

/api/v3/subscription.json

Документация доступна по ссылке

Позволяет работать только с подписками, созданными с помощью данного метода, подписки созданные через v2/subscriptions.json не поддерживаются.

На следующей неделе мы перестанем поддерживать старый метод подписок на события.

Мы закрыли для создания часть пакетов в myTarget. Это пакеты, использовавшиеся в старом интерфейсе создания рекламных кампаний.
Сейчас готовимся к миграции рк из старых пакетов в новые. Прикладываю мапку миграции - старые и соответствующие им новые пакеты, площадки и цели. При миграции будут генерироваться и пуш-уведомления
Если в файле старого пакета нет и при этом название пакета не содержит префикc ttm и не имеет objective_binmask - значит аналога для него нет, формат закрывается.
Начнём миграции на следующей неделе. Первая в понедельник - все рк из пакета 625 (аудиореклама).

О плане миграции других пакетов сообщим дополнительно.

С 1 декабря мы закрываем ресурсы перечисленные ниже, пользуйтесь, пожалуйста, новыми ресурсами.

Старый ресурс: v2/manager/clients.json
Документация: https://target.my.com/doc/api/ru/resource/ManagerClients
Новый ресурс: /api/v3/manager/clients.json

Старый ресурс: v2/managers.json
Документация: https://target.my.com/doc/api/ru/resource/AgencyManagerClients
Новый ресурс: /api/v2/agency/managers/<manager_id>/clients.json

Старые ресурсы:
v2/managers/<user_id>/clients.json
v2/managers/<user_id>.json
v2/managers/<manager_id>/clients/<client_id>.json
Документация: https://target.my.com/doc/api/ru/resource/AgencyManager
Новый ресурс: /api/v2/agency/managers/<manager_id>.json

Старый ресурс: v1/clients.json
Документация: https://target.my.com/doc/api/ru/resource/AgencyClients
Новый ресурс: /api/v2/agency/clients.json

Старый ресурс: v2/clients.json
Документация: https://target.my.com/doc/api/ru/resource/AgencyClients
Новый ресурс: /api/v2/agency/clients.json
Документация: https://target.my.com/doc/api/ru/resource/BranchClients
Новый ресурс: /api/v2/branch/clients.json

Продолжаем миграцию пакетов. Завтра (28 ноября) будут смигрированы все рекламные кампании в пакетах 236, 309, 310, 359, 360, 382, 418, 428, 433, 434, 441, 442, 449, 452, 454, 490, 505, 622, 645

Завтра (3 декабря) будут смигрированы все рекламные кампании в пакетах 220, 311, 312, 313, 314, 379, 380, 381, 401, 423, 450, 456, 457, 463, 464, 472, 549, 557, 580, 664, 666, 675, 676, 679

В понедельник (9 декабря) будут смигрированы все рекламные кампании в пакетах 269, 276, 309, 310, 311, 312, 313, 314, 359, 360, 373, 375, 379, 380, 381, 382, 388, 401, 418, 422, 423, 428, 433, 434, 440, 441, 442, 449, 450, 452, 454, 456, 457, 463, 464, 472, 490, 505, 508, 509, 524, 549, 557, 562, 580, 611, 613, 620, 622, 624, 625, 626, 627, 628, 629, 633, 634, 635, 636, 643, 645, 654, 664, 666, 675, 676, 679, 680, 688, 689, 699, 700, 701, 702, 747, 748, 752, 753, 762, 764, 774, 775, 776, 777, 778, 779, 788, 789, 790, 791, 792, 793

Теперь вы можете подписаться на изменения сегментов, используя ресурс SEGMENT.
Документация

/api/v3/subscription.json

Пример запроса:

{
"resource": "SEGMENT",
"callback_url": "https://mydomain.ru/segments_callback"
}

Во вторник (17 декабря) начнём миграцию последней порции пакетов: 562, 624, 643, 654, 701, 764, 788, 790, 791, 825, 826, 827, 869, 870, 881, 882, 883, 884, 899, 914, 915, 922, 967, 968, 969, 970, 971, 972, 977, 980, 981, 982, 1006, 1007, 1039, 1041, 1042, 1043, 1047, 1120, 1122, 1125, 1154, 1163, 1229, 1230, 1231, 1254, 1271, 1272, 1273, 1284, 1285, 1286, 1299, 1300, 1301, 1496, 1497, 1498, 1499, 1500, 1501

С 13 января в ресурсах /api/v2/user.json и /api/v2/user/session.json поля allowed_geo и sudoers__allowed_geo перестанут поддерживаться.
Используйте поля regions и sudoers__regions объкта User https://target.my.com/doc/api/ru/object/User
Документация к полю regions/sudoers__regions

Теперь вы можете подписаться ещё и на изменения пользователя, используя ресурс USER.
Документация

/api/v3/subscription.json

Пример запроса:

{
"resource": "USER",
"callback_url": "https://mydomain.ru/users_callback"
}

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

Обращаем ваше внимание, что с 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

Мы обновили форму создания баннеров: с 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 паттернов и полей.

Для некоторых пакетов и мест размещения некоторые варианты формата могут быть обязательными. В таком случае чтобы создать баннер, нужно отправить поля для заполнения обязательного варианта формата.
Если обязательные варианты формата в пакете не указаны, баннер будет создан при заполнении одного любого варианта формата.

Если в пакете текущий баннерный формат совпадает с доступным в пакете вариантом формата, создавать объявления можно обоими способами — и по баннерному формату, и по вариантам формата. У таких пакетов стоят флаги patterns и patterns_migration.

Для остальных пакетов (таких как мультиформат) будет работать только один способ, и после переключения пакета на варианты формата создавать баннеры с использованием баннерных форматов будет невозможно.

Документация: https://target.my.com/doc/api/ru/resource/BannerPatterns
https://target.my.com/doc/api/ru/object/BannerPattern

Уже сейчас вам доступен новый способ в нашей песочнице для отладки 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/GMS2JRJh

2. В секции «паттерн» получаем для каждого места размещения список вариантов формата (patterns), которые поддерживаются на указанном месте размещения. Например, место размещения Десктоп Лента, pad:242743 — поддерживается только вариант формата id=34
Для места размещения Десктоп-МРГ-Колонка, pad:146590 — поддерживаются варианты формата с id=2,3,64,51

3. Чтобы получить список полей для вариантов формата, идем в API паттернов:
https://target.my.com/api/v2/banner_patterns.json?limit=50

Например, для варианта формата 34 получаем список полей:
https://pastebin.com/LsNGXcVK

4. Требования к полям получаем в 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

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

Работа по новому API для пакетов с флагом patterns_migration.

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

Для большинства пакетов еще некоторое время будет доступна работа и по старому, и по новому API.
Для мультиформата будет доступна только работа по новому API, обратная миграция с текущими форматами перестанет работать. Это произойдет до конца ноября, точную дату переключения мультиформата мы сообщим позже.

Мы рекомендуем перейти на новое API и отладить работу уже сейчас, чтобы быть готовыми к отключению старого API.

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

Напоминаем, что теперь создавать рекламные кампании в мультиформатах и тизерах можно только новым способом, с помощью вариантов формата (patterns)

Подробная схема создания с примером: https://xn--r1a.website/mytarget_api/24

Мы подготовили для вас несколько инструкций "было-стало" для вашего удобства:

Мультиформат https://pastebin.com/7dvrfXZs
Тизеры: https://pastebin.com/aKFVbsR8
Мультиформат аппы: https://pastebin.com/ucALBpmC
Карусель сайты: https://pastebin.com/aTfn10Me
Карусель аппы: https://pastebin.com/24Gi7Zvq

В ближайшее время добавим шаг при установке общего ограничения бюджета budget_limit в настройках кампании. Изменение должно быть кратно значению budget_limit_step из /api/v2/currencies.json для валюты пользователя.

Документация: https://target.my.com/doc/api/ru/resource/Campaign

Теперь вы можете добавить существующего клиента в своё агентство используя 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