Tracker

index.rst

@@ -10,6 +10,7 @@ Adspect: документация
    vla
    use-cases
    streams
+   tracker
    reporting
    tips
    pitfalls

streams.md

@@ -84,6 +84,35 @@ https://example.com/index.php?__sid=1ea85c7c-b977-6804-8e69-00162501c2b4
 
 Этот функционал особенно полезен для работы с т.н. deep-ссылками, которые ведут на контент внутри мобильных приложений.
 
+### Макросы ссылок и PHP-переменные
+
+Adspect поддерживает макросы в ссылках для перенаправления и соответствующие им PHP-переменные для использования
+в PHP-лэндингах:
+
+* `{clickid}` и `$_SERVER["ADSPECT_CLICK_ID"]`: уникальный идентификатор клика — внешний из параметра ссылки,
+  либо сгенерированный Adspect;
+* `{country}` и `$_SERVER["ADSPECT_COUNTRY"]`: [ISO 3166-1 alpha-2](https://ru.wikipedia.org/wiki/ISO_3166-1_alpha-2)
+  код страны посетителя;
+* `{os}` и `$_SERVER["ADSPECT_OS"]`: операционная система посетителя и ее версия в случае Windows и Android
+  (*PHP-переменная может содержать специальные символы и должна быть закодирована для использования в ссылке
+  при помощи* `rawurlencode()`);
+* `{browser}` и `$_SERVER["ADSPECT_BROWSER"]`: название браузера посетителя
+  (*PHP-переменная может содержать специальные символы и должна быть закодирована при помощи* `rawurlencode()`);
+
+Пример использования в ссылке:
+
+```
+https://example.com/?clickid={clickid}&geo={country}&os={os}
+```
+
+Пример использования в коде PHP-лэндинга:
+
+```php
+<a href="https://example.com/offer?clickid=<?= $_SERVER["ADSPECT_CLICK_ID"] ?>">
+	Это ссылка на оффер со встроенным в нее click ID
+</a>
+```
+
 ## Белая страница
 
 Это безопасная страница, которую можно показывать модераторам, роботам, скрейперам и т.п. Она не должна содержать
@@ -163,6 +192,11 @@ https://tracker.test/lander/index.php?subid={zoneid}-{platform}
 Это позволяет находить отдельные клики в сырых покликовых отчетах, которые можно выгрузить в формате CSV. Одним из
 способов применения может быть сбор доказательной базы для выявления кликфрода в трафике.
 
+Если параметр не указан, то Adspect сам сгенерирует индентификатор перехода для использования в [трекере](tracker.md).
+В зависимости от того, как именно осуществляется отображение контента/белой страницы, идентификаторы переходов могут
+быть помещены в целевые ссылки при помощи макроса `{clickid}`, либо встроены где угодно в файлы лендингов при помощи
+PHP-переменной `$_SERVER["ADSPECT_CLICK_ID"]`.
+
 ## Режим паранойи
 
 Режим паранойи подключает дополнительные строгие проверки JavaScript-отпечатков, а также обширные черные списки IP-адресов
@@ -171,14 +205,6 @@ https://tracker.test/lander/index.php?subid={zoneid}-{platform}
 
 **Мы рекомендуем включить этот режим при работе с Facebook и Google Ads.**
 
-## Собирать отпечатки в режиме «Модерация»
-
-Эта настройка отвечает за то, будет ли Adspect собирать машинные отпечатки посетителей, когда поток находится в режиме
-«Модерация», либо покажет им белую страницу сразу без дополнительной обработки. Это важно при работе с некоторыми
-особенно строгими рекламными сетями, которым наш JavaScript-код может показаться подозрительным.
-
-С другой стороны, сбор и анализ отпечатков модераторов помогает VLA лучше изучить их и затем точнее определять.
-
 ## Разрешить трафик из мобильных приложений
 
 Эта настройка говорит нам пропускать трафик из мобильных приложений в общем порядке, не считая его априори фродовым.

tracker.md

@@ -0,0 +1,53 @@
+# Трекер
+
+Трекер --- это незаменимый инструмент в цифровой рекламе в целом и в партнерском маркетинге в частности.
+Его главная задача состоит в регистрации конверсий (лидов, заказов, продаж) и отслеживании их до
+конкретных посетителей, ранее пришедших на сайт или оффер. Это позволяет маркетологам собирать статистику
+по конверсиям и анализировать ее в различных разрезах, выстраивая так называемые
+[воронки продаж](https://ru.wikipedia.org/wiki/%D0%92%D0%BE%D1%80%D0%BE%D0%BD%D0%BA%D0%B0_%D0%BF%D1%80%D0%BE%D0%B4%D0%B0%D0%B6).
+
+Adspect имеет встроенный в ядро системы трекер, легкий, но в то же время эффективный и полнофункциональный.
+В разделе [Статистика](reporting.md) личного кабинета вы можете строить и анализировать различные воронки,
+используя любые комбинации доступных группировок и фильтров. В числе прочего, статистика Adspect считает и
+отображает такие важнейшие маркетинговые показатели, как конверсии, расход, доход, CR (коэффициент конверсии),
+ROI (возврат инвестиций), CPA (цену лида) и EPC (доходность перехода) / EPM (доходность тысячи переходов).
+Эти метрики особенно полезны в комбинации с группировкой по отдельным площадкам в источнике трафика, как
+описано в [параграфе о настройке Sub ID](streams.html#sub-id).
+
+## Postback
+
+Для того, чтобы использовать трекер, вам понадобится настроить postback --- «отстук» информации о конверсиях
+на postback URL, который вы можете найти в вашем профиле. Мы принимаем postback любым из доступных HTTP-методов:
+`GET`, `POST`, `PUT` и др. Postback URL принимает три параметра:
+
+1. `aid` --- ID аккаунта в Adspect, который заранее указан в ссылке и обычно не меняется;
+2. `cid` --- уникальный идентификатор перехода, с которого произошла конверсия;
+3. `sum` (необязательно) --- сумма выплаты за конверсию при работе по моделям CPA и revenue share.
+
+Большинство партнерских программ и сетей поддерживают postback и предоставляют различные макросы, которые
+можно использовать для заполнения переменных частей postback-ссылки (параметры `cid` и `sum`). Если вам нужно
+делать postback самостоятельно, то вы можете разместить пиксель конверсии где-нибудь, например на странице
+«Спасибо за заказ». Код пикселя может выглядеть следующим образом (положим, что ID перехода передается в
+параметре ссылки `clickid`):
+
+```html
+<script>
+(function () {
+  const cid = new URLSearchParams(location.search).get("clickid");
+  const url = "https://rpc.adspect.net/v1/postback?aid=1ea704aa-d0d3-6262-bf65-ac1f6b95a853&cid=" + cid;
+  fetch(url, {mode: "no-cors"});
+})();
+</script>
+```
+
+При успешной регистрации конверсии запрос будет завершен HTTP-кодом ответа 200 и текстом `OK`.
+
+## ID переходов
+
+Чтобы конверсия была зарегистрирована и обработана, Adspect необходимо иметь данные о предшествующем ей
+переходе в базе данных статистики, то есть ранее должен быть зарегистрирован переход с тем же ID перехода.
+Вы можете использовать внешние ID переходов, например генерируемые рекламной сетью, для чего следует указать
+имя параметра ссылки, содержащего ID перехода, в поле [Click ID](streams.html#click-id) в настройках потока.
+Вы также можете оставить поле Click ID пустым, и тогда Adspect будет самостоятельно генерировать ID переходов.
+Postback-ссылка принимает без ошибок ранее не встречавшиеся ID переходов, однако такие конверсии будут отброшены
+на более поздних стадиях обработки.