Подключение сайта на внешнем хостинге
Ваш сайт живёт на собственном хостинге, доступа к его серверу у Qubix нет, а заходы, нажатия, формы и события сайта нужны в Qubix вместе со всем остальным. Такой сайт подключается кодом, который работает в браузере посетителя: страница остаётся на вашем сервере, а браузер сообщает Qubix, что на ней происходит. Код один на сайт, сколько бы источников ни закупали на него трафик.
Если сайт загружен в Qubix, добавлять в него ничего не нужно — см. Размещение сайта в Qubix.
Как подключить сайт
- Откройте раздел Сайты и нажмите + Внешний сайт.
- Введите название сайта и его адрес, например
https://my-landing.com. Оставьте Трекинг событий включённым; отметьте Запись сессий, если нужны и записи сессий. Нажмите Создать. - Откройте карточку сайта. На вкладке Внешний сайт найдите блок Подключение сайта.
- В списке Домен Qubix выберите домен, с которого будет загружаться код. Это один из доменов раздела Домены, а не адрес панели. Если список пуст, сначала добавьте домен.
- Поставьте код на каждую страницу сайта одним из двух способов ниже и опубликуйте страницы.
Если у сайта выключены оба переключателя — Трекинг событий и Запись сессий, — блок кода не показывает: вместо него надпись, а при праве на управление сайтами — переключатель Трекинг событий прямо в блоке. Включённый переключатель начинает действовать в течение минуты.
Способ 1: скрипт с домена Qubix
Скопируйте блок Скрипт с домена Qubix и вставьте его в <head> каждой страницы. Код выглядит так:
<script src="https://your-qubix-domain.com/sdk.js" data-site="WEBSITE-ID" async></script>
Атрибут data-site несёт идентификатор этого сайта, поэтому код сам называет свой сайт. Если включена Запись сессий, в блоке вторая строка — скрипт записи сессий.
Страница шлёт заходы и события прямо на домен Qubix, а опознаватель посетителя хранится в хранилище браузера на домене вашего сайта. Этот способ работает, пока у этого сайта или у любого другого внешнего сайта того же домена включён переключатель Трекинг событий или Запись сессий: разрешение принадлежит домену. Без него Qubix не выдаёт странице опознаватель посетителя, и каждое событие засчитывается новому посетителю. http и https, а также адрес с www. и без него здесь считаются разными доменами.
Способ 2: через ваш nginx
В блоке Через ваш nginx — два блока location и скрипт. Добавьте блоки в раздел server вашего сайта, а скрипт — в <head> каждой страницы:
location /pwa-api/ {
proxy_pass https://your-qubix-domain.com/pwa-api/;
proxy_set_header Host your-qubix-domain.com;
proxy_ssl_server_name on;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
set $qubix_visitor_ip $remote_addr;
if ($http_cf_connecting_ip) { set $qubix_visitor_ip $http_cf_connecting_ip; }
proxy_set_header X-Qubix-Visitor-IP $qubix_visitor_ip;
}
location = /sdk.js {
proxy_pass https://your-qubix-domain.com/sdk.js;
proxy_set_header Host your-qubix-domain.com;
proxy_ssl_server_name on;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
<script src="/sdk.js" data-site="WEBSITE-ID" async></script>
Теперь адреса /pwa-api/ и /sdk.js вашего сайта ведут в Qubix, и браузер видит один сайт: опознаватель посетителя — кука на домене вашего сайта. События, пришедшие через ваш сервер, принимаются при любом положении переключателей.
Последние три строки первого блока передают Qubix IP-адрес посетителя — от Cloudflare, если ваш сайт стоит за ним. По этому адресу Qubix определяет страну посетителя. Без этих строк каждый посетитель получит адрес и страну вашего сервера. Адрес из этого заголовка Qubix берёт таким, каким он пришёл, и не проверяет, кто его поставил.
Что считает код
Код считает сам, без ваших вызовов:
- заход — когда страница открыта не с другой страницы того же сайта: с объявления, по ссылке откуда-то ещё или вводом адреса. Объявление берётся из параметра
ad_idадреса; - следующие страницы того же сайта продолжают этот заход и новых не засчитывают;
- нажатия и формы — на каждой странице.
Регистрации и депозиты приходят постбэком партнёрки, как обычно, либо их шлёт бэкенд вашего сайта — см. Если у сайта свой бэкенд. Свои шаги на странице размечаются через sdk.sendEvent — см. Разметьте свои шаги.
Числа — на вкладке Статистика карточки сайта, см. Статистика вашего лендинга.
Если у сайта свой бэкенд
Регистрации и депозиты ваш бэкенд — на PHP или на чём угодно — может слать в Qubix сам, без браузера: запросом на адрес постбэка, так же, как это делает партнёрка.
- Возьмите адрес постбэка в карточке домена с ролью Постбэк — см. Настройки домена.
- На странице возьмите идентификатор клика у кода учёта —
sdk.getTrackingParams().click_id— и передайте его бэкенду вместе с заявкой, например скрытым полем формы. - Когда бэкенд принял регистрацию или депозит, он зовёт адрес постбэка с этим идентификатором:
# регистрация
curl "https://pb.your-domain.com/postback?subid=CLICK_ID&status=lead&from=mysite"
# депозит
curl "https://pb.your-domain.com/postback?subid=CLICK_ID&status=sale&payout=50¤cy=USD&from=mysite"
Конверсия встаёт к своему клику, кампании и объявлению. Все параметры и их синонимы — в статье Передача параметров и постбэк.
Какой кампании принадлежит заход
Заход принадлежит той кампании трекера, чья точка входа накрывает адрес страницы — её домен и путь. Если на этой точке входа стоят несколько кампаний, одну из них выбирает клик по тем же правилам, что и на сайте, размещённом в Qubix, — см. Один лендинг — несколько источников. Точки входа кампании выбираются из доменов раздела Домены.
Если ни у одной кампании нет точки входа на адресе страницы, заходы и события всё равно считаются по сайту, но не принадлежат ни одной кампании. Конверсии таких заходов в Facebook не отправляются: сопоставление событий Facebook берётся у источника кампании захода — см. FB CAPI.