# Интеграция через плагин для 1С-Битрикс Если ваш сайт создан на базе CMS 1С-Битрикс, вы можете быстро интегрировать его с системой Admitad с помощью плагина от Admitad. Плагин — это специальный программный модуль, который нужно установить на свой сайт и настроить его. В результате ваш сайт будет проинтегрирован с системой Admitad. # Общая информация: особенности и рекомендации * Приступить к интеграции можно только, если в вашей программе: * уже сформирована трекинг-ссылка в разделе «Общие настройки»; * уже добавлено целевое действие и настроен тариф для него в разделе «Действия». :::tip Если у вас нет менеджера, то вам нужно самостоятельно сформировать трекинг-ссылку ([инструкция](/article/ru/159.html#tracking-link)), а также добавить хотя бы одно действие и хотя бы один тариф ([инструкция](/article/ru/163.html)). Если у вас есть личный менеджер, он выполнит все эти настройки за вас. ::: * Интеграция — обязательный этап для продолжения работы. Без нее невозможно запустить партнерскую программу в Admitad. * Чтобы настроить интеграцию у вас должен быть доступ к административной панели вашего сайта на 1С-Битрикс. Если у вас нет доступа, отправьте эту инструкцию для интеграции коллеге, у которого есть необходимый доступ. Когда интеграция будет завершена, все данные о целевых действиях — дата действия, ID заказа и его сумма и пр. — будут отправляться в Admitad автоматически. # Как установить плагин для 1С-Битрикс на сайт Перед установкой и настройкой интеграции убедитесь, что в административной панели вашего сайта в разделе «Установленные решения» (Marketplace → Установленные решения) установлен и настроен модуль [«Современный интернет-магазин»](https://marketplace.1c-bitrix.ru/solutions/admitad.tracking/) от 1С-Битрикс. 1\. Откройте административную панель своего сайта. Перейдите в раздел «Marketplace» (1) и откройте подраздел «Каталог решений» (2). 2\. В поле поиска введите «Модуль интеграции с Admitad» (3) и нажмите Enter. 3\. На странице отобразится найденный модуль. Нажмите «Установить» (4). ![](https://cdn-support.admitad.ru/images/669b1c1bf909d3c81e84cc5f5afa65c3.png) :::tip Модуль также доступен на [сайте каталога решений Маркетплейс](https://marketplace.1c-bitrix.ru/solutions/admitad.tracking/). ::: 4\. Откроется страница «Мастер установки модуля интеграции с Admitad» , где начнется проверка параметров и компонентов системы. Как только напротив каждого параметра и компонента отобразится статус «Успешно», нажмите «Следующий шаг». 5\. Заполните поля для авторизации в Admitad: * **Ваш идентификатор** — укажите значение client\_id\*. * **Ваш секретный ключ** — укажите значение client\_secret\*. * **Название параметра** — введите «admitad\_uid» (без кавычек). :::tip \* Чтобы получить client\_id и client\_secret, в личном кабинете Admitad откройте вкладку [«API и приложения»](https://store.admitad.com/ru/webmaster/account/settings/credentials/) (раздел «Настройки»). Затем в блоке «Учетные данные API» нажмите «Показать учетные данные» и скопируйте соответствующие значения. ::: 6\. Нажмите «Следующий шаг». Вы увидите сообщение об окончании установки. Готово, установка модуля завершена. Далее необходимо выполнить [настройку модуля интеграции](/article/ru/173.html#settings). # Как настроить плагин интеграции для 1С-Битрикс 1. В административной панели своего сайта перейдите в раздел «Настройки модуля» (Настройки → Настройки продукта → Настройки модулей). 2. В выпадающем списке выберите «Admitad Интеграция». ![](https://cdn-support.admitad.ru/images/a3b96499d9074a487010cfe55f5273ef.png) 3. Выполните настройку модуля на вкладках: * [Общие настройки](#general-settings) * [Действия и тарифы](#actions-rates) ## Вкладка «Общие настройки» 1\. На вкладке «Общие настройки» в поля «Ваш идентификатор», «Ваш секретный ключ» и «Название параметра» будут автоматически подставлены значения, которые вы указали при установке модуля — не изменяйте их. 2\. Заполните остальные поля (обязательные поля отмечены \*): * **Название cookie старой интеграции** — укажите, только если вы ранее уже сотрудничали с Admitad Affiliate. В противном случае оставьте поле пустым. * **Базовый URL сервера\*** — введите ссылку на свой сайт без http(s)://, поддоменов и www. Пример: mysite.ru * **Код валюты\*** — укажите трехбуквенный код валюты программы согласно ISO 4217. Пример: RUB. * **Метка источника дедупликации\*** — укажите название метки, по которой будет определяться последний платный источник трафика. [Подробнее](/article/ru/173.html#deduplication) По умолчанию указана метка «utm\_source». В данном GET-параметре со стороны Admitad Affiliate будет передаваться значение «admitad». ![](https://cdn-support.admitad.ru/images/530761e44e1a6c2b009608e2f34ec25b.png) 3\. Нажмите «Сохранить» и перейдите на вкладку «Действия и тарифы». ## Вкладка «Действия и тарифы» На вкладке «Действия и тарифы» отображаются действия и тарифы в соответствии с настройками вашей программы в Admitad. Вы можете выбрать и активировать действия и тарифы для заказов с промокодами и без промокодов. 1\. Укажите, для какого типа заказов нужно настроить действия и тарифы. Выберите «Оплаченный заказ» или «Заказ с промокодом». 2 . В выпадающем списке «Тип действия» выберите «Покупка». 3\. В списках с категориями выберите категории товаров в соответствии с тарифами, настроенными в вашей партнерской программе. :::tip Чтобы выбрать сразу несколько категорий товаров, используйте: Ctrl+клик — для выбора нескольких категорий в произвольном порядке; Shift+клик — для выбора диапазона категорий; Ctrl+A — для выбора всех категорий. ::: 4\. Нажмите «Сохранить» внизу страницы. ![](https://cdn-support.admitad.ru/images/ab00c96a5d47abd36ef67417921efa76.png) Готово, настройка модуля выполнена, и теперь ваш сайт проинтегрирован с системой Admitad. :::tip Не заполняйте настройки на вкладке «Автосверка» — этот функционал плагина сейчас дорабатывается. Подробнее о сверке, ее типах и возможных способах настройки читайте в [этой статье](/article/ru/222.html). ::: # Как настроить дедупликацию В плагине для 1С-Битрикс дедупликация целевых действий уже настроена по умолчанию. Если вы работаете с несколькими платными источниками трафика — например, размещаете контекстную рекламу или работаете с другими партнерскими сетями — настройка дедупликация позволит: * правильно определить платный источник трафика и присвоить заказ ему по модели атрибуции [Last Paid Click / Last Cookie Wins](/article/ru/145.html#last-paid-click-last-cookie-wins-en), * устранить дублирующие друг друга целевые действия, если они есть. Параметр дедупликации, по которому определяется источник действия, отображается на вкладке «Общие настройки» в поле «Метка источника дедупликации». Чтобы действие было присвоено Admitad, в значении метки должно быть указано «utm\_source». # Как тестировать интеграцию после настройки 1\. Получите тестовую партнерскую ссылку на странице «Настройка интеграции для 1-С Битрикс» в блоке «Тестирование интеграции». :::cut{title="Как найти блок «Тестирование интеграции»"} 1.1 В личном кабинете перейдите в раздел «Интеграция» (Программа → Интеграция). 1.2 Затем нажмите «Далее» и на странице «Способы интеграции» выберите «1-С Битрикс». Нажмите «Далее». 1.3 Блок «Тестирование интеграции» находится в нижней части экрана. ::: 2\. Перейдите по ссылке и выполните целевое действие согласно условиям вашей программы. **Рекомендации по тестированию интеграции:** * Если у вас несколько действий и/или тарифов, сделайте несколько тестовых заказов, чтобы проверить все действия и тарифы. * Включите несколько товарных позиций в один из тестовых заказов, чтобы проверить, что позиции и общая сумма заказа передаются корректно. * Если у вас есть форма быстрого заказа или заказа «В один клик», сделайте заказ через нее, чтобы проверить интеграцию формы. Тестовый заказ появится в статистике Admitad в течение часа. :::tip Если через час и более заказ не появился в статистике, проверьте, что настройка модуля выполнена корректно ([инструкция](#settings)). Если проблема сохраняется, сообщите об этом специалисту Admitad. ::: 3\. Перейдите в свой личный кабинет Admitad → «Статистика» → «По действиям» и проверьте, что в статистике корректно отображается целевое действие и данные по нему: * целевое действие соответствует настройкам партнерской программы; * ID действия в колонке «ID заказа» соответствует ID действия в вашей системе; * сумма заказа в Admitad соответствует сумме тестового заказа. 4\. Сообщите специалисту Admitad об окончании тестирования — программа будет поставлена на подготовку к запуску. Готово. Модуль интеграции протестирован. # Как удалить плагин для 1С-Битрикс со своего сайта 1\. Откройте административную панель своего сайта. Перейдите в раздел «Доступные решения» (Marketplace → Установленные решения). 2\. В таблице «Доступные решения» найдите модуль «Admitad Интеграция». Откройте контекстное меню слева и выберите «Удалить». ![](https://cdn-support.admitad.ru/images/457ce02aa247677278f499ce1351b5fb.png) 3\. На открывшейся странице снимите галочку «Сохранить таблицы» и затем нажмите «Удалить модуль». Вы увидите сообщение «Удаление модуля успешно завершено». 4\. Нажмите «Вернуться в список». В таблице «Доступные решения» модуль получит новый статус — «Не установлен». Далее вы можете выбрать один из двух вариантов: * **Оставить модуль в списке в статусе «Не установлен»**. В этом случае вы сможете повторно установить уже загруженный плагин, если потребуется. Чтобы повторно установить модуль, в таблице «Доступные решения» откройте контекстное меню модуля, нажмите «Установить» и следуйте [инструкции, начиная с шага 4](#4). * **Стереть модуль из списка доступных решений**. В этом случае модуль будет полностью удален из системы. Чтобы стереть модуль, в таблице «Доступные решения» откройте контекстное меню модуля и нажмите «Стереть». Готово, модуль интеграции с Admitad удален.