Latest revision as of 15:55, 3 January 2024

Other languages:

If you want to take control of handling fraudulent impressions yourself, for example, redirecting them to different URLs based on the traffic source, the onResponse option will assist you.

Please note that this option is only available in JS check type integrations.

Option Activation

Request the activation of the onResponse option from your manager for your integration. Once enabled, implement its logic after activation.

After implementing the function, it will appear in the window.kmnr.onResponse field in the generated script code, which you can copy using the Copy button and place on your page within the <head> tag.

Signature

The function takes as argument object { fraud, block }, where fraud can have a value of 0 (legitimate impression) or 1 (bot impression), and block can have a value of 0 (legitimate impression) or 1 (click was blocked according to the integration settings)

function(response) {
    if (response.block == 1) {
        // blocked click
        window.location = 'some.url';
    } else if (response.fraud == 1) {
        // bot
        window.location = 'some.url';
    } else {
        // not a bot
        showAd();
    }
}

Interaction with Traffic-back URL

If you have an integration with both the onResponse and Traffic-back URL options enabled, keep in mind that onResponse takes precedence. In this case, the Traffic-back URL will be ignored.

@@ Line 1: / Line 1: @@
 <languages/>
-Если вы хотите сами решать что делать с фродовыми показами, и, например, в зависимости от источника трафика редиректить их на разные URL, вам поможет опция '''onResponse'''.
+If you want to take control of handling fraudulent impressions yourself, for example, redirecting them to different URLs based on the traffic source, the '''onResponse''' option will assist you.
-'''Обратите внимание, опция доступна только в интеграциях типа ''JS check''.'''
+'''Please note that this option is only available in ''JS check'' type integrations.'''
-= Подключение опции =
+= Option Activation =
-Закажите у менеджера включение опции '''onResponse''' на своей интеграции. После того как её включат, реализуйте её логику.
+Request the activation of the '''onResponse''' option from your manager for your integration. Once enabled, implement its logic after activation.
 [[File:On response.png]]
-После реализации функции, она появится в поле ''window.kmnr.onResponse'' в сгенерированном коде скрипта, который вы можете скопировать кнопкой ''Copy'' и разместить у себя на странице в теге <code><body></code>.
+After implementing the function, it will appear in the ''window.kmnr.onResponse'' field in the generated script code, which you can copy using the ''Copy'' button and place on your page within the <code><head></code> tag.
 [[File:On response2.png]]
-= Сигнатура =
+= Signature =
-Функция принимает на вход объект <code>{ fraud }</code>, где ''fraud'' может иметь значение '''0''' (хороший показ) или '''1''' (ботовый показ).
+The function takes as argument object <code>{ fraud, block }</code>, where ''fraud'' can have a value of '''0''' (legitimate impression) or '''1''' (bot impression), and ''block'' can have a value of '''0''' (legitimate impression) or '''1''' (click was blocked according to the integration settings)
 <pre>
 function(response) {
-     if (response.fraud == 1) {
+     if (response.block == 1) {
+        // blocked click
+        window.location = 'some.url';
+    } else if (response.fraud == 1) {
          // bot
          window.location = 'some.url';
@@ Line 29: / Line 32: @@
 </pre>
-= Взаимодействие с Traffic-back URL =
+= Interaction with Traffic-back URL =
-Если на вашей интеграции одновременно включены и опция '''onResponse''', и опция '''[[Traffic_back_URL|Traffic-back URL]]''', то поскольку '''onResponse''' обладает большим приоритетом, '''Traffic-back URL''' будет игнорироваться.
+If you have an integration with both the '''onResponse''' and '''[[Traffic_back_URL|Traffic-back URL]]''' options enabled, keep in mind that '''onResponse''' takes precedence. In this case, the '''Traffic-back URL''' will be ignored.
 [[Category:Features]]