General settings/ru: Difference between revisions

From Wiki Kaminari Click
(Updating to match new version of source page)
(Created page with "File:Js check 12.png")
 
Line 1: Line 1:
<languages/>
<languages/>
<div lang="en" dir="ltr" class="mw-content-ltr">
<span id="Create_an_integration"></span>
= Create an integration =
= Создание интеграции =
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Для того, чтобы создать интеграцию выберите пункт '''Get JS Check''', '''Get Meta Redirect''' на странице [https://kaminari.click/integration Integration].
To create an integration, select '''Get JS Check''' or '''Get Meta Redirect''' option on the [https://kaminari.click/integration Integration] page.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
[[File:Settings 5.png]]
[[File:Settings 5.png]]
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<br>
<br>
You will be redirected to the integration creation page. You will need to fill in the required integration name field and select the integration status (choose ''Active'' if you want to launch it immediately or ''Stopped'' if you need more time).
Вы попадёте на страницу создания интеграции. Вам надо будет заполнить поле с названием интеграции (оно является обязательным), и выбрать статус интеграции (если вы хотите сразу же запустить её, выберите ''Active'', если вам ещё надо время, выберите ''Stopped'').
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
[[File:Settings 4.png]]
[[File:Settings 4.png]]
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<br>
<br>
= Sub-tags =
= Sub-метки =
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
При желании вы можете размечать входящий трафик метками. Вы можете передавать нам до семи различных параметров (от '''Sub1''' до '''Sub7''') каждый из них будет отображаться в статистике отдельной колонкой.
If desired, you can tag incoming traffic with tags. You can pass up to seven different parameters to us (from '''Sub1''' to '''Sub7'''), each of which will be displayed as a separate column in the statistics.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
== Передача параметров ==
== Passing parameters ==
Для этого надо пробросить выбранные параметры в конфиг нашего скрипта. Реализация зависит от языка програмирования и от того как именно вы получаете эти данные. Рассмотим самый простой вариант — язык программирования [https://www.php.net/ PHP] или [https://developer.mozilla.org/en-US/docs/Web/JavaScript JS], а параметры приходят прямо в ссылке.
To do this, you need to forward the selected parameters into the config of our script. The implementation depends on the programming language and how you receive this data. Let's consider the simplest scenario — the programming language is [https://www.php.net/ PHP] or [https://developer.mozilla.org/en-US/docs/Web/JavaScript JS], and the parameters come directly in the URL.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Например, наш скрипт насположен на вашей странице
For example, our script is located on the your page
<pre>https://example.com/page1?utm_source=10&utm_campaign=93637&utm_click=144639372218154527</pre>
<pre>https://example.com/page1?utm_source=10&utm_campaign=93637&utm_click=144639372218154527</pre>
and you want to pass <code>utm_source</code> to <code>sub1</code>, <code>utm_campaign</code> to <code>sub2</code>, and <code>utm_click</code> to <code>sub3</code>.
и вы хотите прокидывать <code>utm_source</code> как <code>sub1</code>, <code>utm_campaign</code> как <code>sub2</code>, and <code>utm_click</code> как <code>sub3</code>.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
На PHP это можно сделать таким образом:
In PHP, you can do this as follows:
<pre>
<pre>
<script>
<script>
Line 51: Line 33:
         sub3: '<?= $_GET['utm_click'] ?>',
         sub3: '<?= $_GET['utm_click'] ?>',
     };
     };
</div>


     <div lang="en" dir="ltr" class="mw-content-ltr">
     var kmnrSc = document.createElement('script');
var kmnrSc = document.createElement('script');
     var kmnrPrnt = document.getElementsByTagName('head')[0] || document.body;
     var kmnrPrnt = document.getElementsByTagName('head')[0] || document.body;
     kmnrSc.setAttribute('async', true);
     kmnrSc.setAttribute('async', true);
Line 62: Line 42:
</script>
</script>
</pre>
</pre>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
На JS:
In JS:
<pre>
<pre>
<script>
<script>
     var params = new URLSearchParams(location.href)
     var params = new URLSearchParams(location.href)
</div>


     <div lang="en" dir="ltr" class="mw-content-ltr">
     window.kmnr = {
window.kmnr = {
         kmnrKey: 'YYYYYYYYY',
         kmnrKey: 'YYYYYYYYY',
         sub1: params.get('utm_source') || '',
         sub1: params.get('utm_source') || '',
Line 78: Line 54:
         sub3: params.get('utm_click') || '',
         sub3: params.get('utm_click') || '',
     };
     };
</div>


     <div lang="en" dir="ltr" class="mw-content-ltr">
     var kmnrSc = document.createElement('script');
var kmnrSc = document.createElement('script');
     var kmnrPrnt = document.getElementsByTagName('head')[0] || document.body;
     var kmnrPrnt = document.getElementsByTagName('head')[0] || document.body;
     kmnrSc.setAttribute('async', true);
     kmnrSc.setAttribute('async', true);
Line 89: Line 63:
</script>
</script>
</pre>
</pre>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
== Сохранение конфигурации ==
== Configuration saving ==
Вы можете заполнить поля суб-меток прямо тут, в форме, тогда они будут храниться в базе и если вам надо будет что-то поправить, они всегда будут под рукой. Или вы можете оставить поля пустыми и настраивать проброс меток прямо на лендинге.
You can fill in the sub-tag fields here in the form, and they will be stored in the database. If you need to make any adjustments, they will always be at your fingertips. Alternatively, you can leave the fields blank and configure tags on your landing.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Кнопка ''encode'' делает метку безопасной для URL.
The ''encode'' button makes the tag safe for URLs.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<br>
<br>
==== Examples of tag filling ====
==== Примеры заполнения меток ====
For example, if your landing page is written in PHP and the parameters for the tags come in the URL, you can extract them directly from there:
Например, если ваш лендинг написан на PHP и параметры для меток приходят в URL, можно доставать их прямо оттуда:
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
[[File:Js check 12.png]]
[[File:Js check 12.png]]
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Или если вы используете шаблонизатор типа Mustache или Jinja, то поля могут выглядеть как-то так:
<br>
Or if you're using a template engine like Mustache or Jinja, the fields may look something like this:
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
[[File:Js check 5.png]]
[[File:Js check 5.png]]
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<br>
<br>
= Embed code =
= Код для вставки =
After filling out the form, a generated script or link code will appear at the bottom of the page, which you can copy using the ''Copy'' button and place on your page in the <code><head></code> tag.
После заполнения формы, внизу страницы появится сгенерированный код скрипта или ссылки, который вы можете скопировать кнопкой ''Copy'' и разместить у себя на странице в теге <code><head></code>.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<br />
'''Under no circumstances should you change the kmnrKey field, which specifies the unique ID of your integration. If it differs from the saved one, clicks will not be recorded in the database.'''
'''Ни в коем случае не меняйтся поле kmnrKey, в нём указан уникальный ID вашей интеграции. Если он будет отличаться от сохранённого, клики не будут писаться в базу.'''
</div>
<br />


<div lang="en" dir="ltr" class="mw-content-ltr">
[[File:Js check 13.png]]
[[File:Js check 13.png]]
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
или так:
<br>
or like this:
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
[[File:Js check 6.png]]
[[File:Js check 6.png]]
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<br>
<br>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
= Остановка интеграции =
= Integration stop =
Если вы захотите остановить интеграцию, измените её статус на ''Stopped''. Новая статистика перестанет писаться, но вы по прежнему сможете править настройки, смотреть накопленную статистику, запускать интеграцию.
If you want to stop the integration, change its status to ''Stopped''. New statistics will stop being recorded, but you will still be able to edit the settings, view the accumulated statistics, and start the integration again.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
[[File:Settings 3.png]]
[[File:Settings 3.png]]
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<br>
<br>
= Modifying or deleting an integration =
= Изменение или удаление интеграции =
If you want to modify or delete an integration, click on the ''Edit'' or ''Delete'' button in the list.  
Если вы захотите изменить или удалить интеграцию, нажмите на кнопку ''Edit'' или ''Delete'' в списке.
'''Note that after deletion, the integration and its statistics will become unavailable.'''
'''Обратите внимание: после удаления интеграция и статистика по ней станут недоступны.'''
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
[[File:Settings 2.png]]
[[File:Settings 2.png]]
</div>

Latest revision as of 14:06, 8 March 2024

Other languages:

Создание интеграции

Для того, чтобы создать интеграцию выберите пункт Get JS Check, Get Meta Redirect на странице Integration.

Settings 5.png


Вы попадёте на страницу создания интеграции. Вам надо будет заполнить поле с названием интеграции (оно является обязательным), и выбрать статус интеграции (если вы хотите сразу же запустить её, выберите Active, если вам ещё надо время, выберите Stopped).

Settings 4.png


Sub-метки

При желании вы можете размечать входящий трафик метками. Вы можете передавать нам до семи различных параметров (от Sub1 до Sub7) каждый из них будет отображаться в статистике отдельной колонкой.

Передача параметров

Для этого надо пробросить выбранные параметры в конфиг нашего скрипта. Реализация зависит от языка програмирования и от того как именно вы получаете эти данные. Рассмотим самый простой вариант — язык программирования PHP или JS, а параметры приходят прямо в ссылке.

Например, наш скрипт насположен на вашей странице 

https://example.com/page1?utm_source=10&utm_campaign=93637&utm_click=144639372218154527

и вы хотите прокидывать utm_source как sub1, utm_campaign как sub2, and utm_click как sub3.

На PHP это можно сделать таким образом: 

<script>
    window.kmnr = {
        kmnrKey: 'YYYYYYYYY',
        sub1: '<?= $_GET['utm_source'] ?>',
        sub2: '<?= $_GET['utm_campaign'] ?>',
        sub3: '<?= $_GET['utm_click'] ?>',
    };

    var kmnrSc = document.createElement('script');
    var kmnrPrnt = document.getElementsByTagName('head')[0] || document.body;
    kmnrSc.setAttribute('async', true);
    kmnrSc.setAttribute('charset', 'utf-8');
    kmnrSc.src = '//kaminari.systems/v1/script.js?kmnrKey=' + window.kmnr.kmnrKey;
    kmnrPrnt && kmnrPrnt.appendChild(kmnrSc);
</script>

На JS: 

<script>
    var params = new URLSearchParams(location.href)

    window.kmnr = {
        kmnrKey: 'YYYYYYYYY',
        sub1: params.get('utm_source') || '',
        sub2: params.get('utm_campaign') || '',
        sub3: params.get('utm_click') || '',
    };

    var kmnrSc = document.createElement('script');
    var kmnrPrnt = document.getElementsByTagName('head')[0] || document.body;
    kmnrSc.setAttribute('async', true);
    kmnrSc.setAttribute('charset', 'utf-8');
    kmnrSc.src = '//kaminari.systems/v1/script.js?kmnrKey=' + window.kmnr.kmnrKey;
    kmnrPrnt && kmnrPrnt.appendChild(kmnrSc);
</script>

Сохранение конфигурации

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

Кнопка encode делает метку безопасной для URL.


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

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

Js check 12.png

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

Js check 5.png


Код для вставки

После заполнения формы, внизу страницы появится сгенерированный код скрипта или ссылки, который вы можете скопировать кнопкой Copy и разместить у себя на странице в теге <head>.


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

Js check 13.png

или так:

Js check 6.png


Остановка интеграции

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

Settings 3.png


Изменение или удаление интеграции

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

Settings 2.png

Retrieved from "https://wiki.kaminari.click/index.php?title=General_settings/ru&oldid=1134"