Действие — «Добавить / Исключить из аудитории ретаргетинга»

Действие позволяет добавить пользователя в аудиторию ретаргетинга Рекламного кабинета ВК, либо исключить из нее.

Важно! Доступ к рекламному кабинету выдается в момент регистрации в сервисе «Автопилот» (когда пользователь впервые входит через ВК). Он необходим для работы действия и позволяет техническим специалистам настраивать рекламные кабинеты клиентов (с их разрешения)!

Рассмотрим действие подробнее:

• Переключатель «был добавлен/ был исключен» будет добавлять либо исключать подписчиков из аудитории.
• Второй параметр — сообщество ВКонтакте в котором выполняется действие.

• Третий параметр %account_id% —Идентификатор рекламного кабинета числом или переменной. Берется из настроек вашего рекламного кабинета.
• Четвертый параметр — %client_id% — ID клиента, в рекламном кабинете которого находится аудитория. Указывать только для рекламных агентств. Если у вас нет рекламного агентства, удаляйте переменную из действия.

• Пятый параметр %target_group_id% — Идентификатор аудитории таргетинга числом или переменной. Обязательный параметр, целое число. Берется в настройках вашего рекламного кабинета из раздела «Ретаргетинг».
• Шестой параметр — Список телефонов, email адресов или идентификаторов пользователей, указанных через запятую. Также принимаются их MD5-хеши. Не более 1000 за запрос. Если не задан, используется текущий пользователь %vk_id%.

Ограничения Рекламного API

Важно! Рекламный API имеет свои жесткие ограничения со стороны ВК. Подробности можно узнать по ссылке https://vk.com/dev/ads_limits, проверку в действия добавлять обязательно. За несработавшие действия без проверки мы ответственности не несём.

При работе с Ads API стоит учитывать следующие особенности платформы:

• Примитивное ограничение — ограничение на количество вызываемых методов в течение короткого промежутка времени для каждого пользователя.
• Часовое ограничение — ограничение на количество вызываемых методов в течение часа для каждого рекламного кабинета.
• Все методы разрешается запускать не чаще 2 раз в секунду.

Часовое ограничение

Ограничение на количество запускаемых методов (кроме ads.getUploadURL) — 5000 методов в час для обычных кабинетов и 10000 для кабинетов рекламных агентств. Час начинает отсчитываться в точности в момент, когда происходит запрос на исполнение метода и счетчик равен нулю.

Особенности работы с ограничениями

При превышении примитивного ограничения API возвращает ошибку с кодом 9.

При превышении часового ограничения API возвращает ошибку с кодом 601.

Итак, про ограничения мы поняли, теперь приступаем к настройке. В качестве примера будем реагировать на подписку в Senler. Если у вас не настроена интеграция, то настроить ее можно по этой статье. Настроили, отлично.

Настройка Рекламного кабинета

Для входа в рекламный кабинет переходим по ссылке https://vk.com/ads

ID кабинета можете брать из адресной строки после перехода (после параметра union_id), либо из настроек.

Аудиторию создаем в разделе «Ретаргетинг» и берем номер аудитории, отредактировав правила.

Все, летим настраивать команду.

Команда «Добавление аудитории в ретаргетинг»

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

Событие:

Важно! У вас будет своя группа подписчиков. Это пример.

1) Для реакции на подписку используем событие «Подписался / Отписался в Senler» и вставляем нужную группу подписчиков. В примере: 1868712

Действия:

Важно! Это пример, у вас номера кабинета и аудитории ретаргета будут свои. Будьте внимательны.

1) Для добавления пользователя добавляем действие «Добавить / Исключить из аудитории ретаргетинга» с переключателем «Был добавлен»и номером кабинета 1605269350пустым полем рекламного агентства и номером аудитории 48777334. В примере добавляется текущий пользователь.

2) Во временную переменную достаем из ответа ВК код ошибки с помощью JSON PATH. Т.е. в переменной %error% записываем код ошибки:

%response.error.error_code%

3) Далее можем отправлять действием «Отправить сообщение» сотруднику с текстом, как отработала команда:

Ссылка: %vk_link%

Ответ: %response%
Ошибка: %error%

Здесь кликабельное имя пользователя. Ответ от ВК в переменной %response% и код ошибки в переменной %error%

4) Дальнейшие действия выполняем, только если возникла ошибка, т.е. ВК не отработало и вернуло ошибку, например, по лимитам. Мы, например, будем добавлять их в ресурс и тогда через массовый запуск или ключевиком от админа, сможем их добавить в аудиторию, но это уже дополнительные навороты, их вы можете делать по желанию. Добавляем действие «Прервать / продолжить выполнение команды», если числовая переменная %error%больше 0

5) Чтобы не потерять VK ID нашего пользователя, давайте запишем его в ресурс с названием %subscription_id%(ID группы подписчиков в Senler) этим действием и для содержимого добавляем элементы массива и удаляем повторяющиеся. Т.е. нам неважно сколько раз подпишется пользователь, в ресурсе будет ID записана один раз.

Тестируем.

Как видно все отлично работает.

Задать вопрос, оставить замечание или пожелание (или просто лайкнуть инструкцию) можно в этом посте.