Для того, чтобы подключить сервис Adopty к вашему сайту, нужно скопировать и вставить скрипт в код вашего сайта. Код для вставки можно скопировать из раздела Настройки→Установка.

Для работы с Adopty не требуется установки дополнительных программ на компьютер и плагинов в браузер. Также не требуется навыков программирования, поэтому вы можете передать создание обучающих модулей рядовому менеджеру или маркетологу.

Для корректной работы туров нужно добавить идентификацию посетителя.

Идентификация посетителя

В Adopty нужно отправить данные посетителя, чтобы можно было их собирать, анализировать и запускать туры. Для этого, после добавления скрипта из установки, нужно добавить код:

	<script>
		adopty.identify({
			USER_ID: "ID",
			USER_HASH: "HASH",
		});
	</script>

USER_ID мы используем для объединения пользователей с разных устройств. Как только пользователь авторизуется в вашей системе необходимо передать нам его ID.

USER_ID — ID пользователя в вашей системе.

USER_HASH — хеш HMAC SHA 256 (Текстом для хеширования является USER_ID, ключом - User Auth Secret его можно узнать в разделе Настройки→Установка). USER_HASH не обязательный параметр, но предотвращает вас от подделки данных и злоумышленников. Служит своего рода подписью. Вы можете включить обязательную подпись пользователя, чтобы другие не попадали в вашу базу данных. Его обязательно нужно генерировать на сервере, чтобы не давать доступ к User Auth Secret (держите его в секрете).

Пример на PHP:

$userId = '…';
$hash = hash_hmac('sha256', $userId, 'User-Auth-Key' );
echo "adopty.identify({USER_ID: '".$userId."', USER_HASH: '".$hash."'});"

Как выбрать правильный USER_ID**?**

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

Есть два правила:

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

USER_ID не обязательно должен быть числом, допускаются строки длиной не более 255 символов. Рекомендуется использовать числовой идентификатор.

Можно в качестве USER_ID взять составную строку из разных данных. Например, у вас один пользователь может использовать несколько продуктов в системе и для каждого продукта вам нужно делать отдельное обучение, следить на пользователем и считать метрики. В данном случае можно использовать USER_ID:

USER_ID = {ID} + "-" + {PRODUCT_ID};

Дополнительные свойства