Conversions/en - Revision history

FuzzyBot: Updating to match new version of source page

2025-01-28T03:09:26Z

Updating to match new version of source page

← Older revision		Revision as of 03:09, 28 January 2025
Line 18:		Line 18:

	= Postback =		= Postback =
	For any type of integration after conversion, send us a postback to the URL <code>https://kaminari.~~click~~/v1/conversion</code> with the following parameters:		For any type of integration after conversion, send us a postback to the URL <code>https://kaminari.systems/v1/conversion</code> with the following parameters:

	<pre>https://kaminari.~~space~~/v1/conversion?kmnrKey=111111111&cnvId=CONVERSION_ID&sub1=111&sub2=222&sub3=333&sub4=444&sub5=555&sub6=666&sub7=777&status=~~approved~~&currency=RUB&payout=12</pre>		<pre>https://kaminari.systems/v1/conversion?kmnrKey=111111111&cnvId=CONVERSION_ID&sub1=111&sub2=222&sub3=333&sub4=444&sub5=555&sub6=666&sub7=777&status=l1&currency=RUB&payout=12</pre>

	{\| class="wikitable"		{\| class="wikitable"
Line 44:		Line 44:
	\| sub7 \|\| ... \|\| optional		\| sub7 \|\| ... \|\| optional
	\|-		\|-
	\| status \|\| Conversion status, possible values are: <code>~~approved~~</code>, <code>~~reject~~</code>, <code>~~hold~~</code>, <code>~~test~~</code> \|\| '''required'''		\| status \|\| Conversion status, possible values are: <code>l1</code>, <code>l2</code>, <code>l3</code>, <code>l4</code> \|\| '''required'''
	\|-		\|-
	\| currency \|\| Conversion currency (<code>RUB</code>, <code>USD</code>, <code>EUR</code>). Complete list of possible values: [https://www.xe.com/iso4217.php ISO 4217] \|\| optional		\| currency \|\| Conversion currency (<code>RUB</code>, <code>USD</code>, <code>EUR</code>). Complete list of possible values: [https://www.xe.com/iso4217.php ISO 4217] \|\| optional

FuzzyBot: Updating to match new version of source page

2024-10-23T21:10:15Z

Updating to match new version of source page

← Older revision		Revision as of 21:10, 23 October 2024
Line 1:		Line 1:
	<languages/>		<languages/>
	If you want to check conversions with our help, ~~ask your manager to~~ activate the '''Conversions''' option on your integration.		If you want to check conversions with our help, activate the '''Conversions''' option on your integration.

	= General workflow =		= General workflow =
Line 20:		Line 20:
	For any type of integration after conversion, send us a postback to the URL <code>https://kaminari.click/v1/conversion</code> with the following parameters:		For any type of integration after conversion, send us a postback to the URL <code>https://kaminari.click/v1/conversion</code> with the following parameters:

	<pre>https://kaminari.~~click~~/v1/conversion?kmnrKey=111111111&cnvId=CONVERSION_ID&sub1=111&sub2=222&sub3=333&sub4=444&sub5=555&sub6=666&sub7=777&status=approved&currency=RUB&payout=12</pre>		<pre>https://kaminari.space/v1/conversion?kmnrKey=111111111&cnvId=CONVERSION_ID&sub1=111&sub2=222&sub3=333&sub4=444&sub5=555&sub6=666&sub7=777&status=approved&currency=RUB&payout=12</pre>

	{\| class="wikitable"		{\| class="wikitable"

FuzzyBot: Updating to match new version of source page

2024-02-11T15:43:19Z

Updating to match new version of source page

New page

<languages/>
If you want to check conversions with our help, ask your manager to activate the '''Conversions''' option on your integration.

= General workflow =
At the hit, you run our script and pass it the unique identifier of the hit in the <code>cnvId</code> parameter. We check the visitor and write the verification results to the database.

After the conversion has occurred, you send us a postback with the same unique identifier. With its help, we combine conversion and hit's verification and display the result in statistics.

= Implementation JS Check-type integration =
Add the <code>cnvId</code> key to <code>window.kmnr</code> with any unique identifier convenient for you.

[[File:Conversion 1.png]]

= Implementation Meta Redirect-type integration =
Add the <code>cnvId</code> parameter into URL.

<pre>https://kaminari.systems/v1/click?kmnrKey=111111111&cnvId=CONVERSION_ID&u=https%3A%2F%2Fsome.url</pre>

= Postback =
For any type of integration after conversion, send us a postback to the URL <code>https://kaminari.click/v1/conversion</code> with the following parameters:

<pre>https://kaminari.click/v1/conversion?kmnrKey=111111111&cnvId=CONVERSION_ID&sub1=111&sub2=222&sub3=333&sub4=444&sub5=555&sub6=666&sub7=777&status=approved&currency=RUB&payout=12</pre>

{| class="wikitable"
|-
! Name !! Value !! -
|-
| cnvId || Unique conversion identifier convenient for you || '''required'''
|-
| kmnrKey || Integration identifier || '''required'''
|-
| sub1 || Sub-tags that were sent with the hit || optional
|-
| sub2 || ... || optional
|-
| sub3 || ... || optional
|-
| sub4 || ... || optional
|-
| sub5 || ... || optional
|-
| sub6 || ... || optional
|-
| sub7 || ... || optional
|-
| status || Conversion status, possible values are: <code>approved</code>, <code>reject</code>, <code>hold</code>, <code>test</code> || '''required'''
|-
| currency || Conversion currency (<code>RUB</code>, <code>USD</code>, <code>EUR</code>). Complete list of possible values: [https://www.xe.com/iso4217.php ISO 4217] || optional
|-
| payout || Conversion payout || optional
|}

= How to view conversions in statistics =
After the option is enabled and the parameter <code>cnvId</code> passing mechanism is implemented, you will see the '''Conversion''' metric in your statistics. With its help, you can see which slices converted more and which converted less. For example, we are looking at a '''Sub 5''' slice.

[[File:Conversion 2.png]]

If you click on the conversion value, you will be taken to a table that will only show impressions that converted. For example, there were four conversions on the <code>Sub 5 = 807</code>, and here we can look at them in detail.

[[File:Conversion 3.png]]

To exit this slice and return to the previous table, click on the arrow under the column heading '''Conversions'''.