Js check: Difference between revisions

Revision as of 17:03, 6 March 2023

Интеграция предназначена для проверки трафика на лендингах, web-страницах. Когда пользователь заходит на страницу наш скрипт собирает данные и отправляет на сервер. На сервере данные анализируются и пишутся в базу данных. Вы можете смотреть накопленные данные в статистике. Если вы хотите сразу перенаправлять ботовый трафик после проверки, есть возможность сделать это через настройки.

Шаг 1

Для того, чтобы создать интеграцию с типом JS сheck выберите пункт Get JS check на странице Интеграции.

Шаг 2

Вы попадёте на страницу создания интеграции. Там надо будет заполнить поля с названием интеграции и выбрать её статус.

Sub-метки

При желании вы можете разметить кампанию метками. Доступно до 7 суб-меток, они будут писаться в отдельные поля базы данных. Кнопка encode делает метку безопасной для URL. Вы можете заполнить их прямо тут, в форме, тогда они будут храниться в базе и если вам надо будет что-то поправить, они всегда будут под рукой. Или вы можете оставить поля пустыми.

Примеры заполнения меток

Если ваш лендинг написан на PHP и параметры для меток приходят в URL, можно доставать их прямо оттуда:

Или если вы используете какой-то шаблонизатор, типа mustache или jinja, то поля будут выглядеть как-то так:

Traffic-back URL

Если вы хотите, чтобы фродовый трафик автоматически перенаправлялся на какую-то страницу, укажите её URL в поле Traffic-back URL

File:Js check 7.png

Скрипт для вставки

Внизу размещён сгенерированный скрипт, который вы можете скопировать кнопкой Copy и разместить у себя на странице в теге body.

Ни в коем случае не меняйтся поле kmnrKey, в нём указан уникальный ID вашей интеграции. Если он будет отличаться от сохранённого, клики не будут писаться в базу.

или так:

kmnr.onResponse

Если вы хотите сами обрабатывать фродовые показы, и, например, в зависимости от источника трафика редиректить их на разные URL, можете добавить в window.kmnr поле kmnr.onResponse. Это функция, которая принимает на вход объект { fraud }, где fraud может иметь значение 0 или 1.

File:Js check 11.png

Обратите внимание, что если вы укажете и kmnr.onResponse и Traffic-back URL, то поскольку kmnr.onResponse отдалает большим приоритетом, Traffic-back URL будет игнорироваться.

Остановка кампании

Если вы захотите остановить кампанию, измените статус интеграции на blocked. Новая статистика по кампании перестанет писаться, но вы по прежнему будете способны править настройки, смотреть накопленную статистику, запускать кампанию снова.

Удаление кампании

Если вы захотите удалить кампанию, измените статус интеграции на deleted, или нажмите кнопку delete в списке. После удаления интеграция и статистика по ней станут недоступны.

@@ Line 12: / Line 12: @@
 === Sub-метки ===
-При желании вы можете разметить кампанию метками. Доступно до 7 суб-меток, они будут писаться в отдельные поля базы данных. Кнопка encode делает метку безопасной для URL. Вы можете заполнить их прямо тут, или потом, когда будете вставлять скрипт на страницу.
+При желании вы можете разметить кампанию метками. Доступно до 7 суб-меток, они будут писаться в отдельные поля базы данных. Кнопка encode делает метку безопасной для URL. Вы можете заполнить их прямо тут, в форме, тогда они будут храниться в базе и если вам надо будет что-то поправить, они всегда будут под рукой. Или вы можете оставить поля пустыми.
+==== Примеры заполнения меток ====
+Если ваш лендинг написан на PHP и параметры для меток приходят в URL, можно доставать их прямо оттуда:
+[[File:Js check 12.png]]
+Или если вы используете какой-то шаблонизатор, типа mustache или jinja, то поля будут выглядеть как-то так:
+[[File:Js check 5.png]]
 === Traffic-back URL ===
 Если вы хотите, чтобы фродовый трафик автоматически перенаправлялся на какую-то страницу, укажите её URL в поле Traffic-back URL
+[[File:Js check 7.png]]
 === Скрипт для вставки ===
 Внизу размещён сгенерированный скрипт, который вы можете скопировать кнопкой Copy и разместить у себя на странице в теге body.
-Ни в коем случае не меняйтся поле kmnrKey, в нём указан уникальный ID вашей интеграции. Если он будет отличаться от сохранённого, клики не будут писаться в базу.
+'''Ни в коем случае не меняйтся поле kmnrKey, в нём указан уникальный ID вашей интеграции. Если он будет отличаться от сохранённого, клики не будут писаться в базу.'''
+[[File:Js check 13.png]]
+или так:
+[[File:Js check 6.png]]
 === kmnr.onResponse ===
-Если вы хотите сами обрабатывать фродовые показы, можете добавить в window.kmnr поле kmnr.onResponse. Это функция, которая принимает на вход объект { fraud }, где fraud может иметь значение 0 или 1.
+Если вы хотите сами обрабатывать фродовые показы, и, например, в зависимости от источника трафика редиректить их на разные URL, можете добавить в window.kmnr поле kmnr.onResponse. Это функция, которая принимает на вход объект { fraud }, где fraud может иметь значение 0 или 1.
-onResponse: function(response) { if (response.fraud == 1) { window.location = 'some.url' } }
-kmnr.onResponse обладает большим приоритетом, чем Traffic-back URL
+[[File:Js check 11.png]]
+Обратите внимание, что если вы укажете и kmnr.onResponse и Traffic-back URL, то поскольку kmnr.onResponse отдалает большим приоритетом, Traffic-back URL будет игнорироваться.
 === Остановка кампании ===
-Если вы захотите остановить кампанию, измените статус интеграции на blocked.
+Если вы захотите остановить кампанию, измените статус интеграции на blocked. Новая статистика по кампании перестанет писаться, но вы по прежнему будете способны править настройки, смотреть накопленную статистику, запускать кампанию снова.
+[[File:Js check 8.png]]
 === Удаление кампании ===
-Если вы захотите удалить кампанию, измените статус интеграции на deleted, или нажать кнопку delete в списке. После этого она перестанет быть доступна.
+Если вы захотите удалить кампанию, измените статус интеграции на deleted, или нажмите кнопку delete в списке. После удаления интеграция и статистика по ней станут недоступны.
+[[File:Js check 9.png]]