Как пользоваться возможностями АПИ Вконтакте без программирования

2 марта 2018 г.

Многое из АПИ вконтакте не требует программирования. Расскажу об одном методе, который позволит расширить ваши возможности в таргетированной рекламе, а также покажу как самостоятельно искать возможности в АПИ вконтакте, расширяющие возможности работы с социальной сетью.

Методы API вконтакте можно посмотреть на странице https://vk.com/dev/methods

Методы можно вызывать в вёбе прямо из документации, это и позволяет нам работать с API без навыков программирования.

Пример вызова метода из документации

Будем вызывать метод https://vk.com/dev/ads.updateTargetGroup позволяющий обновлять аудитории ретаргетинга. Этот метод был выбран, т.к. используемый в нём параметр lifetime позволяет свободно устанавливать количество дней, через которые будет удалены пользователи, собранные через пиксель (в диапазоне 1-365 дней). То есть, в отличие от интерфейса рекламного кабинета, где вы можете собирать аудиторию за 3, 7, 14 и т.д. дней, через API возможно настроить аудиторию гибче. Это позволит, например, использовать гибкие стратегии ретаргетинга: показывать в ретаргетинге каждый день разные креативы, использовать посылы вроде: «21 день назад вы заходили к нам» и т.д.

Также в этом методе содержится параметр target_pixel_rules, дающий дополнительную гибкость в настройке ретаргетинга по пикселю.

Интерфейс вызова запроса выглядит так:

Рассмотрим как нужно заполнять поля:

1.account_id – сюда вписываем id рекламного аккаунта, к которому принадлежит редактируемая аудитория. id кабинета находится в адресной строке браузера, когда вы заходите в список кампаний (на личном кабинете) или в список клиентов (на кабинете агентства). Если id у вас не отображается, попробуйте переключиться между разными рекламными кабинетами.

2.client_id – используется только рекламными агентствами. Айди клиента, который можно получить перейдя к списку кампаний клиента рекламного агентства. Если вы используете метод для личного кабинета, оставьте это поле пустым.

3.target_group_id – идентификатор аудитории ретаргетинга. Чтобы его получить, перейдите в раздел “добавить аудиторию” и скопируйте идентификатор в нижней части всплывающего окна:

4. name – новое название аудитории. К сожалению, этот параметр обязательный. Если вы не впишите название, то аудитория не будет изменена. Максимальная возможная длина – 60 символов. Поэтому, если вы будете использовать данный метод для некоторых LAL аудиторий, возможно название придётся сократить.

5. domain – устаревший параметр, используется для старых аудиторий (созданных до введения нового пикселя). В новых аудиториях нужно пропустить, или получим ошибку и не сохраним аудиторию.

6. lifetime – тот параметр, ради которого мы всё и затеваем. Количество дней, через которые аудитория будет удалена.

7. target_pixel_id – айди пикселя ретаргетинга. Чтобы получить айди, переходим в “Пиксели”, нажимаем кнопку “Редактировать”. Ищем строку вида VK-RTRG-123456-1AbCdE; id пикселя – числа после RTRG (т.е. в данном примере – 123456).

8. target_pixel_rules – правила сбора аудитории пикселем ретаргетинга. Задаётся конструкцией вида:

[

{“url_full_match“: “https://vk.com”},

{“url_substrings_match“: [“cats”, “dogs”, “parrots”]},

{“url_regex_match“: “(item[s]|good[s])_\d+”},

{“event_full_match“: “purchase”},

{“event_substrings_match“: [“item”, “order”, “parrots”]},

{“event_regex_match“: “f[ao]r.*”}

]

На первый взгляд сложно, но если разобраться, в этой строке содержится ещё больше возможностей ретаргетинга.

Важное правило: все значения здесь должны указываться в двойных кавычках. Открывающие и закрывающие кавычки вокруг одного текста должны быть одинакового типа.

В каждой строке, как можно догадаться по названию, представлены разные типы событий для пикселя:

• url_full_match – полное совпадение url: здесь необходимо указывать полный URL сайта, включая протокол (т.е. в нашем примере недостаточно указать просто “vk.com””, нужно указать именно “https://vk.com“”).
• url_substrings_match – аудитория будет собираться по словам, указанным в данном массиве. В указанном примере, в ретаргетинг попадут пользователи всех страниц, в url которых содержатся слова “cats”, “dogs”, “parrots”. Обратите внимание, что список слов должен быть заключён в квадратные скобки.
• url_regex_match – регулярные выражения. По сути от небольшой язык программирования для обработки текстов. Позволяет гибко выделять различные части текста, подменять их, совершать массовые операции и др. В указанном примере пользователи будут собираться со всех страниц, url которые содержат конструкции вида item_, items_, good_, goods_ с не более чем двумя цифрами, следующими после нижнего подчёркивания. Для подробного изучения регулярных выражений рекомендую сервис https://regex101.com/ (англоязычный). Он содержит не только обучающие материалы, но и удобный инструмент для проверки регулярок.

event – это события пикселей ВК, настраиваются по той же логике, что и url

При настройке вы можете оставить поля пустыми, либо просто стереть не нужные вам поля. Обратите внимание, что между фигурными скобками разных полей должна стоять запятая, но после последнего поля её быть не должно.

Пример заполненной формы ретаргетинга:

Когда всё заполнили, нажимаем кнопку “Выполнить”. Если всё сделали правильно, увидим единичку:

Если где-то ошиблись, увидим сообщение и, скорее всего, подсказку в каком именно месте она возникла (в некоторых случаях подсказки может не быть).

Заключение

Я показал только один из множества методов ВК, которые позволят расширить возможности специалистам, предложить уникальные, ещё не открытые возможности клиентам.

По вопросам вы можете связаться со мной: vk.com/funkymusic.

Если вы воспользуетесь методом, присылайте ссылки на кейсы. Мне интересно как это работает у разных рекламодателей.