Настройка Карусели товаров и рекламы Вконтакте

В этой статье расскажем, как создать Карусель Вконтакте, настроить ретаргетинг и автоматическую маркировку рекламы Вконтакте

Как создать Карусель ВКонтакте

Карусель Вконтакте - это создание поста или рекламы с фотографиями или видеозаписями, которые пользователь может пролистывать в поисках необходимого продукта, для рекламы и продажи Вашего товара или услуги.

В карточках могут использоваться фотографии с соотношением сторон ТОЛЬКО 13:8 (Например, 1300 на 800 пикселей). Если взять другие фото, сообщение от бота НЕ придет

Требования:

•Пропорции изображения: 13/8;

•Минимальный размер: 221х136;

•Заголовок, максимум 80 символов;

•Подзаголовок, максимум 80 символов;

•Один элемент карусели может содержать не больше 3-х кнопок

Рассмотрим на примере карусели из 3 карточек. Для создания карточек вам нужно в поле "Калькулятор" написать следующее:

p = [{"title":"заголовок", "description": "ОПИСАНИЕ КАРТОЧКИ 1", "image": "ССЫЛКА НА КАРТИНКУ 1", "buttons":[{"text":"ТЕКСТ КНОПКИ 1"}]},{"title":"заголовок", "description": "ОПИСАНИЕ КАРТОЧКИ 2", "image": "ССЫЛКА НА КАРТИНКУ 2", "buttons":[{"text":"ТЕКСТ КНОПКИ 2"}]}, {"title":"заголовок", "description": "ОПИСАНИЕ КАРТОЧКИ 3", "image": "ССЫЛКА НА КАРТИНКУ 3", "buttons":[{"text":"ТЕКСТ КНОПКИ 3"}]}] r = send_carousel(p, 'ТЕКСТ ПЕРЕД КАРУСЕЛЬЮ')

То есть сначала записываем массив с title, description, image, buttons в переменную p (вы можете назвать переменную иначе), а далее используем ее в методе send_carousel(p, 'ТЕКСТ ПЕРЕД КАРУСЕЛЬЮ')

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

В поле "Ответ" оставляем #{none}

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

Чтобы вставить ссылку в кнопку на карточке, запишите в массив так (на примере одной карточки)

p = [{"title":"заголовок", "description": "ОПИСАНИЕ КАРТОЧКИ 1", "image": "ССЫЛКА НА КАРТИНКУ 1", "buttons":[{"text":"ТЕКСТ КНОПКИ 1", "url":"ССЫЛКА ДЛЯ КНОПКИ" }]}]

Обработка откликов на товары Вконтакте

Магазин ВКонтакте — бесплатный инструмент, который помогает превратить сообщество в полноценный интернет-магазин и продавать товары и услуги.

Настроить Магазин можно довольно просто: Управление → Настройки → Разделы → Товары. После этого вам нужно выбрать режим работы — базовый или расширенный. Подробнее Вы можете ознакомиться тут

После настройки карточек товаров клиенты смогут написать Вам (откликнуться):

При этом в карточке клиента появятся переменные, соответсвующие товару:

market_description — описание товара (берется из карточки товара)

market_title — заголовок товара

market_price — стоимость товара

market_id — id товара

Остаётся настроить реакцию и Ваш магазин автоматизирован!

Ретаргетинг Вконтакте

Основные данные

Для каждого запроса в проекте должен быть авторизованный VK пользователь, у которого есть нужный рекламный кабинет. Ниже приведен пример авторизации. После чего будет выдан токен для работы с API ретаргетинга.

При попытке добавления сотрудника ранее неавторизованного в Salebot будет предложено создать новый аккаунт:

Идентификатор рекламного кабинета (account_id)

Идентификатор рекламного кабинета можно найти, перейдя в настройки. Скопируйте его: он понадобится для использования функций ретаргетинга.

Идентификатор аудитории таргетинга (target_group_id)

Идентификатор нужной аудитории таргетинга, можно найти перейдя в раздел Ретаргетинг и нажав на нужную аудиторию. В выпадающем меню выбрать пункт Редактировать правила:

Если такого пункта нет, тогда выбираем - Добавить аудиторию

Во всплывающем окне находим абзац с идентификатором аудитории:

Как добавить пользователя в аудиторию ретаргетинга ВК: параметр vk_add_to_target_group()

vk_add_to_target_group(email, account_id, target_group_id, contacts, ads_client_id)

Параметры:

! email - email сотрудника в проекте

! account_id - идентификатор рекламного кабинета.

! target_group_id - идентификатор аудитории таргетинга.

contacts - список телефонов, email адресов, мобильные рекламные идентификаторы (IDFA, GAID) или идентификаторов пользователей, указанных через запятую.

По умолчанию передается идентификатор пользователя во ВКонтакте.

ads_client_id - только для рекламных агентств. id клиента, в рекламном кабинете которого будет редактироваться аудитория.

Как удалить пользователя из аудитории ретаргетинга ВК: параметр vk_remove_from_target_group()

vk_remove_from_target_group(email, account_id, target_group_id, contacts, ads_client_id)

Параметры

! email - email сотрудника в проекте

! account_id - идентификатор рекламного кабинета.

! target_group_id - идентификатор аудитории таргетинга.

contacts - список телефонов, email адресов или идентификаторов пользователей, указанных через запятую. По умолчанию передается идентификатор пользователя в вк.

ads_client_id - только для рекламных агентств. id клиента, в рекламном кабинете которого будет редактироваться аудитория.

Как добавить новую аудиторию ретаргетинга ВК: параметр vk_add_new_target_group()

vk_add_new_target_group(email, account_id, name, lifetime, ads_client_id)

Параметры

! email - email сотрудника в проекте, который подключил свой аккаунт к проекту и у которого находится нужный рекламный кабинет

! account_id - идентификатор рекламного кабинета

! name - название аудитории ретаргетинга — до 64 символов

! lifetime - количество дней, через которое пользователи, добавляемые в аудиторию, будут автоматически исключены из нее. Число от 1 до 720

ads_client_id - только для рекламных агентств. id клиента, в рекламном кабинете которого будет редактироваться аудитория.

При успешном исполнении запроса в ответ получите идентификатор созданной аудитории: {'id': 41333076}

Автоматическая маркировка рекламы Вконтакте

С 1 сентября 2023 года вся реклама размещенная в интернете на территории Российской федерации должна маркироваться, в случае отсутствия маркировки, грозят штрафы.

Что нужно маркировать?

  • Закрепленный пост, если в нем есть призыв к действию

  • Акции и специальные условия

  • Реферальные программы

  • Посты, которые призывают что-то покупать Для вашего удобства мы создали готовый шаблон, который можно скопировать в ваш проект или использовать отдельно. Внедряйте его в любые проекты и автоматизируйте процесс маркировки. Чтобы установить шаблон себе в проект перейдите в раздел и нажмите кнопку "Установить"

Настройка маркировки в кабинете ВК ОРД и Salebot

Для настройки маркировки понадобиться кабинет ВК ОРД(Оператор рекламных данных VK)

Необходимо зарегистрироваться и создать два кабинета:

  • Основной через который будет маркироваться реклама.

  • Демо-кабинет для тестирования маркировки.

Для этого переходим по ссылке: https://ord.vk.com/

Получение Api токена для основного аккаунта

Заходим в кабинет, выбираем меню настроек и генерируем токен и сразу сохраните его себе. Важно сохранить токен так как он показывается один раз.

Получение Api токена для тестовой среды

Выбираем меню настроек, выбираем демо-кабинет и генерируем токен и сохраняем его.

Настройка ОРД в кабинете Salebot

Заходим в настройки проекта. В общий переменных задаем переменную vk_ord_token и в значение ставим токен демо кабинета из ОРД ВКА. Сначала ставим токен демо-кабинета для тестирования, как только мы закончим все настройки кабинета и будем готовы передавать данные меняем токен на основной.

Мы записали видео инструкцию, где подробно объяснили, как работать с шаблоном.

Настройка маркировки постов в схеме бота

Собираем все необходимые данные от клиента для его регистрации в ОРД как контрагента.

Если ранее вы не сталкивались с созданием чат-ботов, рекомендуем изучить раздел Основы ботостроения.

Собираем бота который запрашивает необходимые данные. Для граждан РФ нам понадобиться:

  • ФИО

  • ИНН

  • Номер телефона

Для вашего удобства мы создали готовый шаблон, скопируйте его к себе в проект.

Уточняем форму организации обратившегося

Далее стрелка пропускает пользователя по схеме бота только при условии: У меня ИП; У меня ООО; Я физ.лицо

При нажатии кнопки определился тип контерагента (пользователя, который регистрируется в нашем чат-боте). Записали его в переменную type в калькуляторе блока. В текстовом поле запрашиваем ИНН у пользователя.

Для следующей стрелки ставим условие. Это условие проверяет введенный текст и сохраняет его в переменную inn. Ставим выбор соответствия - регулярное выражение.

Запрашиваем номер телефона. По стрелке прописываем условие:

Регистрация контрагента

Создаем блок , в текстовом поле пишем "Регистрируем в системе" в калькуляторе прописываем функцию: vk_ord_create_new_publisher(name, publisher_type, publisher_inn, publisher_phone, test, token, rs_url)

name - ФИО контрагента

publisher_type - это определяем кто он из списка['juridical', 'ip', 'physical']

test - если тестовый запрос, то передать 1, если нет, то 0

token - необязателен, если не передать то ищет в переменных проекта переменную

vk_ord_token rs_url - необязательные параметры после выполнения создаст переменную сделки

vk_ord_publisher_data с данными по контрагенту Собранные данные отправляются в ord.

ВАЖНО: ОРД ВК не присылает результатов загрузки. контрагента. Поэтому если у вас не отображается переменная значит вы сделали все правильно если отображается ошибка, значит нужно внести поправки в функции и проверить правильность данных.

Регистрация договора с контрагентом

Чтобы создать договор по которому данные пойдут дальше, в калькуляторе следующего блока прописываем функцию: vk_ord_add_new_distribution(amount, vat_included, creatives_reporter, test, token, client_external_id, date)

amount - сумма (может быть равна 0)

vat_included - НДС ( 1- включен в стоимость, 0 не включен)

creatives_reporter - 1 если контр агент передает, 0 если мы

test - если тестовый запрос, то передать 1, если нет, то 0

token - необязателен, если не передать то ищет в переменных проекта переменную vk_ord_token

client_external_id - необязателен, по умолчанию использует 'my'

date - по умолчанию ставит текущую дату всегда пересоздает переменную сделки vk_ord_contract_id если переменная vk_ord_contract_data есть, то дополняет ее, иначе создает эту переменную с данными по договору

Возвращаем созданный id договора клиенту в следующем блоке, он понадобиться в дальнейшем.

Регистрирация рекламной площадки контрагента

Это место в котором будет выложена реклама. Создаем блок и запрашиваем имя площадки.

По стрелке сохраняем ответ пользователя как имя площадки в переменную pad_name И в следующем блоке запрашиваем ссылку на площадку и сохраняем ее по стрелке.

Функция по созданию рекламной площадки

Далее создаем блок и в калькуляторе указываем функцию: vk_ord_add_web_pad(pad_name, is_owner, pad_url, test, token)

pad_name - имя площадки

is_owner - владелец ли клиент, если да передать 1, если нет 0

pad_url - ссылка на площадку

test - если тестовый запрос, то передать 1, если нет, то 0 token - необязателен, если не передать то ищет в переменных проекта переменную vk_ord_token

В следующем блоке уведомляем, что площадка создана и отдаем контрагенту его id

Регистрация креатива

Запрашиваем название креатива и по стрелке прописываем условие. Важно в каждой стрелке указать значение переменной, название вы можете увидеть на изображениях. В данном случае - creative_name

Далее в блоке запрашиваем описание и прописываем условие в стрелке.

В следующем блоке в текстовом после запрашиваем текст креатива, также добавляем условие по стрелке.

Создаем еще один блок, в нем мы запросим ссылку на креатив. Это ссылка на то, что рекламируем или, если по репостам, на исходное сообщение с которого идут репосты. И прописываем условие по стрелке ниже. (https?):((//)|(\\))+[\w\d:#@%/;$()~_?+-=\.&]*

В следующем блоке запрашиваем целевую аудиторию. И далее в следующем блоке регистрируем креатив с помощью функции: vk_ord_add_new_creative(creative_name, description, text, url, targeting, okveds, test, token, media_external_ids, media_urls, flags, form, pay_type)

В текстовом после возвращаем Id креатива.

Функция загрузки картинки крео

Как загрузить картинку подробно описано в видео инструкции. В блоке прописываем функцию и в ней указываем ссылку на изображение загруженное на Salebot ( чтобы загрузить изображение создайте блок, добавьте в него изображение и скопируйте ссылку на него) vk_ord_upload_media(external_id, image_url, description, test, token=None)

Создание актов выполненных работ

Для создания акта запрашиваем id креатива, Id площадки, число просмотров за отчетный период. И в последнем блоке прописываем функцию:

vk_ord_create_invoice(vk_ord_contract_id, creative_platform_data, test, token)

В словаре 'creative_external_id' - id креатива, а в platforms все нужные для него платформы. Схема заполнения такая в списке первый вложенный список - первая платформа, второй - вторая платформа для этого же креатива.

Порядок параметров в списке по платформе pad_external_id, shows_count, invoice_shows_count, amount, amount_per_event Флаги тянет с договора date_start_planned и date_start_actual - из контракта берет дату регистрации, date_end_planned и date_end_actual - берет текущую дату pay_type - из контракта

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

Чтобы не копировать все функции используйте готовый шаблон. А в видео мы подробно объяснили, как работает схема бота и какие данные необходимо прописывать.

Видео-инструкция Маркировка рекламы Вконтакте:

Last updated