Playbook

streams.md

@@ -510,7 +510,7 @@ Sub ID --- это параметр ссылки, по которому можн
 ссылку для передачи в трекер при помощи макроса, например `{zoneid}`:
 
 ```
-https://tracker.test/lander/index.php?subid={zoneid}
+https://example.com/?subid={zoneid}
 ```
 
 Для каждого клика рекламная сеть заменит этот макрос `{zoneid}` фактическим номером зоны, из которой пришел клик,
@@ -523,7 +523,7 @@ https://tracker.test/lander/index.php?subid={zoneid}
 параметр ссылки. Вы можете комбинировать несколько макросов для получения составного параметра для sub ID, например:
 
 ```
-https://tracker.test/lander/index.php?subid={zoneid}-{platform}
+https://example.com/?subid={zoneid}-{platform}
 ```
 
 В этом примере каждый субаккаунт будет парой из зоны и платформы устройства посетителя.

use-cases.md

@@ -1,50 +1,89 @@
-# Примеры использования
+# Готовые рецепты
 
-**Данная глава не обязательна к прочтению.**
-
-У Adspect есть несколько четко обозначенных способов применения, которые зарекомендовали себя как полезные и
-надежные. Здесь мы прежде всего говорим о двух взаимосвязанных, но тем не менее различных функциях Adspect:
-клоакинг и фильтрация ботов. Остановимся подробнее на каждой.
+Данная глава содержит инструкции для решения наиболее частых задач, основанные на коллективном опыте
+клиентов Adspect.
 
 ## Клоакинг
 
-Клоакинг --- это практика сокрытия настоящего контента, будь то лендинг или CPA-оффер, от тех, для кого этот
-контент не предназначен, по единоличному усмотрению владельца контента. Мы в Adspect твердо верим, что если вы
-не желаете показывать ваш контент кому-либо, то вы должны иметь возможность ограничить доступ, вне зависимости
-от ваших причин. И мы даем вам инструмент для этого. В частности, это означает сокрытие ваших лендингов от
-модераторов рекламных сетей, spy-сервисов и роботов антивирусных компаний. Эти посетители никогда не принесут
-вам конверсий и денег.
+Для клоакинга вам потребуется подписка на тариф "Клоакинг". *Пожалуйста, не пытайтесь клоачить при помощи
+тарифа "Антифрод" --- он не содержит необходимых для клоакинга фильтров и баз данных, так что вы лишь
+потеряете время, нервы и аккаунты!*
+
+### Клоакинг Google Ads
+
+1.  При создании потока выберите источник трафика Google Ads;
+2.  Белую страницу *необходимо* отображать без редиректа;
+3.  Используйте PHP-интеграцию, в идеале в контент-страницу;
+4.  Следуйте всем [общим рекомендациям](recommendations.html).
+
+### Клоакинг Facebook
+
+1.  При создании потока выберите источник трафика Facebook;
+2.  Белую страницу *необходимо* отображать без редиректа;
+3.  *Настоятельно рекомендуется* отображать контент также без редиректа: существуют обоснованные подозрения,
+    что мобильное приложение Facebook шпионит за пользователями, отправляя историю переходов встроенного
+    браузера в Meta Platforms, и таким образом они могут обнаружить редирект на контент без необходимости
+    "пробивания" клоакинга;
+4.  Используйте PHP-интеграцию, в идеале в контент-страницу;
+5.  Следуйте всем [общим рекомендациям](recommendations.html).
+
+### Клоакинг TikTok
+
+1.  При создании потока выберите источник трафика TikTok;
+2.  *Рекомендуется* отображать контент и белую страницу без редиректа;
+3.  В кампании TikTok Ads укажите в рекламной ссылке все доступные макросы (`__CAMPAIGN_ID__`, `__PLACEMENT__`
+    и т.п.);
+4.  Используйте PHP-интеграцию, в идеале в контент-страницу;
+5.  Следуйте всем [общим рекомендациям](recommendations.html).
+
+### Клоакинг in-app
+
+Adspect позволяет легко клоачить контент мобильных приложений, то есть показывать целевым пользователям и модераторам
+разные элементы приложения (пэйволлы, условия, цены и т.п.)
 
-## Обнаружение ботовых площадок
+1.  При создании потока на странице выбора источника трафика выберите Apps API;
+2.  Выполните [прямую PHP-интеграцию](integration.html#id2) путем размещения файла `index.php` на своем домене ---
+    URL этого файла будет простым HTTP API, который отвечает `200 OK` целевым пользователям и
+    `403 Forbidden` всем остальным (модераторам);
+3.  Внутри приложения сделайте простой HTTP-запрос `GET` на URL вашего API и производите дальнейшие действия
+    в зависимости от кода ответа:
+    - 200 -- пользователь целевой, можно показывать чувствительный контент;
+    - любой другой код или ошибка -- считайте пользователя модератором, не показывайте чувствительный контент.
 
-Популярные форматы онлайн-рекламы, такие как баннеры, тизеры, нативная реклама и popunder, все наводнены ботами
+Вы можете изменить формат ответов API при помощи выбора других действий для контента и белой страницы.
+Например, можно возвращать JSON-данные вместо пустого ответа 200 для целевых пользователей:
+
+- Действие: выполнить PHP-код
+- Поле страницы: `echo json_encode(['user_is_legit' => true]);`
+
+## Фильтрация ботовых площадок
+
+Популярные форматы рекламы, такие как баннеры, тизеры, нативная реклама и popunder, все наводнены ботами
 для накрутки кликов --- [кликфродом](https://ru.wikipedia.org/wiki/%D0%9A%D0%BB%D0%B8%D0%BA%D1%84%D1%80%D0%BE%D0%B4).
-Технологии, на которых строятся эти форматы (HTTP, HTML и JavaScript), позволяют относительно легко и дешево
-генерировать автоматические клики --- достаточно выбрать любой из программируемых
-[headless-браузеров](https://en.wikipedia.org/wiki/Headless_browser). Неудивительно, что эти браузеры, изначально
-предназначенные для автоматизации тестирования веб-приложений, активно используются мошенниками для накрутки кликов
-в рекламных сетях, вынуждая рекламодателей платить за то, что никогда не принесет им доход.
-
-Adspect с легкостью обнаруживает их всех. Все, что вам нужно сделать, --- это указать параметр для "Sub ID" в
-настройках потока, как [описано в главе о потоках](streams.html#sub-id). Если вы передадите нам идентификатор
-паблишера, сайта или площадки (будем называть их *источниками* здесь и далее) через параметр ссылки, то вы
-сможете выгружать отчеты с разбивкой по отдельным источникам, содержащие точную статистику о ботах в их трафике.
-Самая правая колонка отчета, "Качество", удобна для оценки и сравнения различных источников и показывает процент
-целевого трафика в общей массе трафика с каждого конкретного источника. Просто выберите разбивку по "Sub ID"
-в поле слева от выбора часового пояса.
-
-Проведя черту, скажем, в минимум 80% целевого трафика, вы легко сможете найти источники, удовлетворяющие этому
-требованию --- кликните на заголовок колонки "Качество", чтобы отсортировать ее по возрастанию или убыванию.
-Источники с качеством выше 80% будут вашим белым списком площадок; наоборот, если вы хотите использовать черный
-список, то им будут источники с качеством ниже 80%. Этот простой метод поможет вам избежать больших и бессмысленных
-трат на составление черных и белых списков в медийной рекламе и popunder-е, как при отсеве по CR (conversion rate).
-Сначала офильтруйте ботовые площадки, а затем уже переходите к фильтрации по конверсиям.
-
-## Сокрытие источников трафика
-
-Многие партнерские сети имеют внутренние отделы медиабаинга ("media buying" --- закупка рекламы), которые могут
-обнаружить ваши источники трафика и использовать эту информацию для кражи ваших рекламных кампаний. Поэтому
-источники трафика следует скрывать от партнерских сетей и любых других третьих лиц. Adspect делает это для вас,
-отрезая [HTTP-заголовок Referer](https://developer.mozilla.org/ru/docs/Web/HTTP/%D0%97%D0%B0%D0%B3%D0%BE%D0%BB%D0%BE%D0%B2%D0%BA%D0%B8/Referer)
-от проходящих через систему кликов, что делает невозможным тривиальное обнаружение ваших источников трафика
-путем анализа журналов веб-серверов в цепочке редиректов.
+Adspect с легкостью обнаруживает их всех, позволяя вам быстро составлять черные списки фродящих
+паблишеров/площадок/сайтов/спотов (далее --- "площадок"):
+
+1.  В настройках потока заполните [поле Sub ID](streams.html#sub-id), указав в нем имя параметра ссылки,
+    в котором рекламная сеть будет передавать идентификатор площадки, например `subid`;
+3.  В рекламной кампании добавьте этот параметр к рекламной ссылке, подставив в него подходящий по смыслу
+    макрос, например `subid={zoneid}` или `subid=__PLACEMENT__` (обратитесь в поддержку рекламной сети,
+    чтобы получить список поддерживаемых макросов);
+3.  В разделе ["Статистика"](reporting.html) личного кабинета выберите разбивку воронки по Sub Id;
+4.  Оцените качество трафика отдельных площадок по колонке "Качество" и составьте черный список площадок,
+    например, с качеством 75% и ниже (т.е. тех, где как минимум ¼ всего трафика --- боты).
+
+Сперва занесите в блеклист фродящие площадки, что сэкономит вам уйму денег на старте, а уже далее переходите
+к фильтрации площадок по прибыли или ROI как обычно.
+
+## Сокрытие источника трафика
+
+Источник трафика обычно легко обнаружить по передаваемому в каждом клике
+[HTTP-заголовку Referer](https://developer.mozilla.org/ru/docs/Web/HTTP/%D0%97%D0%B0%D0%B3%D0%BE%D0%BB%D0%BE%D0%B2%D0%BA%D0%B8/Referer).
+Если вы хотите скрыть его от тех, кто получает ваш трафик, то добавьте следующий код после тега `<head>`
+в PHP-файле вашего потока Adspect (`index.php` или `filter.php`):
+
+```html
+<meta name="referrer" content="no-referrer">
+```
+
+*Внимание:* это имеет смысл только при использовании PHP-интеграции и включенной фильтрации по JavaScript-отпечаткам.