General settings: Difference between revisions

From Wiki Kaminari Click
(Marked this version for translation)
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[General settings en|English version]]
<languages/>
<translate>
= Create an integration = <!--T:24-->


= Создание интеграции =
<!--T:25-->
 
To create an integration, select '''Get JS Check''' or '''Get Meta Redirect''' option on the [https://kaminari.click/integration Integration] page.
Для того, чтобы создать интеграцию выберите пункт '''Get JS check''', '''Get meta redirect''' на странице [https://kaminari.click/integration Integration].


<!--T:26-->
[[File:Settings 5.png]]
[[File:Settings 5.png]]


<!--T:27-->
<br>
<br>
Вы попадёте на страницу создания интеграции. Вам надо будет заполнить поле с названием интеграции (оно является обязательным), и выбрать статус интеграции (если вы хотите сразу же запустить её, выберите ''Active'', если вам ещё надо время, выберите ''Stopped'').
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).


<!--T:28-->
[[File:Settings 4.png]]
[[File:Settings 4.png]]


<!--T:29-->
<br>
<br>
= Sub-tags =


= Sub-метки =
<!--T:30-->
При желании вы можете размечать входящий трафик метками. В зависимости от типа интеграции вам доступно 7 или 10 суб-меток, каждая из них будет отображаться в статистике отдельной колонкой.
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.


Кнопка ''encode'' делает метку безопасной для URL.
<!--T:31-->
== Passing parameters ==
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.


Вы можете заполнить поля суб-меток прямо тут, в форме, тогда они будут храниться в базе и если вам надо будет что-то поправить, они всегда будут под рукой. Или вы можете оставить поля пустыми.
<!--T:32-->
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>
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>.


<!--T:33-->
In PHP, you can do this as follows:
<pre>
<script>
    window.kmnr = {
        kmnrKey: 'YYYYYYYYY',
        sub1: '<?= $_GET['utm_source'] ?>',
        sub2: '<?= $_GET['utm_campaign'] ?>',
        sub3: '<?= $_GET['utm_click'] ?>',
    };
    <!--T:34-->
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>
</pre>
<!--T:35-->
In JS:
<pre>
<script>
    var params = new URLSearchParams(location.href)
    <!--T:36-->
window.kmnr = {
        kmnrKey: 'YYYYYYYYY',
        sub1: params.get('utm_source') || '',
        sub2: params.get('utm_campaign') || '',
        sub3: params.get('utm_click') || '',
    };
    <!--T:37-->
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>
</pre>
<!--T:38-->
== 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.
<!--T:39-->
The ''encode'' button makes the tag safe for URLs.
<!--T:40-->
<br>
<br>
==== Примеры заполнения меток ====
==== Examples of tag filling ====
Например, если ваш лендинг написан на PHP и параметры для меток приходят в URL, можно доставать их прямо оттуда:
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:


<!--T:41-->
[[File:Js check 12.png]]
[[File:Js check 12.png]]


<!--T:42-->
<br>
<br>
Или если вы используете шаблонизатор типа mustache или jinja, то поля могут выглядеть как-то так:
Or if you're using a template engine like Mustache or Jinja, the fields may look something like this:


<!--T:43-->
[[File:Js check 5.png]]
[[File:Js check 5.png]]


<!--T:44-->
<br>
<br>
= Код для вставки =
= Embed code =
После заполнения формы, внизу страницы появится сгенерированный код скрипта или ссылки, который вы можете скопировать кнопкой ''Copy'' и разместить у себя на странице в теге <code><body></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.


'''Ни в коем случае не меняйтся поле kmnrKey, в нём указан уникальный ID вашей интеграции. Если он будет отличаться от сохранённого, клики не будут писаться в базу.'''
<!--T:45-->
'''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.'''


<!--T:46-->
[[File:Js check 13.png]]
[[File:Js check 13.png]]


<!--T:47-->
<br>
<br>
или так:
or like this:


<!--T:48-->
[[File:Js check 6.png]]
[[File:Js check 6.png]]


<!--T:49-->
<br>
<br>


= Остановка интеграции =
<!--T:50-->
Если вы захотите остановить интеграцию, измените её статус на ''Stopped''. Новая статистика перестанет писаться, но вы по прежнему сможете править настройки, смотреть накопленную статистику, запускать интеграцию.
= Integration stop =
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.


<!--T:51-->
[[File:Settings 3.png]]
[[File:Settings 3.png]]


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


<!--T:53-->
[[File:Settings 2.png]]
[[File:Settings 2.png]]
</translate>

Latest revision as of 13:18, 8 March 2024

Other languages:

Create an integration

To create an integration, select Get JS Check or Get Meta Redirect option on the Integration page.

Settings 5.png


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).

Settings 4.png


Sub-tags

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.

Passing parameters

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 PHP or JS, and the parameters come directly in the URL.

For example, our script is located on the your page 

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

and you want to pass utm_source to sub1, utm_campaign to sub2, and utm_click to sub3.

In PHP, you can do this as follows: 

<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>

In 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>

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.

The encode button makes the tag safe for URLs.


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:

Js check 12.png


Or if you're using a template engine like Mustache or Jinja, the fields may look something like this:

Js check 5.png


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 <head> tag.

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.

Js check 13.png


or like this:

Js check 6.png


Integration stop

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.

Settings 3.png


Modifying or deleting an integration

If you want to modify or delete an integration, click on the Edit or Delete button in the list. Note that after deletion, the integration and its statistics will become unavailable.

Settings 2.png

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