Настройка Карусели товаров и рекламы Вконтакте
В этой статье расскажем, как создать Карусель Вконтакте, настроить ретаргетинг и автоматическую маркировку рекламы Вконтакте
Как создать Карусель ВКонтакте
Карусель Вконтакте - это создание поста или рекламы с фотографиями или видеозаписями, которые пользователь может пролистывать в поисках необходимого продукта, для рекламы и продажи Вашего товара или услуги.
В карточках могут использоваться фотографии с соотношением сторон ТОЛЬКО 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)
| Параметры функции | Значение параметра функции |
|---|---|
creative_name | название креатива |
description | описание |
text | текст креатива |
url | ссылка |
targeting | целевая аудитория |
okveds | просто через запятую без пробелов перечисляем нужные ОКВЕДы (зависит от того, что рекламируем) |
test | 1 еслит тестовый запрос, 0 если боевой |
token | если не нужен тут передать None и его будет искать в переменной |
media_external_ids | id загруженных файлов через запятую без пробелов |
media_urls | ссылки на медия через запятую без пробелов |
flags | нужные флаги через запятую без пробелов |
form | форма рекламы, по умолчанию 'text_graphic_block' |
pay_type | тип оплаты, по умолчанию "cpc" |
В текстовом после возвращаем 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)
| Параметры функции | Описание параметра |
|---|---|
vk_ord_contract_id | договор по которому надо создать акт, должен быть в переменной vk_ord_contract_data, иначе не сработает и вернет ошибку |
creative_platform_data | конструкция такого вида: [{"creative_external_id": "тут подставляете нужный id креатива", "platforms": [[pad_id, 500, 500, 0, 0], [pad2_id, 100, 150, 0, 0]]}] в данном примере данные для 1 креатива на 2 площадки. [pad_id, 500, 500, 0, 0] первое - id площадки, потом идут по порядку - число показов общее, число показов за период на который создается акт, сумма (может быть равно 0), сумма за событие (может быть равно 0) |
В словаре '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
