Meta redirect s2s: Difference between revisions

Revision as of 09:34, 9 March 2023

Интеграция предназначена для серьёзных решений без потери кликов.

НАСТРОЙКА ИНТЕГРАЦИИ

Общие настройки

Общая информация по настройке интеграции находится здесь: General settings

Target URL и текст ссылки

Если у вас есть постоянная целевая ссылка, или она передаётся в каком-то параметре, можете указать её в настройках интеграции. Также можете указать текст кликовой ссылки.

Если вы вставляете ссылку, обязательно нажмите кнопку Encode, чтобы она стала безопасной для URL.

Если указываете внешний параметр, кнопку Encode нажимать не надо.

Другой вариант.

НАСТРОЙКА НА СТОРОНЕ СЕРВЕРА

Со своим кликворкером

Чтобы все манипуляции происходили на одном домене. Нет потери на редиректах, нет потери на сетевых запросах, потому что скрипт размещается прямо на странице.

Сервер. На кликворвер приходит клик

Собирается инфа о клике, генерится kmnrId, передаётся на /ping (application/json) kmnrId kmnrKey sub1..10 UA в хидере User-Agent IP клиентский (хидер X-Original-IP) IP x-forwarded-for (хидер X-Forwarded-For) IP x-real-ip (хидер X-Real-IP) referrer acceptLanguage Пример: 'accept-language: en-US,en;q=0.9,uk;q=0.8,ru;q=0.7,sr;q=0.6' 'cache-control: no-cache' 'origin: https://test.my' 'pragma: no-cache' 'referer: https://test.my/' 'sec-ch-ua: "Google Chrome";v="105", "Not)A;Brand";v="8", "Chromium";v="105"' 'sec-ch-ua-mobile: ?0' 'sec-ch-ua-platform: "Windows"' 'sec-fetch-dest: empty' 'sec-fetch-mode: no-cors' 'sec-fetch-site: cross-site' 'user-agent: Mozilla/5.0 (Windows NT 6.3; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/105.0.0.0 Safari/537.36' + {"kmnrKey":"e15f644b-a755-4e96-271c-bd38ba8abb96","kmnrId":"1125570260","utmSource":"test","utmCampaign":"1001","utmMedium":"10","utmSite":"1385282124113622","utmTerm":"222","utmContent":"555666","utmClickId":"8833705265931305","utmBlockId":"94839150","utmPlacementId":"50656068","clickId":432971006,"blockId":333333,"domainId":-2222222,"eventType":"test","susReason":"123"}

Фронт. Кликворкер Шаблон с параметрами и скриптами. Должен храниться на стороне клиента и с какой-то периодичностью подтягиваться от нас.

accept-ch: Width, Viewport-Width, DPR, Device-Memory, Downlink, RTT, ECT, Save-Data, Sec-CH-UA-Arch, Sec-CH-UA-Bitness, Sec-CH-UA-Mobile, Sec-CH-UA-Model, Sec-CH-UA-Platform, Sec-CH-UA-Platform-Version, Sec-CH-UA, Sec-CH-UA-Full-Version access-control-allow-headers: X-Requested-With, Cache-Control, Content-Type access-control-allow-methods: GET, POST, OPTIONS access-control-allow-origin: *

Параметры (заполняются клиентом): {%= url %} - целевой URL {%= kmnrKey %} - kmnrKey {%= kmnrId %} - kmnrId {%= sub1 %} {%= sub2 %} {%= sub3 %} {%= sub4 %} {%= sub5 %} {%= sub6 %} {%= sub7 %} {%= sec_fetch %}

{%l= clickUrl %} - URL, на который скрипт отправит данные {%l= trafficBackUrl %} - заполняем мы

Скрипты: kaminari/click.legacy, clickworker/antifraud.script, kaminari/click.error, kaminari/click.noscript

Наша JS-ка отрабатывает, посылает данные на clickUrl, который расположен на том же домене, что и кликворкер. clickUrl проксирует данные на наш /check.

Кликворкер редиректит на clickUrl.

Данные обрабатываются, пишутся в КХ, на Ping back url (указывается в настройках) шлётся fraud и то, что пришло на /ping req.Header.SetContentType(ApplicationJSON) req.Header.SetMethod("POST")

@@ Line 3: / Line 3: @@
 == НАСТРОЙКА ИНТЕГРАЦИИ ==
-=== Шаг 1 ===
+=== Общие настройки ===
-Для того, чтобы создать интеграцию с типом ''Meta redirect S2S'' выберите пункт '''Get meta redirect S2S''' на странице [https://kaminari.click/integration Интеграции].
+Общая информация по настройке интеграции находится здесь: [[General settings]]
-[[File:Meta redirect s2s 1.png|750px]]
-=== Шаг 2 ===
-Вы попадёте на страницу создания интеграции. Там надо будет заполнить поле с названием интеграции и выбрать её статус.
-[[File:Meta redirect s2s 2.png]]
-=== Sub-метки ===
-При желании вы можете разметить входящий трафик метками. Доступно до 10 суб-меток, каждая из них будет отображаться в статистике. Кнопка encode делает метку безопасной для URL. Вы можете заполнить поля суб-меток прямо тут, в форме, тогда они будут храниться в базе и если вам надо будет что-то поправить, они всегда будут под рукой. Или вы можете оставить поля пустыми.
-==== Примеры заполнения меток ====
-Например, если ваш сайт написан на PHP и параметры для меток приходят в URL, можно доставать их прямо оттуда:
-[[File:Js check 12.png]]
-Или если вы используете шаблонизатор типа mustache или jinja, то поля могут выглядеть как-то так:
-[[File:Js check 5.png]]
 === Target URL и текст ссылки ===
@@ Line 39: / Line 20: @@
 [[File:Meta redirect 7.png]]
-=== Код для вставки ===
-Внизу размещён сгенерированный код ссылки, который вы можете скопировать кнопкой Copy и разместить у себя на странице в теге body.
-'''Ни в коем случае не меняйтся поле kmnrKey, в нём указан уникальный ID вашей интеграции. Если он будет отличаться от сохранённого, клики не будут писаться в базу.'''
-[[File:Js check 13.png]]
-или так:
-[[File:Js check 6.png]]
-=== Остановка кампании ===
-Если вы захотите остановить кампанию, измените статус интеграции на blocked. Новая статистика по кампании перестанет писаться, но вы по прежнему будете способны править настройки, смотреть накопленную статистику, запускать кампанию снова.
-[[File:Js check 8.png]]
-=== Удаление кампании ===
-Если вы захотите удалить кампанию, измените статус интеграции на deleted, или нажмите кнопку delete в списке. После удаления интеграция и статистика по ней станут недоступны.
-[[File:Js check 9.png]]
 == НАСТРОЙКА НА СТОРОНЕ СЕРВЕРА ==