JavaScript integration

overview.md

@@ -43,20 +43,56 @@
 
 Дополнительная информация по основным вопросам представлена в нашем [FAQ](https://www.adspect.dev/faq).
 
-Разделение трафика осуществляется при помощи специального файла, именуемого здесь и далее `index.php`, который
-вы размещаете в папке лэндинга или в любом другом месте, доступном по протоколу HTTP. Этот файл выступает в роли
-точки входа для вашего трафика и работает в паре с нашими серверами, которые уже непосредственно выполняют
+Мы поддерживаем несколько типов интеграции, которые отличаются техническими деталями, но все предоставляют одинаково
+высокий уровень защиты трафика:
+
+* PHP-интеграция при помощи отдельного файла `index.php`;
+* JavaScript-интеграция при помощи HTML-тэга `<script>`:
+  * Пассивный режим без клоакинга, как Google Analytics --- подходит для сбора статистики по ботам;
+  * Клоакинг при помощи JavaScript-редиректа на целевую страницу методом `location.replace()`;
+  * Клоакинг при помощи наложения iframe на белую страницу без редиректа.
+
+## PHP-интеграция
+
+В PHP-интеграции разделение трафика осуществляется при помощи специального файла, именуемого здесь и далее `index.php`,
+который вы размещаете в папке лэндинга или в любом другом месте, доступном по протоколу HTTP. Этот файл выступает
+в роли точки входа для вашего трафика и работает в паре с нашими серверами, которые уже непосредственно выполняют
 фильтрацию. В зависимости от принятого нашими фильтрами решения, посетитель может быть направлен на ваш контент
 (оффер, лэндинг) или на так называемую «белую страницу» --- страницу, которая не содержит никакого чувствительного
 к несанкционированному доступу содержимого. Другими словами, Adspect выступает в роли промежуточного этапа на пути
 прохождения трафика, осуществляя отсев нежелательных посетителей от целевых в реальном времени.
 
-![Схема прохождения трафика](_static/flow-ru.png "Схема прохождения трафика")
+![Схема прохождения трафика](_static/flow-ru.png "Схема прохождения трафика при PHP-интеграции")
 
 Несколько одинаковых файлов `index.php` могут использоваться параллельно для защиты нескольких офферов или лэндингов,
 при этом не мешая друг другу.
 
-## index.php
+## JavaScript-интеграция
+
+JavaScript-интеграция предназначена в первую очередь для использования со сторонними сервисами, такими как Shopify,
+Tilda и OpenCart, где вы не можете загрузить наш файл `index.php` для PHP-интеграции. Она также позволяет вам
+использовать более защищенную и аутентичную с точки зрения рекламных сетей схему клоакинга, в которой посетитель сразу
+попадает на белую страницу, а переход на целевой контент происходит при помощи JavaScript после одобрения нашей системы.
+Такой режим особенно желателен при работе с Facebook и Google Ads.
+
+![Схема прохождения трафика](_static/flow-js-ru.png "Схема прохождения трафика JavaScript-интеграции")
+
+Вам также потребуется загрузить и разместить на сервере наш PHP-скрипт `adspect.php`, но его конкретное расположение
+не имеет значения, так как файл будет подключен к белой странице через HTML-тэг `<script>`. Когда посетитель попадает
+на белую страницу, тэг `<script>` обращается к удаленному файлу `adspect.php`, который отдает наш JavaScript-код для
+фильтрации. Дальнейшее поведение зависит от режима работы, выбранного при интеграции:
+
+* В пассивном режиме обновляется статистика Adspect, но никаких действий не предпринимается --- посетитель останется
+  на белой странице. Этот режим похож на Google Analytics и предназначен для пассивного сбора аналитической информации
+  по ботам в трафике в тех случаях, когда клоакинг не требуется.
+
+* В режиме JavaScript-редиректа благонадежные по мнению наших фильтров посетители будут перенаправлены на страницу контента
+  при помощи JavaScript-редиректа методом `location.replace()`. Это означает, что **URL в адресной строке изменится**.
+
+* В режиме отображения в iframe целевые посетители увидят контент-страницу в [iframe](http://htmlbook.ru/html/iframe)
+  без редиректа, то есть iframe будет наложен поверх белой страницы.
+
+## index.php и adspect.php
 
 `index.php` --- это PHP-скрипт, который является связующим звеном между вашим хостом и нашими бэкенд-серверами.
 Имя файла `index.php` является лишь принятым обозначением, которое мы используем в Adspect, однако вы можете
@@ -75,6 +111,8 @@ PHP 5 поддерживается, PHP 4 *вероятно* также рабо
 проверить, поддерживается ли cURL вашей сборкой PHP, используя информацию из [phpinfo](https://www.php.net/manual/ru/function.phpinfo.php);
 cURL поддерживается подавляющим большинством работающих ныне сборок PHP.
 
+Файл `adspect.php` является лишь измененной версией файла `index.php`, поэтому все сказанное выше также применимо.
+
 ## Хостинг
 
 Мы рекомендуем использовать хостинг от [Inferno Solutions](https://cp.inferno.name/aff.php?aff=2952) из-за
@@ -94,10 +132,10 @@ cURL поддерживается подавляющим большинство
 Типичный порядок работы с Adspect для защиты рекламных кампаний в партнерском маркетинге выглядит следующим образом:
 
 1. [Создаете поток](streams.md) в Adspect и переводите его в режим «Модерация»;
-2. Скачиваете файл `index.php`, привязанный к этому потоку;
-3. Размещаете `index.php` в корневой папке вашего лэндинга, либо в другом месте, доступном извне;
-4. Создаете рекламную кампанию, используя в качестве рекламной ссылки ссылку на файл `index.php`;
-5. Ожидаете одобрения вашей кампании модерацией рекламной сети и переключаете поток в режим «Фильтр»;
-6. Льете трафик и анализируете его показатели в разделе [«Статистика»](reporting.md).
+2. Выбираете подходящий вам тип интеграции и следуете соответствующим инструкциям на странице интеграции;
+3. Создаете рекламную кампанию, используя в качестве рекламной ссылки ссылку на файл `index.php` при PHP-интеграции
+   или на белую страницу, в которую вы встроили наш тэг `<script>`, при JavaScript-интеграции;
+4. Ожидаете одобрения вашей кампании модерацией рекламной сети и переключаете поток в режим «Фильтр»;
+5. Льете трафик и анализируете его показатели в разделе [«Статистика»](reporting.md).
 
 Мы остановимся на тонкостях отдельных шагов этом процессе в следующих главах настоящего руководства.