Инструкция по настройке модуля маркировки саморекламы на сайтах 1С-Битрикс
Данная инструкция предназначена для модуля ОРД API - маркировка рекламы на сайте. Посмотреть модуль на маркетплейсе 1С-Битрикс можно по ссылке.
После установки модуля из маркетплейса переходим по пути: “Сервисы” - “ОРД API” - “ОРД-профили” нажимаем на кнопку “Добавить ОРД-Профиль”.
Откроется окно добавление названия профиля и Токена.
Вписываете свое понятное для вас название (оно используется только в админ-части), и переходим к получению токена.
Для получения токена необходимо иметь зарегистрированный аккаунт в Яндексе.
Внимание! Под данным аккаунтом будут передаваться данные в ОРД, соответственно сделать либо отдельный аккаунт для передачи, либо использовать уже созданные корпоративные.
Для получения токена необходимо зарегистрироваться в кабинете ОРД Яндекса: https://ord.yandex.ru/cabinet (ссылка доступна на странице добавления профиля).
На открытой ссылке проверьте что зашли под нужным аккаунтом, согласитесь с условиями и нажмите "Войти в кабинет ОРД"
После перехода вы попадете в основной кабинет ОРД. Далее необходимо выдать доступ к API. Подробную инструкцию по выдаче доступов от имени организации или выдаче доступов другому пользователю можете посмотреть на странице справки: https://yandex.ru/support2/ord/ru/api/connect ниже расскажем как выдать доступы самому себе, для этого нужно сделать несколько действий:
- В левом меню перейдите в раздел Настройки → Пользователи и роли. В правом верхнем углу нажмите Открыть доступ к API;
- В левом меню перейдите в раздел Настройки → Пользователи и роли → Получить токен для API;
- На странице авторизации Яндекс ID разрешите доступ для сервиса «API Яндекс.ОРД». Для этого нажмите кнопку Войти как <имя пользователя>. Проверьте, что вы находитесь именно под тем аккаунтом, на который выдан доступ к API;
- Скопируйте и вставьте токен для использования в модуле.
После вставки токена профиль должен выглядеть подобным образом:
После проверки нажимаем кнопку “Сохранить”.
Переходим к следующему пункту “Организации/контрагенты”. После перехода нажимаем “Добавить контрагента” и выбираем “ОРД-Профиль” - Яндекс.
В поля вписываем организацию или данные частного лица, поля у которых написано в скобках “для иностранных физлиц и юр.лиц” резидентам РФ заполнять не надо.
Заполнив организацию нажимаем кнопку “Сохранить” и переходим к добавлению площадки.
Переходим на вкладку “Рекламные площадки” и нажимаем кнопку “Добавить площадку”. На следующем шаге выбираем организацию, которую мы добавили на предыдущем шаге, заполняем 2 поля и ставим чек-бокс: “Площадка принадлежит контрагенту”.
Сохранив, нам необходимо вернуться на вкладку: “Организации/контрагенты” зайти в добавленную организацию и поставить чек-бокс: “Является рекламораспространителем (РР)”.
После этих шагов мы подготовили модуль к передаче юр. данных и данных сайта в ОРД Яндекса. Переходим к подготовке креативов.
Модуль работает с элементами инфоблока, для его работы нам необходимо выполнить небольшие действия со свойствами инфоблока.
Для этого перейдем в настройки инфоблока, элементы которого необходимо маркировать и добавим два свойства, со следующими параметрами:
Тип: “Простой чекбокс (число)”
Данные настройки необходимо выполнить для всех инфоблоков, элементы которых необходимо маркировать.
После добавления свойств в инфоблоке переходим к созданию профиля в модуле по следующему пути: “Сервисы” - “ОРД API” - “Профили инфоблока”.
Нажимаем кнопку “Добавить профиль” и заполняем данные:
На данной странице необходимо выбрать инфоблок, в котором на прошлом шаге мы добавили свойства, остальные параметры указаны на скриншоте. Нажимаем кнопку “Далее”.
На следующей странице необходимо заполнить данные:
В поля с изображениями можно выбрать несколько свойств, допустим для моментов когда для мобильного и десктопа используются 2 изображения.
Остальные поля заполняем согласно скриншоту. После заполнения полей нажимаем кнопку “Далее”.
На последнем шаге нам осталось только задать правила фильтрации элементов, которые подлежат маркировке.
Нажимаем “Добавить фильтр” после чего можем создать как произвольные условия отбора элементов для маркировки, так и использовать созданное нами ранее свойство инфоблока.
Ниже пример фильтра с использованием созданного свойства:
После добавления фильтра необходимо нажать кнопку “Сохранить”.
На этом настройки модуля закончены. Необходимо перейти в инфоблок с элементами и добавить чек-боксы тем элементам, которые необходимо маркировать.
Покажем на примере исходя из наших условий, что мы добавили проверку на свойство “Рекламный баннер”.
После добавления чек-бокса “Рекламный баннер” нажимаем кнопку “Применить”. После этого в поле “ОРД токен” должен добавиться сам токен, что означает что модуль отправил.
Скриншот с полученным токеном и заполненным erid в ссылке:
Последним шагом является включение сбора статистики показов слайдеров. Для этого необходимо перейти по пути: “Сервисы” - “ОРД API” - “Настройки модуля” и включить чек-бокс: “Включить фиксирование показов”.
Кроме полученных токенов в ссылках, можно добавить аннотацию к элементам с информацией о юр лице и добавлением erid в всплывающем окне.
По примеру приведем код для любого шаблона или решения:
<?if($arItem['PROPERTIES']['SAM_ORD_ERID']['VALUE'] <> '' && \Bitrix\Main\Config\Option::get('sam.ord', 'IS_TIPPY', 'N') === 'Y'):?>
<button class="samord-tippy-init" width="24" height="24" data-content="Реклама: Название_компании<br> erid: <?=$arItem['PROPERTIES']['SAM_ORD_ERID']['VALUE']?>" data-sam-ord-erid="<?=$arItem['PROPERTIES']['SAM_ORD_ERID']['VALUE']?>">
<svg width="8" height="20" viewBox="0 0 8 20">
<circle cx="4" cy="4" r="1.5"></circle>
<circle cx="4" cy="10" r="1.5"></circle>
<circle cx="4" cy="16" r="1.5"></circle>
Если у вас остались вопросы или вам требуется помощь с настройкой, вы всегда можете обратиться к нам по нашей почте: [email protected]