<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
	<id>https://docs.barion.com/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Baloghn</id>
	<title>Barion Documentation - User contributions [en]</title>
	<link rel="self" type="application/atom+xml" href="https://docs.barion.com/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Baloghn"/>
	<link rel="alternate" type="text/html" href="https://docs.barion.com/Special:Contributions/Baloghn"/>
	<updated>2026-11-22T02:37:23Z</updated>
	<subtitle>User contributions</subtitle>
	<generator>MediaWiki 1.43.11</generator>
	<entry>
		<id>https://docs.barion.com/index.php?title=Implementing_the_Base_Barion_Pixel&amp;diff=2506</id>
		<title>Implementing the Base Barion Pixel</title>
		<link rel="alternate" type="text/html" href="https://docs.barion.com/index.php?title=Implementing_the_Base_Barion_Pixel&amp;diff=2506"/>
		<updated>2020-09-21T13:41:35Z</updated>

		<summary type="html">&lt;p&gt;Baloghn: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
{{PageTitle|title= Implementing the Base Barion Pixel}}&lt;br /&gt;
&lt;br /&gt;
= Getting Ready =&lt;br /&gt;
The first prerequisite to implement the Base Barion Pixel irrespective of your webshop is knowing your your Barion Pixel ID. You must paste this Pixel ID into the following code at both locations marked with a red outline. &amp;lt;br&amp;gt;&lt;br /&gt;
The Pixel ID should be pasted without any extra parentheses, breackets or quotes, just as it is in the provided sample, the only difference being the ten characters in the middle and the two at the back.&lt;br /&gt;
&lt;br /&gt;
{{NotificationBox|title=IMPORTANT|text=&lt;br /&gt;
Your Barion Pixel ID can be found in the Details page of your Barion shop. Every webshop (with a unique POSKey) has a different Barion Pixel ID.&lt;br /&gt;
|color=#FF0000}}&lt;br /&gt;
&lt;br /&gt;
{{NotificationBox|title=IMPORTANT|text=&lt;br /&gt;
All Barion Pixel IDs conform to the format of &amp;quot;BP&amp;quot;, ten characters, then two numbers, connected by two dashes, as is provided in the example. Incorrect entries and other formats, such as IDs beginning with &amp;quot;BPT&amp;quot; will prevent the Barion Pixel from operating correctly.&amp;lt;br&amp;gt;&lt;br /&gt;
Be sure to insert your webshop&#039;s unique Barion Pixel ID at both locations in the provided code example, marked by a red outline. The Barion Pixel ID is different in the sandbox and live Barion systems.&lt;br /&gt;
|color=#FF0000}}&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Implementation of the base code&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
    &amp;lt;nowiki&amp;gt;&lt;br /&gt;
        &amp;lt;script&amp;gt;&lt;br /&gt;
            // Create BP element on the window&lt;br /&gt;
            window[&amp;quot;bp&amp;quot;] = window[&amp;quot;bp&amp;quot;] || function () {&lt;br /&gt;
                (window[&amp;quot;bp&amp;quot;].q = window[&amp;quot;bp&amp;quot;].q || []).push(arguments);&lt;br /&gt;
            };&lt;br /&gt;
            window[&amp;quot;bp&amp;quot;].l = 1 * new Date();&lt;br /&gt;
    &lt;br /&gt;
            // Insert a script tag on the top of the head to load bp.js&lt;br /&gt;
            scriptElement = document.createElement(&amp;quot;script&amp;quot;);&lt;br /&gt;
            firstScript = document.getElementsByTagName(&amp;quot;script&amp;quot;)[0];&lt;br /&gt;
            scriptElement.async = true;&lt;br /&gt;
            scriptElement.src = &#039;https://pixel.barion.com/bp.js&#039;;&lt;br /&gt;
            firstScript.parentNode.insertBefore(scriptElement, firstScript);&lt;br /&gt;
            window[&#039;barion_pixel_id&#039;] = &amp;lt;/nowiki&amp;gt;&amp;lt;span style=&amp;quot;color:red&amp;quot;&amp;gt;&#039;BP-0000000000-00&#039;&amp;lt;/span&amp;gt;&amp;lt;nowiki&amp;gt;;            &lt;br /&gt;
&lt;br /&gt;
            // Send init event&lt;br /&gt;
            bp(&#039;init&#039;, &#039;addBarionPixelId&#039;, window[&#039;barion_pixel_id&#039;]);&lt;br /&gt;
        &amp;lt;/script&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;noscript&amp;gt;&lt;br /&gt;
            &amp;lt;img height=&amp;quot;1&amp;quot; width=&amp;quot;1&amp;quot; style=&amp;quot;display:none&amp;quot; alt=&amp;quot;Barion Pixel&amp;quot; src=&amp;quot;https://pixel.barion.com/a.gif?ba_pixel_id=&amp;lt;/nowiki&amp;gt;&amp;lt;span style=&amp;quot;color:red&amp;quot;&amp;gt;&#039;BP-0000000000-00&#039;&amp;lt;/span&amp;gt;&amp;lt;nowiki&amp;gt;&amp;amp;ev=contentView&amp;amp;noscript=1&amp;quot;&amp;gt;&lt;br /&gt;
        &amp;lt;/noscript&amp;gt;&lt;br /&gt;
    &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= Direct HTML implementation =&lt;br /&gt;
&lt;br /&gt;
If you have direct access to the codebase of your website, meaning you can directly edit the HTML code of the pages that are displayed, paste the Base Barion Pixel code into the `&amp;lt;head&amp;gt;` tag of your website. This can be found just after the doctype declarations, and is comprised of various site metadata, such as the title of the current page.&lt;br /&gt;
&lt;br /&gt;
The higher it is in the page markup the better, since our code takes a minimal time to run as the majority of Barion Pixel functions are loaded from an external source which loads asynctronously so that it won&#039;t block your page from loading or cause slowdowns. You should also just directly place the code that it is served with the HTML file, so that it is loaded with the page. Marketing consent management software should not interact with this code, since it should also be present for fraud prevention purposes.&lt;br /&gt;
&lt;br /&gt;
== Static HTML pages ==&lt;br /&gt;
&lt;br /&gt;
If your site is served as a single HTML page optionally extended with CSS or JS files, but not pregenerated server-side, or as a collection of such pages, simply paste the code into the head of each and every page that you serve. If you don&#039;t know if your pages fall into this category, if your webshop doesn&#039;t use PHP, Ruby, AngularJS or some other server-side language, then it usually does.&lt;br /&gt;
&lt;br /&gt;
== Dynamic HTML pages ==&lt;br /&gt;
&lt;br /&gt;
If your site is dynamically generated by server-side templating software (such as PHP, ERB, CSHTML or Jinja), or you use a server side language to preprocess your HTML pages, you should also make sure to have the code in the head of every page of your site. The best practice to do this is to use a persistent layout HTML document which stores the elements of your site that are loaded into every page (such as navigation bars and external JS or CSS libraries), and paste our code into it. If you want, you can also create a loadable subpage usually called a template with our code, and include that page in your layout. The important thing is to ensure that our code appears in every HTML document that you serve as part of your webshop.&lt;br /&gt;
&lt;br /&gt;
= Implementation through third party services =&lt;br /&gt;
&lt;br /&gt;
Implementing the Base Barion Pixel is fully supported by the webshop providers UNAS ([[Az Alap (Base) és a Teljes (Full) Barion Pixel implementációja UNAS webshopokban|see documentation]]) and Shoprenter ([[Az Alap (Base) és a Teljes (Full) Barion Pixel implementációja Shoprenter webshopokban|see documentation]]).&lt;br /&gt;
&lt;br /&gt;
We also support implementing the Base Barion Pixel through the Google Tag Manager ([[Implementing the Barion Pixel through the Google Tag Manager|see documentation]]).&lt;br /&gt;
&lt;br /&gt;
= How it works =&lt;br /&gt;
&lt;br /&gt;
The Base Barion Pixel by itself serves two purposes. It loads the Barion Pixel code, comprised of a JS file called &amp;quot;bp.js&amp;quot; containing the functions of the Pixel and an HTML document named &amp;quot;barion.html&amp;quot; that is used for placing third-party cookies into your webpage. The other function, which is performed by the &amp;quot;bp&amp;quot; function call is to send an &amp;quot;init&amp;quot; event towards our servers which initializes the session if not already present and also tracks the page view event and some general, mostly technical data about the user. In itself, the Base Barion Pixel will not perform any marketing-related functions and it will not load any further code into your users&#039; browser.&lt;br /&gt;
&lt;br /&gt;
You can view what data the Pixel sends yourself in your browser&#039;s console. The message text after implementation is usually &amp;quot;Testing message&amp;quot;, which means your Pixel has not yet been authorized to actually send any data besides the type of the event that is triggered. After Barion authorizes your Pixel to send user data, this changes to &amp;quot;Sending message&amp;quot;. Below this message, the actual data that is sent or would be sent can be inspected, but in the case of the &amp;quot;init&amp;quot; event, this data is filled by the Pixel automatically.&lt;br /&gt;
&lt;br /&gt;
It is also important to note that since your website and Barion have a legitimate interest in preventing payment fraud, the Base Barion Pixel should be loaded irrespective of other marketing consent management software. We will not use any data that lack marketing consent for marketing related purposes, only to combat attempts at payment fraud. This is fully compliant with the General Data Protection Regulation 2016/679 of the European Union and any other regulations that implement this nationally.&lt;/div&gt;</summary>
		<author><name>Baloghn</name></author>
	</entry>
	<entry>
		<id>https://docs.barion.com/index.php?title=Az-Alap-(Base)-Barion-Pixel-implementacioja&amp;diff=2505</id>
		<title>Az-Alap-(Base)-Barion-Pixel-implementacioja</title>
		<link rel="alternate" type="text/html" href="https://docs.barion.com/index.php?title=Az-Alap-(Base)-Barion-Pixel-implementacioja&amp;diff=2505"/>
		<updated>2020-09-21T13:41:02Z</updated>

		<summary type="html">&lt;p&gt;Baloghn: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
{{PageTitle|title= Az Alap (Base) Barion Pixel implementációja}}&lt;br /&gt;
&lt;br /&gt;
= Előkészületek =&lt;br /&gt;
A legfontosabb dolog, amire az Alap (Base) Barion Pixel implementációjához szükséged van, az a boltod Barion Pixel ID-ja. Ezt a Pixel ID-t kell az alábbi kódba mindkét pirossal jelölt helyen beillesztened.&amp;lt;br&amp;gt;&lt;br /&gt;
A Pixel ID beillesztésekor ügyelj arra, hogy a mintával azonos módon kerüljön be, tehát ne kerüljön bele esetleges extra idézőjel vagy zárójel, az egyetlen különbség a példakódtól a középső tíz és az utolsó két karakter lehet.&lt;br /&gt;
&lt;br /&gt;
{{NotificationBox|title=FONTOS|text=&lt;br /&gt;
A boltod Barion Pixel ID-ját a Barion Tárcában találod. Minden bolthoz (minden egyedi POSKey-hez) külön Barion Pixel ID tartozik.&lt;br /&gt;
|color=#FF0000}}&lt;br /&gt;
&lt;br /&gt;
{{NotificationBox|title=FONTOS|text=&lt;br /&gt;
Minden Barion Pixel ID a következő formátumú; először a &amp;quot;BP&amp;quot; karakterek, majd tíz karakter, majd két szám, amely három csoportot kötőjelek választanak el, ahogy a példában is látszik. A hibás megadás vagy rossz formátum a Pixel hibás működését okozza.&amp;lt;br&amp;gt;&lt;br /&gt;
Győződj meg róla, hogy a webshopod Barion Pixel ID-ját az alábbi példakódban található mindkét helyre beillesztetted, amiket a piros kiemelés mutat. A Barion Pixel ID eltér a próba és az éles Barion rendszereken.&lt;br /&gt;
|color=#FF0000}}&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Az alapkód implementációja&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
    &amp;lt;nowiki&amp;gt;&lt;br /&gt;
        &amp;lt;script&amp;gt;&lt;br /&gt;
            // Create BP element on the window&lt;br /&gt;
            window[&amp;quot;bp&amp;quot;] = window[&amp;quot;bp&amp;quot;] || function () {&lt;br /&gt;
                (window[&amp;quot;bp&amp;quot;].q = window[&amp;quot;bp&amp;quot;].q || []).push(arguments);&lt;br /&gt;
            };&lt;br /&gt;
            window[&amp;quot;bp&amp;quot;].l = 1 * new Date();&lt;br /&gt;
    &lt;br /&gt;
            // Insert a script tag on the top of the head to load bp.js&lt;br /&gt;
            scriptElement = document.createElement(&amp;quot;script&amp;quot;);&lt;br /&gt;
            firstScript = document.getElementsByTagName(&amp;quot;script&amp;quot;)[0];&lt;br /&gt;
            scriptElement.async = true;&lt;br /&gt;
            scriptElement.src = &#039;https://pixel.barion.com/bp.js&#039;;&lt;br /&gt;
            firstScript.parentNode.insertBefore(scriptElement, firstScript);&lt;br /&gt;
            window[&#039;barion_pixel_id&#039;] = &amp;lt;/nowiki&amp;gt;&amp;lt;span style=&amp;quot;color:red&amp;quot;&amp;gt;&#039;BP-0000000000-00&#039;&amp;lt;/span&amp;gt;&amp;lt;nowiki&amp;gt;;            &lt;br /&gt;
&lt;br /&gt;
            // Send init event&lt;br /&gt;
            bp(&#039;init&#039;, &#039;addBarionPixelId&#039;, window[&#039;barion_pixel_id&#039;]);&lt;br /&gt;
        &amp;lt;/script&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;noscript&amp;gt;&lt;br /&gt;
            &amp;lt;img height=&amp;quot;1&amp;quot; width=&amp;quot;1&amp;quot; style=&amp;quot;display:none&amp;quot; alt=&amp;quot;Barion Pixel&amp;quot; src=&amp;quot;https://pixel.barion.com/a.gif?ba_pixel_id=&amp;lt;/nowiki&amp;gt;&amp;lt;span style=&amp;quot;color:red&amp;quot;&amp;gt;&#039;BP-0000000000-00&#039;&amp;lt;/span&amp;gt;&amp;lt;nowiki&amp;gt;&amp;amp;ev=contentView&amp;amp;noscript=1&amp;quot;&amp;gt;&lt;br /&gt;
        &amp;lt;/noscript&amp;gt;&lt;br /&gt;
    &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= Implementáció közvetlenül HTML-be =&lt;br /&gt;
&lt;br /&gt;
Ha közvetlen hozzáférésed van a weboldalad kódjához, azaz a megjelenített oldalak HTML kódját közvetlenül tudod szerkeszteni, illeszd az Alap (Base) Barion Pixel kódot a weboldalad &#039;&amp;lt;head&amp;gt;&#039; tagjébe. Ez az oldal tetején a doctype deklarációk alatt található, és az oldal metaadatait tartalmazza, mint például az oldal címe.&lt;br /&gt;
&lt;br /&gt;
Minél magasabban van a kód az oldalon annál jobb, mert maga a kód minimális idő alatt lefut, mivel a Barion Pixel funkcióinak nagy része külső forrásból van betöltve aszinkron módon, tehát nem fogja akadályozni vagy lassítani az oldal működését. Emellett elengedhetetlen, hogy egyszerűen az oldalba legyen helyezve a kód, hogy az oldallal együtt töltődhessen be. Hozzájáruláskezelési szoftver alkalmazása esetén fontos, hogy ezzel a kóddal ne foglalkozzon, mivel működése a csalásmegelőzési célokhoz is szükséges.&lt;br /&gt;
&lt;br /&gt;
== Statikus HTML oldalak ==&lt;br /&gt;
&lt;br /&gt;
Ha az oldalad egyetlen HTML oldalként valósul meg, esetleg külső JS vagy CSS fájlokkal kiegészítve, amit szerver oldalon nem módosítasz, vagy ilyen oldalak halmazaként létezik, egyszerűen illeszd a kódot minden kiszolgált oldal fejlécébe. Ha saját készítésű oldalad van, ami nem használ szerver oldali nyelveket vagy keretrendszereket, mint a PHP, Ruby vagy az AngularJS, valószínűleg ebbe a katágóriába tartozik.&lt;br /&gt;
&lt;br /&gt;
== Dinamikusan generált HTML oldalak ==&lt;br /&gt;
&lt;br /&gt;
Ha az oldaladat valamilyen szerver oldali szofverrel generálod (pl. PHP, ERB, CSHTML or Jinja), vagy valamely szerveroldali nyelvvel előfeldolgozod a HTML oldalaidat, figyelj arra, hogy minden oldal fejlécébe kerüljön bele az alapkód. Erre a bevett gyakorlat egy perzisztens layout dokumentum alkalmazása, ami a minden oldalon megjelenő elemeket tartalmazza (pl. az oldalsávot vagy CSS és JS könyvtárakat), amibe a mi kódunkat is be tudod illeszteni. Ha akarod, egy betölthető aloldalt is csinálhatsz, ami szerveroldalon belekerül a layoutba, ami tartalmazza a mi kódunkat. Az egyetlen fontos dolog, hogy az összes a webshopod részeként kiszolgált HTML oldalban legyen benne a mi kódunk.&lt;br /&gt;
&lt;br /&gt;
= Külső szolgáltatáson keresztüli implementáció =&lt;br /&gt;
&lt;br /&gt;
Az Alap (Base) Barion Pixel implementációja támogatva van az UNAS webáruházakban ([[Az Alap (Base) és a Teljes (Full) Barion Pixel implementációja UNAS webshopokban|lásd a dokumentációt]]) és a Shoprenter webáruházakban ([[Az Alap (Base) és a Teljes (Full) Barion Pixel implementációja Shoprenter webshopokban|lásd a dokumentációt]]).&lt;br /&gt;
&lt;br /&gt;
Ezen kívül támogatjuk a Google Tag Manager-en keresztüli implementációt ([[Az Alap (Base) Barion Pixel implementációja a Google Tag Managerben|lásd a dokumentációt]]).&lt;/div&gt;</summary>
		<author><name>Baloghn</name></author>
	</entry>
	<entry>
		<id>https://docs.barion.com/index.php?title=Barion_Pixel_API_reference&amp;diff=2092</id>
		<title>Barion Pixel API reference</title>
		<link rel="alternate" type="text/html" href="https://docs.barion.com/index.php?title=Barion_Pixel_API_reference&amp;diff=2092"/>
		<updated>2019-09-16T15:32:49Z</updated>

		<summary type="html">&lt;p&gt;Baloghn: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
{{NotificationBox|title=WARNING|text=Barion Pixel will launch very soon.|color=#FF0000}}&lt;br /&gt;
&lt;br /&gt;
{{PageTitle|title=Barion Pixel}}&lt;br /&gt;
&lt;br /&gt;
{| style=&amp;quot;margin-left:2em;&amp;quot; align=&amp;quot;right&amp;quot;&lt;br /&gt;
| __TOC__&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
The Barion Pixel is JavaScript code that allows you to track visitor activity on your website. It works by loading a&lt;br /&gt;
JavaScript function which you can use whenever a site visitor takes an action that you want to track (this action is&lt;br /&gt;
called an event).&lt;br /&gt;
&lt;br /&gt;
In order to implement the Pixel, you will need:&lt;br /&gt;
* access to your website&#039;s HTML code base&lt;br /&gt;
* your Barion Pixel ID that you can access from your Barion Wallet&lt;br /&gt;
&lt;br /&gt;
By default, the Pixel will track pages visited, and the devices your visitors use. In addition, you can use the&lt;br /&gt;
Pixel&#039;s JavaScript function to track other events that are associated with webshop usage and e-commerce. Without&lt;br /&gt;
collecting the consent of the website visitor you must still use the Barion Pixel on your website for fraud management&lt;br /&gt;
purposes. (Tracking visitor behavior for the purposes of preventing fraud is considered a legitimate interest of&lt;br /&gt;
Barion and the merchant in contract with Barion). The implementation of the base code is considered mandatory for using&lt;br /&gt;
the Barion Smart Gateway.&lt;br /&gt;
&lt;br /&gt;
= Implementing the base code =&lt;br /&gt;
&lt;br /&gt;
Implementing the base code is not only required for you to be considered for special offers relating to the Barion&lt;br /&gt;
Pixel, but also for using the Barion Smart Gateway at all. This is based on the fact that both Barion and you as the&lt;br /&gt;
website owner have a legitimate interest in fraud management, and the data provided by the Barion Pixel greatly helps&lt;br /&gt;
these efforts. This, as a legitimate interest case, is fully compliant with the GDPR, and must be implemented&lt;br /&gt;
independently of any consent management software that your site may use.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Init (init) ==&lt;br /&gt;
&lt;br /&gt;
* User intent: View pages on your site&lt;br /&gt;
* To be implemented at: Every page load, in the document head tag&lt;br /&gt;
* Why do we need this: This provides very basic information on user sessions, and can be implemented very easily&lt;br /&gt;
&lt;br /&gt;
To use the Pixel, you need to add the following code (referred to as the base code) between the opening and closing&lt;br /&gt;
&amp;lt;head&amp;gt; tags on every page of your site. Most developers add it to their website&#039;s persistent header, so that it appears&lt;br /&gt;
automatically on all loaded pages. Be sure to insert your unique Barion Pixel ID at both locations in the provided code&lt;br /&gt;
example.&lt;br /&gt;
&lt;br /&gt;
Placing the code within your &amp;lt;head&amp;gt; tags reduces the chances of browsers or third-party code blocking the Pixel&#039;s&lt;br /&gt;
execution. It also executes the code sooner, increasing the chance that your visitors are tracked before they leave your&lt;br /&gt;
page. Sending the data happens asynchronously in the client&#039;s browser so that it does not affect user experience.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Implementation of the base code&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
    &amp;lt;nowiki&amp;gt;&lt;br /&gt;
        &amp;lt;script&amp;gt;&lt;br /&gt;
            (function(i,s,o,g,r,a,m){i[&#039;BarionAnalyticsObject&#039;]=r;i[r]=i[r]||function(){&lt;br /&gt;
            (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),&lt;br /&gt;
            m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)&lt;br /&gt;
            })(window, document, &#039;script&#039;, &#039;https://pixel.barion.com/bp.js&#039;, &#039;bp&#039;);&lt;br /&gt;
&lt;br /&gt;
            // send page view event&lt;br /&gt;
            bp(&#039;init&#039;, &#039;addBarionPixelId&#039;, &#039;&amp;lt;/nowiki&amp;gt;&amp;lt;span style=&amp;quot;color:red&amp;quot;&amp;gt;[YOUR BARION PIXEL ID GOES HERE]&amp;lt;/span&amp;gt;&amp;lt;nowiki&amp;gt;&#039;);&lt;br /&gt;
        &amp;lt;/script&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;noscript&amp;gt;&lt;br /&gt;
            &amp;lt;img height=&amp;quot;1&amp;quot; width=&amp;quot;1&amp;quot; style=&amp;quot;display:none&amp;quot; src=&amp;quot;https://pixel.barion.com/a.gif?__ba_pixel_id=&amp;lt;/nowiki&amp;gt;&amp;lt;span style=&amp;quot;color:red&amp;quot;&amp;gt;[YOUR BARION PIXEL ID GOES HERE]&amp;lt;/span&amp;gt;&amp;lt;nowiki&amp;gt;&amp;amp;ev=contentView&amp;amp;noscript=1&amp;quot;/&amp;gt;&lt;br /&gt;
        &amp;lt;/noscript&amp;gt;&lt;br /&gt;
    &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; Implementing the base code in the Google Tag Manager &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Google Tag Manager enables managing custom JavaScript snippets and HTML tags. The steps below outline how to implement the Base Code in the GTM.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;gallery mode=&amp;quot;slideshow&amp;quot; widths=1662px heights=1662px&amp;gt;&lt;br /&gt;
Image:Datamongtm-1.png|1. GTM screen&lt;br /&gt;
Image:Datamongtm-2.png|2. Click on Tags in Current Workspace on the left side&lt;br /&gt;
Image:Datamongtm-3.png|3. Click on New on the screen that appears&lt;br /&gt;
Image:Datamongtm-4.png|4. Name the tag as you like, for example to &amp;quot;Barion Pixel - Base Code&amp;quot;&lt;br /&gt;
Image:Datamongtm-5.png|5. Click into the &amp;quot;Choose a tag&amp;quot; box&lt;br /&gt;
Image:Datamongtm-6.png|6. Choose &amp;quot;Custom HTML&amp;quot; in the dropdown&lt;br /&gt;
Image:Datamongtm-7.png|7. Paste the Base Code into the HTML box&lt;br /&gt;
Image:Datamongtm-8.png|8. Put your own Pixel ID into both places&lt;br /&gt;
Image:Datamongtm-9.png|9. Verify that you have put your own Pixel ID into both places&lt;br /&gt;
Image:Datamongtm-10.png|10. Click into the &amp;quot;Triggering&amp;quot; box&lt;br /&gt;
Image:Datamongtm-11.png|11. Choose &amp;quot;All Pages&amp;quot; from the list&lt;br /&gt;
Image:Datamongtm-12.png|12. Verify triggering on all pages and your Pixel ID in both places, then click &amp;quot;Save&amp;quot;&lt;br /&gt;
Image:Datamongtm-13.png|13.The new tag shoud appear in the Tags list&lt;br /&gt;
&amp;lt;/gallery&amp;gt;&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
= Full Implementation =&lt;br /&gt;
&lt;br /&gt;
This is the list of all events that are supported by the Barion Pixel. You have to implement the following events on your site in every location applicable. The more accurately you implement these, the better service quality we can provide for you, especially in connection to your market and your users, as we will receive more and better data about them. Events may require parameters that must be included in the bp function call as a JS object. These contain additional information about an event, for example product IDs, categories, and the number of products purchased. If any properties are not required and are not applicable in your case, you can simply skip them. When the implementation is finished, all events must be checked by watching browser console messages throughout a test purchase.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Consent (grantConsent, rejectConsent) ==&lt;br /&gt;
&lt;br /&gt;
* User intent: Give or reject Barion Pixel consent&lt;br /&gt;
* To be implemented at: Inside your own consent management software&lt;br /&gt;
* Why do we need this: Participation of webshop clients is entirely consent based complying with the GDPR&lt;br /&gt;
&lt;br /&gt;
Consent events determine which of the sent data can be used by us for marketing purposes. Two consent events can be&lt;br /&gt;
used to control user consent. The &amp;quot;grantConsent&amp;quot; event has to be sent when the visitor accepts the cookie policy&lt;br /&gt;
that expressly allows Barion to use data for marketing purposes. Sending this event must be handled by your own consent&lt;br /&gt;
management implementation that you are responsible for as outlined in our terms. The &amp;quot;rejectConsent&amp;quot; event should be&lt;br /&gt;
sent when the customer rejects the cookie policy that includes Barion Pixel functionality. It should be noted that&lt;br /&gt;
rejecting Barion marketing consent does not mean that no data should be sent towards Barion, as Barion has a legitimate&lt;br /&gt;
interest using this data for fraud management. Rejecting Barion consent however means that the data from that session&lt;br /&gt;
will not be used for marketing purposes at all, despite receiving it. All consent events are sent by calling the Pixel&#039;s&lt;br /&gt;
consent function as shown below. Usage of a fully compliant consent management platform (CMP) is strongly recommended by Barion. You can find our recommendation [[#Consent_management_requirements|here]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Consent event implementation example&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
    &amp;lt;nowiki&amp;gt;&lt;br /&gt;
        bp(&#039;consent&#039;, &#039;grantConsent&#039;);&lt;br /&gt;
        bp(&#039;consent&#039;, &#039;rejectConsent&#039;);&lt;br /&gt;
    &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Content View (contentView) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Page load&#039;&#039; of item pages minimally, preferably on all pages that refers to a single item, offer or promotion&lt;br /&gt;
* User intent: View the page that shows a single offer described exclusively&lt;br /&gt;
* Why do we need this: Offer descriptions help us know more about your offers&lt;br /&gt;
&lt;br /&gt;
This event should be fired when one of your users enters a page that refers to one of your items that can be bought,&lt;br /&gt;
and describes it in general terms, with an offer to buy. This can be something like an offer page on an e-commerce&lt;br /&gt;
website or a product page on a retail site. It is important to not confuse this with a full product detail page where&lt;br /&gt;
the product itself is described in greater detail, but there is no information on price, shipping and other details that&lt;br /&gt;
are relevant to you offer, like in the case of a product manual.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Content view event properties  &#039;&#039;&#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| If this is a product page as per minimal requirements, this value should be &amp;quot;Product&amp;quot;. Otherwise select a value that best fits from these: Page/Product/Article/Promotion/Banner/Misc.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES (in case of &amp;quot;Product&amp;quot;)&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| The currency that the product price is provided in, preferably in the three letter ISO 4217 format (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| An unique ID that you have for the offer, this can be your ID for the product, an SKU or a promotion ID.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The full name that you have for the offer, for example a product name (eg. Red Bull 24pcs carton). Please note that item names should be consistent in all events.&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| YES (in case of &amp;quot;Product&amp;quot;)&lt;br /&gt;
| float&lt;br /&gt;
| The quantity of the product offered as initially given on the page.&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES (in case of &amp;quot;Product&amp;quot;)&lt;br /&gt;
| text&lt;br /&gt;
| The unit that your offer is measured in (eg. pieces, kg, m).&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES (in case of &amp;quot;Product&amp;quot;)&lt;br /&gt;
| float&lt;br /&gt;
| The price of one measurement of your offer in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The brand of the offer.&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| | The subcategory branch (preferred, eg. &#039;clothes|shoes|winter&#039;, separate levels with &#039;|&#039;) or single category (eg. &#039;winter shoes&#039; or &#039;summer shoes&#039;) of the offer.&lt;br /&gt;
|-&lt;br /&gt;
! [[#Special_properties|contents]]&lt;br /&gt;
| NO&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing multiple items of the offer. For more details see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The name or description of the promotion, for example a promotion picture filename or slogan.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| A metric that you define that measures the value of the action performed to your business.&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) of the offer if available.&lt;br /&gt;
|-&lt;br /&gt;
! imageUrl&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The URL of the image of the viewed item.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The function of the loaded page from one of these possible values: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc&lt;br /&gt;
|-&lt;br /&gt;
! positioning&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The product&#039;s position in a list or collection (e.g. 2) or the position of the promotion on a page (e.g. banner_slot_1).&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| NO&lt;br /&gt;
| integer&lt;br /&gt;
| If the page is displayed along the checkout process, the checkout step number that the page is displayed in, numbered from 0 as the checkout initiation.&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the offer from the list of possible identical items (eg. the color of a phone or the time and venue of a concert or movie)&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;span style=&amp;quot;font-size:80%; line-height: 1.31em;&amp;quot;&amp;gt;(*It&#039;s possible to add [[#Special_properties|custom property]])&amp;lt;/span&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Content view event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For physical items &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // example properties for a product page&lt;br /&gt;
        var contentViewProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;quantity&#039;: 10.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 4990.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;creative&#039;: undefined,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;ProductPage&#039;,&lt;br /&gt;
            &#039;positioning&#039;: undefined,&lt;br /&gt;
            &#039;step&#039;: undefined,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // example properties on a home page for a promotion of a product&lt;br /&gt;
        var contentViewProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Promotion&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;quantity&#039;: 10.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 4990.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;creative&#039;: &#039;book_promo_02&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;HomePage&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;2&#039;,&lt;br /&gt;
            &#039;step&#039;: undefined,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // example properties on a checkout page for a promotion of a product&lt;br /&gt;
        var contentViewProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Promotion&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;quantity&#039;: 10.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 4990.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;creative&#039;: &#039;also_bought_05&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;5&#039;,&lt;br /&gt;
            &#039;step&#039;: 2,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        bp(&#039;track&#039;, &#039;contentView&#039;, contentViewProperties);&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For ticket sellers &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // example properties for a product page&lt;br /&gt;
        var contentViewProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;metalica_12&#039;,&lt;br /&gt;
            &#039;name&#039;: &#039;Metallica&#039;,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 300.0,&lt;br /&gt;
            &#039;brand&#039;: undefined,&lt;br /&gt;
            &#039;category&#039;: &#039;Pop|Metal&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;creative&#039;: undefined,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: undefined,&lt;br /&gt;
            &#039;imageUrl&#039;: &amp;quot;https://www.revolvermag.com/sites/default/files/styles/image_954_x_537/public/media/images/article/metallicapr.jpg&amp;quot;,&lt;br /&gt;
            &#039;list&#039;: &#039;ProductPage&#039;,&lt;br /&gt;
            &#039;positioning&#039;: undefined,&lt;br /&gt;
            &#039;step&#039;: undefined,&lt;br /&gt;
            &#039;variant&#039;: &#039;2019.06.08 20:00|Slane Castle&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // example properties on a home page for a promotion of a product&lt;br /&gt;
        var contentViewProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Promotion&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;metalica_12&#039;,&lt;br /&gt;
            &#039;name&#039;: &#039;Metallica&#039;,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 300.0,&lt;br /&gt;
            &#039;brand&#039;: undefined,&lt;br /&gt;
            &#039;category&#039;: &#039;Pop|Metal&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;creative&#039;: &#039;metallica_promo_02&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: undefined,&lt;br /&gt;
            &#039;imageUrl&#039;: &amp;quot;https://www.revolvermag.com/sites/default/files/styles/image_954_x_537/public/media/images/article/metallicapr.jpg&amp;quot;,&lt;br /&gt;
            &#039;list&#039;: &#039;HomePage&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;2&#039;,&lt;br /&gt;
            &#039;step&#039;: undefined,&lt;br /&gt;
            &#039;variant&#039;: &#039;2019.06.08 20:00|Slane Castle&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // example properties on a checkout page for a promotion of a product&lt;br /&gt;
        var contentViewProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Promotion&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;metalica_12&#039;,&lt;br /&gt;
            &#039;name&#039;: &#039;Metallica&#039;,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 300.0,&lt;br /&gt;
            &#039;brand&#039;: undefined,&lt;br /&gt;
            &#039;category&#039;: &#039;Pop|Metal&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;creative&#039;: &#039;also_bought_05&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: undefined,&lt;br /&gt;
            &#039;imageUrl&#039;: &amp;quot;https://www.revolvermag.com/sites/default/files/styles/image_954_x_537/public/media/images/article/metallicapr.jpg&amp;quot;,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;5&#039;,&lt;br /&gt;
            &#039;step&#039;: 2,&lt;br /&gt;
            &#039;variant&#039;: &#039;2019.06.08 20:00|Slane Castle&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        bp(&#039;track&#039;, &#039;contentView&#039;, contentViewProperties);&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Add to Cart (addToCart) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; that results in a product to be selected for purchase&lt;br /&gt;
* User intent: Select product for purchase&lt;br /&gt;
* Why do we need this: Users demonstrate strong interest in your items by selecting them for purchase&lt;br /&gt;
&lt;br /&gt;
The add to cart event is, as its name suggests, connected to a user &amp;quot;adding a product to their cart&amp;quot;. Usually this means&lt;br /&gt;
that a user decide to purchase a product or service, and has added this item to their cart. Even if your website does&lt;br /&gt;
not use carts in the literal sense, there is a point in a user session where the given user decides that they intend to&lt;br /&gt;
purchase the product. This exact intent is what we want to capture here, so the button click which best matches the&lt;br /&gt;
point of this intent, such as one labeled &#039;Buy&#039; or &#039;Reserve&#039; should be the one to attach this event to.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Add to cart event properties&#039;&#039;&#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Usually, this value should be &amp;quot;Product&amp;quot;.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| The currency that the price is provided in, preferably in the three letter ISO 4217 format (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| An unique ID that you have for the item, this can be your ID for the product, an SKU or a promotion ID.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The full name that you have for the added item, for example a product name (eg. Red Bull 24pcs carton).&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The quantity of the item added to the cart.&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The total price of the added items in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The unit that your item is measured in (eg. pieces, kg, hours).&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The price of one measurement of your item in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The brand of the item.&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| | The subcategory branch (preferred, eg. &#039;clothes|shoes|winter&#039;, separate levels with &#039;|&#039;) or single category (eg. &#039;winter shoes&#039; or &#039;summer shoes&#039;) of the item.&lt;br /&gt;
|-&lt;br /&gt;
! [[#Special_properties|contents]]&lt;br /&gt;
| NO&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing multiple items of the item. For more details see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The coupon code that was used when the item was added to cart.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The name or description of the promotion for the item, for example a promotion picture filename or slogan of the promotion that adds the items to the cart automatically.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| A metric that you define that measures the value of the action performed to your business.&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) of the offer if available.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The function of the loaded page from one of these possible values: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc&lt;br /&gt;
|-&lt;br /&gt;
! positioning&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The item&#039;s position in a list or collection (e.g. 2) or the position of the promotion on a page (e.g. banner_slot_1).&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| NO&lt;br /&gt;
| integer&lt;br /&gt;
| If the page is displayed along the checkout process, the checkout step number that the page is displayed in, numbered from 0 as the checkout initiation.&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the offer from the list of possible identical items (eg. the color of a phone or the time and venue of a concert or movie)&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;span style=&amp;quot;font-size:80%; line-height: 1.31em;&amp;quot;&amp;gt;(*It&#039;s possible to add [[#Special_properties|custom property]])&amp;lt;/span&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Add to cart event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For physical items &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample product data for single items&lt;br /&gt;
        var addToCartProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;quantity&#039;: 10.0,&lt;br /&gt;
            &#039;totalItemPrice&#039;: 49900.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 4990.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;product_page_promo_42&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;ProductPage&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;3&#039;,&lt;br /&gt;
            &#039;step&#039;: undefined,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // sample product data for bundled items&lt;br /&gt;
        var addToCartProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42pack&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;quantity&#039;: 10.0,&lt;br /&gt;
            &#039;totalItemPrice&#039;: 150000.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 15000.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;add_to_cart_promo_42&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;BasketPage&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;3&#039;,&lt;br /&gt;
            &#039;step&#039;: undefined,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;addtocart_button&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;addToCart&#039;, addToCartProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#addtocart_button&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;addToCart&#039;, addToCartProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For ticket sellers &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|    // sample product data for single items&lt;br /&gt;
        var addToCartProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;metalica_12&#039;,&lt;br /&gt;
            &#039;name&#039;: &#039;Metallica&#039;,&lt;br /&gt;
            &#039;quantity&#039;: 2.0,&lt;br /&gt;
            &#039;totalItemPrice&#039;: 600.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 300.0,&lt;br /&gt;
            &#039;brand&#039;: undefined,&lt;br /&gt;
            &#039;category&#039;: &#039;Pop|Metal&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;product_page_promo_metallica&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: undefined,&lt;br /&gt;
            &#039;list&#039;: &#039;ProductPage&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;3&#039;,&lt;br /&gt;
            &#039;step&#039;: undefined,&lt;br /&gt;
            &#039;variant&#039;: &#039;2019.06.08 20:00|Slane Castle&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // sample product data for bundled items&lt;br /&gt;
        var addToCartProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;spring_festival_two_tickets&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Spring Festival ticket&amp;quot;,&lt;br /&gt;
            &#039;quantity&#039;: 2.0,&lt;br /&gt;
            &#039;totalItemPrice&#039;: 1800.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 900.0,&lt;br /&gt;
            &#039;brand&#039;: undefined,&lt;br /&gt;
            &#039;category&#039;: &#039;Festival&#039;,&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;metalica_12&#039;,&lt;br /&gt;
                &#039;name&#039;: &#039;Metallica&#039;,&lt;br /&gt;
                &#039;quantity&#039;: 2.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 800.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 400.0,&lt;br /&gt;
                &#039;brand&#039;: undefined,&lt;br /&gt;
                &#039;category&#039;: &#039;Pop|Metal&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;Early Bird&#039;,&lt;br /&gt;
                &#039;ean&#039;: undefined,&lt;br /&gt;
                &#039;imageUrl&#039;: &amp;quot;https://www.revolvermag.com/sites/default/files/styles/image_954_x_537/public/media/images/article/metallicapr.jpg&amp;quot;,&lt;br /&gt;
                &#039;variant&#039;: &#039;2019.06.08 20:00|Slane Castle&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;snoop_dog_2019&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Snoop Dog&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 2.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 1000.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 500,&lt;br /&gt;
                &#039;brand&#039;: undefined,&lt;br /&gt;
                &#039;category&#039;: &#039;Rap&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;Early Bird&#039;,&lt;br /&gt;
                &#039;ean&#039;: undefined,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://cdn1.thr.com/sites/default/files/2012/08/snoop-dogg-pr-08-p.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;2019.06.08 20:00|Slane Castle&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;add_to_cart_promo_42&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: undefined,&lt;br /&gt;
            &#039;list&#039;: &#039;BasketPage&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;3&#039;,&lt;br /&gt;
            &#039;step&#039;: undefined,&lt;br /&gt;
            &#039;variant&#039;: &#039;2019.06.08 20:00|Slane Castle&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;addtocart_button&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;addToCart&#039;, addToCartProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#addtocart_button&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;addToCart&#039;, addToCartProperties);&lt;br /&gt;
        });&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Initiate Checkout (initiateCheckout) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; that starts the checkout process&lt;br /&gt;
* User intent: Purchase the items in the cart&lt;br /&gt;
* Why do we need this: Users usually are put off by adverts of an item they already purchased, but can be receptive to related products&lt;br /&gt;
&lt;br /&gt;
Usually on a webshop, there is a checkout process that starts with clicking a button with items in your cart. This&lt;br /&gt;
button click is the one that this event should be attached to. After this click, typically the user has to provide other&lt;br /&gt;
data, such as a shipping address and method, and confirm the purchase (which should fire the initiate purchase event).&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Initiate checkout event properties&#039;&#039;&#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! [[#Special_properties|contents]]&lt;br /&gt;
| YES&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing the actual items contained in the cart, meaning the shipping and coupons should be excluded. For the detailed format see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| The currency that the price is provided in, preferably in the three letter ISO 4217 format (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! revenue&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The total revenue associated with the transaction in the given currency. This should include all costs the customer pays like shipping or tax.&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| YES&lt;br /&gt;
| integer&lt;br /&gt;
| In most cases, since this is the first checkout step, this should be 1.&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Usually this value should be &amp;quot;Product&amp;quot;.&lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The coupon code that is being used.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The name or description of the promotion for the cart, for example a promotion picture filename or slogan of the promotion that starts the checkout automatically.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| A metric that you define that measures the value of the action performed to your business.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| In most cases this should be &#039;Checkout&#039;.&lt;br /&gt;
|-&lt;br /&gt;
! opt&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Additional information about the purchase.&lt;br /&gt;
|-&lt;br /&gt;
! orderNumber&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The unique ID of the purchase.&lt;br /&gt;
|-&lt;br /&gt;
! positioning&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The item&#039;s position in a list or collection (e.g. 2) or the position of the promotion on a page (e.g. banner_slot_1).&lt;br /&gt;
|-&lt;br /&gt;
! shipping&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The price of shipping associated with the purchase in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! shippingAddress&lt;br /&gt;
| NO&lt;br /&gt;
| object&lt;br /&gt;
| The shipping address given in the format detailed below.&lt;br /&gt;
|-&lt;br /&gt;
! tax&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The tax associated with the purchase in the given currency.&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;span style=&amp;quot;font-size:80%; line-height: 1.31em;&amp;quot;&amp;gt;(*It&#039;s possible to add [[#Special_properties|custom property]])&amp;lt;/span&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Initiate checkout event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For physical items &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample product data&lt;br /&gt;
        var initiateCheckoutProperties = {&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;revenue&#039;: 17500.0,&lt;br /&gt;
            &#039;step&#039;: 0,&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;preselected_cart_01&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;opt&#039;: &#039;To postal office, no street address&#039;,&lt;br /&gt;
            &#039;orderNumber&#039;: &#039;852&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;shipping&#039;: 2500.0,&lt;br /&gt;
            &#039;shippingAddress&#039;: {&lt;br /&gt;
                &#039;city&#039;: &#039;Budapest&#039;,&lt;br /&gt;
                &#039;country&#039;: &#039;HU&#039;,&lt;br /&gt;
                &#039;deliveryMethod&#039;: &#039;DHL&#039;,&lt;br /&gt;
                &#039;fullName&#039;: &#039;John Doe&#039;,&lt;br /&gt;
                &#039;phone&#039;: &#039;+36 1 1111 111&#039;,&lt;br /&gt;
                &#039;region&#039;: &#039;HU-BU&#039;,&lt;br /&gt;
                &#039;street&#039;: &#039;Műegyetem rkpt. 3.&#039;,&lt;br /&gt;
                &#039;street2&#039;: &#039;2. porta&#039;,&lt;br /&gt;
                &#039;zipCode&#039;: &#039;1111&#039;&lt;br /&gt;
            },&lt;br /&gt;
            &#039;tax&#039;: 0.0&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;checkout_button&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;initiateCheckout&#039;, initiateCheckoutProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#checkout_button&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;initiateCheckout&#039;, initiateCheckoutProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For ticket sellers &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|       // sample product data&lt;br /&gt;
        var initiateCheckoutProperties = {&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;metalica_12&#039;,&lt;br /&gt;
                &#039;name&#039;: &#039;Metallica&#039;,&lt;br /&gt;
                &#039;quantity&#039;: 2.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 600.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 300.0,&lt;br /&gt;
                &#039;brand&#039;: undefined,&lt;br /&gt;
                &#039;category&#039;: &#039;Pop|Metal&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;Early Bird&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://www.revolvermag.com/sites/default/files/styles/image_954_x_537/public/media/images/article/metallicapr.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;2019.06.08 20:00|Slane Castle&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;snoop_dog_2019&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Snoop Dog&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 1500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 500,&lt;br /&gt;
                &#039;brand&#039;: undefined,&lt;br /&gt;
                &#039;category&#039;: &#039;Rap&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;Early Bird&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://cdn1.thr.com/sites/default/files/2012/08/snoop-dogg-pr-08-p.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;2019.04.02 23:00|Wembley&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
            &#039;revenue&#039;: 2100.0,&lt;br /&gt;
            &#039;step&#039;: 0,&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;preselected_cart_01&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;opt&#039;: &#039;To postal office, no street address&#039;,&lt;br /&gt;
            &#039;orderNumber&#039;: &#039;852&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;shipping&#039;: 2500.0,&lt;br /&gt;
            &#039;shippingAddress&#039;: {&lt;br /&gt;
                &#039;city&#039;: &#039;Budapest&#039;,&lt;br /&gt;
                &#039;country&#039;: &#039;HU&#039;,&lt;br /&gt;
                &#039;deliveryMethod&#039;: &#039;DHL&#039;,&lt;br /&gt;
                &#039;fullName&#039;: &#039;John Doe&#039;,&lt;br /&gt;
                &#039;phone&#039;: &#039;+36 1 1111 111&#039;,&lt;br /&gt;
                &#039;region&#039;: &#039;HU-BU&#039;,&lt;br /&gt;
                &#039;street&#039;: &#039;Műegyetem rkpt. 3.&#039;,&lt;br /&gt;
                &#039;street2&#039;: &#039;2. porta&#039;,&lt;br /&gt;
                &#039;zipCode&#039;: &#039;1111&#039;&lt;br /&gt;
            },&lt;br /&gt;
            &#039;tax&#039;: 0.0&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;checkout_button&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;initiateCheckout&#039;, initiateCheckoutProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#checkout_button&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;initiateCheckout&#039;, initiateCheckoutProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Initiate Purchase (initiatePurchase) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; that completes the checkout process&lt;br /&gt;
* User intent: Pay for the items in the cart&lt;br /&gt;
* Why do we need this: Users usually are put off by adverts of an item they already purchased, but can be receptive to related products&lt;br /&gt;
&lt;br /&gt;
This event should be fired at the same time as the user is redirected to a payment solution&#039;s own website, for example&lt;br /&gt;
when the user is sent to the Barion Smart Gateway for payment. It should also be fired if the user chose a non-payment&lt;br /&gt;
checkout option, for example payment on receipt, but the transaction is considered complete. This should be the last&lt;br /&gt;
confirmation of the checkout process, after which the sale is considered to have taken place. Ideally after pressing&lt;br /&gt;
this button the user should reach either a &#039;payment pending&#039; then a &#039;thank you&#039; page, or simply the &#039;thank you&#039; page.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Initiate purchase event properties&#039;&#039;&#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! [[#Special_properties|contents]]&lt;br /&gt;
| YES&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing the actual items contained in the cart, meaning the shipping and coupons should be excluded. For the detailed format see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| The currency that the price is provided in, preferably in the three letter ISO 4217 format (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! revenue&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The total revenue associated with the transaction in the given currency. This should include all costs the customer pays like shipping or tax.&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| YES&lt;br /&gt;
| integer&lt;br /&gt;
| It is its sequential number in checkout process.&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Usually this value should be &amp;quot;Product&amp;quot;.&lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The coupon code that is being used.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The name or description of the promotion for the cart, for example a promotion picture filename or slogan of the promotion that starts the checkout automatically.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| A metric that you define that measures the value of the action performed to your business.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| In most cases this should be &#039;Checkout&#039;.&lt;br /&gt;
|-&lt;br /&gt;
! opt&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Additional information about the purchase.&lt;br /&gt;
|-&lt;br /&gt;
! orderNumber&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The unique ID of the purchase.&lt;br /&gt;
|-&lt;br /&gt;
! positioning&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The item&#039;s position in a list or collection (e.g. 2) or the position of the promotion on a page (e.g. banner_slot_1).&lt;br /&gt;
|-&lt;br /&gt;
! shipping&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The price of shipping associated with the purchase in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! shippingAddress&lt;br /&gt;
| NO&lt;br /&gt;
| object&lt;br /&gt;
| The shipping address given in the format detailed below.&lt;br /&gt;
|-&lt;br /&gt;
! tax&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The tax associated with the purchase in the given currency.&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;span style=&amp;quot;font-size:80%; line-height: 1.31em;&amp;quot;&amp;gt;(*It&#039;s possible to add [[#Special_properties|custom property]])&amp;lt;/span&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Initiate purchase event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For physical items &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample product data&lt;br /&gt;
        var initiatePurchaseProperties = {&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;revenue&#039;: 17500.0,&lt;br /&gt;
            &#039;step&#039;: 6,&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;preselected_cart_01&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;opt&#039;: &#039;To postal office, no street address&#039;,&lt;br /&gt;
            &#039;orderNumber&#039;: &#039;852&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;shipping&#039;: 2500.0,&lt;br /&gt;
            &#039;shippingAddress&#039;: {&lt;br /&gt;
                &#039;city&#039;: &#039;Budapest&#039;,&lt;br /&gt;
                &#039;country&#039;: &#039;HU&#039;,&lt;br /&gt;
                &#039;deliveryMethod&#039;: &#039;DHL&#039;,&lt;br /&gt;
                &#039;fullName&#039;: &#039;John Doe&#039;,&lt;br /&gt;
                &#039;phone&#039;: &#039;+36 1 1111 111&#039;,&lt;br /&gt;
                &#039;region&#039;: &#039;HU-BU&#039;,&lt;br /&gt;
                &#039;street&#039;: &#039;Műegyetem rkpt. 3.&#039;,&lt;br /&gt;
                &#039;street2&#039;: &#039;2. porta&#039;,&lt;br /&gt;
                &#039;zipCode&#039;: &#039;1111&#039;&lt;br /&gt;
            },&lt;br /&gt;
            &#039;tax&#039;: 0.0&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;confirm_payment&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;initiatePurchase&#039;, initiatePurchaseProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#confirm_payment&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;initiatePurchase&#039;, initiatePurchaseProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For ticket sellers &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|    // sample product data&lt;br /&gt;
        var initiateCheckoutProperties = {&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;metalica_12&#039;,&lt;br /&gt;
                &#039;name&#039;: &#039;Metallica&#039;,&lt;br /&gt;
                &#039;quantity&#039;: 2.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 600.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 300.0,&lt;br /&gt;
                &#039;brand&#039;: undefined,&lt;br /&gt;
                &#039;category&#039;: &#039;Pop|Metal&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;Early Bird&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://www.revolvermag.com/sites/default/files/styles/image_954_x_537/public/media/images/article/metallicapr.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;2019.06.08 20:00|Slane Castle&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;snoop_dog_2019&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Snoop Dog&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 1500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 500,&lt;br /&gt;
                &#039;brand&#039;: undefined,&lt;br /&gt;
                &#039;category&#039;: &#039;Rap&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;Early Bird&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://cdn1.thr.com/sites/default/files/2012/08/snoop-dogg-pr-08-p.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;2019.04.02 23:00|Wembley&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
            &#039;revenue&#039;: 2100.0,&lt;br /&gt;
            &#039;step&#039;: 6,&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;preselected_cart_01&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;opt&#039;: &#039;To postal office, no street address&#039;,&lt;br /&gt;
            &#039;orderNumber&#039;: &#039;852&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;shipping&#039;: 2500.0,&lt;br /&gt;
            &#039;shippingAddress&#039;: {&lt;br /&gt;
                &#039;city&#039;: &#039;Budapest&#039;,&lt;br /&gt;
                &#039;country&#039;: &#039;HU&#039;,&lt;br /&gt;
                &#039;deliveryMethod&#039;: &#039;DHL&#039;,&lt;br /&gt;
                &#039;fullName&#039;: &#039;John Doe&#039;,&lt;br /&gt;
                &#039;phone&#039;: &#039;+36 1 1111 111&#039;,&lt;br /&gt;
                &#039;region&#039;: &#039;HU-BU&#039;,&lt;br /&gt;
                &#039;street&#039;: &#039;Műegyetem rkpt. 3.&#039;,&lt;br /&gt;
                &#039;street2&#039;: &#039;2. porta&#039;,&lt;br /&gt;
                &#039;zipCode&#039;: &#039;1111&#039;&lt;br /&gt;
            },&lt;br /&gt;
            &#039;tax&#039;: 0.0&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;confirm_payment&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;initiatePurchase&#039;, initiatePurchaseProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#confirm_payment&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;initiatePurchase&#039;, initiatePurchaseProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Set User Properties (setUserProperties) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; when user properties are available&lt;br /&gt;
* User intent: Provide personal details&lt;br /&gt;
* Why do we need this: Information about users helps us give more relevant offers to them&lt;br /&gt;
&lt;br /&gt;
This event should be attached to any browser event that when fired, can access user information. We handle all user&lt;br /&gt;
information in accordance with the GDPR and as such, all personally identifying information is hashed directly on the&lt;br /&gt;
client side, in the JS code, before being forwarded to us, which makes it impossible to read it on our side. This makes&lt;br /&gt;
it very important to fill out the properties provided below correctly, so that all PII falls in the correct fields that&lt;br /&gt;
will be hashed before sending. The pages that this event can be inserted into are mostly sign up or sign in pages,&lt;br /&gt;
newsletter subscription pages, and any other page where the user can provide information about themselves. This event&lt;br /&gt;
can also be sent during the checkout process.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Set user properties event properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! hashed&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! userId&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Your ID for the user, for example an username, email or internal ID that you identify the user with on your site.&lt;br /&gt;
|-&lt;br /&gt;
! accountCreatedTime&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| UNIX timestamp&lt;br /&gt;
| The time that the user account had been created, in a UNIX timestamp that is seconds accurate.&lt;br /&gt;
|-&lt;br /&gt;
! age&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The age of the user.&lt;br /&gt;
|-&lt;br /&gt;
! city&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The city that the user lives in.&lt;br /&gt;
|-&lt;br /&gt;
! country&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The country that the user lives in, preferably in the ISO 3166-1 alpha-2 format, eg. HU or CZ.&lt;br /&gt;
|-&lt;br /&gt;
! region&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The region that the user lives in, preferably in the ISO 3166-2 format, eg. HU-BU.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Currency that the user prefers, or the one that the prices are displayed to them in. 3 digit ISO 4217 format is preferred (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! email&lt;br /&gt;
| NO&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The email that belongs to the user.&lt;br /&gt;
|-&lt;br /&gt;
! gender&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The gender of the user.&lt;br /&gt;
|-&lt;br /&gt;
! interests&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| | The interests of the user, separated with the pipe character, eg. &amp;quot;Arts|Games&amp;quot;.&lt;br /&gt;
|-&lt;br /&gt;
! lang&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The language of the user, preferably in the ISO 639-1 format, eg. hu or cz.&lt;br /&gt;
|-&lt;br /&gt;
! phone&lt;br /&gt;
| NO&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Phone number of the user, preferably in the E.164 format, eg. +36 1 111 1111&lt;br /&gt;
|-&lt;br /&gt;
! shippingAddress&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| object&lt;br /&gt;
| The address of the user in the format described below.&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| If the user properties are set in the checkout process, the checkout process step.&lt;br /&gt;
|-&lt;br /&gt;
! zipCode&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The ZIP code&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;span style=&amp;quot;font-size:80%; line-height: 1.31em;&amp;quot;&amp;gt;(*It&#039;s possible to add [[#Special_properties|custom property]])&amp;lt;/span&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Set user properties event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; General example &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample user data&lt;br /&gt;
        var setUserPropertiesProperties= {&lt;br /&gt;
            &#039;userId&#039;: &#039;user_42&#039;,&lt;br /&gt;
            &#039;accountCreatedTime&#039;: 1557223622,&lt;br /&gt;
            &#039;age&#039;: &#039;12-24&#039;,&lt;br /&gt;
            &#039;city&#039;: &#039;Budapest&#039;,&lt;br /&gt;
            &#039;country&#039;: &#039;HU&#039;,&lt;br /&gt;
            &#039;region&#039;: &#039;HU-BU&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;email&#039;: &#039;sample.steve@gmail.com&#039;,&lt;br /&gt;
            &#039;gender&#039;: &#039;male&#039;,&lt;br /&gt;
            &#039;interests&#039;: &#039;Arts|Crafts&#039;,&lt;br /&gt;
            &#039;lang&#039;: &#039;hu&#039;,&lt;br /&gt;
            &#039;phone&#039;: &#039;+36 1 111 1111&#039;,&lt;br /&gt;
            &#039;shippingAddress&#039;: {&lt;br /&gt;
                &#039;city&#039;: &#039;Budapest&#039;,&lt;br /&gt;
                &#039;country&#039;: &#039;HU&#039;,&lt;br /&gt;
                &#039;deliveryMethod&#039;: &#039;DHL&#039;,&lt;br /&gt;
                &#039;fullName&#039;: &#039;John Doe&#039;,&lt;br /&gt;
                &#039;phone&#039;: &#039;+36 1 1111 111&#039;,&lt;br /&gt;
                &#039;region&#039;: &#039;HU-BU&#039;,&lt;br /&gt;
                &#039;street&#039;: &#039;Műegyetem rkpt. 3.&#039;,&lt;br /&gt;
                &#039;street2&#039;: &#039;2. porta&#039;,&lt;br /&gt;
                &#039;zipCode&#039;: &#039;1111&#039;&lt;br /&gt;
            },&lt;br /&gt;
            &#039;step&#039;: 1,&lt;br /&gt;
            &#039;zipCode&#039;: &#039;1111&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;next&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;setUserProperties&#039;, setUserPropertiesProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#next&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;setUserProperties&#039;, setUserPropertiesProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Category Selection (categorySelection) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; on a category on a category selection page&lt;br /&gt;
* User intent: View a category&lt;br /&gt;
* Why do we need this: Users demonstrate interest in items belonging to a category by looking at the category&lt;br /&gt;
&lt;br /&gt;
This event should be implemented where the user can select a category of events on a page, for example a brand, a common&lt;br /&gt;
property, a theme, a price range or any grouping of product along something that makes them belong to the category.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Category selection event properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Unique ID of the category clicked on your site.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Full name of the category. (eg. &#039;shoes&#039;)&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Brand of the item in the category clicked.&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| | The category (eg. &#039;winter shoes&#039; or &#039;summer shoes&#039;) or subcategory branch (eg. &#039;clothes|winter|shoes&#039; or &#039;clothes|summer|shoes&#039;, separate levels with &#039;|&#039;) of the category that was clicked.&lt;br /&gt;
|-&lt;br /&gt;
! [[#Special_properties|contents]]&lt;br /&gt;
| NO&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing items in the category. For more details see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Usually this value should be &amp;quot;Product&amp;quot;.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The value of a user performing this event to the business.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The collection that the category clicked is in from one of these possible values: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc&lt;br /&gt;
|-&lt;br /&gt;
! positioning&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The category&#039;s position in the list or collection (e.g. 2) or the position of the creative (e.g. banner_slot_1)&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| NO&lt;br /&gt;
| integer&lt;br /&gt;
| A number that represents the progress in the checkout process.&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;span style=&amp;quot;font-size:80%; line-height: 1.31em;&amp;quot;&amp;gt;(*It&#039;s possible to add [[#Special_properties|custom property]])&amp;lt;/span&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Category selection event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For physical items &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample category data&lt;br /&gt;
        var categorySelectionProperties = {&lt;br /&gt;
            &#039;id&#039;: &#039;books_scifi&#039;,&lt;br /&gt;
            &#039;name&#039;: &#039;Sci-Fi Books&#039;,&lt;br /&gt;
            &#039;brand&#039;: undefined,&lt;br /&gt;
            &#039;category&#039;: &#039;Books&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;contentType&#039;: &#039;Page&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;list&#039;: &#039;SearchPage&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;42&#039;,&lt;br /&gt;
            &#039;step&#039;: undefined&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;select_category&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;categorySelection&#039;, categorySelectionProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#select_category&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;categorySelection&#039;, categorySelectionProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Click Product (clickProduct) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; on an item&lt;br /&gt;
* User intent: View an item&lt;br /&gt;
* Why do we need this: Users demonstrate interest in your items by clicking them&lt;br /&gt;
&lt;br /&gt;
This event should be fired each time when a user selects any of your items and then the item&#039;s page will be loaded. This could be for example on a product&lt;br /&gt;
selection page, a result on a search or filter page, an item on a promotion. The page type on which the button is on&lt;br /&gt;
should be specified in the &#039;list&#039; property. In case of product bundles, you can use the &#039;contents&#039; property to list each&lt;br /&gt;
item in the bundle, while the direct properties should refer to the bundle as a whole as an item.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Click product event properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The type of the content of the page where the item was selected. Possible values (only these are accepted): Page/Product/Article/Promotion/Banner/Misc.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| Currency that the item is listed in for purchase. 3 digit ISO 4217 format is preferred (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Unique ID of the item clicked on your site.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Full name of the item clicked.&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The quantity of a product clicked measured in the unit provided (e.g. 2).&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The measurement unit of the item clicked. (e.g. pcs, kg).&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| Price of one unit (that you provided) of the item clicked (in the currency that you provided).&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Brand of the item clicked.&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The category (eg. &#039;winter shoes&#039; or &#039;summer shoes&#039;) or subcategory branch (eg. &#039;clothes|shoes|winter&#039; or &#039;clothes|shoes|summer&#039;, separate levels with &#039;|&#039;) of the item clicked.&lt;br /&gt;
|-&lt;br /&gt;
! [[#Special_properties|contents]]&lt;br /&gt;
| NO&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing multiple items clicked. For more details see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The name or description of the promotion for the item, for example a promotion picture filename or slogan of the promotion that selects the item.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The value of a user performing this event to the business.&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) of the item if available.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The collection that the product clicked is in from one of these possible values: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc&lt;br /&gt;
|-&lt;br /&gt;
! positioning&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The product&#039;s position in the list or collection (e.g. 2) or the position of the creative (e.g. banner_slot_1)&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| NO&lt;br /&gt;
| integer&lt;br /&gt;
| A number that represents the progress in the checkout process. Usually at a click product event, this is 0.&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the product (e.g. &#039;black&amp;lt;nowiki&amp;gt;|&amp;lt;/nowiki&amp;gt;XS&#039;) clicked.&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;span style=&amp;quot;font-size:80%; line-height: 1.31em;&amp;quot;&amp;gt;(*It&#039;s possible to add [[#Special_properties|custom property]])&amp;lt;/span&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Click product event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For physical items in checkout process &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample product data for single product&lt;br /&gt;
        var clickProductProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;creative&#039;: &#039;book_42&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;step&#039;: 2,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        // sample product data for bundle offer&lt;br /&gt;
        var clickProductProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42pack&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 15000.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;creative&#039;: &#039;bundle_offer_01&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;step&#039;: 2,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;book_42&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;clickProduct&#039;, clickProductProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#book_42&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;clickProduct&#039;, clickProductProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Click Product Detail (clickProductDetail) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; requesting extended details about an item&lt;br /&gt;
* User intent: View extended information about an item&lt;br /&gt;
* Why do we need this: Users demonstrate high interest in your items by looking up details about them&lt;br /&gt;
&lt;br /&gt;
This event should fire on a button click that can be either a webpage or an asynchronous request for more details about&lt;br /&gt;
an item. It should be implemented at any button that results in more details being shown about an item.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Click product detail event properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The type of the content of the page where the item was selected. Possible values (only these are accepted): Page/Product/Article/Promotion/Banner/Misc.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| Currency that the item is listed in for purchase. 3 digit ISO 4217 format is preferred (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Unique ID of the item clicked on your site.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Full name of the item clicked.&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The measurement unit of the item clicked. (e.g. pcs, kg).&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| Price of one unit (that you provided) of the item clicked (in the currency that you provided).&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the product (e.g. &#039;black&amp;lt;nowiki&amp;gt;|&amp;lt;/nowiki&amp;gt;XS&#039;) clicked.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Brand of the item clicked.&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The category (eg. &#039;winter shoes&#039; or &#039;summer shoes&#039;) or subcategory branch (eg. &#039;clothes|shoes|winter&#039; or &#039;clothes|shoes|summer&#039;, separate levels with &#039;|&#039;) of the item clicked.&lt;br /&gt;
|-&lt;br /&gt;
! [[#Special_properties|contents]]&lt;br /&gt;
| NO&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing multiple items clicked. For more details see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The name or description of the promotion for the item, for example a promotion picture filename or slogan of the promotion that selects the item.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The value of a user performing this event to the business.&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) of the item if available.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The collection that the product clicked is in from one of these possible values: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc&lt;br /&gt;
|-&lt;br /&gt;
! positioning&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The product&#039;s position in the list or collection (e.g. 2) or the position of the creative (e.g. banner_slot_1)&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| NO&lt;br /&gt;
| integer&lt;br /&gt;
| A number that represents the progress in the checkout process. Usually at a click product event, this is 0.&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The quantity of a product clicked measured in the unit provided (e.g. 2).&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the product (e.g. &#039;black&amp;lt;nowiki&amp;gt;|&amp;lt;/nowiki&amp;gt;XS&#039;) clicked.&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;span style=&amp;quot;font-size:80%; line-height: 1.31em;&amp;quot;&amp;gt;(*It&#039;s possible to add [[#Special_properties|custom property]])&amp;lt;/span&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Click product detail event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For physical items in checkout process&amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample product data for single product&lt;br /&gt;
        var clickProductDetailProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;creative&#039;: &#039;book_42&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;step&#039;: 2,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        // sample product data for bundle offer&lt;br /&gt;
        var clickProductDetailProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42pack&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 15000.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;creative&#039;: &#039;bundle_offer_01&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;step&#039;: 2,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;more_details&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;clickProductDetail&#039;, clickProductDetailProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#more_details&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;clickProductDetail&#039;, clickProductDetailProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Customize Product (customizeProduct) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; changing particular characteristics of an item&lt;br /&gt;
* User intent: Change characteristics of an item&lt;br /&gt;
* Why do we need this: Users demonstrate interest in your items by customizing them&lt;br /&gt;
&lt;br /&gt;
This event should fire on a button click that can be either a webpage or an asynchronous request for a different variant&lt;br /&gt;
of an item, for example color, size etc. It should be implemented at any button that results in a different variant&lt;br /&gt;
being shown.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Customize product event properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The type of the content of the page where the item was selected. Possible values (only these are accepted): Page/Product/Article/Promotion/Banner/Misc.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| Currency that the item is listed in for purchase. 3 digit ISO 4217 format is preferred (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Unique ID of the item clicked on your site.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Full name of the item clicked.&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The measurement unit of the item clicked. (e.g. pcs, kg).&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| Price of one unit (that you provided) of the item clicked (in the currency that you provided).&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the product (e.g. &#039;black&amp;lt;nowiki&amp;gt;|&amp;lt;/nowiki&amp;gt;XS&#039;) clicked.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Brand of the item clicked.&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The category (eg. &#039;winter shoes&#039; or &#039;summer shoes&#039;) or subcategory branch (eg. &#039;clothes|shoes|winter&#039; or &#039;clothes|shoes|summer&#039;, separate levels with &#039;|&#039;) of the item clicked.&lt;br /&gt;
|-&lt;br /&gt;
! [[#Special_properties|contents]]&lt;br /&gt;
| NO&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing multiple items clicked. For more details see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The name or description of the promotion for the item, for example a promotion picture filename or slogan of the promotion that selects the item.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The value of a user performing this event to the business.&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) of the item if available.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The collection that the product clicked is in from one of these possible values: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc&lt;br /&gt;
|-&lt;br /&gt;
! positioning&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The product&#039;s position in the list or collection (e.g. 2) or the position of the creative (e.g. banner_slot_1)&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The quantity of a product clicked measured in the unit provided (e.g. 2).&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| NO&lt;br /&gt;
| integer&lt;br /&gt;
| A number that represents the progress in the checkout process. Usually at a click product event, this is 0.&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;span style=&amp;quot;font-size:80%; line-height: 1.31em;&amp;quot;&amp;gt;(*It&#039;s possible to add [[#Special_properties|custom property]])&amp;lt;/span&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Customize product event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For physical items in checkout process &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample product data for single product&lt;br /&gt;
        var customizeProductProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;creative&#039;: &#039;book_42&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;step&#039;: 2,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        // sample product data for bundle offer&lt;br /&gt;
        var customizeProductProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42pack&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 15000.0,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;creative&#039;: &#039;bundle_offer_01&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;step&#039;: 2,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;customize&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;customizeProduct&#039;, customizeProductProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#customize&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;customizeProduct&#039;, customizeProductProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Purchase (purchase) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Page load&#039;&#039; after the payment process&lt;br /&gt;
* User intent: Verify the completion of the transaction&lt;br /&gt;
* Why do we need this: Users usually are put off by adverts of an item they already purchased, but can be receptive to related products&lt;br /&gt;
&lt;br /&gt;
This event should be fired on the page load where the user is notified about the completion of their transaction that is finished by successful payment. If the user chooses cash as the method of payment, usually this event should be fired when the ‘thank you’ page is loaded, if they choose online payment it should be fired when the ‘successful payment’ page is loaded. If the payment wasn&#039;t successful, then still this event still needs to be fired, except the &#039;step&#039; property should set to a &#039;-1&#039; value.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Purchase event properties&#039;&#039;&#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! [[#Special_properties|contents]]&lt;br /&gt;
| YES&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing the actual items contained in the cart, meaning the shipping and coupons should be excluded. For the detailed format see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| The currency that the price is provided in, preferably in the three letter ISO 4217 format (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! revenue&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The total revenue associated with the transaction in the given currency. This should include all costs the customer pays like shipping or tax.&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| YES&lt;br /&gt;
| integer&lt;br /&gt;
| In most cases, since this is after the last checkout step, this should be the maximum value that you use. If the transaction is unsuccessful, this should be -1.&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Usually this value should be &amp;quot;Product&amp;quot;.&lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The coupon code that is being used.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The name or description of the promotion for the cart, for example a promotion picture filename or slogan of the promotion that starts the checkout automatically.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| A metric that you define that measures the value of the action performed to your business.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| In most cases this should be &#039;Checkout&#039;.&lt;br /&gt;
|-&lt;br /&gt;
! opt&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Additional information about the purchase.&lt;br /&gt;
|-&lt;br /&gt;
! orderNumber&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The unique ID of the purchase.&lt;br /&gt;
|-&lt;br /&gt;
! positioning&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The item&#039;s position in a list or collection (e.g. 2) or the position of the promotion on a page (e.g. banner_slot_1).&lt;br /&gt;
|-&lt;br /&gt;
! shipping&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The price of shipping associated with the purchase in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! shippingAddress&lt;br /&gt;
| NO&lt;br /&gt;
| object&lt;br /&gt;
| The shipping address given in the format detailed below.&lt;br /&gt;
|-&lt;br /&gt;
! tax&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The tax associated with the purchase in the given currency.&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;span style=&amp;quot;font-size:80%; line-height: 1.31em;&amp;quot;&amp;gt;(*It&#039;s possible to add [[#Special_properties|custom property]])&amp;lt;/span&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Purchase event implementation example: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; Successful purchase example for physical items &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|       var purchaseProperties = {&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;revenue&#039;: 17500.0,&lt;br /&gt;
            &#039;step&#039;: 7,&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;preselected_cart_01&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;opt&#039;: &#039;To postal office, no street address&#039;,&lt;br /&gt;
            &#039;orderNumber&#039;: &#039;852&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;shipping&#039;: 2500.0,&lt;br /&gt;
            &#039;shippingAddress&#039;: {&lt;br /&gt;
                &#039;city&#039;: &#039;Budapest&#039;,&lt;br /&gt;
                &#039;country&#039;: &#039;HU&#039;,&lt;br /&gt;
                &#039;deliveryMethod&#039;: &#039;DHL&#039;,&lt;br /&gt;
                &#039;fullName&#039;: &#039;John Doe&#039;,&lt;br /&gt;
                &#039;phone&#039;: &#039;+36 1 1111 111&#039;,&lt;br /&gt;
                &#039;region&#039;: &#039;HU-BU&#039;,&lt;br /&gt;
                &#039;street&#039;: &#039;Műegyetem rkpt. 3.&#039;,&lt;br /&gt;
                &#039;street2&#039;: &#039;2. porta&#039;,&lt;br /&gt;
                &#039;zipCode&#039;: &#039;1111&#039;&lt;br /&gt;
            },&lt;br /&gt;
            &#039;tax&#039;: 0.0&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        bp(&#039;track&#039;, &#039;purchase&#039;, purchaseProperties);&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Remove from Cart (removeFromCart) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; that results in a product to be removed from the items selected for purchase&lt;br /&gt;
* User intent: Deselect product for purchase&lt;br /&gt;
* Why do we need this: Users demonstrate interest in carted products, and this can be refined if we know when products are deselected&lt;br /&gt;
&lt;br /&gt;
The remove from cart event is very similar to the add to cart event, and is mainly required to refine our data on&lt;br /&gt;
selected items by informing us when products are taken out from the cart or deselected from purchase. It can also mean&lt;br /&gt;
that a purchase process that first made a user select an item is simply cancelled.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Remove from cart event properties&#039;&#039;&#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Usually, this value should be &amp;quot;Product&amp;quot;.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| The currency that the price is provided in, preferably in the three letter ISO 4217 format (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| An unique ID that you have for the item, this can be your ID for the product, an SKU or a promotion ID.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The full name that you have for the added item, for example a product name (eg. Red Bull 24pcs carton).&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The quantity of the item removed from the cart.&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The total price of the removed items in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The unit that your item is measured in (eg. pieces, kg, hours).&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The price of one measurement of your item in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The brand of the item.&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| | The subcategory branch (preferred, eg. &#039;clothes|shoes|winter&#039;, separate levels with &#039;|&#039;) or single category (eg. &#039;winter shoes&#039; or &#039;summer shoes&#039;) of the item.&lt;br /&gt;
|-&lt;br /&gt;
! [[#Special_properties|contents]]&lt;br /&gt;
| NO&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing multiple items of the item. For more details see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The coupon code that was used when the item was removed from cart.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Seldom used, for example a promotion that changes a product in your cart to a better, more expensive or more recent one.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| A metric that you define that measures the value of the action performed to your business.&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) of the item if available.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The function of the loaded page from one of these possible values: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc&lt;br /&gt;
|-&lt;br /&gt;
! positioning&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The item&#039;s position in a list or collection (e.g. 2) or the position of the promotion on a page (e.g. banner_slot_1).&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| NO&lt;br /&gt;
| integer&lt;br /&gt;
| If the page is displayed along the checkout process, the checkout step number that the page is displayed in, numbered from 0 as the checkout initiation.&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the offer from the list of possible identical items (eg. the color of a phone or the time and venue of a concert or movie)&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;span style=&amp;quot;font-size:80%; line-height: 1.31em;&amp;quot;&amp;gt;(*It&#039;s possible to add [[#Special_properties|custom property]])&amp;lt;/span&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Remove from cart event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For physical items in basket page &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample product data for single items&lt;br /&gt;
        var removeFromCartProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;quantity&#039;: 10.0,&lt;br /&gt;
            &#039;totalItemPrice&#039;: 49900.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 4990.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;upsell_promo_42&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;BasketPage&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;3&#039;,&lt;br /&gt;
            &#039;step&#039;: undefined,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // sample product data for bundled items&lt;br /&gt;
        var removeFromCartProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42pack&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;quantity&#039;: 10.0,&lt;br /&gt;
            &#039;totalItemPrice&#039;: 150000.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 15000.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;upsell_promo_42&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;BasketPage&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;3&#039;,&lt;br /&gt;
            &#039;step&#039;: undefined,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;remove_button&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;removeFromCart&#039;, removeFromCartProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#remove_button&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;removeFromCart&#039;, removeFromCartProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Add Payment Info (addPaymentInfo) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; at a point in the checkout process where the payment method is already set&lt;br /&gt;
* User intent: Select payment method&lt;br /&gt;
* Why do we need this: It helps to identify user financial habits&lt;br /&gt;
&lt;br /&gt;
This event should be fired when the payment method of a user is already entered. This event should be fired both if&lt;br /&gt;
the payment info is explicitly requested and provided, but also if it is only implied for example when only one option&lt;br /&gt;
is available.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Add payment info event properties&#039;&#039;&#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! [[#Special_properties|contents]]&lt;br /&gt;
| YES&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing the actual items contained in the cart, meaning the shipping and coupons should be excluded. For the detailed format see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! paymentMethod&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The method of payment that the user chooses, for example Barion, cash etc.&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| YES&lt;br /&gt;
| integer&lt;br /&gt;
| It representing the current number of step in the checkout process.&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Usually this value should be &amp;quot;Product&amp;quot;.&lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The coupon code that is being used.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The name or description of the promotion for the cart, for example a promotion picture filename or slogan of the promotion that starts the checkout automatically.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| NO&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| The currency that the price is provided in, preferably in the three letter ISO 4217 format (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| A metric that you define that measures the value of the action performed to your business.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| In most cases this should be &#039;Checkout&#039;.&lt;br /&gt;
|-&lt;br /&gt;
! opt&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Additional information about the purchase.&lt;br /&gt;
|-&lt;br /&gt;
! orderNumber&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The unique ID of the purchase.&lt;br /&gt;
|-&lt;br /&gt;
! positioning&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The item&#039;s position in a list or collection (e.g. 2) or the position of the promotion on a page (e.g. banner_slot_1).&lt;br /&gt;
|-&lt;br /&gt;
! revenue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The total revenue associated with the transaction in the given currency. This should include all costs the customer pays like shipping or tax.&lt;br /&gt;
|-&lt;br /&gt;
! shipping&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The price of shipping associated with the purchase in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! shippingAddress&lt;br /&gt;
| NO&lt;br /&gt;
| object&lt;br /&gt;
| The shipping address given in the format detailed below.&lt;br /&gt;
|-&lt;br /&gt;
! tax&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The tax associated with the purchase in the given currency.&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;span style=&amp;quot;font-size:80%; line-height: 1.31em;&amp;quot;&amp;gt;(*It&#039;s possible to add [[#Special_properties|custom property]])&amp;lt;/span&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Add payment info event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For physical items &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample product data&lt;br /&gt;
        var addPaymentInfoProperties = {&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;paymentMethod&#039;: &#039;Barion&#039;,&lt;br /&gt;
            &#039;step&#039;: 0,&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;preselected_cart_01&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;opt&#039;: &#039;To postal office, no street address&#039;,&lt;br /&gt;
            &#039;orderNumber&#039;: &#039;852&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;revenue&#039;: 17500.0,&lt;br /&gt;
            &#039;shipping&#039;: 2500.0,&lt;br /&gt;
            &#039;shippingAddress&#039;: {&lt;br /&gt;
                &#039;city&#039;: &#039;Budapest&#039;,&lt;br /&gt;
                &#039;country&#039;: &#039;HU&#039;,&lt;br /&gt;
                &#039;deliveryMethod&#039;: &#039;DHL&#039;,&lt;br /&gt;
                &#039;fullName&#039;: &#039;John Doe&#039;,&lt;br /&gt;
                &#039;phone&#039;: &#039;+36 1 1111 111&#039;,&lt;br /&gt;
                &#039;region&#039;: &#039;HU-BU&#039;,&lt;br /&gt;
                &#039;street&#039;: &#039;Műegyetem rkpt. 3.&#039;,&lt;br /&gt;
                &#039;street2&#039;: &#039;2. porta&#039;,&lt;br /&gt;
                &#039;zipCode&#039;: &#039;1111&#039;&lt;br /&gt;
            },&lt;br /&gt;
            &#039;tax&#039;: 0.0&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;checkout_next&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;addPaymentInfo&#039;, addPaymentInfoProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#checkout_next&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;addPaymentInfo&#039;, addPaymentInfoProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Click Promo (clickPromo) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; on a promotion box only on your site.&lt;br /&gt;
* User intent: View a promotion&lt;br /&gt;
* Why do we need this: Users demonstrate interest in your promotion offers by clicking them&lt;br /&gt;
&lt;br /&gt;
This event should be fired when one of your users selects a promotion on your site. Promotions can be usually placed on home pages,&lt;br /&gt;
product places, in the checkout process and many other places. The promotion can be about a product, offer, brand or any&lt;br /&gt;
other single offer or grouping of offers. This event should be implemented only on promotions that you serve on your page natively,&lt;br /&gt;
as opposed to those served dynamically by external third party services such as Google Ads.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Click promo event properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The type of the content of the page where the promotion was selected. Possible values (only these are accepted): Page/Product/Article/Promotion/Banner/Misc.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The name or description of the promotion, for example a promotion picture filename or slogan of the promotion.&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Unique ID of the promotion clicked on your site.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Full name of the promotion.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Brand of the item in the promotion clicked.&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| | The category (eg. &#039;winter shoes&#039; or &#039;summer shoes&#039;) or subcategory branch (eg. &#039;clothes|shoes|winter&#039; or &#039;clothes|shoes|summer&#039;, separate levels with &#039;|&#039;) of the item in the promotion clicked.&lt;br /&gt;
|-&lt;br /&gt;
! [[#Special_properties|contents]]&lt;br /&gt;
| NO&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing multiple items promoted. For more details see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| NO&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| Currency that the promoted offer is listed in. 3 digit ISO 4217 format is preferred (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The value of a user performing this event to the business.&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) of the item if available.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The collection that the promotion clicked is in from one of these possible values: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc&lt;br /&gt;
|-&lt;br /&gt;
! positioning&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The promotion&#039;s position in the list or collection (e.g. 2) or the position of the creative (e.g. banner_slot_1)&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The quantity that the item is promoted in, measured in the unit provided (e.g. 2).&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| NO&lt;br /&gt;
| integer&lt;br /&gt;
| A number that represents the progress in the checkout process. Usually at a click product event, this is 0.&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The measurement unit of the item promoted (e.g. pcs, kg).&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| Price of one unit (that you provided) of the item promoted (in the currency that you provided).&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the product (e.g. &#039;black|XS&#039;) promoted.&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;span style=&amp;quot;font-size:80%; line-height: 1.31em;&amp;quot;&amp;gt;(*It&#039;s possible to add [[#Special_properties|custom property]])&amp;lt;/span&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Click promo event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; In checkout process &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample product data for single product&lt;br /&gt;
        var clickPromoProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;book_42&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
            &#039;step&#039;: 2,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        // sample product data for bundle offer&lt;br /&gt;
        var clickPromoProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;bundle_offer_01&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42pack&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;positioning&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
            &#039;step&#039;: 2,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 15000.0,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;book_42_promo&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;clickPromo&#039;, clickPromoProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#book_42_promo&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;clickPromo&#039;, clickPromoProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Sign Up (signUp) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; that completes the registration or login process&lt;br /&gt;
* User intent: Register for or login to a user account or a newsletter subscription&lt;br /&gt;
* Why do we need this: Users demonstrate interest in your market area by signing up for an account&lt;br /&gt;
&lt;br /&gt;
This event should be usually sent along the set user properties event in registration process, since this event only captures the actual signup,&lt;br /&gt;
not the user itself. This event should both be fired if a user registers for an account or subscription for the first&lt;br /&gt;
time and when they login afterwards. Unsuccessful login or signup events should cause error events to be sent. If&lt;br /&gt;
possible, it is better if only successful attempts send a sign up event, but it is more important for all signing ups to&lt;br /&gt;
send an event than for each signup to be only sent once.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Add to cart event properties&#039;&#039;&#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| If the user signs up for a product, then it should be &#039;Product&#039; else this can be &#039;Page&#039; if it is a general registration or login.&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| This should be your unique ID for the form used to register or login.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The name of the for used for the signing up, for example &#039;Register&#039; or &#039;Sign In&#039;.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The brand of the product the user signs up for.&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| | The subcategory branch (preferred, eg. &#039;clothes|shoes|winter&#039;, separate levels with &#039;|&#039;) or single category (eg. &#039;winter shoes&#039; or &#039;summer shoes&#039;) of the item.&lt;br /&gt;
|-&lt;br /&gt;
! [[#Special_properties|contents]]&lt;br /&gt;
| NO&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing multiple items of the item. For more details see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| NO&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| The currency that the price is provided in, preferably in the three letter ISO 4217 format (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| A metric that you define that measures the value of the action performed to your business.&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) of the offer if available.&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The unit that your subscribed item is measured in (eg. pieces, kg, hours).&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The price of one measurement of your item in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| THehvariant of the offer from the list of possible identical items (eg. the color of a phone or the time and venue of a concert or movie)&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;span style=&amp;quot;font-size:80%; line-height: 1.31em;&amp;quot;&amp;gt;(*It&#039;s possible to add [[#Special_properties|custom property]])&amp;lt;/span&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Sign up event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; Newsletter for a given item&amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample subscription data&lt;br /&gt;
        var signUpProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, newsletter&amp;quot;,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 4990.0,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;signup_button&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;signUp&#039;, signUpProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#signup_button&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;signUp&#039;, signUpProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; Registration &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample subscription data&lt;br /&gt;
        var signUpProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Page&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;registration_form_1&#039;,&lt;br /&gt;
            &#039;name&#039;: &#039;Registration&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;signup_button&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;signUp&#039;, signUpProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#signup_button&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;signUp&#039;, signUpProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Search (search) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; that starts a search on a page&lt;br /&gt;
* User intent: Search for an offer on your page&lt;br /&gt;
* Why do we need this: Users demonstrate interest in an offer by searching for it&lt;br /&gt;
&lt;br /&gt;
This event is quite straightforward, every time a search button is clicked, this should send. If the search has no&lt;br /&gt;
search button, but instead gives results on the change of the search box, then this event can be sent if the user clicks&lt;br /&gt;
on a result. In this case, searches are sent asynchronously for partial search terms, which should not in themselves&lt;br /&gt;
send an event. If you have a product selection page where items can be filtered, then the same can apply, the search&lt;br /&gt;
string in this case can be the query that the settings make that can be read in your browser address bar in HTTP&lt;br /&gt;
properties (eg. &#039;goats&#039; in this: &#039;https://www.google.com/search?ei=A3rRXNHmJY-nrgSJs5HgDQ&amp;amp;q=goats&#039;).&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Search event properties&#039;&#039;&#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! searchString&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The search terms entered by the user or the HTTP property that contains the search terms.&lt;br /&gt;
|-&lt;br /&gt;
! [[#Special_properties|contents]]&lt;br /&gt;
| NO&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects containing the top ten results of your search.&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Usually this should be &#039;Product&#039;.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| NO&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| If you have a filter that selects products by price, and the search string doesn&#039;t contain this, then you should provide it here.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| A metric that you define that measures the value of the action performed to your business.&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The id of the search facility that the search is made in, for example of a search box or a filter array.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The name of the search facility that the search is made in, for example of a search box or a filter array.&lt;br /&gt;
|-&lt;br /&gt;
! totalResults&lt;br /&gt;
| NO&lt;br /&gt;
| integer&lt;br /&gt;
| The number of the search or filter results.&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;span style=&amp;quot;font-size:80%; line-height: 1.31em;&amp;quot;&amp;gt;(*It&#039;s possible to add [[#Special_properties|custom property]])&amp;lt;/span&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Search event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; General example&amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample search result data&lt;br /&gt;
        var searchProperties = {&lt;br /&gt;
            &#039;searchString&#039;: &#039;big GOATS&#039;,&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: undefined,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;id&#039;: &#039;search_01&#039;,&lt;br /&gt;
            &#039;name&#039;: &#039;Book Search&#039;,&lt;br /&gt;
            &#039;totalResults&#039;: 2&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;search_button&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;search&#039;, searchProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#search_button&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;search&#039;, searchProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Error (error) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: Any event that results in erroneous operation&lt;br /&gt;
* User intent: Something else&lt;br /&gt;
* Why do we need this: We can get more information about event failures&lt;br /&gt;
&lt;br /&gt;
This event should be sent each time the page can&#039;t complete the requested operation, for examnple on 40x or 50x pages,&lt;br /&gt;
failed form submissions et cetera.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Error event properties&#039;&#039;&#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! description&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The description of the error, or preferably the full error message.&lt;br /&gt;
|-&lt;br /&gt;
! code&lt;br /&gt;
| NO&lt;br /&gt;
| int&lt;br /&gt;
| The error code.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Error event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For 404 error &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // on a static 404 page&lt;br /&gt;
        var errorProperties = {&lt;br /&gt;
            &#039;description&#039;: &#039;I find your lack of navigation disturbing.&#039;,&lt;br /&gt;
            &#039;code&#039;: 404&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        bp(&#039;track&#039;, &#039;error&#039;, errorProperties);&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Custom Event (customEvent) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: Any action that can&#039;t be described with our events&lt;br /&gt;
* User intent: Something different&lt;br /&gt;
* Why do we need this: We can get more information&lt;br /&gt;
&lt;br /&gt;
This event is for describing any event that can&#039;t be otherwise described with our standard events.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Error event properties&#039;&#039;&#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! eventAction&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The action that the user takes, eg. click.&lt;br /&gt;
|-&lt;br /&gt;
! eventCategory&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The category that the event falls in, you can define it for yourself, eg. &#039;user_settings&#039;.&lt;br /&gt;
|-&lt;br /&gt;
! eventLabel&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The label associated with the event, eg. &#039;language_selection&#039;.&lt;br /&gt;
|-&lt;br /&gt;
! eventProperty&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The property associated with the event, eg. &#039;unit_format&#039;.&lt;br /&gt;
|-&lt;br /&gt;
! eventValue&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The value of the property associated with the event, eg. &#039;metric&#039;.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Custom event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For measuring unit selection &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|      // for measuring unit selection&lt;br /&gt;
        var customEventProperties = {&lt;br /&gt;
            &#039;eventAction&#039;: &#039;click&#039;,&lt;br /&gt;
            &#039;eventCategory&#039;: &#039;user_settings&#039;,&lt;br /&gt;
            &#039;eventLabel&#039;: &#039;language_selection&#039;,&lt;br /&gt;
            &#039;eventProperty&#039;: &#039;unit_format&#039;,&lt;br /&gt;
            &#039;eventValue&#039;: &#039;metric&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;set_language&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;customEvent&#039;, customEventProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#set_language&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;customEvent&#039;, customEventProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
= Special properties =&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Contents value type - array of objects &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| If this is a product page as per minimal requirements, this value should be &amp;quot;Product&amp;quot;. Otherwise select a value that best fits from these: Page/Product/Article/Promotion/Banner/Misc.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| The currency that the product price is provided in, preferably in the three letter ISO 4217 format (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| An unique ID that you have for the offer, this can be your ID for the product, an SKU or a promotion ID.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The full name that you have for the offer, for example a product name (eg. Red Bull 24pcs carton).&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The quantity of the product offered as initially given on the page.&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The total price of the added items in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The unit that your offer is measured in (eg. pieces, kg, m).&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The price of one measurement of your offer in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The brand of the offer.&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| | The subcategory branch (preferred, eg. &#039;clothes|shoes|winter&#039;, separate levels with &#039;|&#039;) or single category (eg. &#039;winter shoes&#039; or &#039;summer shoes&#039;) of the offer.&lt;br /&gt;
|-&lt;br /&gt;
! description&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The detailed description of item.&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) of the offer if available.&lt;br /&gt;
|-&lt;br /&gt;
! imageUrl&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The URL of the image of the viewed item.&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the offer from the list of possible identical items (eg. the color of a phone or the time and venue of a concert or movie)&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Address value type - array of objects &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! city&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The complete name of the city of the recipient address.&lt;br /&gt;
|-&lt;br /&gt;
! country&lt;br /&gt;
| NO&lt;br /&gt;
| text (ISO-3166-1 alpha-2)&lt;br /&gt;
| The recipient&#039;s country code in ISO-3166-1 alpha-2 format.&lt;br /&gt;
|-&lt;br /&gt;
! deliveryMethod&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The delivery method, if applicable.&lt;br /&gt;
|-&lt;br /&gt;
! fullName&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The full civil or official name of the recipient.&lt;br /&gt;
|-&lt;br /&gt;
! phone&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The phone number of the recipient.&lt;br /&gt;
|-&lt;br /&gt;
! region&lt;br /&gt;
| NO&lt;br /&gt;
| text (ISO-3166-2)&lt;br /&gt;
| The region code of the recipient address in ISO-3166-2 format.&lt;br /&gt;
|-&lt;br /&gt;
! street&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The shipping street address with house number and other details.&lt;br /&gt;
|-&lt;br /&gt;
! street2&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The address, continued.&lt;br /&gt;
|-&lt;br /&gt;
! zipCode&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The zip code of the recipient address.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Custom Property &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! name&lt;br /&gt;
! Value Type&lt;br /&gt;
! Description&lt;br /&gt;
|-&lt;br /&gt;
| _custom&lt;br /&gt;
| any type&lt;br /&gt;
| If our predefined events and/or object properties don&#039;t suit your needs, you can include your own, custom events and/or properties. Custom properties can be used with standard events. Custom properties must start with an underscore.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Custom property implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; In purchase event &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|       //_custome_event_test&lt;br /&gt;
        var purchaseProperties = {&lt;br /&gt;
                &#039;contents&#039;: [{&lt;br /&gt;
                    &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                    &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                    &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                    &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                    &#039;quantity&#039;: 3.0,&lt;br /&gt;
                    &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                    &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                    &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                    &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                    &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                    &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                    &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                    &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                    &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                    },&lt;br /&gt;
                    {&lt;br /&gt;
                    &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                    &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                    &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                    &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                    &#039;quantity&#039;: 3.0,&lt;br /&gt;
                    &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                    &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                    &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                    &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                    &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                    &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                    &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                    &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                    &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                    }],&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;revenue&#039;: 17500.0,&lt;br /&gt;
                &#039;step&#039;: 7,&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
                &#039;creative&#039;: &#039;preselected_cart_01&#039;,&lt;br /&gt;
                &#039;customerValue&#039;: 150.0,&lt;br /&gt;
                &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
                &#039;opt&#039;: &#039;To postal office, no street address&#039;,&lt;br /&gt;
                &#039;orderNumber&#039;: &#039;852&#039;,&lt;br /&gt;
                &#039;positioning&#039;: &#039;1&#039;,&lt;br /&gt;
                &#039;shipping&#039;: 2500.0,&lt;br /&gt;
                &#039;shippingAddress&#039;: {&lt;br /&gt;
                    &#039;city&#039;: &#039;Budapest&#039;,&lt;br /&gt;
                    &#039;country&#039;: &#039;HU&#039;,&lt;br /&gt;
                    &#039;deliveryMethod&#039;: &#039;DHL&#039;,&lt;br /&gt;
                    &#039;fullName&#039;: &#039;John Doe&#039;,&lt;br /&gt;
                    &#039;phone&#039;: &#039;+36 1 1111 111&#039;,&lt;br /&gt;
                    &#039;region&#039;: &#039;HU-BU&#039;,&lt;br /&gt;
                    &#039;street&#039;: &#039;Műegyetem rkpt. 3.&#039;,&lt;br /&gt;
                    &#039;street2&#039;: &#039;2. porta&#039;,&lt;br /&gt;
                    &#039;zipCode&#039;: &#039;1111&#039;&lt;br /&gt;
                },&lt;br /&gt;
                &#039;tax&#039;: 0.0,&lt;br /&gt;
                &#039;_myCustomProperty&#039; : &#039;This is my first custom property&#039;&lt;br /&gt;
            }&lt;br /&gt;
&lt;br /&gt;
            bp(&#039;track&#039;, &#039;purchase&#039;, purchaseProperties);&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
= Implementation FAQ =&lt;br /&gt;
&amp;lt;b&amp;gt;When do I have to send an event?&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
Every event description contains the trigger that may be a page load or a button click (Firing event at the event description).&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;What should I do if an event is undefinable in my web shop?&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
If event is not applicable to any user intent either explicitly or implicitly then you do not need to implement it.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Should visitors to a product page who are coming from external ads be tracked with a clickPromo event? (for example those that are provided by third party services such as Google Ads)&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
No, as the click event didn’t happen on your page, this event should not be tracked on your page.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;When do I have to send the setUserProperties event?&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
Only when users first provide personal data about themselves or they modify them, you do not need to send this event at every sign in.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;What event should be sent when my user registers and signs up for a newsletter during the registration process and is afterwards automatically logged in when the registration process is completed?&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
In that case, you should send a setUserProperties with the personal data, one signUp event for the registration, and another signUp event for the newsletter, and finally a third signUp event for the login.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;What should I send in the variant property?&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
Before adding it to cart, you may specify the exact type of your product, such as size or color on the product page. You have to send the value that describes the variant, not the altered quality of the item. E.g. If you specify the size and color for a T-shirt, send ’Red|XXL’ instead of ’Size|Color’&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Most events have the list and contentType property, what are they?&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
Both of them predefined values. contentType: Page/ Product/ Article/ Promotion/ Banner/ Misc, list: HomePage/ SearchPage/ ProductPage/ Recommendation/ ComparisonPage/ BasketPage/ Checkout/ Misc. ContentType describes the type of the visited page’s content. It is ‘product’ on product page/category selection pages. If it is an article then ‘Article’ or e.g. Black Friday promotion then ‘promotion’, general pages are ‘Page’ e.g. contact or about us pages.&lt;br /&gt;
The list describes the functionality of the page, product page (ProductPage), basket page (BasketPage) or a page in the checkout process (Checkout) etc.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;What is the step property?&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
First of all, consider the start point of the checkout process in your case. Usually, personal data and a delivery address are given after this point but before the actual purchase. This start point will be your initiateCheckout event where the value of step is 1. And then, split your checkout process up to the purchase into different steps, and fill this property with the position of the page in the checkout sequence.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;What should I do if click on basket icon does not add item into basket in all case?&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
In that case, you have to manage different cases in different ways. The addToCart event should only be sent in the case when an item is actually added to the cart, otherwise you should not send this event.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;I have empty cart button, how do I manage click on it by removeFromCart?&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
Send a removeFromCart event about each item that is in the cart.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;What are name and ID properties in the signUp event?&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
These properties do not describe the user, the name identifies user intent, e.g. ’registration’, ’login’, ’newsletter’. The ID identifies the form or the checkbox. If there is no ID, then the same value can be entered as ID as the name.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Where can I find the Barion Pixel ID?&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
In your Barion wallet in the shop details menu.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;If no results are returned to a search initiated by a customer, should a search event be sent?&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
Yes, in the same way as if the search results were not empty.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;If quantity added to cart by the customer exceeds the acceptable quantity of items added to cart, which one should be sent in quantity property in addToCart event?&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
The quantity that was finally added to the cart. If no items are added to cart then you do not need to send an addToCart event.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;When do I send a purchase event?&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
When a purchase is completed and finished by successful payment. If the user chooses cash as the payment method, then the purchase event should be sent when the user hits the ’Thank you’ page. If the user chooses online payment, then the purchase event should be sent when the user hits a ’Successful payment’ page.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;What should I do if payment is unsuccessful?&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
In that case you must send a purchase event when the user hits an ’Unsuccessful payment’ page, however set the step property to -1. This special step value indicates that the payment has failed.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;The item name on the product page is different from the same item in checkout process, what do I do?&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
The only thing that’s important is that all items should be named consistently in all events, meaning that the same item should have the same name in all cases.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
= Dataprocessing Partners =&lt;br /&gt;
* Barions’s secure servers are operated by Sense/Net Ltd. having 22 years of operations experience, also providing assistance with customer service. Address: 1117 Budapest, Infopark boardwalk 1. I. building 5. floor 5.&lt;br /&gt;
* Predicting credit card fraud is done by SEON Technologies LLC. Address: 1136 Budapest, Pannónia street 32.&lt;br /&gt;
* Customer Care telephony is provided by Minerva-Soft Development and Provider LLC. Address: 3900 Szerencs, Lipták road 1/a.&lt;br /&gt;
* The telephony services for user complaint handling is provided by Interswitch LLC. Address:1056 Budapest, Irányi street 15.&lt;br /&gt;
* Infrastructure for online user identification services required by money laundering laws is provided by TechTeamer LLC. Address: 1095 Budapest, Lechner Ödön avenue 3. 2. 1., B.&lt;br /&gt;
* Traffic statistics for our website and mobile application are provided by MIXPANEL Inc. Address: 405 Howard Street San Francisco, CA 94105&lt;br /&gt;
* Regarding our bookkeeping duties we are partnered with In-Voice Kontroll LLC. Address: 1046 Budapest, Leiningen Károly street 16/B&lt;br /&gt;
* Our mobile parking e-billing partner is KBOSS.hu LLC. (also known as szamlazz.hu) Address: 1031 Budapest, Záhony street 7.&lt;/div&gt;</summary>
		<author><name>Baloghn</name></author>
	</entry>
	<entry>
		<id>https://docs.barion.com/index.php?title=Barion_Pixel_API_reference&amp;diff=1802</id>
		<title>Barion Pixel API reference</title>
		<link rel="alternate" type="text/html" href="https://docs.barion.com/index.php?title=Barion_Pixel_API_reference&amp;diff=1802"/>
		<updated>2019-05-31T15:22:19Z</updated>

		<summary type="html">&lt;p&gt;Baloghn: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{PageTitle|title=Barion Pixel}}&lt;br /&gt;
&lt;br /&gt;
{| style=&amp;quot;margin-left:2em;&amp;quot; align=&amp;quot;right&amp;quot;&lt;br /&gt;
| __TOC__&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
The Barion Pixel is JavaScript code that allows you to track visitor activity on your website. It works by loading a&lt;br /&gt;
JavaScript function which you can use whenever a site visitor takes an action that you want to track (this action is&lt;br /&gt;
called an event).&lt;br /&gt;
&lt;br /&gt;
In order to implement the Pixel, you will need:&lt;br /&gt;
* access to your website&#039;s HTML code base&lt;br /&gt;
* your Barion Pixel ID that you can access from your Barion Wallet&lt;br /&gt;
&lt;br /&gt;
By default, the Pixel will track pages visited, and the devices your visitors use. In addition, you can use the&lt;br /&gt;
Pixel&#039;s JavaScript function to track other events that are associated with webshop usage and e-commerce. Without&lt;br /&gt;
collecting the consent of the website visitor you must still use the Barion Pixel on your website for fraud management&lt;br /&gt;
purposes. (Tracking visitor behavior for the purposes of preventing fraud is considered a legitimate interest of&lt;br /&gt;
Barion and the merchant in contract with Barion). The implementation of the base code is considered mandatory for using&lt;br /&gt;
the Barion Smart Gateway.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
= Implementing the base code =&lt;br /&gt;
&lt;br /&gt;
Implementing the base code is not only required for you to be considered for special offers relating to the Barion&lt;br /&gt;
Pixel, but also for using the Barion Smart Gateway at all. This is based on the fact that both Barion and you as the&lt;br /&gt;
website owner have a legitimate interest in fraud management, and the data provided by the Barion Pixel greatly helps&lt;br /&gt;
these efforts. This, as a legitimate interest case, is fully compliant with the GDPR, and must be implemented&lt;br /&gt;
independently of any consent management software that your site may use.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Init (init) ==&lt;br /&gt;
&lt;br /&gt;
* User intent: View pages on your site&lt;br /&gt;
* To be implemented at: Every page load, in the document head tag&lt;br /&gt;
* Why do we need this: This provides very basic information on user sessions, and can be implemented very easily&lt;br /&gt;
&lt;br /&gt;
To use the Pixel, you need to add the following code (referred to as the base code) between the opening and closing&lt;br /&gt;
&amp;lt;head&amp;gt; tags on every page of your site. Most developers add it to their website&#039;s persistent header, so that it appears&lt;br /&gt;
automatically on all loaded pages. Be sure to insert your unique Barion Pixel ID at both locations in the provided code&lt;br /&gt;
example.&lt;br /&gt;
&lt;br /&gt;
Placing the code within your &amp;lt;head&amp;gt; tags reduces the chances of browsers or third-party code blocking the Pixel&#039;s&lt;br /&gt;
execution. It also executes the code sooner, increasing the chance that your visitors are tracked before they leave your&lt;br /&gt;
page. Sending the data happens asynchronously in the client&#039;s browser so that it does not affect user experience.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Implementation of the base code&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
    &amp;lt;nowiki&amp;gt;&lt;br /&gt;
        &amp;lt;script&amp;gt;&lt;br /&gt;
            (function(i,s,o,g,r,a,m){i[&#039;BarionAnalyticsObject&#039;]=r;i[r]=i[r]||function(){&lt;br /&gt;
            (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),&lt;br /&gt;
            m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)&lt;br /&gt;
            })(window, document, &#039;script&#039;, &#039;https://pixel.barion.com/bp.js&#039;, &#039;bp&#039;);&lt;br /&gt;
&lt;br /&gt;
            // send page view event&lt;br /&gt;
            bp(&#039;init&#039;, &#039;addBarionPixelId&#039;, &#039;&amp;lt;/nowiki&amp;gt;&amp;lt;span style=&amp;quot;color:red&amp;quot;&amp;gt;[YOUR BARION PIXEL ID GOES HERE]&amp;lt;/span&amp;gt;&amp;lt;nowiki&amp;gt;&#039;);&lt;br /&gt;
        &amp;lt;/script&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;noscript&amp;gt;&lt;br /&gt;
            &amp;lt;img height=&amp;quot;1&amp;quot; width=&amp;quot;1&amp;quot; style=&amp;quot;display:none&amp;quot; src=&amp;quot;https://pixel.barion.com/a.gif?__ba_pixel_id=&amp;lt;/nowiki&amp;gt;&amp;lt;span style=&amp;quot;color:red&amp;quot;&amp;gt;[YOUR BARION PIXEL ID GOES HERE]&amp;lt;/span&amp;gt;&amp;lt;nowiki&amp;gt;&amp;amp;ev=contentView&amp;amp;noscript=1&amp;quot;/&amp;gt;&lt;br /&gt;
        &amp;lt;/noscript&amp;gt;&lt;br /&gt;
    &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Heartbeat (heartbeat) ==&lt;br /&gt;
&lt;br /&gt;
* User intent: Browse your site&lt;br /&gt;
* To be implemented at: No further implementation needed beyond the init event&lt;br /&gt;
* Why do we need this: This provides information on time spent on your various pages&lt;br /&gt;
&lt;br /&gt;
Heartbeat events are sent each minute from each page that the init event is implemented at, as long as the user does not&lt;br /&gt;
navigate away from the page or the session is not considered timed out. It can provide information about time spent&lt;br /&gt;
viewing each site by users.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
= Minimal implementation =&lt;br /&gt;
&lt;br /&gt;
To be considered for the special contract terms in connection with the implementation of the Barion Pixel&#039;s full&lt;br /&gt;
marketing capabilities, you have to implement the following events on your site. All events should be implemented in&lt;br /&gt;
every location applicable, further detailed below. Events may require parameters, which must be included in the bp&lt;br /&gt;
function call as a JS object. This contains additional information about an event, for example product IDs, categories,&lt;br /&gt;
and the number of products purchased.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Consent (grantConsent, rejectConsent) ==&lt;br /&gt;
&lt;br /&gt;
* User intent: Give or reject Barion Pixel consent&lt;br /&gt;
* To be implemented at: Inside your own consent management software&lt;br /&gt;
* Why do we need this: Participation of webshop clients is entirely consent based complying with the GDPR&lt;br /&gt;
&lt;br /&gt;
Consent events determine which of the sent data can be used by us for marketing purposes. Two consent events can be&lt;br /&gt;
used to control user consent. The &amp;quot;grantConsent&amp;quot; event has to be sent when the visitor accepts the cookie policy&lt;br /&gt;
that expressly allows Barion to use data for marketing purposes. Sending this event must be handled by your own consent&lt;br /&gt;
management implementation that you are responsible for as outlined in our terms. The &amp;quot;rejectConsent&amp;quot; event should be&lt;br /&gt;
sent when the customer rejects the cookie policy that includes Barion Pixel functionality. It should be noted that&lt;br /&gt;
rejecting Barion marketing consent does not mean that no data should be sent towards Barion, as Barion has a legitimate&lt;br /&gt;
interest using this data for fraud management. Rejecting Barion consent however means that the data from that session&lt;br /&gt;
will not be used for marketing purposes at all, despite receiving it. All consent events are sent by calling the Pixel&#039;s&lt;br /&gt;
consent function as shown below.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Consent event implementation example&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
    &amp;lt;nowiki&amp;gt;&lt;br /&gt;
        bp(&#039;consent&#039;, &#039;grantConsent&#039;);&lt;br /&gt;
        bp(&#039;consent&#039;, &#039;rejectConsent&#039;);&lt;br /&gt;
    &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Content View (contentView) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Page load&#039;&#039; of item pages minimally, preferably on all pages that refers to a single item, offer or promotion&lt;br /&gt;
* User intent: View the page that shows a single offer described exclusively&lt;br /&gt;
* Why do we need this: Offer descriptions help us know more about your offers&lt;br /&gt;
&lt;br /&gt;
This event should be fired when one of your users enters a page that refers to one of your items that can be bought,&lt;br /&gt;
and describes it in general terms, with an offer to buy. This can be something like an offer page on an e-commerce&lt;br /&gt;
website or a product page on a retail site. It is important to not confuse this with a full product detail page where&lt;br /&gt;
the product itself is described in greater detail, but there is no information on price, shipping and other details that&lt;br /&gt;
are relevant to you offer, like in the case of a product manual.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Content view event properties &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| If this is a product page as per minimal requirements, this value should be &amp;quot;Product&amp;quot;. Otherwise select a value that best fits from these: Page/Product/Article/Promotion/Banner/Misc.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES (in case of &amp;quot;Product&amp;quot;)&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| The currency that the product price is provided in, preferably in the three letter ISO 4217 format (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| An unique ID that you have for the offer, this can be your ID for the product, an SKU or a promotion ID.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The full name that you have for the offer, for example a product name (eg. Red Bull 24pcs carton).&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| YES (in case of &amp;quot;Product&amp;quot;)&lt;br /&gt;
| float&lt;br /&gt;
| The quantity of the product offered as initially given on the page.&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES (in case of &amp;quot;Product&amp;quot;)&lt;br /&gt;
| text&lt;br /&gt;
| The unit that your offer is measured in (eg. pieces, kg, m).&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES (in case of &amp;quot;Product&amp;quot;)&lt;br /&gt;
| float&lt;br /&gt;
| The price of one measurement of your offer in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The brand of the offer.&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| | The subcategory branch (preferred, eg. &#039;clothes|shoes|winter&#039;, separate levels with &#039;|&#039;) or single category (eg. &#039;winter shoes&#039; or &#039;summer shoes&#039;) of the offer.&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| NO&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing multiple items of the offer. For more details see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The name or description of the promotion, for example a promotion picture filename or slogan.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| A metric that you define that measures the value of the action performed to your business.&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) of the offer if available.&lt;br /&gt;
|-&lt;br /&gt;
! imageUrl&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The URL of the image of the viewed item.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The function of the loaded page from one of these possible values: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc&lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The product&#039;s position in a list or collection (e.g. 2) or the position of the promotion on a page (e.g. banner_slot_1).&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| NO&lt;br /&gt;
| integer&lt;br /&gt;
| If the page is displayed along the checkout process, the checkout step number that the page is displayed in, numbered from 0 as the checkout initiation.&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the offer from the list of possible identical items (eg. the color of a phone or the time and venue of a concert or movie)&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Content view event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For physical items &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // example properties for a product page&lt;br /&gt;
        var contentViewProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;quantity&#039;: 10.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 4990.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;creative&#039;: undefined,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;ProductPage&#039;,&lt;br /&gt;
            &#039;position&#039;: undefined,&lt;br /&gt;
            &#039;step&#039;: undefined,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // example properties on a home page for a promotion of a product&lt;br /&gt;
        var contentViewProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Promotion&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;quantity&#039;: 10.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 4990.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;creative&#039;: &#039;book_promo_02&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;HomePage&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;2&#039;,&lt;br /&gt;
            &#039;step&#039;: undefined,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // example properties on a checkout page for a promotion of a product&lt;br /&gt;
        var contentViewProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Promotion&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;quantity&#039;: 10.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 4990.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;creative&#039;: &#039;also_bought_05&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;5&#039;,&lt;br /&gt;
            &#039;step&#039;: 2,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        bp(&#039;track&#039;, &#039;contentView&#039;, contentViewProperties);&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For ticket sellers &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // example properties for a product page&lt;br /&gt;
        var contentViewProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;metalica_12&#039;,&lt;br /&gt;
            &#039;name&#039;: &#039;Metallica&#039;,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 300.0,&lt;br /&gt;
            &#039;brand&#039;: undefined,&lt;br /&gt;
            &#039;category&#039;: &#039;Pop|Metal&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;creative&#039;: undefined,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: undefined,&lt;br /&gt;
            &#039;imageUrl&#039;: &amp;quot;https://www.revolvermag.com/sites/default/files/styles/image_954_x_537/public/media/images/article/metallicapr.jpg&amp;quot;,&lt;br /&gt;
            &#039;list&#039;: &#039;ProductPage&#039;,&lt;br /&gt;
            &#039;position&#039;: undefined,&lt;br /&gt;
            &#039;step&#039;: undefined,&lt;br /&gt;
            &#039;variant&#039;: &#039;2019.06.08 20:00|Slane Castle&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // example properties on a home page for a promotion of a product&lt;br /&gt;
        var contentViewProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Promotion&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;metalica_12&#039;,&lt;br /&gt;
            &#039;name&#039;: &#039;Metallica&#039;,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 300.0,&lt;br /&gt;
            &#039;brand&#039;: undefined,&lt;br /&gt;
            &#039;category&#039;: &#039;Pop|Metal&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;creative&#039;: &#039;metallica_promo_02&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: undefined,&lt;br /&gt;
            &#039;imageUrl&#039;: &amp;quot;https://www.revolvermag.com/sites/default/files/styles/image_954_x_537/public/media/images/article/metallicapr.jpg&amp;quot;,&lt;br /&gt;
            &#039;list&#039;: &#039;HomePage&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;2&#039;,&lt;br /&gt;
            &#039;step&#039;: undefined,&lt;br /&gt;
            &#039;variant&#039;: &#039;2019.06.08 20:00|Slane Castle&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // example properties on a checkout page for a promotion of a product&lt;br /&gt;
        var contentViewProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Promotion&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;metalica_12&#039;,&lt;br /&gt;
            &#039;name&#039;: &#039;Metallica&#039;,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 300.0,&lt;br /&gt;
            &#039;brand&#039;: undefined,&lt;br /&gt;
            &#039;category&#039;: &#039;Pop|Metal&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;creative&#039;: &#039;also_bought_05&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: undefined,&lt;br /&gt;
            &#039;imageUrl&#039;: &amp;quot;https://www.revolvermag.com/sites/default/files/styles/image_954_x_537/public/media/images/article/metallicapr.jpg&amp;quot;,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;5&#039;,&lt;br /&gt;
            &#039;step&#039;: 2,&lt;br /&gt;
            &#039;variant&#039;: &#039;2019.06.08 20:00|Slane Castle&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        bp(&#039;track&#039;, &#039;contentView&#039;, contentViewProperties);&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Add to Cart (addToCart) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; that results in a product to be selected for purchase&lt;br /&gt;
* User intent: Select product for purchase&lt;br /&gt;
* Why do we need this: Users demonstrate strong interest in your items by selecting them for purchase&lt;br /&gt;
&lt;br /&gt;
The add to cart event is, as its name suggests, connected to a user &amp;quot;adding a product to their cart&amp;quot;. Usually this means&lt;br /&gt;
that a user decide to purchase a product or service, and has added this item to their cart. Even if your website does&lt;br /&gt;
not use carts in the literal sense, there is a point in a user session where the given user decides that they intend to&lt;br /&gt;
purchase the product. This exact intent is what we want to capture here, so the button click which best matches the&lt;br /&gt;
point of this intent, such as one labeled &#039;Buy&#039; or &#039;Reserve&#039; should be the one to attach this event to.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Add to cart event properties&#039;&#039;&#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Usually, this value should be &amp;quot;Product&amp;quot;.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| The currency that the price is provided in, preferably in the three letter ISO 4217 format (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| An unique ID that you have for the item, this can be your ID for the product, an SKU or a promotion ID.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The full name that you have for the added item, for example a product name (eg. Red Bull 24pcs carton).&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The quantity of the item added to the cart.&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The total price of the added items in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The unit that your item is measured in (eg. pieces, kg, hours).&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The price of one measurement of your item in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The brand of the item.&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| | The subcategory branch (preferred, eg. &#039;clothes|shoes|winter&#039;, separate levels with &#039;|&#039;) or single category (eg. &#039;winter shoes&#039; or &#039;summer shoes&#039;) of the item.&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| NO&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing multiple items of the item. For more details see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The coupon code that was used when the item was added to cart.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The name or description of the promotion for the item, for example a promotion picture filename or slogan of the promotion that adds the items to the cart automatically.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| A metric that you define that measures the value of the action performed to your business.&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) of the offer if available.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The function of the loaded page from one of these possible values: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc&lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The item&#039;s position in a list or collection (e.g. 2) or the position of the promotion on a page (e.g. banner_slot_1).&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| NO&lt;br /&gt;
| integer&lt;br /&gt;
| If the page is displayed along the checkout process, the checkout step number that the page is displayed in, numbered from 0 as the checkout initiation.&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the offer from the list of possible identical items (eg. the color of a phone or the time and venue of a concert or movie)&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Add to cart event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For physical items &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample product data for single items&lt;br /&gt;
        var addToCartProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;quantity&#039;: 10.0,&lt;br /&gt;
            &#039;totalItemPrice&#039;: 49900.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 4990.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;product_page_promo_42&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;ProductPage&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;3&#039;,&lt;br /&gt;
            &#039;step&#039;: undefined,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // sample product data for bundled items&lt;br /&gt;
        var addToCartProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42pack&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;quantity&#039;: 10.0,&lt;br /&gt;
            &#039;totalItemPrice&#039;: 150000.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 15000.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;add_to_cart_promo_42&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;BasketPage&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;3&#039;,&lt;br /&gt;
            &#039;step&#039;: undefined,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;addtocart_button&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;addToCart&#039;, addToCartProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#addtocart_button&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;addToCart&#039;, addToCartProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For ticket sellers &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|    // sample product data for single items&lt;br /&gt;
        var addToCartProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;metalica_12&#039;,&lt;br /&gt;
            &#039;name&#039;: &#039;Metallica&#039;,&lt;br /&gt;
            &#039;quantity&#039;: 2.0,&lt;br /&gt;
            &#039;totalItemPrice&#039;: 600.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 300.0,&lt;br /&gt;
            &#039;brand&#039;: undefined,&lt;br /&gt;
            &#039;category&#039;: &#039;Pop|Metal&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;product_page_promo_metallica&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: undefined,&lt;br /&gt;
            &#039;list&#039;: &#039;ProductPage&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;3&#039;,&lt;br /&gt;
            &#039;step&#039;: undefined,&lt;br /&gt;
            &#039;variant&#039;: &#039;2019.06.08 20:00|Slane Castle&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // sample product data for bundled items&lt;br /&gt;
        var addToCartProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;spring_festival_two_tickets&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Spring Festival ticket&amp;quot;,&lt;br /&gt;
            &#039;quantity&#039;: 2.0,&lt;br /&gt;
            &#039;totalItemPrice&#039;: 1800.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 900.0,&lt;br /&gt;
            &#039;brand&#039;: undefined,&lt;br /&gt;
            &#039;category&#039;: &#039;Festival&#039;,&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;metalica_12&#039;,&lt;br /&gt;
                &#039;name&#039;: &#039;Metallica&#039;,&lt;br /&gt;
                &#039;quantity&#039;: 2.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 800.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 400.0,&lt;br /&gt;
                &#039;brand&#039;: undefined,&lt;br /&gt;
                &#039;category&#039;: &#039;Pop|Metal&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;Early Bird&#039;,&lt;br /&gt;
                &#039;ean&#039;: undefined,&lt;br /&gt;
                &#039;imageUrl&#039;: &amp;quot;https://www.revolvermag.com/sites/default/files/styles/image_954_x_537/public/media/images/article/metallicapr.jpg&amp;quot;,&lt;br /&gt;
                &#039;variant&#039;: &#039;2019.06.08 20:00|Slane Castle&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;snoop_dog_2019&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Snoop Dog&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 2.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 1000.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 500,&lt;br /&gt;
                &#039;brand&#039;: undefined,&lt;br /&gt;
                &#039;category&#039;: &#039;Rap&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;Early Bird&#039;,&lt;br /&gt;
                &#039;ean&#039;: undefined,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://cdn1.thr.com/sites/default/files/2012/08/snoop-dogg-pr-08-p.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;2019.06.08 20:00|Slane Castle&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;add_to_cart_promo_42&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: undefined,&lt;br /&gt;
            &#039;list&#039;: &#039;BasketPage&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;3&#039;,&lt;br /&gt;
            &#039;step&#039;: undefined,&lt;br /&gt;
            &#039;variant&#039;: &#039;2019.06.08 20:00|Slane Castle&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;addtocart_button&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;addToCart&#039;, addToCartProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#addtocart_button&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;addToCart&#039;, addToCartProperties);&lt;br /&gt;
        });&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Initiate Checkout (initiateCheckout) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; that starts the checkout process&lt;br /&gt;
* User intent: Purchase the items in the cart&lt;br /&gt;
* Why do we need this: Users usually are put off by adverts of an item they already purchased, but can be receptive to related products&lt;br /&gt;
&lt;br /&gt;
Usually on a webshop, there is a checkout process that starts with clicking a button with items in your cart. This&lt;br /&gt;
button click is the one that this event should be attached to. After this click, typically the user has to provide other&lt;br /&gt;
data, such as a shipping address and method, and confirm the purchase (which should fire the initiate purchase event).&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Initiate checkout event properties&#039;&#039;&#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| YES&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing the actual items contained in the cart, meaning the shipping and coupons should be excluded. For the detailed format see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| The currency that the price is provided in, preferably in the three letter ISO 4217 format (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! revenue&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The total revenue associated with the transaction in the given currency. This should include all costs the customer pays like shipping or tax.&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| YES&lt;br /&gt;
| integer&lt;br /&gt;
| In most cases, since this is the first checkout step, this should be 0.&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Usually this value should be &amp;quot;Product&amp;quot;.&lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The coupon code that is being used.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The name or description of the promotion for the cart, for example a promotion picture filename or slogan of the promotion that starts the checkout automatically.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| A metric that you define that measures the value of the action performed to your business.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| In most cases this should be &#039;Checkout&#039;.&lt;br /&gt;
|-&lt;br /&gt;
! option&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Additional information about the purchase.&lt;br /&gt;
|-&lt;br /&gt;
! orderNumber&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The unique ID of the purchase.&lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The item&#039;s position in a list or collection (e.g. 2) or the position of the promotion on a page (e.g. banner_slot_1).&lt;br /&gt;
|-&lt;br /&gt;
! shipping&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The price of shipping associated with the purchase in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! shippingAddress&lt;br /&gt;
| NO&lt;br /&gt;
| object&lt;br /&gt;
| The shipping address given in the format detailed below.&lt;br /&gt;
|-&lt;br /&gt;
! tax&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The tax associated with the purchase in the given currency.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Initiate checkout event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For physical items &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample product data&lt;br /&gt;
        var initiateCheckoutProperties = {&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;revenue&#039;: 17500.0,&lt;br /&gt;
            &#039;step&#039;: 0,&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;preselected_cart_01&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;option&#039;: &#039;To postal office, no street address&#039;,&lt;br /&gt;
            &#039;orderNumber&#039;: &#039;852&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;shipping&#039;: 2500.0,&lt;br /&gt;
            &#039;shippingAddress&#039;: {&lt;br /&gt;
                &#039;city&#039;: &#039;Budapest&#039;,&lt;br /&gt;
                &#039;country&#039;: &#039;HU&#039;,&lt;br /&gt;
                &#039;deliveryMethod&#039;: &#039;DHL&#039;,&lt;br /&gt;
                &#039;fullName&#039;: &#039;John Doe&#039;,&lt;br /&gt;
                &#039;phone&#039;: &#039;+36 1 1111 111&#039;,&lt;br /&gt;
                &#039;region&#039;: &#039;HU-BU&#039;,&lt;br /&gt;
                &#039;street&#039;: &#039;Műegyetem rkpt. 3.&#039;,&lt;br /&gt;
                &#039;street2&#039;: &#039;2. porta&#039;,&lt;br /&gt;
                &#039;zip&#039;: &#039;1111&#039;&lt;br /&gt;
            },&lt;br /&gt;
            &#039;tax&#039;: 0.0&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;checkout_button&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;initiateCheckout&#039;, initiateCheckoutProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#checkout_button&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;initiateCheckout&#039;, initiateCheckoutProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For ticket sellers &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|       // sample product data&lt;br /&gt;
        var initiateCheckoutProperties = {&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;metalica_12&#039;,&lt;br /&gt;
                &#039;name&#039;: &#039;Metallica&#039;,&lt;br /&gt;
                &#039;quantity&#039;: 2.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 600.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 300.0,&lt;br /&gt;
                &#039;brand&#039;: undefined,&lt;br /&gt;
                &#039;category&#039;: &#039;Pop|Metal&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;Early Bird&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://www.revolvermag.com/sites/default/files/styles/image_954_x_537/public/media/images/article/metallicapr.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;2019.06.08 20:00|Slane Castle&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;snoop_dog_2019&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Snoop Dog&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 1500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 500,&lt;br /&gt;
                &#039;brand&#039;: undefined,&lt;br /&gt;
                &#039;category&#039;: &#039;Rap&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;Early Bird&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://cdn1.thr.com/sites/default/files/2012/08/snoop-dogg-pr-08-p.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;2019.04.02 23:00|Wembley&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
            &#039;revenue&#039;: 2100.0,&lt;br /&gt;
            &#039;step&#039;: 0,&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;preselected_cart_01&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;option&#039;: &#039;To postal office, no street address&#039;,&lt;br /&gt;
            &#039;orderNumber&#039;: &#039;852&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;shipping&#039;: 2500.0,&lt;br /&gt;
            &#039;shippingAddress&#039;: {&lt;br /&gt;
                &#039;city&#039;: &#039;Budapest&#039;,&lt;br /&gt;
                &#039;country&#039;: &#039;HU&#039;,&lt;br /&gt;
                &#039;deliveryMethod&#039;: &#039;DHL&#039;,&lt;br /&gt;
                &#039;fullName&#039;: &#039;John Doe&#039;,&lt;br /&gt;
                &#039;phone&#039;: &#039;+36 1 1111 111&#039;,&lt;br /&gt;
                &#039;region&#039;: &#039;HU-BU&#039;,&lt;br /&gt;
                &#039;street&#039;: &#039;Műegyetem rkpt. 3.&#039;,&lt;br /&gt;
                &#039;street2&#039;: &#039;2. porta&#039;,&lt;br /&gt;
                &#039;zip&#039;: &#039;1111&#039;&lt;br /&gt;
            },&lt;br /&gt;
            &#039;tax&#039;: 0.0&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;checkout_button&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;initiateCheckout&#039;, initiateCheckoutProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#checkout_button&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;initiateCheckout&#039;, initiateCheckoutProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Initiate Purchase (initiatePurchase) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; that completes the checkout process&lt;br /&gt;
* User intent: Pay for the items in the cart&lt;br /&gt;
* Why do we need this: Users usually are put off by adverts of an item they already purchased, but can be receptive to related products&lt;br /&gt;
&lt;br /&gt;
This event should be fired at the same time as the user is redirected to a payment solution&#039;s own website, for example&lt;br /&gt;
when the user is sent to the Barion Smart Gateway for payment. It should also be fired if the user chose a non-payment&lt;br /&gt;
checkout option, for example payment on receipt, but the transaction is considered complete. This should be the last&lt;br /&gt;
confirmation of the checkout process, after which the sale is considered to have taken place. Ideally after pressing&lt;br /&gt;
this button the user should reach either a &#039;payment pending&#039; then a &#039;thank you&#039; page, or simply the &#039;thank you&#039; page.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Initiate purchase event properties&#039;&#039;&#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| YES&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing the actual items contained in the cart, meaning the shipping and coupons should be excluded. For the detailed format see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| The currency that the price is provided in, preferably in the three letter ISO 4217 format (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! revenue&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The total revenue associated with the transaction in the given currency. This should include all costs the customer pays like shipping or tax.&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| YES&lt;br /&gt;
| integer&lt;br /&gt;
| In most cases, since this is the first checkout step, this should be 0.&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Usually this value should be &amp;quot;Product&amp;quot;.&lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The coupon code that is being used.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The name or description of the promotion for the cart, for example a promotion picture filename or slogan of the promotion that starts the checkout automatically.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| A metric that you define that measures the value of the action performed to your business.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| In most cases this should be &#039;Checkout&#039;.&lt;br /&gt;
|-&lt;br /&gt;
! option&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Additional information about the purchase.&lt;br /&gt;
|-&lt;br /&gt;
! orderNumber&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The unique ID of the purchase.&lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The item&#039;s position in a list or collection (e.g. 2) or the position of the promotion on a page (e.g. banner_slot_1).&lt;br /&gt;
|-&lt;br /&gt;
! shipping&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The price of shipping associated with the purchase in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! shippingAddress&lt;br /&gt;
| NO&lt;br /&gt;
| object&lt;br /&gt;
| The shipping address given in the format detailed below.&lt;br /&gt;
|-&lt;br /&gt;
! tax&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The tax associated with the purchase in the given currency.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Initiate purchase event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For physical items &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample product data&lt;br /&gt;
        var initiatePurchaseProperties = {&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;revenue&#039;: 17500.0,&lt;br /&gt;
            &#039;step&#039;: 6,&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;preselected_cart_01&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;option&#039;: &#039;To postal office, no street address&#039;,&lt;br /&gt;
            &#039;orderNumber&#039;: &#039;852&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;shipping&#039;: 2500.0,&lt;br /&gt;
            &#039;shippingAddress&#039;: {&lt;br /&gt;
                &#039;city&#039;: &#039;Budapest&#039;,&lt;br /&gt;
                &#039;country&#039;: &#039;HU&#039;,&lt;br /&gt;
                &#039;deliveryMethod&#039;: &#039;DHL&#039;,&lt;br /&gt;
                &#039;fullName&#039;: &#039;John Doe&#039;,&lt;br /&gt;
                &#039;phone&#039;: &#039;+36 1 1111 111&#039;,&lt;br /&gt;
                &#039;region&#039;: &#039;HU-BU&#039;,&lt;br /&gt;
                &#039;street&#039;: &#039;Műegyetem rkpt. 3.&#039;,&lt;br /&gt;
                &#039;street2&#039;: &#039;2. porta&#039;,&lt;br /&gt;
                &#039;zip&#039;: &#039;1111&#039;&lt;br /&gt;
            },&lt;br /&gt;
            &#039;tax&#039;: 0.0&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;confirm_payment&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;initiatePurchase&#039;, initiatePurchaseProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#confirm_payment&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;initiatePurchase&#039;, initiatePurchaseProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For ticket sellers &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|    // sample product data&lt;br /&gt;
        var initiateCheckoutProperties = {&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;metalica_12&#039;,&lt;br /&gt;
                &#039;name&#039;: &#039;Metallica&#039;,&lt;br /&gt;
                &#039;quantity&#039;: 2.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 600.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 300.0,&lt;br /&gt;
                &#039;brand&#039;: undefined,&lt;br /&gt;
                &#039;category&#039;: &#039;Pop|Metal&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;Early Bird&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://www.revolvermag.com/sites/default/files/styles/image_954_x_537/public/media/images/article/metallicapr.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;2019.06.08 20:00|Slane Castle&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;snoop_dog_2019&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Snoop Dog&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 1500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 500,&lt;br /&gt;
                &#039;brand&#039;: undefined,&lt;br /&gt;
                &#039;category&#039;: &#039;Rap&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;Early Bird&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://cdn1.thr.com/sites/default/files/2012/08/snoop-dogg-pr-08-p.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;2019.04.02 23:00|Wembley&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;currency&#039;: &#039;GBP&#039;,&lt;br /&gt;
            &#039;revenue&#039;: 2100.0,&lt;br /&gt;
            &#039;step&#039;: 6,&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;preselected_cart_01&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;option&#039;: &#039;To postal office, no street address&#039;,&lt;br /&gt;
            &#039;orderNumber&#039;: &#039;852&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;shipping&#039;: 2500.0,&lt;br /&gt;
            &#039;shippingAddress&#039;: {&lt;br /&gt;
                &#039;city&#039;: &#039;Budapest&#039;,&lt;br /&gt;
                &#039;country&#039;: &#039;HU&#039;,&lt;br /&gt;
                &#039;deliveryMethod&#039;: &#039;DHL&#039;,&lt;br /&gt;
                &#039;fullName&#039;: &#039;John Doe&#039;,&lt;br /&gt;
                &#039;phone&#039;: &#039;+36 1 1111 111&#039;,&lt;br /&gt;
                &#039;region&#039;: &#039;HU-BU&#039;,&lt;br /&gt;
                &#039;street&#039;: &#039;Műegyetem rkpt. 3.&#039;,&lt;br /&gt;
                &#039;street2&#039;: &#039;2. porta&#039;,&lt;br /&gt;
                &#039;zip&#039;: &#039;1111&#039;&lt;br /&gt;
            },&lt;br /&gt;
            &#039;tax&#039;: 0.0&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;confirm_payment&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;initiatePurchase&#039;, initiatePurchaseProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#confirm_payment&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;initiatePurchase&#039;, initiatePurchaseProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
= Full implementation =&lt;br /&gt;
&lt;br /&gt;
This is the list of all events that are supported by Barion Pixel. Implementing these is currently not normally part of&lt;br /&gt;
contract terms, but supplying these will improve our service to your site, as we will receive more and better data about&lt;br /&gt;
your users. This will improve our capability to provide our services, especially in connection to your market and your&lt;br /&gt;
users.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Set User Properties (setUserProperties) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; when user properties are available&lt;br /&gt;
* User intent: Provide personal details&lt;br /&gt;
* Why do we need this: Information about users helps us give more relevant offers to them&lt;br /&gt;
&lt;br /&gt;
This event should be attached to any browser event that when fired, can access user information. We handle all user&lt;br /&gt;
information in accordance with the GDPR and as such, all personally identifying information is hashed directly on the&lt;br /&gt;
client side, in the JS code, before being forwarded to us, which makes it impossible to read it on our side. This makes&lt;br /&gt;
it very important to fill out the properties provided below correctly, so that all PII falls in the correct fields that&lt;br /&gt;
will be hashed before sending. The pages that this event can be inserted into are mostly sign up or sign in pages,&lt;br /&gt;
newsletter subscription pages, and any other page where the user can provide information about themselves. This event&lt;br /&gt;
can also be sent during the checkout process.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Set user properties event properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! hashed&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! userId&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Your ID for the user, for example an username, email or internal ID that you identify the user with on your site.&lt;br /&gt;
|-&lt;br /&gt;
! accountCreatedTime&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| UNIX timestamp&lt;br /&gt;
| The time that the user account had been created, in a UNIX timestamp that is seconds accurate.&lt;br /&gt;
|-&lt;br /&gt;
! age&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The age of the user.&lt;br /&gt;
|-&lt;br /&gt;
! city&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The city that the user lives in.&lt;br /&gt;
|-&lt;br /&gt;
! country&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The country that the user lives in, preferably in the ISO 3166-1 alpha-2 format, eg. HU or CZ.&lt;br /&gt;
|-&lt;br /&gt;
! county&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The county that the user lives in, preferably in the ISO 3166-2 format, eg. HU-BU.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Currency that the user prefers, or the one that the prices are displayed to them in. 3 digit ISO 4217 format is preferred (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! email&lt;br /&gt;
| NO&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The email that belongs to the user.&lt;br /&gt;
|-&lt;br /&gt;
! gender&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The gender of the user.&lt;br /&gt;
|-&lt;br /&gt;
! interests&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| | The interests of the user, separated with the pipe character, eg. &amp;quot;Arts|Games&amp;quot;.&lt;br /&gt;
|-&lt;br /&gt;
! language&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The language of the user, preferably in the ISO 639-1 format, eg. hu or cz.&lt;br /&gt;
|-&lt;br /&gt;
! phone&lt;br /&gt;
| NO&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Phone number of the user, preferably in the E.164 format, eg. +36 1 111 1111&lt;br /&gt;
|-&lt;br /&gt;
! shippingAddress&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| object&lt;br /&gt;
| The address of the user in the format described below.&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| If the user properties are set in the checkout process, the checkout process step.&lt;br /&gt;
|-&lt;br /&gt;
! zipCode&lt;br /&gt;
| NO&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The ZIP code&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Set user properties event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; General example &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample user data&lt;br /&gt;
        var setUserPropertiesProperties= {&lt;br /&gt;
            &#039;userId&#039;: &#039;user_42&#039;,&lt;br /&gt;
            &#039;accountCreatedTime&#039;: 1557223622,&lt;br /&gt;
            &#039;age&#039;: &#039;12-24&#039;,&lt;br /&gt;
            &#039;city&#039;: &#039;Budapest&#039;,&lt;br /&gt;
            &#039;country&#039;: &#039;HU&#039;,&lt;br /&gt;
            &#039;county&#039;: &#039;HU-BU&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;email&#039;: &#039;sample.steve@gmail.com&#039;,&lt;br /&gt;
            &#039;gender&#039;: &#039;male&#039;,&lt;br /&gt;
            &#039;interests&#039;: &#039;Arts|Crafts&#039;,&lt;br /&gt;
            &#039;language&#039;: &#039;hu&#039;,&lt;br /&gt;
            &#039;phone&#039;: &#039;+36 1 111 1111&#039;,&lt;br /&gt;
            &#039;shippingAddress&#039;: {&lt;br /&gt;
                &#039;city&#039;: &#039;Budapest&#039;,&lt;br /&gt;
                &#039;country&#039;: &#039;HU&#039;,&lt;br /&gt;
                &#039;deliveryMethod&#039;: &#039;DHL&#039;,&lt;br /&gt;
                &#039;fullName&#039;: &#039;John Doe&#039;,&lt;br /&gt;
                &#039;phone&#039;: &#039;+36 1 1111 111&#039;,&lt;br /&gt;
                &#039;region&#039;: &#039;HU-BU&#039;,&lt;br /&gt;
                &#039;street&#039;: &#039;Műegyetem rkpt. 3.&#039;,&lt;br /&gt;
                &#039;street2&#039;: &#039;2. porta&#039;,&lt;br /&gt;
                &#039;zip&#039;: &#039;1111&#039;&lt;br /&gt;
            },&lt;br /&gt;
            &#039;step&#039;: 1,&lt;br /&gt;
            &#039;zipCode&#039;: &#039;1111&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;next&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;setUserProperties&#039;, setUserPropertiesProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#next&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;setUserProperties&#039;, setUserPropertiesProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Category Selection (categorySelection) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; on a category on a category selection page&lt;br /&gt;
* User intent: View a category&lt;br /&gt;
* Why do we need this: Users demonstrate interest in items belonging to a category by looking at the category&lt;br /&gt;
&lt;br /&gt;
This event should be implemented where the user can select a category of events on a page, for example a brand, a common&lt;br /&gt;
property, a theme, a price range or any grouping of product along something that makes them belong to the category.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Category selection event properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Unique ID of the category clicked on your site.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Full name of the category.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Brand of the item in the category clicked.&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| | The category (eg. &#039;winter shoes&#039; or &#039;summer shoes&#039;) or subcategory branch (eg. &#039;clothes|shoes|winter&#039; or &#039;clothes|shoes|summer&#039;, separate levels with &#039;|&#039;) of the category that was clicked.&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| NO&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing items in the category. For more details see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Usually this value should be &amp;quot;Page&amp;quot;.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The value of a user performing this event to the business.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The collection that the category clicked is in from one of these possible values: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc&lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The category&#039;s position in the list or collection (e.g. 2) or the position of the creative (e.g. banner_slot_1)&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| NO&lt;br /&gt;
| integer&lt;br /&gt;
| A number that represents the progress in the checkout process.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Category selection event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For physical items &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample category data&lt;br /&gt;
        var categorySelectionProperties = {&lt;br /&gt;
            &#039;id&#039;: &#039;books_scifi&#039;,&lt;br /&gt;
            &#039;name&#039;: &#039;Sci-Fi Books&#039;,&lt;br /&gt;
            &#039;brand&#039;: undefined,&lt;br /&gt;
            &#039;category&#039;: &#039;Books&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;contentType&#039;: &#039;Page&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;list&#039;: &#039;SearchPage&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;42&#039;,&lt;br /&gt;
            &#039;step&#039;: undefined&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;select_category&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;categorySelection&#039;, categorySelectionProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#select_category&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;categorySelection&#039;, categorySelectionProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Click Product (clickProduct) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; on an item&lt;br /&gt;
* User intent: View an item&lt;br /&gt;
* Why do we need this: Users demonstrate interest in your items by clicking them&lt;br /&gt;
&lt;br /&gt;
This event should be fired each time when a user selects any of your items. This could be for example on a product&lt;br /&gt;
selection page, a result on a search or filter page, an item on a promotion. The page type on which the button is on&lt;br /&gt;
should be specified in the &#039;list&#039; property. In case of product bundles, you can use the &#039;contents&#039; property to list each&lt;br /&gt;
item in the bundle, while the direct properties should refer to the bundle as a whole as an item.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Click product event properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The type of the content of the page where the item was selected. Possible values (only these are accepted): Page/Product/Article/Promotion/Banner/Misc.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| Currency that the item is listed in for purchase. 3 digit ISO 4217 format is preferred (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Unique ID of the item clicked on your site.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Full name of the item clicked.&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The quantity of a product clicked measured in the unit provided (e.g. 2).&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The measurement unit of the item clicked. (e.g. pcs, kg).&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| Price of one unit (that you provided) of the item clicked (in the currency that you provided).&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Brand of the item clicked.&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The category (eg. &#039;winter shoes&#039; or &#039;summer shoes&#039;) or subcategory branch (eg. &#039;clothes|shoes|winter&#039; or &#039;clothes|shoes|summer&#039;, separate levels with &#039;|&#039;) of the item clicked.&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| NO&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing multiple items clicked. For more details see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The name or description of the promotion for the item, for example a promotion picture filename or slogan of the promotion that selects the item.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The value of a user performing this event to the business.&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) of the item if available.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The collection that the product clicked is in from one of these possible values: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc&lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The product&#039;s position in the list or collection (e.g. 2) or the position of the creative (e.g. banner_slot_1)&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| NO&lt;br /&gt;
| integer&lt;br /&gt;
| A number that represents the progress in the checkout process. Usually at a click product event, this is 0.&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the product (e.g. &#039;black&#039;) clicked.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Click product event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For physical items in checkout process &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample product data for single product&lt;br /&gt;
        var clickProductProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;creative&#039;: &#039;book_42&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;step&#039;: 2,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        // sample product data for bundle offer&lt;br /&gt;
        var clickProductProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42pack&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 15000.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;creative&#039;: &#039;bundle_offer_01&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;step&#039;: 2,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;book_42&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;clickProduct&#039;, clickProductProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#book_42&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;clickProduct&#039;, clickProductProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Click Product Detail (clickProductDetail) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; requesting extended details about an item&lt;br /&gt;
* User intent: View extended information about an item&lt;br /&gt;
* Why do we need this: Users demonstrate high interest in your items by looking up details about them&lt;br /&gt;
&lt;br /&gt;
This event should fire on a button click that can be either a webpage or an asynchronous request for more details about&lt;br /&gt;
an item. It should be implemented at any button that results in more details being shown about an item.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Click product detail event properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The type of the content of the page where the item was selected. Possible values (only these are accepted): Page/Product/Article/Promotion/Banner/Misc.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| Currency that the item is listed in for purchase. 3 digit ISO 4217 format is preferred (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Unique ID of the item clicked on your site.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Full name of the item clicked.&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The measurement unit of the item clicked. (e.g. pcs, kg).&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| Price of one unit (that you provided) of the item clicked (in the currency that you provided).&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the product (e.g. &#039;black&#039;) clicked.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Brand of the item clicked.&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The category (eg. &#039;winter shoes&#039; or &#039;summer shoes&#039;) or subcategory branch (eg. &#039;clothes|shoes|winter&#039; or &#039;clothes|shoes|summer&#039;, separate levels with &#039;|&#039;) of the item clicked.&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| NO&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing multiple items clicked. For more details see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The name or description of the promotion for the item, for example a promotion picture filename or slogan of the promotion that selects the item.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The value of a user performing this event to the business.&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) of the item if available.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The collection that the product clicked is in from one of these possible values: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc&lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The product&#039;s position in the list or collection (e.g. 2) or the position of the creative (e.g. banner_slot_1)&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| NO&lt;br /&gt;
| integer&lt;br /&gt;
| A number that represents the progress in the checkout process. Usually at a click product event, this is 0.&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The quantity of a product clicked measured in the unit provided (e.g. 2).&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the product (e.g. &#039;black&#039;) clicked.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Click product detail event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For physical items in checkout process&amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample product data for single product&lt;br /&gt;
        var clickProductDetailProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;creative&#039;: &#039;book_42&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;step&#039;: 2,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        // sample product data for bundle offer&lt;br /&gt;
        var clickProductDetailProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42pack&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 15000.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;creative&#039;: &#039;bundle_offer_01&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;step&#039;: 2,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;more_details&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;clickProductDetail&#039;, clickProductDetailProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#more_details&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;clickProductDetail&#039;, clickProductDetailProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Customize Product (customizeProduct) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; changing particular characteristics of an item&lt;br /&gt;
* User intent: Change characteristics of an item&lt;br /&gt;
* Why do we need this: Users demonstrate interest in your items by customizing them&lt;br /&gt;
&lt;br /&gt;
This event should fire on a button click that can be either a webpage or an asynchronous request for a different variant&lt;br /&gt;
of an item, for example color, size etc. It should be implemented at any button that results in a different variant&lt;br /&gt;
being shown.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Customize product event properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The type of the content of the page where the item was selected. Possible values (only these are accepted): Page/Product/Article/Promotion/Banner/Misc.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| Currency that the item is listed in for purchase. 3 digit ISO 4217 format is preferred (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Unique ID of the item clicked on your site.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Full name of the item clicked.&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The measurement unit of the item clicked. (e.g. pcs, kg).&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| Price of one unit (that you provided) of the item clicked (in the currency that you provided).&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the product (e.g. &#039;black&#039;) clicked.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Brand of the item clicked.&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The category (eg. &#039;winter shoes&#039; or &#039;summer shoes&#039;) or subcategory branch (eg. &#039;clothes|shoes|winter&#039; or &#039;clothes|shoes|summer&#039;, separate levels with &#039;|&#039;) of the item clicked.&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| NO&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing multiple items clicked. For more details see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The name or description of the promotion for the item, for example a promotion picture filename or slogan of the promotion that selects the item.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The value of a user performing this event to the business.&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) of the item if available.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The collection that the product clicked is in from one of these possible values: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc&lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The product&#039;s position in the list or collection (e.g. 2) or the position of the creative (e.g. banner_slot_1)&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The quantity of a product clicked measured in the unit provided (e.g. 2).&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| NO&lt;br /&gt;
| integer&lt;br /&gt;
| A number that represents the progress in the checkout process. Usually at a click product event, this is 0.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Customize product event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For physical items in checkout process &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample product data for single product&lt;br /&gt;
        var customizeProductProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;creative&#039;: &#039;book_42&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;step&#039;: 2,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        // sample product data for bundle offer&lt;br /&gt;
        var customizeProductProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42pack&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 15000.0,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;creative&#039;: &#039;bundle_offer_01&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;step&#039;: 2,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;customize&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;customizeProduct&#039;, customizeProductProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#customize&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;customizeProduct&#039;, customizeProductProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Purchase (purchase) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Page load&#039;&#039; after the payment process&lt;br /&gt;
* User intent: Verify the completion of the transaction&lt;br /&gt;
* Why do we need this: Users usually are put off by adverts of an item they already purchased, but can be receptive to related products&lt;br /&gt;
&lt;br /&gt;
This event should be fired on the page load where the user is notified about the completion of their transaction. This&lt;br /&gt;
is usually a &#039;thank you&#039; page, that thanks the user for their purchase and verifies that the payment was successful. If&lt;br /&gt;
the payment wasn&#039;t successful, then still this is the event that needs to be fire, except the &#039;step&#039; property should be&lt;br /&gt;
given a &#039;-1&#039; value.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Purchase event properties&#039;&#039;&#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| YES&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing the actual items contained in the cart, meaning the shipping and coupons should be excluded. For the detailed format see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| The currency that the price is provided in, preferably in the three letter ISO 4217 format (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! revenue&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The total revenue associated with the transaction in the given currency. This should include all costs the customer pays like shipping or tax.&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| YES&lt;br /&gt;
| integer&lt;br /&gt;
| In most cases, since this is after the last checkout step, this should be the maximum value that you use. If the transaction is unsuccessful, this should be -1.&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Usually this value should be &amp;quot;Product&amp;quot;.&lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The coupon code that is being used.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The name or description of the promotion for the cart, for example a promotion picture filename or slogan of the promotion that starts the checkout automatically.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| A metric that you define that measures the value of the action performed to your business.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| In most cases this should be &#039;Checkout&#039;.&lt;br /&gt;
|-&lt;br /&gt;
! option&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Additional information about the purchase.&lt;br /&gt;
|-&lt;br /&gt;
! orderNumber&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The unique ID of the purchase.&lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The item&#039;s position in a list or collection (e.g. 2) or the position of the promotion on a page (e.g. banner_slot_1).&lt;br /&gt;
|-&lt;br /&gt;
! shipping&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The price of shipping associated with the purchase in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! shippingAddress&lt;br /&gt;
| NO&lt;br /&gt;
| object&lt;br /&gt;
| The shipping address given in the format detailed below.&lt;br /&gt;
|-&lt;br /&gt;
! tax&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The tax associated with the purchase in the given currency.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Purchase event implementation example: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; Successful purchase example for physical items &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|       var purchaseProperties = {&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;revenue&#039;: 17500.0,&lt;br /&gt;
            &#039;step&#039;: 7,&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;preselected_cart_01&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;option&#039;: &#039;To postal office, no street address&#039;,&lt;br /&gt;
            &#039;orderNumber&#039;: &#039;852&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;shipping&#039;: 2500.0,&lt;br /&gt;
            &#039;shippingAddress&#039;: {&lt;br /&gt;
                &#039;city&#039;: &#039;Budapest&#039;,&lt;br /&gt;
                &#039;country&#039;: &#039;HU&#039;,&lt;br /&gt;
                &#039;deliveryMethod&#039;: &#039;DHL&#039;,&lt;br /&gt;
                &#039;fullName&#039;: &#039;John Doe&#039;,&lt;br /&gt;
                &#039;phone&#039;: &#039;+36 1 1111 111&#039;,&lt;br /&gt;
                &#039;region&#039;: &#039;HU-BU&#039;,&lt;br /&gt;
                &#039;street&#039;: &#039;Műegyetem rkpt. 3.&#039;,&lt;br /&gt;
                &#039;street2&#039;: &#039;2. porta&#039;,&lt;br /&gt;
                &#039;zip&#039;: &#039;1111&#039;&lt;br /&gt;
            },&lt;br /&gt;
            &#039;tax&#039;: 0.0&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        bp(&#039;track&#039;, &#039;purchase&#039;, purchaseProperties);&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Remove from Cart (removeFromCart) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; that results in a product to be removed from the items selected for purchase&lt;br /&gt;
* User intent: Deselect product for purchase&lt;br /&gt;
* Why do we need this: Users demonstrate interest in carted products, and this can be refined if we know when products are deselected&lt;br /&gt;
&lt;br /&gt;
The remove from cart event is very similar to the add to cart event, and is mainly required to refine our data on&lt;br /&gt;
selected items by informing us when products are taken out from the cart or deselected from purchase. It can also mean&lt;br /&gt;
that a purchase process that first made a user select an item is simply cancelled.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Remove from cart event properties&#039;&#039;&#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Usually, this value should be &amp;quot;Product&amp;quot;.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| The currency that the price is provided in, preferably in the three letter ISO 4217 format (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| An unique ID that you have for the item, this can be your ID for the product, an SKU or a promotion ID.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The full name that you have for the added item, for example a product name (eg. Red Bull 24pcs carton).&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The quantity of the item removed from the cart.&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The total price of the removed items in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The unit that your item is measured in (eg. pieces, kg, hours).&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The price of one measurement of your item in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The brand of the item.&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| | The subcategory branch (preferred, eg. &#039;clothes|shoes|winter&#039;, separate levels with &#039;|&#039;) or single category (eg. &#039;winter shoes&#039; or &#039;summer shoes&#039;) of the item.&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| NO&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing multiple items of the item. For more details see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The coupon code that was used when the item was removed from cart.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Seldom used, for example a promotion that changes a product in your cart to a better, more expensive or more recent one.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| A metric that you define that measures the value of the action performed to your business.&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) of the item if available.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The function of the loaded page from one of these possible values: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc&lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The item&#039;s position in a list or collection (e.g. 2) or the position of the promotion on a page (e.g. banner_slot_1).&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| NO&lt;br /&gt;
| integer&lt;br /&gt;
| If the page is displayed along the checkout process, the checkout step number that the page is displayed in, numbered from 0 as the checkout initiation.&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the offer from the list of possible identical items (eg. the color of a phone or the time and venue of a concert or movie)&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Remove from cart event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For physical items in basket page &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample product data for single items&lt;br /&gt;
        var removeFromCartProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;quantity&#039;: 10.0,&lt;br /&gt;
            &#039;totalItemPrice&#039;: 49900.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 4990.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;upsell_promo_42&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;BasketPage&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;3&#039;,&lt;br /&gt;
            &#039;step&#039;: undefined,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // sample product data for bundled items&lt;br /&gt;
        var removeFromCartProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42pack&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;quantity&#039;: 10.0,&lt;br /&gt;
            &#039;totalItemPrice&#039;: 150000.0,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 15000.0,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;upsell_promo_42&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;BasketPage&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;3&#039;,&lt;br /&gt;
            &#039;step&#039;: undefined,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;remove_button&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;removeFromCart&#039;, removeFromCartProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#remove_button&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;removeFromCart&#039;, removeFromCartProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Add Payment Info (addPaymentInfo) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; at a point in the checkout process where the payment method is already set&lt;br /&gt;
* User intent: Select payment method&lt;br /&gt;
* Why do we need this: It helps to identify user financial habits&lt;br /&gt;
&lt;br /&gt;
This event should be fired when the payment method of a user is already entered. This event should be fired both if&lt;br /&gt;
the payment info is explicitly requested and provided, but also if it is only implied for example when only one option&lt;br /&gt;
is available.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Add payment info event properties&#039;&#039;&#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| YES&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing the actual items contained in the cart, meaning the shipping and coupons should be excluded. For the detailed format see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! paymentMethod&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The method of payment that the user chooses, for example Barion, cash etc.&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| YES&lt;br /&gt;
| integer&lt;br /&gt;
| It representing the current number of step in the checkout process.&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Usually this value should be &amp;quot;Product&amp;quot;.&lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The coupon code that is being used.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The name or description of the promotion for the cart, for example a promotion picture filename or slogan of the promotion that starts the checkout automatically.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| NO&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| The currency that the price is provided in, preferably in the three letter ISO 4217 format (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| A metric that you define that measures the value of the action performed to your business.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| In most cases this should be &#039;Checkout&#039;.&lt;br /&gt;
|-&lt;br /&gt;
! option&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Additional information about the purchase.&lt;br /&gt;
|-&lt;br /&gt;
! orderNumber&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The unique ID of the purchase.&lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The item&#039;s position in a list or collection (e.g. 2) or the position of the promotion on a page (e.g. banner_slot_1).&lt;br /&gt;
|-&lt;br /&gt;
! revenue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The total revenue associated with the transaction in the given currency. This should include all costs the customer pays like shipping or tax.&lt;br /&gt;
|-&lt;br /&gt;
! shipping&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The price of shipping associated with the purchase in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! shippingAddress&lt;br /&gt;
| NO&lt;br /&gt;
| object&lt;br /&gt;
| The shipping address given in the format detailed below.&lt;br /&gt;
|-&lt;br /&gt;
! tax&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The tax associated with the purchase in the given currency.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Add payment info event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For physical items &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample product data&lt;br /&gt;
        var addPaymentInfoProperties = {&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;paymentMethod&#039;: &#039;Barion&#039;,&lt;br /&gt;
            &#039;step&#039;: 0,&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;preselected_cart_01&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;option&#039;: &#039;To postal office, no street address&#039;,&lt;br /&gt;
            &#039;orderNumber&#039;: &#039;852&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;revenue&#039;: 17500.0,&lt;br /&gt;
            &#039;shipping&#039;: 2500.0,&lt;br /&gt;
            &#039;shippingAddress&#039;: {&lt;br /&gt;
                &#039;city&#039;: &#039;Budapest&#039;,&lt;br /&gt;
                &#039;country&#039;: &#039;HU&#039;,&lt;br /&gt;
                &#039;deliveryMethod&#039;: &#039;DHL&#039;,&lt;br /&gt;
                &#039;fullName&#039;: &#039;John Doe&#039;,&lt;br /&gt;
                &#039;phone&#039;: &#039;+36 1 1111 111&#039;,&lt;br /&gt;
                &#039;region&#039;: &#039;HU-BU&#039;,&lt;br /&gt;
                &#039;street&#039;: &#039;Műegyetem rkpt. 3.&#039;,&lt;br /&gt;
                &#039;street2&#039;: &#039;2. porta&#039;,&lt;br /&gt;
                &#039;zip&#039;: &#039;1111&#039;&lt;br /&gt;
            },&lt;br /&gt;
            &#039;tax&#039;: 0.0&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;checkout_next&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;addPaymentInfo&#039;, addPaymentInfoProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#checkout_next&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;addPaymentInfo&#039;, addPaymentInfoProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Click Promo (clickPromo) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; on a promotion box&lt;br /&gt;
* User intent: View a promotion&lt;br /&gt;
* Why do we need this: Users demonstrate interest in your promotion offers by clicking them&lt;br /&gt;
&lt;br /&gt;
This event should be fired when one of your users selects a promotion. Promotions can be usually placed on home pages,&lt;br /&gt;
product places, in the checkout process and many other places. The promotion can be about a product, offer, brand or any&lt;br /&gt;
other single offer or grouping of offers.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Click promo event properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The type of the content of the page where the promotion was selected. Possible values (only these are accepted): Page/Product/Article/Promotion/Banner/Misc.&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The name or description of the promotion, for example a promotion picture filename or slogan of the promotion.&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Unique ID of the promotion clicked on your site.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| Full name of the promotion.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Brand of the item in the promotion clicked.&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| | The category (eg. &#039;winter shoes&#039; or &#039;summer shoes&#039;) or subcategory branch (eg. &#039;clothes|shoes|winter&#039; or &#039;clothes|shoes|summer&#039;, separate levels with &#039;|&#039;) of the item in the promotion clicked.&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| NO&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing multiple items promoted. For more details see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| NO&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| Currency that the promoted offer is listed in. 3 digit ISO 4217 format is preferred (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The value of a user performing this event to the business.&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) of the item if available.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The collection that the promotion clicked is in from one of these possible values: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc&lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The promotion&#039;s position in the list or collection (e.g. 2) or the position of the creative (e.g. banner_slot_1)&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The quantity that the item is promoted in, measured in the unit provided (e.g. 2).&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| NO&lt;br /&gt;
| integer&lt;br /&gt;
| A number that represents the progress in the checkout process. Usually at a click product event, this is 0.&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The measurement unit of the item promoted (e.g. pcs, kg).&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| Price of one unit (that you provided) of the item promoted (in the currency that you provided).&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the product (e.g. &#039;black&#039;) promoted.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Click promo event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; In checkout process &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample product data for single product&lt;br /&gt;
        var clickPromoProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;book_42&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
            &#039;step&#039;: 2,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        // sample product data for bundle offer&lt;br /&gt;
        var clickPromoProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;creative&#039;: &#039;bundle_offer_01&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42pack&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
            &#039;position&#039;: &#039;1&#039;,&lt;br /&gt;
            &#039;quantity&#039;: 1.0,&lt;br /&gt;
            &#039;step&#039;: 2,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 15000.0,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;book_42_promo&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;clickPromo&#039;, clickPromoProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#book_42_promo&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;clickPromo&#039;, clickPromoProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Sign Up (signUp) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; that completes the registration or login process&lt;br /&gt;
* User intent: Register for or login to a user account or a newsletter subscription&lt;br /&gt;
* Why do we need this: Users demonstrate interest in your market area by signing up for an account&lt;br /&gt;
&lt;br /&gt;
This event should be usually sent along the set user properties event, since this event only captures the actual signup,&lt;br /&gt;
not the user itself. This event should both be fired if a user registers for an account or subscription for the first&lt;br /&gt;
time and when they login afterwards. Unsuccessful login or signup events should cause error events to be sent. If&lt;br /&gt;
possible, it is better if only successful attempts send a sign up event, but it is more important for all signing ups to&lt;br /&gt;
send an event than for each signup to be only sent once.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Add to cart event properties&#039;&#039;&#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| If the user signs up for a product, then it should be &#039;Product&#039; else this can be &#039;Page&#039; if it is a general registration or login.&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| This should be your unique ID for the form used to register or login.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The name of the for used for the signing up, for example &#039;Register&#039; or &#039;Sign In&#039;.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The brand of the product the user signs up for.&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| | The subcategory branch (preferred, eg. &#039;clothes|shoes|winter&#039;, separate levels with &#039;|&#039;) or single category (eg. &#039;winter shoes&#039; or &#039;summer shoes&#039;) of the item.&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| NO&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects for detailing multiple items of the item. For more details see the table below.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| NO&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| The currency that the price is provided in, preferably in the three letter ISO 4217 format (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| A metric that you define that measures the value of the action performed to your business.&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) of the offer if available.&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The unit that your subscribed item is measured in (eg. pieces, kg, hours).&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The price of one measurement of your item in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| THehvariant of the offer from the list of possible identical items (eg. the color of a phone or the time and venue of a concert or movie)&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Sign up event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; Newsletter for a given item&amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample subscription data&lt;br /&gt;
        var signUpProperties = {&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
            &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, newsletter&amp;quot;,&lt;br /&gt;
            &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
            &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
            &#039;contents&#039;: undefined,&lt;br /&gt;
            &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
            &#039;unit&#039;: &#039;pcs.&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 4990.0,&lt;br /&gt;
            &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;signup_button&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;signUp&#039;, signUpProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#signup_button&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;signUp&#039;, signUpProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Search (search) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: &#039;&#039;Button click&#039;&#039; that starts a search on a page&lt;br /&gt;
* User intent: Search for an offer on your page&lt;br /&gt;
* Why do we need this: Users demonstrate interest in an offer by searching for it&lt;br /&gt;
&lt;br /&gt;
This event is quite straightforward, every time a search button is clicked, this should send. If the search has no&lt;br /&gt;
search button, but instead gives results on the change of the search box, then this event can be sent if the user clicks&lt;br /&gt;
on a result. In this case, searches are sent asynchronously for partial search terms, which should not in themselves&lt;br /&gt;
send an event. If you have a product selection page where items can be filtered, then the same can apply, the search&lt;br /&gt;
string in this case can be the query that the settings make that can be read in your browser address bar in HTTP&lt;br /&gt;
properties (eg. &#039;goats&#039; in this: &#039;https://www.google.com/search?ei=A3rRXNHmJY-nrgSJs5HgDQ&amp;amp;q=goats&#039;).&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Search event properties&#039;&#039;&#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! searchString&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The search terms entered by the user or the HTTP property that contains the search terms.&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| NO&lt;br /&gt;
| array&lt;br /&gt;
| An array of JS objects containing the top ten results of your search.&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Usually this should be &#039;Product&#039;.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| NO&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| If you have a filter that selects products by price, and the search string doesn&#039;t contain this, then you should provide it here.&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| A metric that you define that measures the value of the action performed to your business.&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| NO&lt;br /&gt;
| float&lt;br /&gt;
| The id of the search facility that the search is made in, for example of a search box or a filter array.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The name of the search facility that the search is made in, for example of a search box or a filter array.&lt;br /&gt;
|-&lt;br /&gt;
! totalResults&lt;br /&gt;
| NO&lt;br /&gt;
| integer&lt;br /&gt;
| The number of the search or filter results.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Search event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; General example&amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // sample search result data&lt;br /&gt;
        var searchProperties = {&lt;br /&gt;
            &#039;searchString&#039;: &#039;big GOATS&#039;,&lt;br /&gt;
            &#039;contents&#039;: [{&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                },&lt;br /&gt;
                {&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                &#039;quantity&#039;: 3.0,&lt;br /&gt;
                &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                }],&lt;br /&gt;
            &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
            &#039;currency&#039;: undefined,&lt;br /&gt;
            &#039;customerValue&#039;: 150.0,&lt;br /&gt;
            &#039;id&#039;: &#039;search_01&#039;,&lt;br /&gt;
            &#039;name&#039;: &#039;Book Search&#039;,&lt;br /&gt;
            &#039;totalResults&#039;: 2&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;search_button&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;search&#039;, searchProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#search_button&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;search&#039;, searchProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Error (error) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: Any event that results in erroneous operation&lt;br /&gt;
* User intent: Something else&lt;br /&gt;
* Why do we need this: We can get more information about event failures&lt;br /&gt;
&lt;br /&gt;
This event should be sent each time the page can&#039;t complete the requested operation, for examnple on 40x or 50x pages,&lt;br /&gt;
failed form submissions et cetera.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Error event properties&#039;&#039;&#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! description&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The description of the error, or preferably the full error message.&lt;br /&gt;
|-&lt;br /&gt;
! code&lt;br /&gt;
| NO&lt;br /&gt;
| int&lt;br /&gt;
| The error code.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Error event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For 404 error &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|   // on a static 404 page&lt;br /&gt;
        var errorProperties = {&lt;br /&gt;
            &#039;description&#039;: &#039;I find your lack of navigation disturbing.&#039;,&lt;br /&gt;
            &#039;code&#039;: 404&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        bp(&#039;track&#039;, &#039;error&#039;, errorProperties);&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Custom Event (customEvent) ==&lt;br /&gt;
&lt;br /&gt;
* Firing event: Any action that can&#039;t be described with our events&lt;br /&gt;
* User intent: Something different&lt;br /&gt;
* Why do we need this: We can get more information&lt;br /&gt;
&lt;br /&gt;
This event is for describing any event that can&#039;t be otherwise described with our standard events.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Error event properties&#039;&#039;&#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! eventAction&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The action that the user takes, eg. click.&lt;br /&gt;
|-&lt;br /&gt;
! eventCategory&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The category that the event falls in, you can define it for yourself, eg. &#039;user_settings&#039;.&lt;br /&gt;
|-&lt;br /&gt;
! eventLabel&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The label associated with the event, eg. &#039;language_selection&#039;.&lt;br /&gt;
|-&lt;br /&gt;
! eventProperty&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The property associated with the event, eg. &#039;unit_format&#039;.&lt;br /&gt;
|-&lt;br /&gt;
! eventValue&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The value of the property associated with the event, eg. &#039;metric&#039;.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Custom event implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; For measuring unit selection &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|      // for measuring unit selection&lt;br /&gt;
        var customEventProperties = {&lt;br /&gt;
            &#039;eventAction&#039;: &#039;click&#039;,&lt;br /&gt;
            &#039;eventCategory&#039;: &#039;user_settings&#039;,&lt;br /&gt;
            &#039;eventLabel&#039;: &#039;language_selection&#039;,&lt;br /&gt;
            &#039;eventProperty&#039;: &#039;unit_format&#039;,&lt;br /&gt;
            &#039;eventValue&#039;: &#039;metric&#039;&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        // Use one of these to add the event listener to the button click (use only one):&lt;br /&gt;
&lt;br /&gt;
        // vanilla JS (if you don&#039;t use jQuery, if in your console &amp;quot;$&amp;quot; is not defined on your site)&lt;br /&gt;
        document.getElementById(&#039;set_language&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;customEvent&#039;, customEventProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
        // jQuery (if you use jQuery, if in your console &amp;quot;$&amp;quot; is defined on your site)&lt;br /&gt;
        $(&amp;quot;#set_language&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;customEvent&#039;, customEventProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
= Special properties =&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Contents value type - array of objects &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| If this is a product page as per minimal requirements, this value should be &amp;quot;Product&amp;quot;. Otherwise select a value that best fits from these: Page/Product/Article/Promotion/Banner/Misc.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
| text (ISO 4217)&lt;br /&gt;
| The currency that the product price is provided in, preferably in the three letter ISO 4217 format (eg. HUF, EUR).&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| An unique ID that you have for the offer, this can be your ID for the product, an SKU or a promotion ID.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The full name that you have for the offer, for example a product name (eg. Red Bull 24pcs carton).&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The quantity of the product offered as initially given on the page.&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The total price of the added items in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES&lt;br /&gt;
| text&lt;br /&gt;
| The unit that your offer is measured in (eg. pieces, kg, m).&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES&lt;br /&gt;
| float&lt;br /&gt;
| The price of one measurement of your offer in the given currency.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The brand of the offer.&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| | The subcategory branch (preferred, eg. &#039;clothes|shoes|winter&#039;, separate levels with &#039;|&#039;) or single category (eg. &#039;winter shoes&#039; or &#039;summer shoes&#039;) of the offer.&lt;br /&gt;
|-&lt;br /&gt;
! description&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The detailed description of item.&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) of the offer if available.&lt;br /&gt;
|-&lt;br /&gt;
! imageUrl&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The URL of the image of the viewed item.&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the offer from the list of possible identical items (eg. the color of a phone or the time and venue of a concert or movie)&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Address value type - array of objects &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! key&lt;br /&gt;
! required&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! city&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The complete name of the city of the recipient address.&lt;br /&gt;
|-&lt;br /&gt;
! country&lt;br /&gt;
| NO&lt;br /&gt;
| text (ISO-3166-1 alpha-2)&lt;br /&gt;
| The recipient&#039;s country code in ISO-3166-1 alpha-2 format.&lt;br /&gt;
|-&lt;br /&gt;
! deliveryMethod&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The delivery method, if applicable.&lt;br /&gt;
|-&lt;br /&gt;
! fullName&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The full civil or official name of the recipient.&lt;br /&gt;
|-&lt;br /&gt;
! phone&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The phone number of the recipient.&lt;br /&gt;
|-&lt;br /&gt;
! region&lt;br /&gt;
| NO&lt;br /&gt;
| text (ISO-3166-2)&lt;br /&gt;
| The region code of the recipient address in ISO-3166-2 format.&lt;br /&gt;
|-&lt;br /&gt;
! street&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The shipping street address with house number and other details.&lt;br /&gt;
|-&lt;br /&gt;
! street2&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The address, continued.&lt;br /&gt;
|-&lt;br /&gt;
! zip&lt;br /&gt;
| NO&lt;br /&gt;
| text&lt;br /&gt;
| The zip code of the recipient address.&lt;br /&gt;
|}    &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Custom Property &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! name&lt;br /&gt;
! Value Type&lt;br /&gt;
! Description&lt;br /&gt;
|-&lt;br /&gt;
| _custom &lt;br /&gt;
| any type&lt;br /&gt;
| If our predefined events and/or object properties don&#039;t suit your needs, you can include your own, custom events and/or properties. Custom properties can be used with standard events. Custom properties must start with an underscore.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039; Custom property implementation examples: &#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| role=&amp;quot;presentation&amp;quot; class=&amp;quot;wikitable mw-collapsible mw-collapsed&amp;quot;&lt;br /&gt;
| &amp;lt;strong&amp;gt; In purchase event &amp;lt;/strong&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|       //_custome_event_test&lt;br /&gt;
        var purchaseProperties = {&lt;br /&gt;
                &#039;contents&#039;: [{&lt;br /&gt;
                    &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                    &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                    &#039;id&#039;: &#039;item_42&#039;,&lt;br /&gt;
                    &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                    &#039;quantity&#039;: 3.0,&lt;br /&gt;
                    &#039;totalItemPrice&#039;: 7500.0,&lt;br /&gt;
                    &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                    &#039;unitPrice&#039;: 2500.0,&lt;br /&gt;
                    &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                    &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                    &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                    &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                    &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                    &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                    },&lt;br /&gt;
                    {&lt;br /&gt;
                    &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                    &#039;currency&#039;: &#039;USD&#039;,&lt;br /&gt;
                    &#039;id&#039;: &#039;item_42en&#039;,&lt;br /&gt;
                    &#039;name&#039;: &amp;quot;Hitchhikers&#039; Guide to the Galaxy, hardcover, ISBN: 9780575115347&amp;quot;,&lt;br /&gt;
                    &#039;quantity&#039;: 3.0,&lt;br /&gt;
                    &#039;totalItemPrice&#039;: 25.935,&lt;br /&gt;
                    &#039;unit&#039;: &#039;pcs&#039;,&lt;br /&gt;
                    &#039;unitPrice&#039;: 8.645,&lt;br /&gt;
                    &#039;brand&#039;: &#039;Gollancz&#039;,&lt;br /&gt;
                    &#039;category&#039;: &#039;books|hardcover|scifi, books|hardcover|comedy&#039;,&lt;br /&gt;
                    &#039;description&#039;: &#039;The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.&#039;,&lt;br /&gt;
                    &#039;ean&#039;: &#039;9780575115347&#039;,&lt;br /&gt;
                    &#039;imageUrl&#039;: &#039;https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg&#039;,&lt;br /&gt;
                    &#039;variant&#039;: &#039;hardcover&#039;&lt;br /&gt;
                    }],&lt;br /&gt;
                &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
                &#039;revenue&#039;: 17500.0,&lt;br /&gt;
                &#039;step&#039;: 7,&lt;br /&gt;
                &#039;contentType&#039;: &#039;Product&#039;,&lt;br /&gt;
                &#039;coupon&#039;: &#039;43763436874&#039;,&lt;br /&gt;
                &#039;creative&#039;: &#039;preselected_cart_01&#039;,&lt;br /&gt;
                &#039;customerValue&#039;: 150.0,&lt;br /&gt;
                &#039;list&#039;: &#039;Checkout&#039;,&lt;br /&gt;
                &#039;option&#039;: &#039;To postal office, no street address&#039;,&lt;br /&gt;
                &#039;orderNumber&#039;: &#039;852&#039;,&lt;br /&gt;
                &#039;position&#039;: &#039;1&#039;,&lt;br /&gt;
                &#039;shipping&#039;: 2500.0,&lt;br /&gt;
                &#039;shippingAddress&#039;: {&lt;br /&gt;
                    &#039;city&#039;: &#039;Budapest&#039;,&lt;br /&gt;
                    &#039;country&#039;: &#039;HU&#039;,&lt;br /&gt;
                    &#039;deliveryMethod&#039;: &#039;DHL&#039;,&lt;br /&gt;
                    &#039;fullName&#039;: &#039;John Doe&#039;,&lt;br /&gt;
                    &#039;phone&#039;: &#039;+36 1 1111 111&#039;,&lt;br /&gt;
                    &#039;region&#039;: &#039;HU-BU&#039;,&lt;br /&gt;
                    &#039;street&#039;: &#039;Műegyetem rkpt. 3.&#039;,&lt;br /&gt;
                    &#039;street2&#039;: &#039;2. porta&#039;,&lt;br /&gt;
                    &#039;zip&#039;: &#039;1111&#039;&lt;br /&gt;
                },&lt;br /&gt;
                &#039;tax&#039;: 0.0,&lt;br /&gt;
                &#039;_myCustomProperty&#039; : &#039;This is my first custom property&#039;&lt;br /&gt;
            }&lt;br /&gt;
            &lt;br /&gt;
            bp(&#039;track&#039;, &#039;purchase&#039;, purchaseProperties);&lt;br /&gt;
&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
= Implementing the base code in the Google Tag Manager =&lt;br /&gt;
&lt;br /&gt;
&amp;lt;gallery mode=&amp;quot;slideshow&amp;quot; widths=200px heights=200px&amp;gt;&lt;br /&gt;
Image:Datamongtm-1.png|GTM screen&lt;br /&gt;
Image:Datamongtm-2.png|Click on Tags in Current Workspace on the left side&lt;br /&gt;
Image:Datamongtm-3.png|Click on New on the screen that appears&lt;br /&gt;
Image:Datamongtm-4.png|Name the tag as you like, for example to &amp;quot;Barion Pixel - Base Code&amp;quot;&lt;br /&gt;
Image:Datamongtm-5.png|Click into the &amp;quot;Choose a tag&amp;quot; box&lt;br /&gt;
Image:Datamongtm-6.png|Choose &amp;quot;Custom HTML&amp;quot; in the dropdown&lt;br /&gt;
Image:Datamongtm-7.png|Paste the Base Code into the HTML box&lt;br /&gt;
Image:Datamongtm-8.png|Put your own Pixel ID into both places&lt;br /&gt;
Image:Datamongtm-9.png|Verify that you have put your own Pixel ID into both places&lt;br /&gt;
Image:Datamongtm-10.png|Click into the &amp;quot;Triggering&amp;quot; box&lt;br /&gt;
Image:Datamongtm-11.png|Choose &amp;quot;All Pages&amp;quot; from the list&lt;br /&gt;
Image:Datamongtm-12.png|Verify triggering on all pages and your Pixel ID in both places, then click &amp;quot;Save&amp;quot;&lt;br /&gt;
Image:Datamongtm-13.png|The new tag shoud appear in the Tags list&lt;br /&gt;
&amp;lt;/gallery&amp;gt;&lt;/div&gt;</summary>
		<author><name>Baloghn</name></author>
	</entry>
	<entry>
		<id>https://docs.barion.com/index.php?title=Barion_Pixel_API_reference&amp;diff=1702</id>
		<title>Barion Pixel API reference</title>
		<link rel="alternate" type="text/html" href="https://docs.barion.com/index.php?title=Barion_Pixel_API_reference&amp;diff=1702"/>
		<updated>2019-05-02T13:39:56Z</updated>

		<summary type="html">&lt;p&gt;Baloghn: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{PageTitle|title=Barion Pixel}}&lt;br /&gt;
&lt;br /&gt;
{| style=&amp;quot;margin-left:2em;&amp;quot; align=&amp;quot;right&amp;quot;&lt;br /&gt;
| __TOC__&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
The Barion Pixel is JavaScript code that allows you to track visitor activity on your website. It works by loading a&lt;br /&gt;
JavaScript function which you can use whenever a site visitor takes an action that you want to track (this action is&lt;br /&gt;
called an event).&lt;br /&gt;
&lt;br /&gt;
In order to implement the Pixel, you will need:&lt;br /&gt;
* access to your website&#039;s HTML code base&lt;br /&gt;
* your Barion Pixel ID that you can access from your Barion Wallet&lt;br /&gt;
&lt;br /&gt;
By default, the Pixel will track pages visited, and the devices your visitors use. In addition, you can use the&lt;br /&gt;
Pixel&#039;s JavaScript function to track other events that are associated with webshop usage and e-commerce. Without&lt;br /&gt;
collecting the consent of the website visitor you must still use the Barion Pixel on your website for fraud management&lt;br /&gt;
purposes. (Tracking visitor behavior for the purposes of preventing fraud is considered a legitimate interest of&lt;br /&gt;
Barion and the merchant in contract with Barion). If you collect the consent of your visitors (see consent events&lt;br /&gt;
below in Minimum requirements) for marketing purposes, you can get lower fees for your Barion Smart Gateway. The&lt;br /&gt;
implementation of the base code is considered mandatory for using the Barion Smart Gateway.&lt;br /&gt;
&lt;br /&gt;
= Implementing the base code =&lt;br /&gt;
&lt;br /&gt;
== Base code ==&lt;br /&gt;
To install the Pixel, we highly recommend that you add the following code (referred to as the base code) between the&lt;br /&gt;
opening and closing &amp;lt;head&amp;gt; tags on every page of your site. Most developers add it to their website&#039;s persistent header,&lt;br /&gt;
so that it appears automatically on all loaded pages.&lt;br /&gt;
&lt;br /&gt;
Placing the code within your &amp;lt;head&amp;gt; tags reduces the chances of browsers or third-party code blocking the Pixel&#039;s&lt;br /&gt;
execution. It also executes the code sooner, increasing the chance that your visitors are tracked before they leave your&lt;br /&gt;
page. Sending the tracking data happens asynchronously in the client&#039;s browser so that it does not slow user experience.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 1&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
    &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;script&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            (function(i,s,o,g,r,a,m){i[&#039;BarionAnalyticsObject&#039;]=r;i[r]=i[r]||function(){&lt;br /&gt;
            (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),&lt;br /&gt;
            m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)&lt;br /&gt;
            })(window, document, &#039;script&#039;, &#039;https://pixel.barion.com/bp.js&#039;, &#039;bp&#039;);&lt;br /&gt;
&lt;br /&gt;
            // send page view event&lt;br /&gt;
            bp(&#039;init&#039;, &#039;addBarionPixelId&#039;, &#039;&amp;lt;/nowiki&amp;gt;&amp;lt;span style=&amp;quot;color:red&amp;quot;&amp;gt;[YOUR BARION PIXEL ID GOES HERE]&amp;lt;/span&amp;gt;&amp;lt;nowiki&amp;gt;&#039;);&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;/script&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;noscript&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;img height=&amp;quot;1&amp;quot; width=&amp;quot;1&amp;quot; style=&amp;quot;display:none&amp;quot; src=&amp;quot;https://pixel.barion.com/a.gif?__ba_pixel_id=&amp;lt;/nowiki&amp;gt;&amp;lt;span style=&amp;quot;color:red&amp;quot;&amp;gt;[YOUR BARION PIXEL ID GOES HERE]&amp;lt;/span&amp;gt;&amp;lt;nowiki&amp;gt;&amp;amp;ev=contentView&amp;amp;noscript=1&amp;quot;/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;/noscript&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
When run, this code will make available a JavaScript function which you can then use for tracking. It also automatically&lt;br /&gt;
tracks a single PageView conversion by calling the tracking bp() function each time it loads. We recommend that you&lt;br /&gt;
leave this function call intact.&lt;br /&gt;
&lt;br /&gt;
== Consent Events ==&lt;br /&gt;
Consent events determine which of the sent data could be used by us for marketing purposes. Two consent events can be&lt;br /&gt;
used to control user consent. The &amp;quot;grantConsent&amp;quot; event has to be sent when the visitor accepts the cookie policy&lt;br /&gt;
that expressly allows Barion to use data for marketing purposes. The &amp;quot;rejectConsent&amp;quot; event should be sent when the&lt;br /&gt;
customer rejects the cookie policy that includes Barion Pixel tracking. It should be noted that rejecting Barion&lt;br /&gt;
marketing consent does not mean that no data should be sent towards Barion, since Barion has a legitimate interest using&lt;br /&gt;
this data for fraud management. All consent events are tracked by calling the Pixel&#039;s bp(&#039;consent&#039;) function as shown&lt;br /&gt;
below.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 2&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
    &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        bp(&#039;consent&#039;, &#039;grantConsent&#039;);&lt;br /&gt;
        bp(&#039;consent&#039;, &#039;rejectConsent&#039;);&lt;br /&gt;
&lt;br /&gt;
    &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= Implementing Standard and Custom Events =&lt;br /&gt;
There are two ways to track conversions with the Pixel:&lt;br /&gt;
* standard events, which are visitor actions that we have defined and that you report by calling a Pixel function&lt;br /&gt;
* custom events, which are visitor actions that you have defined and that you report by calling a Pixel function&lt;br /&gt;
&lt;br /&gt;
== Standard Events ==&lt;br /&gt;
Standard events are predefined visitor actions that correspond to common conversion-related activities, such as&lt;br /&gt;
searching for a product, viewing a product, or purchasing a product. Standard events require parameters, which must be&lt;br /&gt;
included in the bp function call parameters as an object containing additional information about an event, such as&lt;br /&gt;
product IDs, categories, and the number of products purchased. Some events have mandatory properties (see below). In&lt;br /&gt;
order to track an event, the code tracking the event needs to be added with its properties into your page JavaScript&lt;br /&gt;
either through a &amp;lt;script&amp;gt; tag or sourced JS files.&lt;br /&gt;
&lt;br /&gt;
All standard events are tracked by calling the Pixel&#039;s bp(&#039;track&#039;) function, with the event name, and a JSON object as&lt;br /&gt;
its parameters.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 3&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
    &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    // contentView event tracking example&lt;br /&gt;
    var contentViewProperties = {&lt;br /&gt;
        &#039;id&#039;: &#039;promo01&#039;,&lt;br /&gt;
        &#039;contentType&#039;: &#039;Promotion&#039;,&lt;br /&gt;
        &#039;name&#039;: &#039;Winter tires 20% off&#039;,&lt;br /&gt;
    }&lt;br /&gt;
&lt;br /&gt;
    bp(&#039;track&#039;, &#039;contentView&#039;, contentViewProperties);&lt;br /&gt;
&lt;br /&gt;
    &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Sometimes you may want to track this event when a specific button is clicked. This can be achieved as in the example&lt;br /&gt;
below (note that you may use technologies that require different syntax, like the below example using jQuery). Note that&lt;br /&gt;
the Pixel base code needs to be included in the page in order to be able to track events.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 4&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
    &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        // sample product data&lt;br /&gt;
        var addToCartProperties = {&lt;br /&gt;
            &#039;id&#039;: &#039;item001&#039;,&lt;br /&gt;
            &#039;contentType&#039;: &#039;Page&#039;,&lt;br /&gt;
            &#039;name&#039;: &#039;first&#039;,&lt;br /&gt;
            &#039;ean&#039;: &#039;9501101530003&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 1000,&lt;br /&gt;
            &#039;totalItemPrice&#039;: 2000,&lt;br /&gt;
            &#039;unit&#039;: &#039;kg&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;huf&#039;,&lt;br /&gt;
            &#039;quantity&#039;: 2,&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // tracking the event&lt;br /&gt;
        document.getElementById(&#039;addtocart_button&#039;).addEventListener(&#039;click&#039;, function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;addToCart&#039;, addToCartProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
    &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Tracking the same event with jQuery:&lt;br /&gt;
&lt;br /&gt;
    &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        // sample product data&lt;br /&gt;
        var addToCartProperties = {&lt;br /&gt;
            &#039;id&#039;: &#039;item001&#039;,&lt;br /&gt;
            &#039;contentType&#039;: &#039;Page&#039;,&lt;br /&gt;
            &#039;name&#039;: &#039;first&#039;,&lt;br /&gt;
            &#039;ean&#039;: &#039;9501101530003&#039;,&lt;br /&gt;
            &#039;unitPrice&#039;: 1000,&lt;br /&gt;
            &#039;totalItemPrice&#039;: 2000,&lt;br /&gt;
            &#039;unit&#039;: &#039;kg&#039;,&lt;br /&gt;
            &#039;currency&#039;: &#039;huf&#039;,&lt;br /&gt;
            &#039;quantity&#039;: 2,&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        // tracking the event with jQuery&lt;br /&gt;
        $(&amp;quot;#addtocart_button&amp;quot;).click(function() {&lt;br /&gt;
            bp(&#039;track&#039;, &#039;addToCart&#039;, addToCartProperties);&lt;br /&gt;
        });&lt;br /&gt;
&lt;br /&gt;
    &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Standard event descriptions ==&lt;br /&gt;
&lt;br /&gt;
With these standard events you can describe a lot of ecommerce related user actions in a meaningful way. Each event has&lt;br /&gt;
its own set of properties that is needed in order to fully understand and record the users&#039; intentions.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 1: Event descriptions&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Event name&lt;br /&gt;
! Description&lt;br /&gt;
! Typical use cases&lt;br /&gt;
|-&lt;br /&gt;
! [[#User_Properties|setUserProperties]]&lt;br /&gt;
| With this event One can add user related information.&lt;br /&gt;
| Registration, login, account details in chechkout step, sign up for newsletter, contact request&lt;br /&gt;
|-&lt;br /&gt;
! [[#Events_related_to_content_browsing|contentView]]&lt;br /&gt;
| User sees a certain content on a page (e.g. product, article, promotion, banner, etc). When a key page is viewed such as a product page. This event may be fired on pageload.&lt;br /&gt;
| E.g. product details in product page.&lt;br /&gt;
|-&lt;br /&gt;
! [[#Events_related_to_content_browsing|clickProduct]]&lt;br /&gt;
| A click on a product in any list (search, recommendation box, etc). Usually fired at user click&lt;br /&gt;
| Product means that webshop provides e.g. physical item, ticket, food, service&lt;br /&gt;
|-&lt;br /&gt;
! [[#Events_related_to_content_browsing|clickProductDetail]]&lt;br /&gt;
| A click of product details. (e.g. more info link). Usually fired when user clicks.&lt;br /&gt;
| Button to show more info about product, link to producer&#039;s webpage or user manual, review about product&lt;br /&gt;
|-&lt;br /&gt;
! [[#Events_related_to_content_browsing|customizeProduct]]&lt;br /&gt;
| When a person customizes a product. (color, size, etc). Typically fired at user click.&lt;br /&gt;
| E.g. radio button about color on product page&lt;br /&gt;
|-&lt;br /&gt;
! [[#Events_related_to_content_browsing|clickPromo]]&lt;br /&gt;
| A click on an internal promotion. Fired at mouse click.&lt;br /&gt;
| Promotion has general meaning. Promo means to click on element in category selection page (e.g. Samsung TVs, Outdoor bulbs, Horror movies, Festivals 2019, concerts), recommendation product box, top product box, promotion on basket page/in chehckout/ on Home page (slider) too. Category means group of product that based on their characteristic.&lt;br /&gt;
|-&lt;br /&gt;
! [[#addToCart.2FremoveFromCart|addToCart]]&lt;br /&gt;
| This event may be fired when a product is added to the shopping cart (users clicks on an add to cart button) upon user clicks.&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! [[#addToCart.2FremoveFromCart|removeFromCart]]&lt;br /&gt;
| This event may be fired when a product is removed to the shopping cart (users clicks on an add to cart button) upon user clicks.&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! [[#initiateCheckout.2C_addPaymentInfo.2C_initiatePurchase.2C_purchase|initiateCheckout]]&lt;br /&gt;
| This event may be fired when a the user checks out the cart, clicks on the checkout button.&lt;br /&gt;
| The step property has to be started from 0.&lt;br /&gt;
|-&lt;br /&gt;
! [[#initiateCheckout.2C_addPaymentInfo.2C_initiatePurchase.2C_purchase|addPaymentInfo]]&lt;br /&gt;
| When payment information is added in the checkout flow, this event may be fired upon user click.&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! [[#initiateCheckout.2C_addPaymentInfo.2C_initiatePurchase.2C_purchase|initiatePurchase]]&lt;br /&gt;
| A person clicks on a purchase button (and possibly enters the Thank You Page).&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! [[#initiateCheckout.2C_addPaymentInfo.2C_initiatePurchase.2C_purchase|purchase]]&lt;br /&gt;
| When a purchase is made or checkout flow is completed. Successful or unsuccesful. This may be employed on the Thank you page (typically) on pageload.&lt;br /&gt;
| It is typically called thank you page where tha customer get a feedback about his/her purchase. If the feedback is unsuccessful the step property has to be -1.&lt;br /&gt;
|-&lt;br /&gt;
! [[#Search_event|search]]&lt;br /&gt;
| When a search is entered into a search field upon sending the form, this event may be fired.&lt;br /&gt;
| Search input box, ajax product filter by different attributes (e.g. price, size, color, brand, etc.)&lt;br /&gt;
|-&lt;br /&gt;
! [[#signUp_event|signUp]]&lt;br /&gt;
| To track user signup, when a registration form is completed/sent to the server (just when the status is OK), this event may be fired upon pageload.&lt;br /&gt;
| SignUp event has general meaning. It could be means registration, newsletter, contact request, etc. Usually signUp event pulls a setUserProperties event but it is not necessary.&lt;br /&gt;
|-&lt;br /&gt;
! [[#error_event|error]]&lt;br /&gt;
| If one want to track errors this event may be used for that.&lt;br /&gt;
|&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Custom events ==&lt;br /&gt;
&lt;br /&gt;
Custom events may be defined, with arbitrary text data as parameters. One way to do so is to fire the customEvent event depicted in Figure 4. The event may hold up to 5 attributes: eventCategory, eventAction, eventProperty, eventLabel, eventValue. If You want to add custom properties to standard events You may do so by adding the “_” prefix to that particular event. This is denoted in Figure 5.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 5: Custom event tracking&#039;&#039;&#039;&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
// sample customData&lt;br /&gt;
var customData = {&lt;br /&gt;
    eventCategory: &#039;Video&#039;,&lt;br /&gt;
    eventAction: &#039;play&#039;,&lt;br /&gt;
    eventProperty: &#039;video&#039;,&lt;br /&gt;
    eventLabel: &#039;Fall Campaign&#039;,&lt;br /&gt;
    eventValue: 42&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
bp(&#039;track&#039;, &#039;customEvent&#039;, customData);&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 6: Custom event tracking&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
var contentViewProperties = {&lt;br /&gt;
        &#039;id&#039;: &#039;My blog page&#039;,&lt;br /&gt;
        &#039;contentType&#039;: &#039;Page&#039;,&lt;br /&gt;
        &#039;name&#039;: &#039;Very cool product&#039;,&lt;br /&gt;
        &#039;_mycustomparameter&#039;: 42&lt;br /&gt;
    }&lt;br /&gt;
&lt;br /&gt;
    bp(&#039;track&#039;, &#039;contentView&#039;, contentViewProperties);&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Event Properties ==&lt;br /&gt;
&lt;br /&gt;
Each event may hold a given set of parameters in order to describe a particular user action. In order to provide complete data some parameters are &#039;&#039;&#039;mandatory/required&#039;&#039;&#039; while some a &#039;&#039;&#039;optional&#039;&#039;&#039;. Properties are given to the event in a standard Javascript object with assigning each property (key) a value.&lt;br /&gt;
&lt;br /&gt;
A value has a value type. Some are primitive types like &#039;&#039;&#039;text, integer&#039;&#039;&#039; and &#039;&#039;&#039;float&#039;&#039;&#039; types and there are two compound types &#039;&#039;&#039;item_list&#039;&#039;&#039; and the &#039;&#039;&#039;address&#039;&#039;&#039; a value type. Only compound types are enforced with validation, primitive types are converted during validation and message sending implicitly if the value type is different from the required value type. Text values are truncated to 1024 characters.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Standard properties ===&lt;br /&gt;
&lt;br /&gt;
The table here shows all standard properties that are used throughout the tracking. Each property is context sensitive, which means only a handful of properties are needed in each event, and from those only some may be required.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 2: Standard properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! name&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| text&lt;br /&gt;
| SKU of product/id of article/the promotion ID/etc.&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| text&lt;br /&gt;
| The content type of the page visited. Possible values: Page/Product/Article/Promotion/Banner/Misc. Values here are enforced/validated.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| text&lt;br /&gt;
| Full name of product/article/promotion etc (e.g. Android T-Shirt or e.g. Summer Sale)&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) when applicable.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| text&lt;br /&gt;
| Brand part of product/brand described in name&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| text&lt;br /&gt;
| |Array of categories of product/article/etc. If category is in tree structure, they must be separated with pipe e.g. &amp;quot;clothes|coat|winter&amp;quot; or &amp;quot;clothes|coat|autumn&amp;quot;.&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the product (e.g. Black)&lt;br /&gt;
|-&lt;br /&gt;
! description&lt;br /&gt;
| text&lt;br /&gt;
| The detailed description of the item.&lt;br /&gt;
|-&lt;br /&gt;
! imageUrl&lt;br /&gt;
| text&lt;br /&gt;
| A URL pointing to an image that shows the item. E.g. the picture of the product&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| text&lt;br /&gt;
| The measurement unit of the item. (e.g. pcs, litre)&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| float&lt;br /&gt;
| Price of product (the price of one measurement unit of the item).&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| float&lt;br /&gt;
| The total price of the item.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| text (ISO 4217 format)&lt;br /&gt;
| Currency of product. 3 digit ISO-4217 format is preferred.&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| integer&lt;br /&gt;
| The quantity of a product (e.g. 2)&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| item_list&lt;br /&gt;
| An array of item type JSON objects. For appropriate structure refer to Item definition in this chapter later.&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| text&lt;br /&gt;
| The list or collection to which the product belongs. Possible values: HomePage\SearchPage\ProductPage\Recommendation\ComparisonPage\BasketPage\Checkout\Misc&lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| text&lt;br /&gt;
| The product&#039;s position in a list or collection (e.g. 2) or the position of the creative (e.g. banner_slot_1)&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| text&lt;br /&gt;
| The creative associated with the promotion (e.g. summer_banner2)&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| integer&lt;br /&gt;
| A number represents a step in the checkout process. Optional on checkout actions. If the feedback is unsuccessful on Thank You Page the step has to be -1. The step has to be started from 0. (initiateCheckout event)&lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| text&lt;br /&gt;
| The transaction coupon code redeemed with the transaction.&lt;br /&gt;
|-&lt;br /&gt;
! orderNumber&lt;br /&gt;
| text&lt;br /&gt;
| Required if the action is purchase.&lt;br /&gt;
|-&lt;br /&gt;
! revenue&lt;br /&gt;
| float&lt;br /&gt;
| Specifies the total revenue or grand total associated with the transaction (e.g. 11.99). This value includes shipping, tax costs, or other adjustments to revenue that you want to include as part of your revenue calculations. Note: if revenue is not set, its value will be automatically calculated using the product quantity and price fields of all products in the same hit.&lt;br /&gt;
|-&lt;br /&gt;
! tax&lt;br /&gt;
| float&lt;br /&gt;
| The total tax associated with the transaction&lt;br /&gt;
|-&lt;br /&gt;
! shipping&lt;br /&gt;
| float&lt;br /&gt;
| The shipping cost associated with the transaction.&lt;br /&gt;
|-&lt;br /&gt;
! shippingAddress&lt;br /&gt;
| address&lt;br /&gt;
| This structure represents a shipping address related to a payment. See below the address type for the appropriate structure and syntax.&lt;br /&gt;
|-&lt;br /&gt;
! paymentMethod&lt;br /&gt;
| text&lt;br /&gt;
| Payment method of the purchase. E.g. Barion, PayPal, CashOnDelivery, Klarna&lt;br /&gt;
|-&lt;br /&gt;
! option&lt;br /&gt;
| text&lt;br /&gt;
| Additional field that can describe option information on the checkout page (e.g. delivery method)&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| float&lt;br /&gt;
| The value of a user performing this event to the business.&lt;br /&gt;
|-&lt;br /&gt;
! searchString&lt;br /&gt;
| text&lt;br /&gt;
| In case of Search event. The string entered by the user for the search.&lt;br /&gt;
|-&lt;br /&gt;
! totalResults&lt;br /&gt;
| number&lt;br /&gt;
| Results found in case of a search&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== User Properties ===&lt;br /&gt;
&lt;br /&gt;
For the &#039;&#039;&#039;setUserProperties&#039;&#039;&#039; event there are a custom set of properties that may be set when used.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 3: setUserProperties properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Key&lt;br /&gt;
! Value Type&lt;br /&gt;
! Description&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! userId&lt;br /&gt;
| text&lt;br /&gt;
| User Id&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! email&lt;br /&gt;
| text&lt;br /&gt;
| Email address. &#039;&#039;&#039;Hashed automatically for privacy purposes.&#039;&#039;&#039;&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! phone&lt;br /&gt;
| text&lt;br /&gt;
| Phone number ina format of IPF ()International Phone Number) eg. +1-541-754-3010. &#039;&#039;&#039;Hashed automatically for privacy purposes.&#039;&#039;&#039;&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! accountCreatedTime&lt;br /&gt;
| UNIX timestamp&lt;br /&gt;
| When the user account was created&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! country&lt;br /&gt;
| text&lt;br /&gt;
| The country in which the user lives. ISO 3166-1 alpha-2 codes are preferred.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! county&lt;br /&gt;
| text&lt;br /&gt;
| The county in which the user lives&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! city&lt;br /&gt;
| text&lt;br /&gt;
| The city in which the user lives&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! zipCode&lt;br /&gt;
| text&lt;br /&gt;
| The zip code of the user&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! gender&lt;br /&gt;
| text&lt;br /&gt;
| The gender of the user. Possible values: M - Male, F - Female&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! age&lt;br /&gt;
| integer&lt;br /&gt;
| Age of user&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| text (ISO 4217 format)&lt;br /&gt;
| The preferred currency of the user. 3 digit currency code required.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! language&lt;br /&gt;
| text (ISO 639-1)&lt;br /&gt;
| The preferred language of the user. 2 digit country code is required.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! interests&lt;br /&gt;
| text&lt;br /&gt;
| Lists the interests of the user (e.g., &amp;quot;Arts &amp;amp; Entertainment, Games, Sports&amp;quot;)&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| integer&lt;br /&gt;
| A number represents a step in the checkout process. Optional on checkout actions.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! sessionId&lt;br /&gt;
| text&lt;br /&gt;
| Session Id&lt;br /&gt;
| NO&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== Contetnts value type ===&lt;br /&gt;
&lt;br /&gt;
The &#039;&#039;&#039;contents&#039;&#039;&#039; is a compound value type that is comprised of a standard Javascript dictionary encapsulated in a standard JS array. Each element of the array have to conform to the following property list restrictions.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 4: The contents type properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Property name&lt;br /&gt;
! Property type&lt;br /&gt;
! Description&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| text&lt;br /&gt;
| SKU of product/id of article/the promotion ID/etc.&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| text&lt;br /&gt;
| Possible values: Product/Article/Promotion/Banner/Misc&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| text&lt;br /&gt;
| Full Name of product/article/promotion etc (e.g. Android T-Shirt or e.g. Summer Sale)&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| text&lt;br /&gt;
| Brand part of product/brand described in article&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| text&lt;br /&gt;
| Array of categories of product/article/etc. If category is in tree structure, they must be separated with pipe (e.g. &amp;quot;clothes|coat|winter&amp;quot; or &amp;quot;clothes|coat|autumn&amp;quot;).&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| text&lt;br /&gt;
| The measurement unit of the item.&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| float&lt;br /&gt;
| Price of product (the price of one measurement unit of the item).&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| float&lt;br /&gt;
| The total price of the item.&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| text (ISO 4217 format)&lt;br /&gt;
| Currency of product&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| integer&lt;br /&gt;
| The quantity of a product (e.g. 2)&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the product (e.g. Black)&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! description&lt;br /&gt;
| text&lt;br /&gt;
| The detailed description of the item.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! imageUrl&lt;br /&gt;
| text&lt;br /&gt;
| A URL pointing to an image that shows the item.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) when applicable.&lt;br /&gt;
| NO&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 7&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
 var addToCartProperties = {&lt;br /&gt;
       &#039;id&#039;: &#039;testAddToCart&#039;,&lt;br /&gt;
       &#039;contentType&#039;: &#039;testType&#039;,&lt;br /&gt;
       &#039;name&#039;: &#039;testName&#039;,&lt;br /&gt;
       &#039;contents&#039;: [{&lt;br /&gt;
             &#039;id&#039;: &#039;testId&#039;,&lt;br /&gt;
             &#039;contentType&#039;: &#039;testAnimal&#039;,&lt;br /&gt;
             &#039;name&#039;: &#039;testName&#039;,&lt;br /&gt;
             &#039;brand&#039;: &#039;testDead&#039;,&lt;br /&gt;
             &#039;category&#039;: &#039;testCategory&#039;,&lt;br /&gt;
             &#039;unit&#039;: &#039;testUnit&#039;,&lt;br /&gt;
             &#039;unitPrice&#039;: 10000.0,&lt;br /&gt;
             &#039;totalItemPrice&#039;: 100000.0,&lt;br /&gt;
             &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
             &#039;quantity&#039;: 10,&lt;br /&gt;
             &#039;ean&#039;: &#039;234eqwfq24241324r345&#039;,&lt;br /&gt;
             &#039;variant&#039;: &#039;testVariant&#039;,&lt;br /&gt;
             &#039;description&#039;: &#039;testDescription&#039;,&lt;br /&gt;
             &#039;imageUrl&#039;: &#039;http://example.org/test.jpg&#039;,&lt;br /&gt;
       }],&lt;br /&gt;
       &#039;ean&#039;: &#039;a124jiojrega231&#039;,&lt;br /&gt;
       &#039;brand&#039;: &#039;testBrand&#039;,&lt;br /&gt;
       &#039;category&#039;: &#039;testCategory&#039;,&lt;br /&gt;
       &#039;variant&#039;: &#039;testVariant&#039;,&lt;br /&gt;
       &#039;list&#039;: &#039;testList&#039;,&lt;br /&gt;
       &#039;position&#039;: &#039;testPosition&#039;,&lt;br /&gt;
       &#039;creative&#039;: &#039;testCreative&#039;,&lt;br /&gt;
       &#039;unitPrice&#039;: 10000.0,&lt;br /&gt;
       &#039;totalItemPrice&#039;: 100000.0,&lt;br /&gt;
       &#039;unit&#039;: &#039;db&#039;,&lt;br /&gt;
       &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
       &#039;quantity&#039;: 10,&lt;br /&gt;
       &#039;step&#039;: 6,&lt;br /&gt;
       &#039;customerValue&#039;: 15.00,&lt;br /&gt;
       &#039;coupon&#039;: &#039;testCoupon&#039;&lt;br /&gt;
   }&lt;br /&gt;
&lt;br /&gt;
bp(&#039;track&#039;, &#039;addToCart&#039;, addToCartProperties );&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Address value type ===&lt;br /&gt;
&lt;br /&gt;
The &#039;&#039;&#039;shippingAddress&#039;&#039;&#039; property is a compound value type with a specific set of properties. This is essentially a Javascript object with specified keys below. No keys are mandatory in this value type.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 5: The address value type properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Property name&lt;br /&gt;
! Property type&lt;br /&gt;
! Description&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! deliveryMethod&lt;br /&gt;
| text&lt;br /&gt;
| The delivery method, if applicable.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! country&lt;br /&gt;
| text&lt;br /&gt;
| The recipient&#039;s country code in ISO-3166-1 alpha-2 format.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! city&lt;br /&gt;
| text&lt;br /&gt;
| The complete name of the city of the recipient address.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! region&lt;br /&gt;
| text&lt;br /&gt;
| The region code of the recipient address in ISO-3166-2 format&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! zip&lt;br /&gt;
| text&lt;br /&gt;
| The zip code of the recipient address.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! street&lt;br /&gt;
| text&lt;br /&gt;
| The shipping street address with house number and other details.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! street2&lt;br /&gt;
| text&lt;br /&gt;
| The address, continued.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! fullName&lt;br /&gt;
| text&lt;br /&gt;
| The full civil or official name of the recipient.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! phone&lt;br /&gt;
| text&lt;br /&gt;
| The phone number of the recipient.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 8&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
 &#039;shippingAddress&#039;: {&lt;br /&gt;
           &#039;deliveryMethod&#039;: &#039;ship&#039;,&lt;br /&gt;
           &#039;country&#039;: &#039;Africa&#039;,&lt;br /&gt;
           &#039;city&#039;: &#039;Egypt&#039;,&lt;br /&gt;
           &#039;region&#039;: &#039;idn&#039;,&lt;br /&gt;
           &#039;zip&#039;: &#039;98772&#039;,&lt;br /&gt;
           &#039;street&#039;: &#039;Cleopatra street 24&#039;,&lt;br /&gt;
           &#039;street2&#039;: &#039;Faro street 49&#039;,&lt;br /&gt;
           &#039;fullName&#039;: &#039;Sir Lancelot&#039;,&lt;br /&gt;
           &#039;phone&#039;: &#039;+367187242&#039;&lt;br /&gt;
       }&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Events related to content browsing ==&lt;br /&gt;
&lt;br /&gt;
A portion of all events are related to browsing through a Your webshop’s content: viewing pages, promotions, clicking on products and product details, customization of products, etc. These are specifically: &#039;&#039;&#039;contentView, clickProduct, clickProductDetail, customizeProduct, clickPromo&#039;&#039;&#039;.&lt;br /&gt;
All properties may be used in each event, where You find YES in te corresnponding table the property usage is mandatory. Only 3 properties are overall mandatory, these are: &#039;&#039;&#039;id, contentType and name&#039;&#039;&#039;. Please note that for the contentType property, you are only able to choose from a number of predefined values: Page, Product, Article, Promotion, Banner and Misc. The following table shows the property requirements for these.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 6: Properties of events related to content browsing&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!&lt;br /&gt;
!colspan = &amp;quot;5&amp;quot;| Event&lt;br /&gt;
|-&lt;br /&gt;
! Property&lt;br /&gt;
! contentView&lt;br /&gt;
! clickProduct&lt;br /&gt;
! clickProductDetail&lt;br /&gt;
! customizeProduct&lt;br /&gt;
! clickPromo&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES*&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES*&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES*&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| YES*&lt;br /&gt;
| YES&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
| YES&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
!&lt;br /&gt;
|colspan = &amp;quot;5&amp;quot;| * Required only in case of contentType=Product when using the contentView event.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Purchase related events ==&lt;br /&gt;
&lt;br /&gt;
These events refer to purchase intentions and effective checkouts and purchases. These events also share a number of common properties.&lt;br /&gt;
&lt;br /&gt;
=== addToCart/removeFromCart ===&lt;br /&gt;
&lt;br /&gt;
Both events have the same event set and the required properties are the same as well.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 7: addToCart/removeFromCart event properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Property&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
|&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== initiateCheckout, addPaymentInfo, initiatePurchase, purchase ===&lt;br /&gt;
&lt;br /&gt;
These events refer to checkout and payment info change user events. The allowed properties are generally the same with only one exception: the &#039;&#039;&#039;paymentMethod&#039;&#039;&#039; property is only allowed in the &#039;&#039;&#039;addPaymentInfo&#039;&#039;&#039; event, in other events it is unavailable.&lt;br /&gt;
&lt;br /&gt;
Generally two properties are mandatory throughout all events in this particular group: &#039;&#039;&#039;contents&#039;&#039;&#039; and &#039;&#039;&#039;step&#039;&#039;&#039;, referring to the items in the basket and the step in the buying process. After checkout is initiated the &#039;&#039;&#039;revenue&#039;&#039;&#039; and &#039;&#039;&#039;currency&#039;&#039;&#039; also becomes mandatory property.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 8: Properties of initiateCheckout, addPaymentInfo, initiatePurchase and purchase events&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!&lt;br /&gt;
!colspan=&amp;quot;4&amp;quot;|event&lt;br /&gt;
|-&lt;br /&gt;
! Property&lt;br /&gt;
! initiateCheckout&lt;br /&gt;
! addPaymentInfo&lt;br /&gt;
! initiatePurchase&lt;br /&gt;
! purchase&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! paymentMethod&lt;br /&gt;
| UNAVAILABLE&lt;br /&gt;
| YES&lt;br /&gt;
| UNAVAILABLE&lt;br /&gt;
| UNAVAILABLE&lt;br /&gt;
|-&lt;br /&gt;
! revenue&lt;br /&gt;
|&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! option&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! orderNumber&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! shipping&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! shippingAddress&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! tax&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== search event ===&lt;br /&gt;
&lt;br /&gt;
For product search event tracking one can use the search event. The parameters here are all optional except for one: that is the &#039;&#039;&#039;searchString&#039;&#039;&#039;. The following tables lists all allowed properties for this particular event.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 9: Properties of search event&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Key&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! searchString&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! totalResults&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
|&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== signUp event ===&lt;br /&gt;
&lt;br /&gt;
Upon user signup one may fire the signUp event to record signups for theri webshop. All but three properties are optional. Mandatory properties are: &#039;&#039;&#039;id&#039;&#039;&#039;, &#039;&#039;&#039;contentType&#039;&#039;&#039; and &#039;&#039;&#039;name&#039;&#039;&#039;. Other attributes are denoted in the following table.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 10: Properties of signUp event&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Key&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
|&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== error event ===&lt;br /&gt;
&lt;br /&gt;
Tracking error is possible by error event. It has two mandatory properties. It is denoted in the following table. Example in Figure 9.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 11: Properties of error event&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Key&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! code&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! description&lt;br /&gt;
| YES&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 9&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
var errorData = {&lt;br /&gt;
        &#039;description&#039;: &#039;testError&#039;,&lt;br /&gt;
        &#039;code&#039;: 485,&lt;br /&gt;
    }&lt;br /&gt;
&lt;br /&gt;
    bp(&#039;track&#039;, &#039;error&#039;, errorData);&lt;br /&gt;
 &amp;lt;/nowiki&amp;gt;&lt;/div&gt;</summary>
		<author><name>Baloghn</name></author>
	</entry>
	<entry>
		<id>https://docs.barion.com/index.php?title=Barion_Pixel_API_reference&amp;diff=1647</id>
		<title>Barion Pixel API reference</title>
		<link rel="alternate" type="text/html" href="https://docs.barion.com/index.php?title=Barion_Pixel_API_reference&amp;diff=1647"/>
		<updated>2019-04-03T13:57:09Z</updated>

		<summary type="html">&lt;p&gt;Baloghn: /* Base code */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{PageTitle|title=Barion Pixel Documentation}}&lt;br /&gt;
&lt;br /&gt;
{| style=&amp;quot;margin-left:2em;&amp;quot; align=&amp;quot;right&amp;quot;&lt;br /&gt;
| __TOC__&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
The Barion Pixel is a snippet of JavaScript code that allows you to track visitor activity on your website. It works by loading a small library of functions which you can use whenever a site visitor takes an action that you want to track (called an event).&lt;br /&gt;
&lt;br /&gt;
In order to implement the Pixel, you will need:&lt;br /&gt;
* access to your website&#039;s code base&lt;br /&gt;
* your Pixel&#039;s base code and associated IDs (barionPixelID)&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
= Implementation =&lt;br /&gt;
&lt;br /&gt;
The Barion Pixel is a snippet of JavaScript code that loads a small library of functions you can use to track visitor activity on your website. It relies on Barion cookies. By default, the Pixel will track URLs visited, domains visited, and the devices your visitors use. In addition, you can use the Pixel&#039;s library of functions to track other events that are associated with webshop usage and ecommerce. The installation does not require accepted consent policy by your user. Tracking visitors behavior for the purposes of preventing fraud is legitim interest. Only consent events will determine the permission of the marketing purpose. Base code and consent events set-up are the minimum requirements for implementation.&lt;br /&gt;
&lt;br /&gt;
== Minimum requirements ==&lt;br /&gt;
=== Base code ===&lt;br /&gt;
Before you can install the Pixel, you will need your Pixel&#039;s base code. To install the Pixel, we highly recommend that you add its base code between the opening and closing &amp;lt;head&amp;gt; tags on every page where you will be tracking website visitor actions. Most developers add it to their website&#039;s persistent header, so it can be used on all pages, but it could be used before the closing body tag (&amp;lt;/body&amp;gt;) as well.&lt;br /&gt;
&lt;br /&gt;
Placing the code within your &amp;lt;head&amp;gt; tags reduces the chances of browsers or third-party code blocking the Pixel&#039;s execution. It also executes the code sooner, increasing the chance that your visitors are tracked before they leave your page.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 1&#039;&#039;&#039;&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&amp;lt;script&amp;gt;&lt;br /&gt;
&lt;br /&gt;
  (function(i,s,o,g,r,a,m){i[&#039;BarionAnalyticsObject&#039;]=r;i[r]=i[r]||function(){&lt;br /&gt;
  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),&lt;br /&gt;
  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)&lt;br /&gt;
   })(window, document, &#039;script&#039;, &#039;https://pixel.barion.com/bp.js&#039;, &#039;bat&#039;);&lt;br /&gt;
  &lt;br /&gt;
  // initialize the Pixel&lt;br /&gt;
  bat(&#039;init&#039;, &#039;addBarionPixelId&#039;, &#039;[Your Barion Pixel ID goes here]&#039;);&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/script&amp;gt;&lt;br /&gt;
  &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&amp;lt;noscript&amp;gt;&lt;br /&gt;
&lt;br /&gt;
  &amp;lt;img height=&amp;quot;1&amp;quot; width=&amp;quot;1&amp;quot; style=&amp;quot;display:none&amp;quot; src=&amp;quot;https://pixel.barion.com/a.gif?__ba_pixel_id=[Your Barion Pixel ID goes here]&amp;amp;ev=contentView&amp;amp;noscript=1&amp;quot;/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/noscript&amp;gt;&lt;br /&gt;
 &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
When run, this code will download a library of functions which you can then use for tracking. It also automatically tracks a single PageView conversion by calling the bat() function each time it loads. We recommend that you leave this function call intact.&lt;br /&gt;
&lt;br /&gt;
=== Consent Events ===&lt;br /&gt;
Consent events determine which data could be used by 3rd Party for marketing purpose. Three type of consents event are defined. The grantConsent event have to be sent when the visitor accept the cookie policy and it allows Barion to do data usage for marketing aim. RejectConsent event means when the customer reject the cookie policy (which include Barion Pixel too) and revokeConsent actually when customer change the consent status from granted to rejected state which refer to Barion Pixel. Important notice that reject and revoke consent do not mean to refuse the Barion Pixel by reason of collecting data without consent is legitim interest only for fraud detection. All consent events are tracked by calling the Pixel&#039;s bat(&#039;consent&#039;) function. (Figure 2.)&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 2&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    bat(&#039;consent&#039;, &#039;grantConsent&#039;);&lt;br /&gt;
    bat(&#039;consent&#039;, &#039;revokeConsent&#039;);&lt;br /&gt;
    bat(&#039;consent&#039;, &#039;rejectConsent&#039;);&lt;br /&gt;
 &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Installing Standard and Custom Events ==&lt;br /&gt;
There are two ways to track conversions with the Pixel:&lt;br /&gt;
* standard events, which are visitor actions that we have defined and that you report by calling a Pixel function&lt;br /&gt;
* custom events, which are visitor actions that you have defined and that you report by calling a Pixel function&lt;br /&gt;
&lt;br /&gt;
=== Standard Events ===&lt;br /&gt;
Standard events are predefined visitor actions that correspond to common, conversion-related activities, such as searching for a product, viewing a product, or purchasing a product. Standard events support parameters, which allow you to include an object containing additional information about an event, such as product IDs, categories, and the number of products purchased. Please consider that some events have mandatory properties (see under).&lt;br /&gt;
&lt;br /&gt;
In order to track an event the event needs to be fired, that is the corresponding event with its properties need to be added inside Your javascript or page. This can be seen on Figure 2 and Figure 3.&lt;br /&gt;
&lt;br /&gt;
All standard events are tracked by calling the Pixel&#039;s bat(&#039;track&#039;) function, with the event name, and a JSON object as its parameters (sometimes optional). For example, here&#039;s a function call to track when a visitor has completed a purchase event, with currency and value included as a parameter. (Figure 2)&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 3&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
var contentViewProperties = {&lt;br /&gt;
    &#039;id&#039;: &#039;My blog page&#039;,&lt;br /&gt;
    &#039;contentType&#039;: &#039;Page&#039;,&lt;br /&gt;
    &#039;name&#039;: &#039;Very cool product&#039;,&lt;br /&gt;
}&lt;br /&gt;
bat(&#039;track&#039;, &#039;contentView&#039;, contentViewProperties);&lt;br /&gt;
 &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Sometimes You may want to track this event when a specific button is clicked. This can be achieved with the following code and jQuery. Note that the Pixel needs to be included in the page in order to be able to track events. (Figure 3)&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 4&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
$(&amp;quot;#addtocart_button&amp;quot;).click(function(){&lt;br /&gt;
&lt;br /&gt;
    // sample product data&lt;br /&gt;
    var addToCartPorperties = {&lt;br /&gt;
        &#039;id&#039;: &#039;a&#039;,&lt;br /&gt;
        &#039;contentType&#039;: &#039;Page&#039;,&lt;br /&gt;
        &#039;name&#039;: &#039;a&#039;,&lt;br /&gt;
        &#039;ean&#039;: &#039;a&#039;,&lt;br /&gt;
        &#039;unitPrice&#039;: 1000,&lt;br /&gt;
        &#039;totalItemPrice&#039;: 2000,&lt;br /&gt;
        &#039;unit&#039;: &#039;kg&#039;,&lt;br /&gt;
        &#039;currency&#039;: &#039;huf&#039;,&lt;br /&gt;
        &#039;quantity&#039;: 2,   &lt;br /&gt;
    }    &lt;br /&gt;
&lt;br /&gt;
    bat(&#039;track&#039;, &#039;addToCart&#039;, addToCartPorperties);&lt;br /&gt;
&lt;br /&gt;
});&lt;br /&gt;
 &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Standard event descriptions ===&lt;br /&gt;
&lt;br /&gt;
With these standard events one can describe a lot of ecommerce related user actions in a meaningful way. Each event have its own set of properties that are needed in order to fully understand and record the users intentions/behaviour. &lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 1: Event descriptions&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Event name&lt;br /&gt;
! Description&lt;br /&gt;
|-&lt;br /&gt;
! setUserProperties&lt;br /&gt;
| With this event One can add user related information.&lt;br /&gt;
|-&lt;br /&gt;
! contentView&lt;br /&gt;
| User sees a certain content on a page (e.g. product, article, promotion, banner, etc). When a key page is viewed such as a product page. This event may be fired on pageload.&lt;br /&gt;
|-&lt;br /&gt;
! clickProduct&lt;br /&gt;
| A click on a product in any list (search, recommendation box, etc). Usually fired at user click&lt;br /&gt;
|-&lt;br /&gt;
! clickProductDetail&lt;br /&gt;
| A click of product details. (e.g. more info link). Usually fired when user clicks.&lt;br /&gt;
|-&lt;br /&gt;
! customizeProduct&lt;br /&gt;
| When a person customizes a product. (color, size, etc). Typically fired at user click.&lt;br /&gt;
|-&lt;br /&gt;
! clickPromo&lt;br /&gt;
| A click on an internal promotion. Fired at mouse click.&lt;br /&gt;
|-&lt;br /&gt;
! addToCart&lt;br /&gt;
| This event may be fired when a product is added to the shopping cart (users clicks on an add to cart button) upon user clicks.&lt;br /&gt;
|-&lt;br /&gt;
! removeFromCart&lt;br /&gt;
| This event may be fired when a product is removed to the shopping cart (users clicks on an add to cart button) upon user clicks.&lt;br /&gt;
|-&lt;br /&gt;
! initiateCheckout&lt;br /&gt;
| This event may be fired when a the user checks out the cart, clicks on the checkout button.&lt;br /&gt;
|-&lt;br /&gt;
! addPaymentInfo&lt;br /&gt;
| When payment information is added in the checkout flow, this event may be fired upon user click.&lt;br /&gt;
|-&lt;br /&gt;
! initiatePurchase&lt;br /&gt;
| A person clicks on a purchase button (and possibly enters the Thank You Page).&lt;br /&gt;
|-&lt;br /&gt;
! purchase&lt;br /&gt;
| When a purchase is made or checkout flow is completed. Successful or unsuccesful. This may be employed on the Thank you page (typically) on pageload.&lt;br /&gt;
|-&lt;br /&gt;
! search&lt;br /&gt;
| When a search is entered into a search field upon sending the form, this event may be fired.&lt;br /&gt;
|-&lt;br /&gt;
! signUp&lt;br /&gt;
| To track user signup, when a registration form is completed/sent to the server (just when the status is OK), this event may be fired upon pageload.&lt;br /&gt;
|-&lt;br /&gt;
! error&lt;br /&gt;
| If one want to track errors this event may be used for that.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
===Custom events===&lt;br /&gt;
&lt;br /&gt;
Custom events may be defined, with arbitrary text data as parameters. One way to do so is to fire the customEvent event depicted in Figure 4. The event may hold up to 5 attributes: eventCategory, eventAction, eventProperty, eventLabel, eventValue. If You want to add custom properties to standard events You may do so by adding the “_” prefix to that particular event. This is denoted in Figure 5.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 5: Custom event tracking&#039;&#039;&#039;&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
// sample customData&lt;br /&gt;
var customData = {&lt;br /&gt;
    eventCategory: &#039;Video&#039;,&lt;br /&gt;
    eventAction: &#039;play&#039;,&lt;br /&gt;
    eventProperty: &#039;video&#039;,&lt;br /&gt;
    eventLabel: &#039;Fall Campaign&#039;,&lt;br /&gt;
    eventValue: 42        &lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
bat(&#039;track&#039;, &#039;customEvent&#039;, customData);&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 6: Custom event tracking&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
var contentViewProperties = {&lt;br /&gt;
        &#039;id&#039;: &#039;My blog page&#039;,&lt;br /&gt;
        &#039;contentType&#039;: &#039;Page&#039;,&lt;br /&gt;
        &#039;name&#039;: &#039;Very cool product&#039;,&lt;br /&gt;
        &#039;_mycustomparameter&#039;: 42&lt;br /&gt;
    }&lt;br /&gt;
&lt;br /&gt;
    bat(&#039;track&#039;, &#039;contentView&#039;, contentViewProperties);&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===Event Properties===&lt;br /&gt;
&lt;br /&gt;
Each event may hold a given set of parameters in order to describe a particular user action. In order to provide complete data some parameters are &#039;&#039;&#039;mandatory/required&#039;&#039;&#039; while some a &#039;&#039;&#039;optional&#039;&#039;&#039;. Properties are given to the event in a standard Javascript object with assigning each property (key) a value.&lt;br /&gt;
&lt;br /&gt;
A value has a value type. Some are primitive types like &#039;&#039;&#039;text, integer&#039;&#039;&#039; and &#039;&#039;&#039;float&#039;&#039;&#039; types and there are two compound types &#039;&#039;&#039;item_list&#039;&#039;&#039; and the &#039;&#039;&#039;address&#039;&#039;&#039; a value type. Only compound types are enforced with validation, primitive types are converted during validation and message sending implicitly if the value type is different from the required value type. Text values are truncated to 1024 characters. &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
====Standard properties====&lt;br /&gt;
&lt;br /&gt;
The table here shows all standard properties that are used throughout the tracking. Each property is context sensitive, which means only a handful of properties are needed in each event, and from those only some may be required.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 2: Standard properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! name&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| text&lt;br /&gt;
| SKU of product/id of article/the promotion ID/etc.&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| text&lt;br /&gt;
| The content type of the page visited. Possible values: Page/Product/Article/Promotion/Banner/Misc. Values here are enforced/validated.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| text&lt;br /&gt;
| Full name of product/article/promotion etc (e.g. Android T-Shirt or e.g. Summer Sale)&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) when applicable.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| text&lt;br /&gt;
| Brand part of product/brand described in name&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| text&lt;br /&gt;
| Array of categories of product/article/etc. If category is in tree structure, they must be separated with pipe (e.g. &amp;quot;clothes|coat|winter&amp;quot; or &amp;quot;clothes|coat|autumn&amp;quot;).&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the product (e.g. Black)&lt;br /&gt;
|-&lt;br /&gt;
! description&lt;br /&gt;
| text&lt;br /&gt;
| The detailed description of the item.&lt;br /&gt;
|-&lt;br /&gt;
! imageUrl&lt;br /&gt;
| text&lt;br /&gt;
| A URL pointing to an image that shows the item. E.g. the picture of the product&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| text&lt;br /&gt;
| The measurement unit of the item. (e.g. pcs, litre)&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| float&lt;br /&gt;
| Price of product (the price of one measurement unit of the item).&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| float&lt;br /&gt;
| The total price of the item.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| text (ISO 4217 format)&lt;br /&gt;
| Currency of product. 3 digit ISO-4217 format is preferred.&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| integer&lt;br /&gt;
| The quantity of a product (e.g. 2)&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| item_list&lt;br /&gt;
| An array of item type JSON objects. For appropriate structure refer to Item definition in this chapter later. &lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| text&lt;br /&gt;
| The list or collection to which the product belongs (e.g. Search Results)&lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| text&lt;br /&gt;
| The product&#039;s position in a list or collection (e.g. 2) or the position of the creative (e.g. banner_slot_1)&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| text&lt;br /&gt;
| The creative associated with the promotion (e.g. summer_banner2)&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| integer&lt;br /&gt;
| A number representing a step in the checkout process. Optional on checkout actions.&lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| text&lt;br /&gt;
| The transaction coupon code redeemed with the transaction.&lt;br /&gt;
|-&lt;br /&gt;
! orderNumber&lt;br /&gt;
| text&lt;br /&gt;
| Required if the action is purchase.&lt;br /&gt;
|-&lt;br /&gt;
! revenue&lt;br /&gt;
| float&lt;br /&gt;
| Specifies the total revenue or grand total associated with the transaction (e.g. 11.99). This value includes shipping, tax costs, or other adjustments to revenue that you want to include as part of your revenue calculations. Note: if revenue is not set, its value will be automatically calculated using the product quantity and price fields of all products in the same hit.&lt;br /&gt;
|-&lt;br /&gt;
! tax&lt;br /&gt;
| float&lt;br /&gt;
| The total tax associated with the transaction&lt;br /&gt;
|-&lt;br /&gt;
! shipping&lt;br /&gt;
| float&lt;br /&gt;
| The shipping cost associated with the transaction.&lt;br /&gt;
|-&lt;br /&gt;
! shippingAddress&lt;br /&gt;
| address&lt;br /&gt;
| This structure represents a shipping address related to a payment. See below the address type for the appropriate structure and syntax.&lt;br /&gt;
|-&lt;br /&gt;
! paymentMethod&lt;br /&gt;
| text&lt;br /&gt;
| Payment method of the purchase. E.g. Barion, PayPal, CashOnDelivery, Klarna&lt;br /&gt;
|-&lt;br /&gt;
! option&lt;br /&gt;
| text&lt;br /&gt;
| Additional field that can describe option information on the checkout page (e.g. delivery method)&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| float&lt;br /&gt;
| The value of a user performing this event to the business.&lt;br /&gt;
|-&lt;br /&gt;
! searchString&lt;br /&gt;
| text&lt;br /&gt;
| In case of Search event. The string entered by the user for the search.&lt;br /&gt;
|-&lt;br /&gt;
! totalResults&lt;br /&gt;
| number&lt;br /&gt;
| Results found in case of a search&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====User Properties====&lt;br /&gt;
&lt;br /&gt;
For the &#039;&#039;&#039;setUserProperties&#039;&#039;&#039; event there are a custom set of properties that may be set when used.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 3: setUserProperties properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Key&lt;br /&gt;
! Value Type&lt;br /&gt;
! Description&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! userId&lt;br /&gt;
| text&lt;br /&gt;
| User Id&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! email&lt;br /&gt;
| text&lt;br /&gt;
| Email address. &#039;&#039;&#039;Hashed automatically for privacy purposes.&#039;&#039;&#039;&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! phone&lt;br /&gt;
| text&lt;br /&gt;
| Phone number ina format of IPF ()International Phone Number) eg. +1-541-754-3010. &#039;&#039;&#039;Hashed automatically for privacy purposes.&#039;&#039;&#039;&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! accountCreatedTime&lt;br /&gt;
| UNIX timestamp&lt;br /&gt;
| When the user account was created&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! country&lt;br /&gt;
| text&lt;br /&gt;
| The country in which the user lives. ISO 3166-1 alpha-2 codes are preferred.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! county&lt;br /&gt;
| text&lt;br /&gt;
| The county in which the user lives&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! city&lt;br /&gt;
| text&lt;br /&gt;
| The city in which the user lives&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! zipCode&lt;br /&gt;
| text&lt;br /&gt;
| The zip code of the user&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! gender&lt;br /&gt;
| text&lt;br /&gt;
| The gender of the user. Possible values: M - Male, F - Female&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! age&lt;br /&gt;
| integer&lt;br /&gt;
| Age of user&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| text (ISO 4217 format)&lt;br /&gt;
| The preferred currency of the user. 3 digit currency code required.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! language&lt;br /&gt;
| text (ISO 639-1)&lt;br /&gt;
| The preferred language of the user. 2 digit country code is required.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! interests&lt;br /&gt;
| text&lt;br /&gt;
| Lists the interests of the user (e.g., &amp;quot;Arts &amp;amp; Entertainment, Games, Sports&amp;quot;)&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! sessionId&lt;br /&gt;
| text&lt;br /&gt;
| Session Id&lt;br /&gt;
| NO&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====Contetnts value type====&lt;br /&gt;
&lt;br /&gt;
The &#039;&#039;&#039;contents&#039;&#039;&#039; is a compound value type that is comprised of a standard Javascript dictionary encapsulated in a standard JS array. Each element of the array have to conform to the following property list restrictions.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 4: The contents type properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Property name&lt;br /&gt;
! Property type&lt;br /&gt;
! Description&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| text&lt;br /&gt;
| SKU of product/id of article/the promotion ID/etc.&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| text&lt;br /&gt;
| Possible values: Product/Article/Promotion/Banner/Misc&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| text&lt;br /&gt;
| Full Name of product/article/promotion etc (e.g. Android T-Shirt or e.g. Summer Sale)&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| text&lt;br /&gt;
| Brand part of product/brand described in article&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| text&lt;br /&gt;
| Array of categories of product/article/etc. If category is in tree structure, they must be separated with pipe (e.g. &amp;quot;clothes|coat|winter&amp;quot; or &amp;quot;clothes|coat|autumn&amp;quot;).&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| text&lt;br /&gt;
| The measurement unit of the item.&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| float&lt;br /&gt;
| Price of product (the price of one measurement unit of the item).&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| float&lt;br /&gt;
| The total price of the item.&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| text (ISO 4217 format)&lt;br /&gt;
| Currency of product&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| integer&lt;br /&gt;
| The quantity of a product (e.g. 2)&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the product (e.g. Black)&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! description&lt;br /&gt;
| text&lt;br /&gt;
| The detailed description of the item.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! imageUrl&lt;br /&gt;
| text&lt;br /&gt;
| A URL pointing to an image that shows the item.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) when applicable.&lt;br /&gt;
| NO&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 7&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
 var addToCartProperties = {&lt;br /&gt;
       &#039;id&#039;: &#039;testAddToCart&#039;,&lt;br /&gt;
       &#039;contentType&#039;: &#039;testType&#039;,&lt;br /&gt;
       &#039;name&#039;: &#039;testName&#039;,&lt;br /&gt;
       &#039;contents&#039;: [{&lt;br /&gt;
             &#039;id&#039;: &#039;testId&#039;,&lt;br /&gt;
             &#039;contentType&#039;: &#039;testAnimal&#039;,&lt;br /&gt;
             &#039;name&#039;: &#039;testName&#039;,&lt;br /&gt;
             &#039;brand&#039;: &#039;testDead&#039;,&lt;br /&gt;
             &#039;category&#039;: &#039;testCategory&#039;,&lt;br /&gt;
             &#039;unit&#039;: &#039;testUnit&#039;,&lt;br /&gt;
             &#039;unitPrice&#039;: 10000.0,&lt;br /&gt;
             &#039;totalItemPrice&#039;: 100000.0,&lt;br /&gt;
             &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
             &#039;quantity&#039;: 10,&lt;br /&gt;
             &#039;ean&#039;: &#039;234eqwfq24241324r345&#039;,&lt;br /&gt;
             &#039;variant&#039;: &#039;testVariant&#039;,&lt;br /&gt;
             &#039;description&#039;: &#039;testDescription&#039;,&lt;br /&gt;
             &#039;imageUrl&#039;: &#039;http://example.org/test.jpg&#039;,&lt;br /&gt;
       }],&lt;br /&gt;
       &#039;ean&#039;: &#039;a124jiojrega231&#039;,&lt;br /&gt;
       &#039;brand&#039;: &#039;testBrand&#039;,&lt;br /&gt;
       &#039;category&#039;: &#039;testCategory&#039;,&lt;br /&gt;
       &#039;variant&#039;: &#039;testVariant&#039;,&lt;br /&gt;
       &#039;list&#039;: &#039;testList&#039;,&lt;br /&gt;
       &#039;position&#039;: &#039;testPosition&#039;,&lt;br /&gt;
       &#039;creative&#039;: &#039;testCreative&#039;,&lt;br /&gt;
       &#039;unitPrice&#039;: 10000.0,&lt;br /&gt;
       &#039;totalItemPrice&#039;: 100000.0,&lt;br /&gt;
       &#039;unit&#039;: &#039;db&#039;,&lt;br /&gt;
       &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
       &#039;quantity&#039;: 10,&lt;br /&gt;
       &#039;step&#039;: 6,&lt;br /&gt;
       &#039;customerValue&#039;: 15.00,&lt;br /&gt;
       &#039;coupon&#039;: &#039;testCoupon&#039;&lt;br /&gt;
   }&lt;br /&gt;
&lt;br /&gt;
bat(&#039;track&#039;, &#039;addToCart&#039;, addToCartProperties );&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
====Address value type====&lt;br /&gt;
&lt;br /&gt;
The &#039;&#039;&#039;shippingAddress&#039;&#039;&#039; property is a compound value type with a specific set of properties. This is essentially a Javascript object with specified keys below. No keys are mandatory in this value type.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 5: The address value type properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Property name&lt;br /&gt;
! Property type&lt;br /&gt;
! Description&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! deliveryMethod&lt;br /&gt;
| text&lt;br /&gt;
| The delivery method, if applicable.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! country&lt;br /&gt;
| text&lt;br /&gt;
| The recipient&#039;s country code in ISO-3166-1 alpha-2 format.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! city&lt;br /&gt;
| text&lt;br /&gt;
| The complete name of the city of the recipient address.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! region&lt;br /&gt;
| text&lt;br /&gt;
| The region code of the recipient address in ISO-3166-2 format&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! zip&lt;br /&gt;
| text&lt;br /&gt;
| The zip code of the recipient address.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! street&lt;br /&gt;
| text&lt;br /&gt;
| The shipping street address with house number and other details.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! street2&lt;br /&gt;
| text&lt;br /&gt;
| The address, continued.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! fullName&lt;br /&gt;
| text&lt;br /&gt;
| The full civil or official name of the recipient.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! phone&lt;br /&gt;
| text&lt;br /&gt;
| The phone number of the recipient.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
===Events related to content browsing===&lt;br /&gt;
&lt;br /&gt;
A portion of all events are related to browsing through a Your webshop’s content: viewing pages, promotions, clicking on products and product details, customization of products, etc. These are specifically: &#039;&#039;&#039;contentView, clickProduct, clickProductDetail, customizeProduct, clickPromo&#039;&#039;&#039;. &lt;br /&gt;
All properties may be used in each event, where You find YES in te corresnponding table the property usage is mandatory. Only 3 properties are overall mandatory, these are: &#039;&#039;&#039;id, contentType and name&#039;&#039;&#039;. Please note that for the contentType property, you are only able to choose from a number of predefined values: Page, Product, Article, Promotion, Banner and Misc. The following table shows the property requirements for these.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 6: Properties of events related to content browsing&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!&lt;br /&gt;
!colspan = &amp;quot;5&amp;quot;| Event&lt;br /&gt;
|-&lt;br /&gt;
! Property&lt;br /&gt;
! contentView&lt;br /&gt;
! clickProduct&lt;br /&gt;
! clickProductDetail&lt;br /&gt;
! customizeProduct&lt;br /&gt;
! clickPromo&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES*&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES*&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES*&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| YES*&lt;br /&gt;
| YES&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| YES&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! &lt;br /&gt;
|colspan = &amp;quot;5&amp;quot;| * Required only in case of Product type when using the contentView event.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
===Purchase related events===&lt;br /&gt;
&lt;br /&gt;
These events refer to purchase intentions and effective checkouts and purchases. These events also share a number of common properties. &lt;br /&gt;
&lt;br /&gt;
====addToCart/removeFromCart====&lt;br /&gt;
&lt;br /&gt;
Both events have the same event set and the required properties are the same as well.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 7: addToCart/removeFromCart event properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Property&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| &lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====initiateCheckout, addPaymentInfo, initiatePurchase, purchase====&lt;br /&gt;
&lt;br /&gt;
These events refer to checkout and payment info change user events. The allowed properties are generally the same with only one exception: the &#039;&#039;&#039;paymentMethod&#039;&#039;&#039; property is only allowed in the &#039;&#039;&#039;addPaymentInfo&#039;&#039;&#039; event, in other events it is unavailable. &lt;br /&gt;
&lt;br /&gt;
Generally two properties are mandatory throughout all events in this particular group: &#039;&#039;&#039;contents&#039;&#039;&#039; and &#039;&#039;&#039;step&#039;&#039;&#039;, referring to the items in the basket and the step in the buying process. After checkout is initiated the &#039;&#039;&#039;revenue&#039;&#039;&#039; and &#039;&#039;&#039;currency&#039;&#039;&#039; also becomes mandatory property.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 8: Properties of initiateCheckout, addPaymentInfo, initiatePurchase and purchase events&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!&lt;br /&gt;
!colspan=&amp;quot;4&amp;quot;|event&lt;br /&gt;
|-&lt;br /&gt;
! Property&lt;br /&gt;
! initiateCheckout&lt;br /&gt;
! addPaymentInfo&lt;br /&gt;
! initiatePurchase&lt;br /&gt;
! purchase&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! paymentMethod&lt;br /&gt;
| UNAVAILABLE&lt;br /&gt;
| YES&lt;br /&gt;
| UNAVAILABLE&lt;br /&gt;
| UNAVAILABLE&lt;br /&gt;
|-&lt;br /&gt;
! revenue&lt;br /&gt;
| &lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| &lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! description&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! imageUrl&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! option&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! orderNumber&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! shipping&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! shippingAddress&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! tax&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====Search event====&lt;br /&gt;
&lt;br /&gt;
For product search event tracking one can use the search event. The parameters here are all optional except for one: that is the &#039;&#039;&#039;searchString&#039;&#039;&#039;. The following tables lists all allowed properties for this particular event.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 9: Properties of search event&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Key&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! searchString&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! totalResults&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| &lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====signUp event====&lt;br /&gt;
&lt;br /&gt;
Upon user signup one may fire the signUp event to record signups for theri webshop. All but three properties are optional. Mandatory properties are: &#039;&#039;&#039;id&#039;&#039;&#039;, &#039;&#039;&#039;contentType&#039;&#039;&#039; and &#039;&#039;&#039;name&#039;&#039;&#039;. Other attributes are denoted in the following table.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 10: Properties of signUp event&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Key&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| &lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Baloghn</name></author>
	</entry>
	<entry>
		<id>https://docs.barion.com/index.php?title=Barion_Pixel_API_reference&amp;diff=1644</id>
		<title>Barion Pixel API reference</title>
		<link rel="alternate" type="text/html" href="https://docs.barion.com/index.php?title=Barion_Pixel_API_reference&amp;diff=1644"/>
		<updated>2019-03-26T12:33:26Z</updated>

		<summary type="html">&lt;p&gt;Baloghn: /* Minimum requirements */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{PageTitle|title=Barion Pixel Documentation}}&lt;br /&gt;
&lt;br /&gt;
{| style=&amp;quot;margin-left:2em;&amp;quot; align=&amp;quot;right&amp;quot;&lt;br /&gt;
| __TOC__&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
The Barion Pixel is a snippet of JavaScript code that allows you to track visitor activity on your website. It works by loading a small library of functions which you can use whenever a site visitor takes an action that you want to track (called an event).&lt;br /&gt;
&lt;br /&gt;
In order to implement the Pixel, you will need:&lt;br /&gt;
* access to your website&#039;s code base&lt;br /&gt;
* your Pixel&#039;s base code and associated IDs (barionPixelID)&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
= Implementation =&lt;br /&gt;
&lt;br /&gt;
The Barion Pixel is a snippet of JavaScript code that loads a small library of functions you can use to track visitor activity on your website. It relies on Barion cookies. By default, the Pixel will track URLs visited, domains visited, and the devices your visitors use. In addition, you can use the Pixel&#039;s library of functions to track other events that are associated with webshop usage and ecommerce. The installation does not require accepted consent policy by your user. Tracking visitors behavior for the purposes of preventing fraud is legitim interest. Only consent events will determine the permission of the marketing purpose. Base code and consent events set-up are the minimum requirements for implementation.&lt;br /&gt;
&lt;br /&gt;
== Minimum requirements ==&lt;br /&gt;
=== Base code ===&lt;br /&gt;
Before you can install the Pixel, you will need your Pixel&#039;s base code. To install the Pixel, we highly recommend that you add its base code between the opening and closing &amp;lt;head&amp;gt; tags on every page where you will be tracking website visitor actions. Most developers add it to their website&#039;s persistent header, so it can be used on all pages, but it could be used before the closing body tag (&amp;lt;/body&amp;gt;) as well.&lt;br /&gt;
&lt;br /&gt;
Placing the code within your &amp;lt;head&amp;gt; tags reduces the chances of browsers or third-party code blocking the Pixel&#039;s execution. It also executes the code sooner, increasing the chance that your visitors are tracked before they leave your page.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 1&#039;&#039;&#039;&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&amp;lt;script&amp;gt;&lt;br /&gt;
&lt;br /&gt;
  (function(i,s,o,g,r,a,m){i[&#039;BarionAnalyticsObject&#039;]=r;i[r]=i[r]||function(){&lt;br /&gt;
  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),&lt;br /&gt;
  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)&lt;br /&gt;
   })(window, document, &#039;script&#039;, &#039;https://pixel.barion.com/bp.js&#039;, &#039;bat&#039;);&lt;br /&gt;
  &lt;br /&gt;
  // initialize the Pixel&lt;br /&gt;
  bat(&#039;init&#039;, &#039;addBarionPixelId&#039;, &#039;[Your Barion Pixel ID goes here]&#039;);&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/script&amp;gt;&lt;br /&gt;
  &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Figure 1.1&#039;&#039;&#039;&lt;br /&gt;
  &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&amp;lt;noscript&amp;gt;&lt;br /&gt;
&lt;br /&gt;
  &amp;lt;img height=&amp;quot;1&amp;quot; width=&amp;quot;1&amp;quot; style=&amp;quot;display:none&amp;quot; src=&amp;quot;https://pixel.barion.com/a.gif?__ba_pixel_id=[Your Barion Pixel ID goes here]&amp;amp;ev=contentView&amp;amp;noscript=1&amp;quot;/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/noscript&amp;gt;&lt;br /&gt;
 &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
When run, this code will download a library of functions which you can then use for tracking. It also automatically tracks a single PageView conversion by calling the bat() function each time it loads. We recommend that you leave this function call intact.&lt;br /&gt;
&lt;br /&gt;
=== Consent Events ===&lt;br /&gt;
Consent events determine which data could be used by 3rd Party for marketing purpose. Three type of consents event are defined. The grantConsent event have to be sent when the visitor accept the cookie policy and it allows Barion to do data usage for marketing aim. RejectConsent event means when the customer reject the cookie policy (which include Barion Pixel too) and revokeConsent actually when customer change the consent status from granted to rejected state which refer to Barion Pixel. Important notice that reject and revoke consent do not mean to refuse the Barion Pixel by reason of collecting data without consent is legitim interest only for fraud detection. All consent events are tracked by calling the Pixel&#039;s bat(&#039;consent&#039;) function. (Figure 2.)&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 2&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    bat(&#039;consent&#039;, &#039;grantConsent&#039;);&lt;br /&gt;
    bat(&#039;consent&#039;, &#039;revokeConsent&#039;);&lt;br /&gt;
    bat(&#039;consent&#039;, &#039;rejectConsent&#039;);&lt;br /&gt;
 &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Installing Standard and Custom Events ==&lt;br /&gt;
There are two ways to track conversions with the Pixel:&lt;br /&gt;
* standard events, which are visitor actions that we have defined and that you report by calling a Pixel function&lt;br /&gt;
* custom events, which are visitor actions that you have defined and that you report by calling a Pixel function&lt;br /&gt;
&lt;br /&gt;
=== Standard Events ===&lt;br /&gt;
Standard events are predefined visitor actions that correspond to common, conversion-related activities, such as searching for a product, viewing a product, or purchasing a product. Standard events support parameters, which allow you to include an object containing additional information about an event, such as product IDs, categories, and the number of products purchased. Please consider that some events have mandatory properties (see under).&lt;br /&gt;
&lt;br /&gt;
In order to track an event the event needs to be fired, that is the corresponding event with its properties need to be added inside Your javascript or page. This can be seen on Figure 2 and Figure 3.&lt;br /&gt;
&lt;br /&gt;
All standard events are tracked by calling the Pixel&#039;s bat(&#039;track&#039;) function, with the event name, and a JSON object as its parameters (sometimes optional). For example, here&#039;s a function call to track when a visitor has completed a purchase event, with currency and value included as a parameter. (Figure 2)&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 3&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
var contentViewProperties = {&lt;br /&gt;
    &#039;id&#039;: &#039;My blog page&#039;,&lt;br /&gt;
    &#039;contentType&#039;: &#039;Page&#039;,&lt;br /&gt;
    &#039;name&#039;: &#039;Very cool product&#039;,&lt;br /&gt;
}&lt;br /&gt;
bat(&#039;track&#039;, &#039;contentView&#039;, contentViewProperties);&lt;br /&gt;
 &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Sometimes You may want to track this event when a specific button is clicked. This can be achieved with the following code and jQuery. Note that the Pixel needs to be included in the page in order to be able to track events. (Figure 3)&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 4&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
$(&amp;quot;#addtocart_button&amp;quot;).click(function(){&lt;br /&gt;
&lt;br /&gt;
    // sample product data&lt;br /&gt;
    var addToCartPorperties = {&lt;br /&gt;
        &#039;id&#039;: &#039;a&#039;,&lt;br /&gt;
        &#039;contentType&#039;: &#039;Page&#039;,&lt;br /&gt;
        &#039;name&#039;: &#039;a&#039;,&lt;br /&gt;
        &#039;ean&#039;: &#039;a&#039;,&lt;br /&gt;
        &#039;unitPrice&#039;: 1000,&lt;br /&gt;
        &#039;totalItemPrice&#039;: 2000,&lt;br /&gt;
        &#039;unit&#039;: &#039;kg&#039;,&lt;br /&gt;
        &#039;currency&#039;: &#039;huf&#039;,&lt;br /&gt;
        &#039;quantity&#039;: 2,   &lt;br /&gt;
    }    &lt;br /&gt;
&lt;br /&gt;
    bat(&#039;track&#039;, &#039;addToCart&#039;, addToCartPorperties);&lt;br /&gt;
&lt;br /&gt;
});&lt;br /&gt;
 &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Standard event descriptions ===&lt;br /&gt;
&lt;br /&gt;
With these standard events one can describe a lot of ecommerce related user actions in a meaningful way. Each event have its own set of properties that are needed in order to fully understand and record the users intentions/behaviour. &lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 1: Event descriptions&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Event name&lt;br /&gt;
! Description&lt;br /&gt;
|-&lt;br /&gt;
! setUserProperties&lt;br /&gt;
| With this event One can add user related information.&lt;br /&gt;
|-&lt;br /&gt;
! contentView&lt;br /&gt;
| User sees a certain content on a page (e.g. product, article, promotion, banner, etc). When a key page is viewed such as a product page. This event may be fired on pageload.&lt;br /&gt;
|-&lt;br /&gt;
! clickProduct&lt;br /&gt;
| A click on a product in any list (search, recommendation box, etc). Usually fired at user click&lt;br /&gt;
|-&lt;br /&gt;
! clickProductDetail&lt;br /&gt;
| A click of product details. (e.g. more info link). Usually fired when user clicks.&lt;br /&gt;
|-&lt;br /&gt;
! customizeProduct&lt;br /&gt;
| When a person customizes a product. (color, size, etc). Typically fired at user click.&lt;br /&gt;
|-&lt;br /&gt;
! clickPromo&lt;br /&gt;
| A click on an internal promotion. Fired at mouse click.&lt;br /&gt;
|-&lt;br /&gt;
! addToCart&lt;br /&gt;
| This event may be fired when a product is added to the shopping cart (users clicks on an add to cart button) upon user clicks.&lt;br /&gt;
|-&lt;br /&gt;
! removeFromCart&lt;br /&gt;
| This event may be fired when a product is removed to the shopping cart (users clicks on an add to cart button) upon user clicks.&lt;br /&gt;
|-&lt;br /&gt;
! initiateCheckout&lt;br /&gt;
| This event may be fired when a the user checks out the cart, clicks on the checkout button.&lt;br /&gt;
|-&lt;br /&gt;
! addPaymentInfo&lt;br /&gt;
| When payment information is added in the checkout flow, this event may be fired upon user click.&lt;br /&gt;
|-&lt;br /&gt;
! initiatePurchase&lt;br /&gt;
| A person clicks on a purchase button (and possibly enters the Thank You Page).&lt;br /&gt;
|-&lt;br /&gt;
! purchase&lt;br /&gt;
| When a purchase is made or checkout flow is completed. Successful or unsuccesful. This may be employed on the Thank you page (typically) on pageload.&lt;br /&gt;
|-&lt;br /&gt;
! search&lt;br /&gt;
| When a search is entered into a search field upon sending the form, this event may be fired.&lt;br /&gt;
|-&lt;br /&gt;
! signUp&lt;br /&gt;
| To track user signup, when a registration form is completed/sent to the server (just when the status is OK), this event may be fired upon pageload.&lt;br /&gt;
|-&lt;br /&gt;
! error&lt;br /&gt;
| If one want to track errors this event may be used for that.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
===Custom events===&lt;br /&gt;
&lt;br /&gt;
Custom events may be defined, with arbitrary text data as parameters. One way to do so is to fire the customEvent event depicted in Figure 4. The event may hold up to 5 attributes: eventCategory, eventAction, eventProperty, eventLabel, eventValue. If You want to add custom properties to standard events You may do so by adding the “_” prefix to that particular event. This is denoted in Figure 5.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 5: Custom event tracking&#039;&#039;&#039;&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
// sample customData&lt;br /&gt;
var customData = {&lt;br /&gt;
    eventCategory: &#039;Video&#039;,&lt;br /&gt;
    eventAction: &#039;play&#039;,&lt;br /&gt;
    eventProperty: &#039;video&#039;,&lt;br /&gt;
    eventLabel: &#039;Fall Campaign&#039;,&lt;br /&gt;
    eventValue: 42        &lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
bat(&#039;track&#039;, &#039;customEvent&#039;, customData);&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 6: Custom event tracking&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
var contentViewProperties = {&lt;br /&gt;
        &#039;id&#039;: &#039;My blog page&#039;,&lt;br /&gt;
        &#039;contentType&#039;: &#039;Page&#039;,&lt;br /&gt;
        &#039;name&#039;: &#039;Very cool product&#039;,&lt;br /&gt;
        &#039;_mycustomparameter&#039;: 42&lt;br /&gt;
    }&lt;br /&gt;
&lt;br /&gt;
    bat(&#039;track&#039;, &#039;contentView&#039;, contentViewProperties);&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===Event Properties===&lt;br /&gt;
&lt;br /&gt;
Each event may hold a given set of parameters in order to describe a particular user action. In order to provide complete data some parameters are &#039;&#039;&#039;mandatory/required&#039;&#039;&#039; while some a &#039;&#039;&#039;optional&#039;&#039;&#039;. Properties are given to the event in a standard Javascript object with assigning each property (key) a value.&lt;br /&gt;
&lt;br /&gt;
A value has a value type. Some are primitive types like &#039;&#039;&#039;text, integer&#039;&#039;&#039; and &#039;&#039;&#039;float&#039;&#039;&#039; types and there are two compound types &#039;&#039;&#039;item_list&#039;&#039;&#039; and the &#039;&#039;&#039;address&#039;&#039;&#039; a value type. Only compound types are enforced with validation, primitive types are converted during validation and message sending implicitly if the value type is different from the required value type. Text values are truncated to 1024 characters. &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
====Standard properties====&lt;br /&gt;
&lt;br /&gt;
The table here shows all standard properties that are used throughout the tracking. Each property is context sensitive, which means only a handful of properties are needed in each event, and from those only some may be required.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 2: Standard properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! name&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| text&lt;br /&gt;
| SKU of product/id of article/the promotion ID/etc.&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| text&lt;br /&gt;
| The content type of the page visited. Possible values: Page/Product/Article/Promotion/Banner/Misc. Values here are enforced/validated.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| text&lt;br /&gt;
| Full name of product/article/promotion etc (e.g. Android T-Shirt or e.g. Summer Sale)&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) when applicable.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| text&lt;br /&gt;
| Brand part of product/brand described in name&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| text&lt;br /&gt;
| Array of categories of product/article/etc. If category is in tree structure, they must be separated with pipe (e.g. &amp;quot;clothes|coat|winter&amp;quot; or &amp;quot;clothes|coat|autumn&amp;quot;).&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the product (e.g. Black)&lt;br /&gt;
|-&lt;br /&gt;
! description&lt;br /&gt;
| text&lt;br /&gt;
| The detailed description of the item.&lt;br /&gt;
|-&lt;br /&gt;
! imageUrl&lt;br /&gt;
| text&lt;br /&gt;
| A URL pointing to an image that shows the item. E.g. the picture of the product&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| text&lt;br /&gt;
| The measurement unit of the item. (e.g. pcs, litre)&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| float&lt;br /&gt;
| Price of product (the price of one measurement unit of the item).&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| float&lt;br /&gt;
| The total price of the item.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| text (ISO 4217 format)&lt;br /&gt;
| Currency of product. 3 digit ISO-4217 format is preferred.&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| integer&lt;br /&gt;
| The quantity of a product (e.g. 2)&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| item_list&lt;br /&gt;
| An array of item type JSON objects. For appropriate structure refer to Item definition in this chapter later. &lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| text&lt;br /&gt;
| The list or collection to which the product belongs (e.g. Search Results)&lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| text&lt;br /&gt;
| The product&#039;s position in a list or collection (e.g. 2) or the position of the creative (e.g. banner_slot_1)&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| text&lt;br /&gt;
| The creative associated with the promotion (e.g. summer_banner2)&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| integer&lt;br /&gt;
| A number representing a step in the checkout process. Optional on checkout actions.&lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| text&lt;br /&gt;
| The transaction coupon code redeemed with the transaction.&lt;br /&gt;
|-&lt;br /&gt;
! orderNumber&lt;br /&gt;
| text&lt;br /&gt;
| Required if the action is purchase.&lt;br /&gt;
|-&lt;br /&gt;
! revenue&lt;br /&gt;
| float&lt;br /&gt;
| Specifies the total revenue or grand total associated with the transaction (e.g. 11.99). This value includes shipping, tax costs, or other adjustments to revenue that you want to include as part of your revenue calculations. Note: if revenue is not set, its value will be automatically calculated using the product quantity and price fields of all products in the same hit.&lt;br /&gt;
|-&lt;br /&gt;
! tax&lt;br /&gt;
| float&lt;br /&gt;
| The total tax associated with the transaction&lt;br /&gt;
|-&lt;br /&gt;
! shipping&lt;br /&gt;
| float&lt;br /&gt;
| The shipping cost associated with the transaction.&lt;br /&gt;
|-&lt;br /&gt;
! shippingAddress&lt;br /&gt;
| address&lt;br /&gt;
| This structure represents a shipping address related to a payment. See below the address type for the appropriate structure and syntax.&lt;br /&gt;
|-&lt;br /&gt;
! paymentMethod&lt;br /&gt;
| text&lt;br /&gt;
| Payment method of the purchase. E.g. Barion, PayPal, CashOnDelivery, Klarna&lt;br /&gt;
|-&lt;br /&gt;
! option&lt;br /&gt;
| text&lt;br /&gt;
| Additional field that can describe option information on the checkout page (e.g. delivery method)&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| float&lt;br /&gt;
| The value of a user performing this event to the business.&lt;br /&gt;
|-&lt;br /&gt;
! searchString&lt;br /&gt;
| text&lt;br /&gt;
| In case of Search event. The string entered by the user for the search.&lt;br /&gt;
|-&lt;br /&gt;
! totalResults&lt;br /&gt;
| number&lt;br /&gt;
| Results found in case of a search&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====User Properties====&lt;br /&gt;
&lt;br /&gt;
For the &#039;&#039;&#039;setUserProperties&#039;&#039;&#039; event there are a custom set of properties that may be set when used.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 3: setUserProperties properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Key&lt;br /&gt;
! Value Type&lt;br /&gt;
! Description&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! userId&lt;br /&gt;
| text&lt;br /&gt;
| User Id&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! email&lt;br /&gt;
| text&lt;br /&gt;
| Email address. &#039;&#039;&#039;Hashed automatically for privacy purposes.&#039;&#039;&#039;&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! phone&lt;br /&gt;
| text&lt;br /&gt;
| Phone number ina format of IPF ()International Phone Number) eg. +1-541-754-3010. &#039;&#039;&#039;Hashed automatically for privacy purposes.&#039;&#039;&#039;&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! accountCreatedTime&lt;br /&gt;
| UNIX timestamp&lt;br /&gt;
| When the user account was created&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! country&lt;br /&gt;
| text&lt;br /&gt;
| The country in which the user lives. ISO 3166-1 alpha-2 codes are preferred.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! county&lt;br /&gt;
| text&lt;br /&gt;
| The county in which the user lives&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! city&lt;br /&gt;
| text&lt;br /&gt;
| The city in which the user lives&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! zipCode&lt;br /&gt;
| text&lt;br /&gt;
| The zip code of the user&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! gender&lt;br /&gt;
| text&lt;br /&gt;
| The gender of the user. Possible values: M - Male, F - Female&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! age&lt;br /&gt;
| integer&lt;br /&gt;
| Age of user&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| text (ISO 4217 format)&lt;br /&gt;
| The preferred currency of the user. 3 digit currency code required.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! language&lt;br /&gt;
| text (ISO 639-1)&lt;br /&gt;
| The preferred language of the user. 2 digit country code is required.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! interests&lt;br /&gt;
| text&lt;br /&gt;
| Lists the interests of the user (e.g., &amp;quot;Arts &amp;amp; Entertainment, Games, Sports&amp;quot;)&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! sessionId&lt;br /&gt;
| text&lt;br /&gt;
| Session Id&lt;br /&gt;
| NO&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====Contetnts value type====&lt;br /&gt;
&lt;br /&gt;
The &#039;&#039;&#039;contents&#039;&#039;&#039; is a compound value type that is comprised of a standard Javascript dictionary encapsulated in a standard JS array. Each element of the array have to conform to the following property list restrictions.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 4: The contents type properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Property name&lt;br /&gt;
! Property type&lt;br /&gt;
! Description&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| text&lt;br /&gt;
| SKU of product/id of article/the promotion ID/etc.&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| text&lt;br /&gt;
| Possible values: Product/Article/Promotion/Banner/Misc&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| text&lt;br /&gt;
| Full Name of product/article/promotion etc (e.g. Android T-Shirt or e.g. Summer Sale)&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| text&lt;br /&gt;
| Brand part of product/brand described in article&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| text&lt;br /&gt;
| Array of categories of product/article/etc. If category is in tree structure, they must be separated with pipe (e.g. &amp;quot;clothes|coat|winter&amp;quot; or &amp;quot;clothes|coat|autumn&amp;quot;).&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| text&lt;br /&gt;
| The measurement unit of the item.&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| float&lt;br /&gt;
| Price of product (the price of one measurement unit of the item).&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| float&lt;br /&gt;
| The total price of the item.&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| text (ISO 4217 format)&lt;br /&gt;
| Currency of product&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| integer&lt;br /&gt;
| The quantity of a product (e.g. 2)&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the product (e.g. Black)&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! description&lt;br /&gt;
| text&lt;br /&gt;
| The detailed description of the item.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! imageUrl&lt;br /&gt;
| text&lt;br /&gt;
| A URL pointing to an image that shows the item.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) when applicable.&lt;br /&gt;
| NO&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 7&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
 var addToCartProperties = {&lt;br /&gt;
       &#039;id&#039;: &#039;testAddToCart&#039;,&lt;br /&gt;
       &#039;contentType&#039;: &#039;testType&#039;,&lt;br /&gt;
       &#039;name&#039;: &#039;testName&#039;,&lt;br /&gt;
       &#039;contents&#039;: [{&lt;br /&gt;
             &#039;id&#039;: &#039;testId&#039;,&lt;br /&gt;
             &#039;contentType&#039;: &#039;testAnimal&#039;,&lt;br /&gt;
             &#039;name&#039;: &#039;testName&#039;,&lt;br /&gt;
             &#039;brand&#039;: &#039;testDead&#039;,&lt;br /&gt;
             &#039;category&#039;: &#039;testCategory&#039;,&lt;br /&gt;
             &#039;unit&#039;: &#039;testUnit&#039;,&lt;br /&gt;
             &#039;unitPrice&#039;: 10000.0,&lt;br /&gt;
             &#039;totalItemPrice&#039;: 100000.0,&lt;br /&gt;
             &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
             &#039;quantity&#039;: 10,&lt;br /&gt;
             &#039;ean&#039;: &#039;234eqwfq24241324r345&#039;,&lt;br /&gt;
             &#039;variant&#039;: &#039;testVariant&#039;,&lt;br /&gt;
             &#039;description&#039;: &#039;testDescription&#039;,&lt;br /&gt;
             &#039;imageUrl&#039;: &#039;http://example.org/test.jpg&#039;,&lt;br /&gt;
       }],&lt;br /&gt;
       &#039;ean&#039;: &#039;a124jiojrega231&#039;,&lt;br /&gt;
       &#039;brand&#039;: &#039;testBrand&#039;,&lt;br /&gt;
       &#039;category&#039;: &#039;testCategory&#039;,&lt;br /&gt;
       &#039;variant&#039;: &#039;testVariant&#039;,&lt;br /&gt;
       &#039;list&#039;: &#039;testList&#039;,&lt;br /&gt;
       &#039;position&#039;: &#039;testPosition&#039;,&lt;br /&gt;
       &#039;creative&#039;: &#039;testCreative&#039;,&lt;br /&gt;
       &#039;unitPrice&#039;: 10000.0,&lt;br /&gt;
       &#039;totalItemPrice&#039;: 100000.0,&lt;br /&gt;
       &#039;unit&#039;: &#039;db&#039;,&lt;br /&gt;
       &#039;currency&#039;: &#039;HUF&#039;,&lt;br /&gt;
       &#039;quantity&#039;: 10,&lt;br /&gt;
       &#039;step&#039;: 6,&lt;br /&gt;
       &#039;customerValue&#039;: 15.00,&lt;br /&gt;
       &#039;coupon&#039;: &#039;testCoupon&#039;&lt;br /&gt;
   }&lt;br /&gt;
&lt;br /&gt;
bat(&#039;track&#039;, &#039;addToCart&#039;, addToCartProperties );&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
====Address value type====&lt;br /&gt;
&lt;br /&gt;
The &#039;&#039;&#039;shippingAddress&#039;&#039;&#039; property is a compound value type with a specific set of properties. This is essentially a Javascript object with specified keys below. No keys are mandatory in this value type.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 5: The address value type properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Property name&lt;br /&gt;
! Property type&lt;br /&gt;
! Description&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! deliveryMethod&lt;br /&gt;
| text&lt;br /&gt;
| The delivery method, if applicable.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! country&lt;br /&gt;
| text&lt;br /&gt;
| The recipient&#039;s country code in ISO-3166-1 alpha-2 format.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! city&lt;br /&gt;
| text&lt;br /&gt;
| The complete name of the city of the recipient address.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! region&lt;br /&gt;
| text&lt;br /&gt;
| The region code of the recipient address in ISO-3166-2 format&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! zip&lt;br /&gt;
| text&lt;br /&gt;
| The zip code of the recipient address.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! street&lt;br /&gt;
| text&lt;br /&gt;
| The shipping street address with house number and other details.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! street2&lt;br /&gt;
| text&lt;br /&gt;
| The address, continued.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! fullName&lt;br /&gt;
| text&lt;br /&gt;
| The full civil or official name of the recipient.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! phone&lt;br /&gt;
| text&lt;br /&gt;
| The phone number of the recipient.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
===Events related to content browsing===&lt;br /&gt;
&lt;br /&gt;
A portion of all events are related to browsing through a Your webshop’s content: viewing pages, promotions, clicking on products and product details, customization of products, etc. These are specifically: &#039;&#039;&#039;contentView, clickProduct, clickProductDetail, customizeProduct, clickPromo&#039;&#039;&#039;. &lt;br /&gt;
All properties may be used in each event, where You find YES in te corresnponding table the property usage is mandatory. Only 3 properties are overall mandatory, these are: &#039;&#039;&#039;id, contentType and name&#039;&#039;&#039;. Please note that for the contentType property, you are only able to choose from a number of predefined values: Page, Product, Article, Promotion, Banner and Misc. The following table shows the property requirements for these.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 6: Properties of events related to content browsing&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!&lt;br /&gt;
!colspan = &amp;quot;5&amp;quot;| Event&lt;br /&gt;
|-&lt;br /&gt;
! Property&lt;br /&gt;
! contentView&lt;br /&gt;
! clickProduct&lt;br /&gt;
! clickProductDetail&lt;br /&gt;
! customizeProduct&lt;br /&gt;
! clickPromo&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES*&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES*&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES*&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| YES*&lt;br /&gt;
| YES&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| YES&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! &lt;br /&gt;
|colspan = &amp;quot;5&amp;quot;| * Required only in case of Product type when using the contentView event.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
===Purchase related events===&lt;br /&gt;
&lt;br /&gt;
These events refer to purchase intentions and effective checkouts and purchases. These events also share a number of common properties. &lt;br /&gt;
&lt;br /&gt;
====addToCart/removeFromCart====&lt;br /&gt;
&lt;br /&gt;
Both events have the same event set and the required properties are the same as well.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 7: addToCart/removeFromCart event properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Property&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| &lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====initiateCheckout, addPaymentInfo, initiatePurchase, purchase====&lt;br /&gt;
&lt;br /&gt;
These events refer to checkout and payment info change user events. The allowed properties are generally the same with only one exception: the &#039;&#039;&#039;paymentMethod&#039;&#039;&#039; property is only allowed in the &#039;&#039;&#039;addPaymentInfo&#039;&#039;&#039; event, in other events it is unavailable. &lt;br /&gt;
&lt;br /&gt;
Generally two properties are mandatory throughout all events in this particular group: &#039;&#039;&#039;contents&#039;&#039;&#039; and &#039;&#039;&#039;step&#039;&#039;&#039;, referring to the items in the basket and the step in the buying process. After checkout is initiated the &#039;&#039;&#039;revenue&#039;&#039;&#039; and &#039;&#039;&#039;currency&#039;&#039;&#039; also becomes mandatory property.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 8: Properties of initiateCheckout, addPaymentInfo, initiatePurchase and purchase events&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!&lt;br /&gt;
!colspan=&amp;quot;4&amp;quot;|event&lt;br /&gt;
|-&lt;br /&gt;
! Property&lt;br /&gt;
! initiateCheckout&lt;br /&gt;
! addPaymentInfo&lt;br /&gt;
! initiatePurchase&lt;br /&gt;
! purchase&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! paymentMethod&lt;br /&gt;
| UNAVAILABLE&lt;br /&gt;
| YES&lt;br /&gt;
| UNAVAILABLE&lt;br /&gt;
| UNAVAILABLE&lt;br /&gt;
|-&lt;br /&gt;
! revenue&lt;br /&gt;
| &lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| &lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! description&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! imageUrl&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! option&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! orderNumber&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! shipping&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! shippingAddress&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! tax&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====Search event====&lt;br /&gt;
&lt;br /&gt;
For product search event tracking one can use the search event. The parameters here are all optional except for one: that is the &#039;&#039;&#039;searchString&#039;&#039;&#039;. The following tables lists all allowed properties for this particular event.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 9: Properties of search event&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Key&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! searchString&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! totalResults&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| &lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====signUp event====&lt;br /&gt;
&lt;br /&gt;
Upon user signup one may fire the signUp event to record signups for theri webshop. All but three properties are optional. Mandatory properties are: &#039;&#039;&#039;id&#039;&#039;&#039;, &#039;&#039;&#039;contentType&#039;&#039;&#039; and &#039;&#039;&#039;name&#039;&#039;&#039;. Other attributes are denoted in the following table.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 10: Properties of signUp event&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Key&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| &lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Baloghn</name></author>
	</entry>
	<entry>
		<id>https://docs.barion.com/index.php?title=Barion_Pixel_API_reference&amp;diff=1627</id>
		<title>Barion Pixel API reference</title>
		<link rel="alternate" type="text/html" href="https://docs.barion.com/index.php?title=Barion_Pixel_API_reference&amp;diff=1627"/>
		<updated>2019-03-06T09:17:42Z</updated>

		<summary type="html">&lt;p&gt;Baloghn: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{PageTitle|title=Barion Pixel Documentation}}&lt;br /&gt;
&lt;br /&gt;
{| style=&amp;quot;margin-left:2em;&amp;quot; align=&amp;quot;right&amp;quot;&lt;br /&gt;
| __TOC__&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
The Barion pixel is a snippet of JavaScript code that allows you to track visitor activity on your website. It works by loading a small library of functions which you can use whenever a site visitor takes an action that you want to track (called an event).&lt;br /&gt;
&lt;br /&gt;
In order to implement the pixel, you will need:&lt;br /&gt;
* access to your website&#039;s code base&lt;br /&gt;
* your pixel&#039;s base code and associated IDs (barionPixelID)&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Implementation ==&lt;br /&gt;
&lt;br /&gt;
The Barion pixel is a snippet of JavaScript code that loads a small library of functions you can use to track visitor activity on your website. It relies on Barion cookies. By default, the pixel will track URLs visited, domains visited, and the devices your visitors use. In addition, you can use the pixel&#039;s library of functions to track other events that are associated with webshop usage and ecommerce.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Base code ===&lt;br /&gt;
&lt;br /&gt;
Before you can install the pixel, you will need your pixel&#039;s base code. &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 1&#039;&#039;&#039;&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&amp;lt;script&amp;gt;&lt;br /&gt;
&lt;br /&gt;
  (function(i,s,o,g,r,a,m){i[&#039;BarionAnalyticsObject&#039;]=r;i[r]=i[r]||function(){&lt;br /&gt;
  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),&lt;br /&gt;
  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)&lt;br /&gt;
   })(window, document, &#039;script&#039;, &#039;https://pixel.barion.com/bp.js&#039;, &#039;bat&#039;);&lt;br /&gt;
  &lt;br /&gt;
  // initialize the pixel&lt;br /&gt;
  bat(&#039;init&#039;, &#039;addBarionPixelId&#039;, &#039;[Your Barion Pixel ID goes here]&#039;);&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/script&amp;gt;&lt;br /&gt;
&amp;lt;noscript&amp;gt;&lt;br /&gt;
&lt;br /&gt;
  &amp;lt;img height=&amp;quot;1&amp;quot; width=&amp;quot;1&amp;quot; style=&amp;quot;display:none&amp;quot; src=&amp;quot;https://pixel.barion.com/a.gif?__ba_pixel_id=[Your Barion Pixel ID goes here]&amp;amp;ev=contentView&amp;amp;noscript=1&amp;quot;/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/noscript&amp;gt;&lt;br /&gt;
 &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
When run, this code will download a library of functions which you can then use for tracking. It also automatically tracks a single PageView conversion by calling the bat() function each time it loads. We recommend that you leave this function call intact.&lt;br /&gt;
&lt;br /&gt;
=== Installing The Pixel ===&lt;br /&gt;
&lt;br /&gt;
To install the pixel, we highly recommend that you add its base code between the opening and closing &amp;lt;head&amp;gt; tags on every page where you will be tracking website visitor actions. Most developers add it to their website&#039;s persistent header, so it can be used on all pages, but it could be used before the closing body tag (&amp;lt;/body&amp;gt;) as well.&lt;br /&gt;
&lt;br /&gt;
Placing the code within your &amp;lt;head&amp;gt; tags reduces the chances of browsers or third-party code blocking the pixel&#039;s execution. It also executes the code sooner, increasing the chance that your visitors are tracked before they leave your page.&lt;br /&gt;
&lt;br /&gt;
There are two ways to track conversions with the pixel:&lt;br /&gt;
* standard events, which are visitor actions that we have defined and that you report by calling a pixel function&lt;br /&gt;
* custom events, which are visitor actions that you have defined and that you report by calling a pixel function&lt;br /&gt;
&lt;br /&gt;
=== Standard Events ===&lt;br /&gt;
&lt;br /&gt;
Standard events are predefined visitor actions that correspond to common, conversion-related activities, such as searching for a product, viewing a product, or purchasing a product. Standard events support parameters, which allow you to include an object containing additional information about an event, such as product IDs, categories, and the number of products purchased. &lt;br /&gt;
&lt;br /&gt;
In order to track an event the event needs to be fired, that is the corresponding event with its properties need to be added inside Your javascript or page. This can be seen on Figure 2 and Figure 3.&lt;br /&gt;
&lt;br /&gt;
All standard events are tracked by calling the pixel&#039;s bat(&#039;track&#039;) function, with the event name, and a JSON object as its parameters (sometimes optional). For example, here&#039;s a function call to track when a visitor has completed a purchase event, with currency and value included as a parameter. (Figure 2)&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 2&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
var contentViewProperties = {&lt;br /&gt;
    &#039;id&#039;: &#039;My blog page&#039;,&lt;br /&gt;
    &#039;contentType&#039;: &#039;Page&#039;,&lt;br /&gt;
    &#039;name&#039;: &#039;Very cool product&#039;,&lt;br /&gt;
}&lt;br /&gt;
bat(&#039;track&#039;, &#039;contentView&#039;, contentViewProperties);&lt;br /&gt;
 &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Sometimes You may want to track this event when a specific button is clicked. This can be achieved with the following code and jQuery. Note that the pixel needs to be included in the page in order to be able to track events. (Figure 3)&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 3&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
$(&amp;quot;#addtocart_button&amp;quot;).click(function(){&lt;br /&gt;
&lt;br /&gt;
    // sample product data&lt;br /&gt;
    var addToCartPorperties = {&lt;br /&gt;
        &#039;id&#039;: &#039;a&#039;,&lt;br /&gt;
        &#039;contentType&#039;: &#039;Page&#039;,&lt;br /&gt;
        &#039;name&#039;: &#039;a&#039;,&lt;br /&gt;
        &#039;ean&#039;: &#039;a&#039;,&lt;br /&gt;
        &#039;unitPrice&#039;: 1000,&lt;br /&gt;
        &#039;totalItemPrice&#039;: 2000,&lt;br /&gt;
        &#039;unit&#039;: &#039;kg&#039;,&lt;br /&gt;
        &#039;currency&#039;: &#039;huf&#039;,&lt;br /&gt;
        &#039;quantity&#039;: 2,   &lt;br /&gt;
    }    &lt;br /&gt;
&lt;br /&gt;
    bat(&#039;track&#039;, &#039;addToCart&#039;, addToCartPorperties);&lt;br /&gt;
&lt;br /&gt;
});&lt;br /&gt;
 &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Standard event descriptions ===&lt;br /&gt;
&lt;br /&gt;
With these standard events one can describe a lot of ecommerce related user actions in a meaningful way. Each event have its own set of properties that are needed in order to fully understand and record the users intentions/behaviour. &lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 1: Event descriptions&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Event name&lt;br /&gt;
! Description&lt;br /&gt;
|-&lt;br /&gt;
! setUserProperties&lt;br /&gt;
| With this event One can add user related information.&lt;br /&gt;
|-&lt;br /&gt;
! contentView&lt;br /&gt;
| User sees a certain content on a page (e.g. product, article, promotion, banner, etc). When a key page is viewed such as a product page. This event may be fired on pageload.&lt;br /&gt;
|-&lt;br /&gt;
! clickProduct&lt;br /&gt;
| A click on a product in any list (search, recommendation box, etc). Usually fired at user click&lt;br /&gt;
|-&lt;br /&gt;
! clickProductDetail&lt;br /&gt;
| A click of product details. (e.g. more info link). Usually fired when user clicks.&lt;br /&gt;
|-&lt;br /&gt;
! customizeProduct&lt;br /&gt;
| When a person customizes a product. (color, size, etc). Typically fired at user click.&lt;br /&gt;
|-&lt;br /&gt;
! clickPromo&lt;br /&gt;
| A click on an internal promotion. Fired at mouse click.&lt;br /&gt;
|-&lt;br /&gt;
! addToCart&lt;br /&gt;
| This event may be fired when a product is added to the shopping cart (users clicks on an add to cart button) upon user clicks.&lt;br /&gt;
|-&lt;br /&gt;
! removeFromCart&lt;br /&gt;
| This event may be fired when a product is removed to the shopping cart (users clicks on an add to cart button) upon user clicks.&lt;br /&gt;
|-&lt;br /&gt;
! initiateCheckout&lt;br /&gt;
| This event may be fired when a the user checks out the cart, clicks on the checkout button.&lt;br /&gt;
|-&lt;br /&gt;
! addPaymentInfo&lt;br /&gt;
| When payment information is added in the checkout flow, this event may be fired upon user click.&lt;br /&gt;
|-&lt;br /&gt;
! initiatePurchase&lt;br /&gt;
| A person clicks on a purchase button (and possibly enters the Thank You Page).&lt;br /&gt;
|-&lt;br /&gt;
! purchase&lt;br /&gt;
| When a purchase is made or checkout flow is completed. Successful or unsuccesful. This may be employed on the Thank you page (typically) on pageload.&lt;br /&gt;
|-&lt;br /&gt;
! search&lt;br /&gt;
| When a search is entered into a search field upon sending the form, this event may be fired.&lt;br /&gt;
|-&lt;br /&gt;
! signUp&lt;br /&gt;
| To track user signup, when a registration form is completed/sent to the server (just when the status is OK), this event may be fired upon pageload.&lt;br /&gt;
|-&lt;br /&gt;
! grantConsent&lt;br /&gt;
| User consent is granted for tracking.&lt;br /&gt;
|-&lt;br /&gt;
! revokeConsent&lt;br /&gt;
| User consent is revoked for tracking.&lt;br /&gt;
|-&lt;br /&gt;
! rejectConsent&lt;br /&gt;
| User consent is rejected for tracking.&lt;br /&gt;
|-&lt;br /&gt;
! error&lt;br /&gt;
| If one want to track errors this event may be used for that.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
===Custom events===&lt;br /&gt;
&lt;br /&gt;
Custom events may be defined, with arbitrary text data as parameters. One way to do so is to fire the customEvent event depicted in Figure 4. The event may hold up to 5 attributes: eventCategory, eventAction, eventProperty, eventLabel, eventValue. If You want to add custom properties to standard events You may do so by adding the “_” prefix to that particular event. This is denoted in Figure 5.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 4: Custom event tracking&#039;&#039;&#039;&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
// sample customData&lt;br /&gt;
var customData = {&lt;br /&gt;
    eventCategory: &#039;Video&#039;,&lt;br /&gt;
    eventAction: &#039;play&#039;,&lt;br /&gt;
    eventProperty: &#039;video&#039;,&lt;br /&gt;
    eventLabel: &#039;Fall Campaign&#039;,&lt;br /&gt;
    eventValue: 42        &lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
bat(&#039;track&#039;, &#039;customEvent&#039;, customData);&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 5: Custom event tracking&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
var contentViewProperties = {&lt;br /&gt;
        &#039;id&#039;: &#039;My blog page&#039;,&lt;br /&gt;
        &#039;contentType&#039;: &#039;Page&#039;,&lt;br /&gt;
        &#039;name&#039;: &#039;Very cool product&#039;,&lt;br /&gt;
        &#039;_mycustomparameter&#039;: 42&lt;br /&gt;
    }&lt;br /&gt;
&lt;br /&gt;
    bat(&#039;track&#039;, &#039;contentView&#039;, contentViewProperties);&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===Event Properties===&lt;br /&gt;
&lt;br /&gt;
Each event may hold a given set of parameters in order to describe a particular user action. In order to provide complete data some parameters are &#039;&#039;&#039;mandatory/required&#039;&#039;&#039; while some a &#039;&#039;&#039;optional&#039;&#039;&#039;. Properties are given to the event in a standard Javascript object with assigning each property (key) a value.&lt;br /&gt;
&lt;br /&gt;
A value has a value type. Some are primitive types like &#039;&#039;&#039;text, integer&#039;&#039;&#039; and &#039;&#039;&#039;float&#039;&#039;&#039; types and there are two compound types &#039;&#039;&#039;item_list&#039;&#039;&#039; and the &#039;&#039;&#039;address&#039;&#039;&#039; a value type. Only compound types are enforced with validation, primitive types are converted during validation and message sending implicitly if the value type is different from the required value type. Text values are truncated to 1024 characters. &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
====Standard properties====&lt;br /&gt;
&lt;br /&gt;
The table here shows all standard properties that are used throughout the tracking. Each property is context sensitive, which means only a handful of properties are needed in each event, and from those only some may be required.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 2: Standard properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! name&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| text&lt;br /&gt;
| SKU of product/id of article/the promotion ID/etc.&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| text&lt;br /&gt;
| The content type of the page visited. Possible values: Page/Product/Article/Promotion/Banner/Misc. Values here are enforced/validated.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| text&lt;br /&gt;
| Full name of product/article/promotion etc (e.g. Android T-Shirt or e.g. Summer Sale)&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) when applicable.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| text&lt;br /&gt;
| Brand part of product/brand described in name&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| text&lt;br /&gt;
| Array of categories of product/article/etc. If category is in tree structure, they must be separated with pipe (e.g. &amp;quot;clothes|coat|winter&amp;quot; or &amp;quot;clothes|coat|autumn&amp;quot;).&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the product (e.g. Black)&lt;br /&gt;
|-&lt;br /&gt;
! description&lt;br /&gt;
| text&lt;br /&gt;
| The detailed description of the item.&lt;br /&gt;
|-&lt;br /&gt;
! imageUrl&lt;br /&gt;
| text&lt;br /&gt;
| A URL pointing to an image that shows the item. E.g. the picture of the product&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| text&lt;br /&gt;
| The measurement unit of the item. (e.g. pcs, litre)&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| float&lt;br /&gt;
| Price of product (the price of one measurement unit of the item).&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| float&lt;br /&gt;
| The total price of the item.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| text (ISO 4217 format)&lt;br /&gt;
| Currency of product. 3 digit ISO-4217 format is preferred.&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| integer&lt;br /&gt;
| The quantity of a product (e.g. 2)&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| item_list&lt;br /&gt;
| An array of item type JSON objects. For appropriate structure refer to Item definition in this chapter later. &lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| text&lt;br /&gt;
| The list or collection to which the product belongs (e.g. Search Results)&lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| text&lt;br /&gt;
| The product&#039;s position in a list or collection (e.g. 2) or the position of the creative (e.g. banner_slot_1)&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| text&lt;br /&gt;
| The creative associated with the promotion (e.g. summer_banner2)&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| integer&lt;br /&gt;
| A number representing a step in the checkout process. Optional on checkout actions.&lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| text&lt;br /&gt;
| The transaction coupon code redeemed with the transaction.&lt;br /&gt;
|-&lt;br /&gt;
! orderNumber&lt;br /&gt;
| text&lt;br /&gt;
| Required if the action is purchase.&lt;br /&gt;
|-&lt;br /&gt;
! revenue&lt;br /&gt;
| float&lt;br /&gt;
| Specifies the total revenue or grand total associated with the transaction (e.g. 11.99). This value includes shipping, tax costs, or other adjustments to revenue that you want to include as part of your revenue calculations. Note: if revenue is not set, its value will be automatically calculated using the product quantity and price fields of all products in the same hit.&lt;br /&gt;
|-&lt;br /&gt;
! tax&lt;br /&gt;
| float&lt;br /&gt;
| The total tax associated with the transaction&lt;br /&gt;
|-&lt;br /&gt;
! shipping&lt;br /&gt;
| float&lt;br /&gt;
| The shipping cost associated with the transaction.&lt;br /&gt;
|-&lt;br /&gt;
! shippingAddress&lt;br /&gt;
| address&lt;br /&gt;
| This structure represents a shipping address related to a payment. See below the address type for the appropriate structure and syntax.&lt;br /&gt;
|-&lt;br /&gt;
! paymentMethod&lt;br /&gt;
| text&lt;br /&gt;
| Payment method of the purchase. E.g. Barion, PayPal, CashOnDelivery, Klarna&lt;br /&gt;
|-&lt;br /&gt;
! option&lt;br /&gt;
| text&lt;br /&gt;
| Additional field that can describe option information on the checkout page (e.g. delivery method)&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| float&lt;br /&gt;
| The value of a user performing this event to the business.&lt;br /&gt;
|-&lt;br /&gt;
! searchString&lt;br /&gt;
| text&lt;br /&gt;
| In case of Search event. The string entered by the user for the search.&lt;br /&gt;
|-&lt;br /&gt;
! totalResults&lt;br /&gt;
| number&lt;br /&gt;
| Results found in case of a search&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====User Properties====&lt;br /&gt;
&lt;br /&gt;
For the &#039;&#039;&#039;setUserProperties&#039;&#039;&#039; event there are a custom set of properties that may be set when used.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 3: setUserProperties properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Key&lt;br /&gt;
! Value Type&lt;br /&gt;
! Description&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! userId&lt;br /&gt;
| text&lt;br /&gt;
| User Id&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! email&lt;br /&gt;
| text&lt;br /&gt;
| Email address. &#039;&#039;&#039;Hashed automatically for privacy purposes.&#039;&#039;&#039;&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! phone&lt;br /&gt;
| text&lt;br /&gt;
| Phone number ina format of IPF ()International Phone Number) eg. +1-541-754-3010. &#039;&#039;&#039;Hashed automatically for privacy purposes.&#039;&#039;&#039;&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! accountCreatedTime&lt;br /&gt;
| UNIX timestamp&lt;br /&gt;
| When the user account was created&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! country&lt;br /&gt;
| text&lt;br /&gt;
| The country in which the user lives. ISO 3166-1 alpha-2 codes are preferred.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! county&lt;br /&gt;
| text&lt;br /&gt;
| The county in which the user lives&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! city&lt;br /&gt;
| text&lt;br /&gt;
| The city in which the user lives&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! zipCode&lt;br /&gt;
| text&lt;br /&gt;
| The zip code of the user&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! gender&lt;br /&gt;
| text&lt;br /&gt;
| The gender of the user. Possible values: M - Male, F - Female&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! age&lt;br /&gt;
| integer&lt;br /&gt;
| Age of user&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| text (ISO 4217 format)&lt;br /&gt;
| The preferred currency of the user. 3 digit currency code required.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! language&lt;br /&gt;
| text (ISO 639-1)&lt;br /&gt;
| The preferred language of the user. 2 digit country code is required.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! interests&lt;br /&gt;
| text&lt;br /&gt;
| Lists the interests of the user (e.g., &amp;quot;Arts &amp;amp; Entertainment, Games, Sports&amp;quot;)&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! sessionId&lt;br /&gt;
| text&lt;br /&gt;
| Session Id&lt;br /&gt;
| NO&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====Item value type====&lt;br /&gt;
&lt;br /&gt;
The &#039;&#039;&#039;item_list&#039;&#039;&#039; is a compound value type that is comprised of &#039;&#039;&#039;item&#039;&#039;&#039; type Javascript objects in a standard Javascript array. Each element of the array have to conform to the following property list restrictions.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 4: The item value type properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Property name&lt;br /&gt;
! Property type&lt;br /&gt;
! Description&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| text&lt;br /&gt;
| SKU of product/id of article/the promotion ID/etc.&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| text&lt;br /&gt;
| Possible values: Product/Article/Promotion/Banner/Misc&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| text&lt;br /&gt;
| Full Name of product/article/promotion etc (e.g. Android T-Shirt or e.g. Summer Sale)&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| text&lt;br /&gt;
| Brand part of product/brand described in article&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| text&lt;br /&gt;
| Array of categories of product/article/etc. If category is in tree structure, they must be separated with pipe (e.g. &amp;quot;clothes|coat|winter&amp;quot; or &amp;quot;clothes|coat|autumn&amp;quot;).&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| text&lt;br /&gt;
| The measurement unit of the item.&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| float&lt;br /&gt;
| Price of product (the price of one measurement unit of the item).&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| float&lt;br /&gt;
| The total price of the item.&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| text (ISO 4217 format)&lt;br /&gt;
| Currency of product&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| integer&lt;br /&gt;
| The quantity of a product (e.g. 2)&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the product (e.g. Black)&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! description&lt;br /&gt;
| text&lt;br /&gt;
| The detailed description of the item.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! imageUrl&lt;br /&gt;
| text&lt;br /&gt;
| A URL pointing to an image that shows the item.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) when applicable.&lt;br /&gt;
| NO&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====Address value type====&lt;br /&gt;
&lt;br /&gt;
The &#039;&#039;&#039;shippingAddress&#039;&#039;&#039; property is a compound value type with a specific set of properties. This is essentially a Javascript object with specified keys below. No keys are mandatory in this value type.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 5: The address value type properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Property name&lt;br /&gt;
! Property type&lt;br /&gt;
! Description&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! deliveryMethod&lt;br /&gt;
| text&lt;br /&gt;
| The delivery method, if applicable.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! country&lt;br /&gt;
| text&lt;br /&gt;
| The recipient&#039;s country code in ISO-3166-1 alpha-2 format.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! city&lt;br /&gt;
| text&lt;br /&gt;
| The complete name of the city of the recipient address.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! region&lt;br /&gt;
| text&lt;br /&gt;
| The region code of the recipient address in ISO-3166-2 format&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! zip&lt;br /&gt;
| text&lt;br /&gt;
| The zip code of the recipient address.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! street&lt;br /&gt;
| text&lt;br /&gt;
| The shipping street address with house number and other details.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! street2&lt;br /&gt;
| text&lt;br /&gt;
| The address, continued.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! fullName&lt;br /&gt;
| text&lt;br /&gt;
| The full civil or official name of the recipient.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! phone&lt;br /&gt;
| text&lt;br /&gt;
| The phone number of the recipient.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
===Events related to content browsing===&lt;br /&gt;
&lt;br /&gt;
A portion of all events are related to browsing through a Your webshop’s content: viewing pages, promotions, clicking on products and product details, customization of products, etc. These are specifically: &#039;&#039;&#039;contentView, clickProduct, clickProductDetail, customizeProduct, clickPromo&#039;&#039;&#039;. &lt;br /&gt;
All properties may be used in each event, where You find YES in te corresnponding table the property usage is mandatory. Only 3 properties are overall mandatory, these are: &#039;&#039;&#039;id, contentType and name&#039;&#039;&#039;. Please note that for the contentType property, you are only able to choose from a number of predefined values: Page, Product, Article, Promotion, Banner and Misc. The following table shows the property requirements for these.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 6: Properties of events related to content browsing&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!&lt;br /&gt;
!colspan = &amp;quot;5&amp;quot;| Event&lt;br /&gt;
|-&lt;br /&gt;
! Property&lt;br /&gt;
! contentView&lt;br /&gt;
! clickProduct&lt;br /&gt;
! clickProductDetail&lt;br /&gt;
! customizeProduct&lt;br /&gt;
! clickPromo&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES*&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES*&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES*&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| YES*&lt;br /&gt;
| YES&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| YES&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! &lt;br /&gt;
|colspan = &amp;quot;5&amp;quot;| * Required only in case of Product type when using the contentView event.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
===Purchase related events===&lt;br /&gt;
&lt;br /&gt;
These events refer to purchase intentions and effective checkouts and purchases. These events also share a number of common properties. &lt;br /&gt;
&lt;br /&gt;
====addToCart/removeFromCart====&lt;br /&gt;
&lt;br /&gt;
Both events have the same event set and the required properties are the same as well.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 7: addToCart/removeFromCart event properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Property&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| &lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====initiateCheckout, addPaymentInfo, initiatePurchase, purchase====&lt;br /&gt;
&lt;br /&gt;
These events refer to checkout and payment info change user events. The allowed properties are generally the same with only one exception: the &#039;&#039;&#039;paymentMethod&#039;&#039;&#039; property is only allowed in the &#039;&#039;&#039;addPaymentInfo&#039;&#039;&#039; event, in other events it is unavailable. &lt;br /&gt;
&lt;br /&gt;
Generally two properties are mandatory throughout all events in this particular group: &#039;&#039;&#039;contents&#039;&#039;&#039; and &#039;&#039;&#039;step&#039;&#039;&#039;, referring to the items in the basket and the step in the buying process. After checkout is initiated the &#039;&#039;&#039;revenue&#039;&#039;&#039; and &#039;&#039;&#039;currency&#039;&#039;&#039; also becomes mandatory property.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 8: Properties of initiateCheckout, addPaymentInfo, initiatePurchase and purchase events&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!&lt;br /&gt;
!colspan=&amp;quot;4&amp;quot;|event&lt;br /&gt;
|-&lt;br /&gt;
! Property&lt;br /&gt;
! initiateCheckout&lt;br /&gt;
! addPaymentInfo&lt;br /&gt;
! initiatePurchase&lt;br /&gt;
! purchase&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! paymentMethod&lt;br /&gt;
| UNAVAILABLE&lt;br /&gt;
| YES&lt;br /&gt;
| UNAVAILABLE&lt;br /&gt;
| UNAVAILABLE&lt;br /&gt;
|-&lt;br /&gt;
! revenue&lt;br /&gt;
| &lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| &lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! description&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! imageUrl&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! option&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! orderNumber&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! shipping&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! shippingAddress&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! tax&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====Search event====&lt;br /&gt;
&lt;br /&gt;
For product search event tracking one can use the search event. The parameters here are all optional except for one: that is the &#039;&#039;&#039;searchString&#039;&#039;&#039;. The following tables lists all allowed properties for this particular event.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 9: Properties of search event&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Key&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! searchString&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! totalResults&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| &lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====signUp event====&lt;br /&gt;
&lt;br /&gt;
Upon user signup one may fire the signUp event to record signups for theri webshop. All but three properties are optional. Mandatory properties are: &#039;&#039;&#039;id&#039;&#039;&#039;, &#039;&#039;&#039;contentType&#039;&#039;&#039; and &#039;&#039;&#039;name&#039;&#039;&#039;. Other attributes are denoted in the following table.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 10: Properties of signUp event&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Key&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| &lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Baloghn</name></author>
	</entry>
	<entry>
		<id>https://docs.barion.com/index.php?title=Barion_Pixel_API_reference&amp;diff=1626</id>
		<title>Barion Pixel API reference</title>
		<link rel="alternate" type="text/html" href="https://docs.barion.com/index.php?title=Barion_Pixel_API_reference&amp;diff=1626"/>
		<updated>2019-03-06T09:16:57Z</updated>

		<summary type="html">&lt;p&gt;Baloghn: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{PageTitle|title=Barion Pixel Documentation}}&lt;br /&gt;
&lt;br /&gt;
{| style=&amp;quot;margin-left:2em;&amp;quot; align=&amp;quot;right&amp;quot;&lt;br /&gt;
| __TOC__&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
The Barion pixel is a snippet of JavaScript code that allows you to track visitor activity on your website. It works by loading a small library of functions which you can use whenever a site visitor takes an action that you want to track (called an event).&lt;br /&gt;
&lt;br /&gt;
In order to implement the pixel, you will need:&lt;br /&gt;
* access to your website&#039;s code base&lt;br /&gt;
* your pixel&#039;s base code and associated IDs (barionPixelID)&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Implementation ==&lt;br /&gt;
&lt;br /&gt;
The Barion pixel is a snippet of JavaScript code that loads a small library of functions you can use to track visitor activity on your website. It relies on Barion cookies. By default, the pixel will track URLs visited, domains visited, and the devices your visitors use. In addition, you can use the pixel&#039;s library of functions to track other events that are associated with webshop usage and ecommerce.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Base code ===&lt;br /&gt;
&lt;br /&gt;
Before you can install the pixel, you will need your pixel&#039;s base code. &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 1&#039;&#039;&#039;&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&amp;lt;script&amp;gt;&lt;br /&gt;
&lt;br /&gt;
  (function(i,s,o,g,r,a,m){i[&#039;BarionAnalyticsObject&#039;]=r;i[r]=i[r]||function(){&lt;br /&gt;
  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),&lt;br /&gt;
  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)&lt;br /&gt;
   })(window, document, &#039;script&#039;, &#039;https://pixel.dev.barion.com/bp.js&#039;, &#039;bat&#039;);&lt;br /&gt;
  &lt;br /&gt;
  // initialize the pixel&lt;br /&gt;
  bat(&#039;init&#039;, &#039;addBarionPixelId&#039;, &#039;[Your Barion Pixel ID goes here]&#039;);&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/script&amp;gt;&lt;br /&gt;
&amp;lt;noscript&amp;gt;&lt;br /&gt;
&lt;br /&gt;
  &amp;lt;img height=&amp;quot;1&amp;quot; width=&amp;quot;1&amp;quot; style=&amp;quot;display:none&amp;quot; src=&amp;quot;https://pixel.dev.barion.com/a.gif?__ba_pixel_id=[Your Barion Pixel ID goes here]&amp;amp;ev=contentView&amp;amp;noscript=1&amp;quot;/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/noscript&amp;gt;&lt;br /&gt;
 &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
When run, this code will download a library of functions which you can then use for tracking. It also automatically tracks a single PageView conversion by calling the bat() function each time it loads. We recommend that you leave this function call intact.&lt;br /&gt;
&lt;br /&gt;
=== Installing The Pixel ===&lt;br /&gt;
&lt;br /&gt;
To install the pixel, we highly recommend that you add its base code between the opening and closing &amp;lt;head&amp;gt; tags on every page where you will be tracking website visitor actions. Most developers add it to their website&#039;s persistent header, so it can be used on all pages, but it could be used before the closing body tag (&amp;lt;/body&amp;gt;) as well.&lt;br /&gt;
&lt;br /&gt;
Placing the code within your &amp;lt;head&amp;gt; tags reduces the chances of browsers or third-party code blocking the pixel&#039;s execution. It also executes the code sooner, increasing the chance that your visitors are tracked before they leave your page.&lt;br /&gt;
&lt;br /&gt;
There are two ways to track conversions with the pixel:&lt;br /&gt;
* standard events, which are visitor actions that we have defined and that you report by calling a pixel function&lt;br /&gt;
* custom events, which are visitor actions that you have defined and that you report by calling a pixel function&lt;br /&gt;
&lt;br /&gt;
=== Standard Events ===&lt;br /&gt;
&lt;br /&gt;
Standard events are predefined visitor actions that correspond to common, conversion-related activities, such as searching for a product, viewing a product, or purchasing a product. Standard events support parameters, which allow you to include an object containing additional information about an event, such as product IDs, categories, and the number of products purchased. &lt;br /&gt;
&lt;br /&gt;
In order to track an event the event needs to be fired, that is the corresponding event with its properties need to be added inside Your javascript or page. This can be seen on Figure 2 and Figure 3.&lt;br /&gt;
&lt;br /&gt;
All standard events are tracked by calling the pixel&#039;s bat(&#039;track&#039;) function, with the event name, and a JSON object as its parameters (sometimes optional). For example, here&#039;s a function call to track when a visitor has completed a purchase event, with currency and value included as a parameter. (Figure 2)&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 2&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
var contentViewProperties = {&lt;br /&gt;
    &#039;id&#039;: &#039;My blog page&#039;,&lt;br /&gt;
    &#039;contentType&#039;: &#039;Page&#039;,&lt;br /&gt;
    &#039;name&#039;: &#039;Very cool product&#039;,&lt;br /&gt;
}&lt;br /&gt;
bat(&#039;track&#039;, &#039;contentView&#039;, contentViewProperties);&lt;br /&gt;
 &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Sometimes You may want to track this event when a specific button is clicked. This can be achieved with the following code and jQuery. Note that the pixel needs to be included in the page in order to be able to track events. (Figure 3)&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 3&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
$(&amp;quot;#addtocart_button&amp;quot;).click(function(){&lt;br /&gt;
&lt;br /&gt;
    // sample product data&lt;br /&gt;
    var addToCartPorperties = {&lt;br /&gt;
        &#039;id&#039;: &#039;a&#039;,&lt;br /&gt;
        &#039;contentType&#039;: &#039;Page&#039;,&lt;br /&gt;
        &#039;name&#039;: &#039;a&#039;,&lt;br /&gt;
        &#039;ean&#039;: &#039;a&#039;,&lt;br /&gt;
        &#039;unitPrice&#039;: 1000,&lt;br /&gt;
        &#039;totalItemPrice&#039;: 2000,&lt;br /&gt;
        &#039;unit&#039;: &#039;kg&#039;,&lt;br /&gt;
        &#039;currency&#039;: &#039;huf&#039;,&lt;br /&gt;
        &#039;quantity&#039;: 2,   &lt;br /&gt;
    }    &lt;br /&gt;
&lt;br /&gt;
    bat(&#039;track&#039;, &#039;addToCart&#039;, addToCartPorperties);&lt;br /&gt;
&lt;br /&gt;
});&lt;br /&gt;
 &amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Standard event descriptions ===&lt;br /&gt;
&lt;br /&gt;
With these standard events one can describe a lot of ecommerce related user actions in a meaningful way. Each event have its own set of properties that are needed in order to fully understand and record the users intentions/behaviour. &lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 1: Event descriptions&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Event name&lt;br /&gt;
! Description&lt;br /&gt;
|-&lt;br /&gt;
! setUserProperties&lt;br /&gt;
| With this event One can add user related information.&lt;br /&gt;
|-&lt;br /&gt;
! contentView&lt;br /&gt;
| User sees a certain content on a page (e.g. product, article, promotion, banner, etc). When a key page is viewed such as a product page. This event may be fired on pageload.&lt;br /&gt;
|-&lt;br /&gt;
! clickProduct&lt;br /&gt;
| A click on a product in any list (search, recommendation box, etc). Usually fired at user click&lt;br /&gt;
|-&lt;br /&gt;
! clickProductDetail&lt;br /&gt;
| A click of product details. (e.g. more info link). Usually fired when user clicks.&lt;br /&gt;
|-&lt;br /&gt;
! customizeProduct&lt;br /&gt;
| When a person customizes a product. (color, size, etc). Typically fired at user click.&lt;br /&gt;
|-&lt;br /&gt;
! clickPromo&lt;br /&gt;
| A click on an internal promotion. Fired at mouse click.&lt;br /&gt;
|-&lt;br /&gt;
! addToCart&lt;br /&gt;
| This event may be fired when a product is added to the shopping cart (users clicks on an add to cart button) upon user clicks.&lt;br /&gt;
|-&lt;br /&gt;
! removeFromCart&lt;br /&gt;
| This event may be fired when a product is removed to the shopping cart (users clicks on an add to cart button) upon user clicks.&lt;br /&gt;
|-&lt;br /&gt;
! initiateCheckout&lt;br /&gt;
| This event may be fired when a the user checks out the cart, clicks on the checkout button.&lt;br /&gt;
|-&lt;br /&gt;
! addPaymentInfo&lt;br /&gt;
| When payment information is added in the checkout flow, this event may be fired upon user click.&lt;br /&gt;
|-&lt;br /&gt;
! initiatePurchase&lt;br /&gt;
| A person clicks on a purchase button (and possibly enters the Thank You Page).&lt;br /&gt;
|-&lt;br /&gt;
! purchase&lt;br /&gt;
| When a purchase is made or checkout flow is completed. Successful or unsuccesful. This may be employed on the Thank you page (typically) on pageload.&lt;br /&gt;
|-&lt;br /&gt;
! search&lt;br /&gt;
| When a search is entered into a search field upon sending the form, this event may be fired.&lt;br /&gt;
|-&lt;br /&gt;
! signUp&lt;br /&gt;
| To track user signup, when a registration form is completed/sent to the server (just when the status is OK), this event may be fired upon pageload.&lt;br /&gt;
|-&lt;br /&gt;
! grantConsent&lt;br /&gt;
| User consent is granted for tracking.&lt;br /&gt;
|-&lt;br /&gt;
! revokeConsent&lt;br /&gt;
| User consent is revoked for tracking.&lt;br /&gt;
|-&lt;br /&gt;
! rejectConsent&lt;br /&gt;
| User consent is rejected for tracking.&lt;br /&gt;
|-&lt;br /&gt;
! error&lt;br /&gt;
| If one want to track errors this event may be used for that.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
===Custom events===&lt;br /&gt;
&lt;br /&gt;
Custom events may be defined, with arbitrary text data as parameters. One way to do so is to fire the customEvent event depicted in Figure 4. The event may hold up to 5 attributes: eventCategory, eventAction, eventProperty, eventLabel, eventValue. If You want to add custom properties to standard events You may do so by adding the “_” prefix to that particular event. This is denoted in Figure 5.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 4: Custom event tracking&#039;&#039;&#039;&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
// sample customData&lt;br /&gt;
var customData = {&lt;br /&gt;
    eventCategory: &#039;Video&#039;,&lt;br /&gt;
    eventAction: &#039;play&#039;,&lt;br /&gt;
    eventProperty: &#039;video&#039;,&lt;br /&gt;
    eventLabel: &#039;Fall Campaign&#039;,&lt;br /&gt;
    eventValue: 42        &lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
bat(&#039;track&#039;, &#039;customEvent&#039;, customData);&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Figure 5: Custom event tracking&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;&lt;br /&gt;
var contentViewProperties = {&lt;br /&gt;
        &#039;id&#039;: &#039;My blog page&#039;,&lt;br /&gt;
        &#039;contentType&#039;: &#039;Page&#039;,&lt;br /&gt;
        &#039;name&#039;: &#039;Very cool product&#039;,&lt;br /&gt;
        &#039;_mycustomparameter&#039;: 42&lt;br /&gt;
    }&lt;br /&gt;
&lt;br /&gt;
    bat(&#039;track&#039;, &#039;contentView&#039;, contentViewProperties);&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===Event Properties===&lt;br /&gt;
&lt;br /&gt;
Each event may hold a given set of parameters in order to describe a particular user action. In order to provide complete data some parameters are &#039;&#039;&#039;mandatory/required&#039;&#039;&#039; while some a &#039;&#039;&#039;optional&#039;&#039;&#039;. Properties are given to the event in a standard Javascript object with assigning each property (key) a value.&lt;br /&gt;
&lt;br /&gt;
A value has a value type. Some are primitive types like &#039;&#039;&#039;text, integer&#039;&#039;&#039; and &#039;&#039;&#039;float&#039;&#039;&#039; types and there are two compound types &#039;&#039;&#039;item_list&#039;&#039;&#039; and the &#039;&#039;&#039;address&#039;&#039;&#039; a value type. Only compound types are enforced with validation, primitive types are converted during validation and message sending implicitly if the value type is different from the required value type. Text values are truncated to 1024 characters. &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
====Standard properties====&lt;br /&gt;
&lt;br /&gt;
The table here shows all standard properties that are used throughout the tracking. Each property is context sensitive, which means only a handful of properties are needed in each event, and from those only some may be required.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 2: Standard properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! name&lt;br /&gt;
! type&lt;br /&gt;
! description&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| text&lt;br /&gt;
| SKU of product/id of article/the promotion ID/etc.&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| text&lt;br /&gt;
| The content type of the page visited. Possible values: Page/Product/Article/Promotion/Banner/Misc. Values here are enforced/validated.&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| text&lt;br /&gt;
| Full name of product/article/promotion etc (e.g. Android T-Shirt or e.g. Summer Sale)&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) when applicable.&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| text&lt;br /&gt;
| Brand part of product/brand described in name&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| text&lt;br /&gt;
| Array of categories of product/article/etc. If category is in tree structure, they must be separated with pipe (e.g. &amp;quot;clothes|coat|winter&amp;quot; or &amp;quot;clothes|coat|autumn&amp;quot;).&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the product (e.g. Black)&lt;br /&gt;
|-&lt;br /&gt;
! description&lt;br /&gt;
| text&lt;br /&gt;
| The detailed description of the item.&lt;br /&gt;
|-&lt;br /&gt;
! imageUrl&lt;br /&gt;
| text&lt;br /&gt;
| A URL pointing to an image that shows the item. E.g. the picture of the product&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| text&lt;br /&gt;
| The measurement unit of the item. (e.g. pcs, litre)&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| float&lt;br /&gt;
| Price of product (the price of one measurement unit of the item).&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| float&lt;br /&gt;
| The total price of the item.&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| text (ISO 4217 format)&lt;br /&gt;
| Currency of product. 3 digit ISO-4217 format is preferred.&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| integer&lt;br /&gt;
| The quantity of a product (e.g. 2)&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| item_list&lt;br /&gt;
| An array of item type JSON objects. For appropriate structure refer to Item definition in this chapter later. &lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| text&lt;br /&gt;
| The list or collection to which the product belongs (e.g. Search Results)&lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| text&lt;br /&gt;
| The product&#039;s position in a list or collection (e.g. 2) or the position of the creative (e.g. banner_slot_1)&lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| text&lt;br /&gt;
| The creative associated with the promotion (e.g. summer_banner2)&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| integer&lt;br /&gt;
| A number representing a step in the checkout process. Optional on checkout actions.&lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| text&lt;br /&gt;
| The transaction coupon code redeemed with the transaction.&lt;br /&gt;
|-&lt;br /&gt;
! orderNumber&lt;br /&gt;
| text&lt;br /&gt;
| Required if the action is purchase.&lt;br /&gt;
|-&lt;br /&gt;
! revenue&lt;br /&gt;
| float&lt;br /&gt;
| Specifies the total revenue or grand total associated with the transaction (e.g. 11.99). This value includes shipping, tax costs, or other adjustments to revenue that you want to include as part of your revenue calculations. Note: if revenue is not set, its value will be automatically calculated using the product quantity and price fields of all products in the same hit.&lt;br /&gt;
|-&lt;br /&gt;
! tax&lt;br /&gt;
| float&lt;br /&gt;
| The total tax associated with the transaction&lt;br /&gt;
|-&lt;br /&gt;
! shipping&lt;br /&gt;
| float&lt;br /&gt;
| The shipping cost associated with the transaction.&lt;br /&gt;
|-&lt;br /&gt;
! shippingAddress&lt;br /&gt;
| address&lt;br /&gt;
| This structure represents a shipping address related to a payment. See below the address type for the appropriate structure and syntax.&lt;br /&gt;
|-&lt;br /&gt;
! paymentMethod&lt;br /&gt;
| text&lt;br /&gt;
| Payment method of the purchase. E.g. Barion, PayPal, CashOnDelivery, Klarna&lt;br /&gt;
|-&lt;br /&gt;
! option&lt;br /&gt;
| text&lt;br /&gt;
| Additional field that can describe option information on the checkout page (e.g. delivery method)&lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| float&lt;br /&gt;
| The value of a user performing this event to the business.&lt;br /&gt;
|-&lt;br /&gt;
! searchString&lt;br /&gt;
| text&lt;br /&gt;
| In case of Search event. The string entered by the user for the search.&lt;br /&gt;
|-&lt;br /&gt;
! totalResults&lt;br /&gt;
| number&lt;br /&gt;
| Results found in case of a search&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====User Properties====&lt;br /&gt;
&lt;br /&gt;
For the &#039;&#039;&#039;setUserProperties&#039;&#039;&#039; event there are a custom set of properties that may be set when used.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 3: setUserProperties properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Key&lt;br /&gt;
! Value Type&lt;br /&gt;
! Description&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! userId&lt;br /&gt;
| text&lt;br /&gt;
| User Id&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! email&lt;br /&gt;
| text&lt;br /&gt;
| Email address. &#039;&#039;&#039;Hashed automatically for privacy purposes.&#039;&#039;&#039;&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! phone&lt;br /&gt;
| text&lt;br /&gt;
| Phone number ina format of IPF ()International Phone Number) eg. +1-541-754-3010. &#039;&#039;&#039;Hashed automatically for privacy purposes.&#039;&#039;&#039;&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! accountCreatedTime&lt;br /&gt;
| UNIX timestamp&lt;br /&gt;
| When the user account was created&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! country&lt;br /&gt;
| text&lt;br /&gt;
| The country in which the user lives. ISO 3166-1 alpha-2 codes are preferred.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! county&lt;br /&gt;
| text&lt;br /&gt;
| The county in which the user lives&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! city&lt;br /&gt;
| text&lt;br /&gt;
| The city in which the user lives&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! zipCode&lt;br /&gt;
| text&lt;br /&gt;
| The zip code of the user&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! gender&lt;br /&gt;
| text&lt;br /&gt;
| The gender of the user. Possible values: M - Male, F - Female&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! age&lt;br /&gt;
| integer&lt;br /&gt;
| Age of user&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| text (ISO 4217 format)&lt;br /&gt;
| The preferred currency of the user. 3 digit currency code required.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! language&lt;br /&gt;
| text (ISO 639-1)&lt;br /&gt;
| The preferred language of the user. 2 digit country code is required.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! interests&lt;br /&gt;
| text&lt;br /&gt;
| Lists the interests of the user (e.g., &amp;quot;Arts &amp;amp; Entertainment, Games, Sports&amp;quot;)&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! sessionId&lt;br /&gt;
| text&lt;br /&gt;
| Session Id&lt;br /&gt;
| NO&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====Item value type====&lt;br /&gt;
&lt;br /&gt;
The &#039;&#039;&#039;item_list&#039;&#039;&#039; is a compound value type that is comprised of &#039;&#039;&#039;item&#039;&#039;&#039; type Javascript objects in a standard Javascript array. Each element of the array have to conform to the following property list restrictions.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 4: The item value type properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Property name&lt;br /&gt;
! Property type&lt;br /&gt;
! Description&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| text&lt;br /&gt;
| SKU of product/id of article/the promotion ID/etc.&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| text&lt;br /&gt;
| Possible values: Product/Article/Promotion/Banner/Misc&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| text&lt;br /&gt;
| Full Name of product/article/promotion etc (e.g. Android T-Shirt or e.g. Summer Sale)&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| text&lt;br /&gt;
| Brand part of product/brand described in article&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| text&lt;br /&gt;
| Array of categories of product/article/etc. If category is in tree structure, they must be separated with pipe (e.g. &amp;quot;clothes|coat|winter&amp;quot; or &amp;quot;clothes|coat|autumn&amp;quot;).&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| text&lt;br /&gt;
| The measurement unit of the item.&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| float&lt;br /&gt;
| Price of product (the price of one measurement unit of the item).&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| float&lt;br /&gt;
| The total price of the item.&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| text (ISO 4217 format)&lt;br /&gt;
| Currency of product&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| integer&lt;br /&gt;
| The quantity of a product (e.g. 2)&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| text&lt;br /&gt;
| The variant of the product (e.g. Black)&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! description&lt;br /&gt;
| text&lt;br /&gt;
| The detailed description of the item.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! imageUrl&lt;br /&gt;
| text&lt;br /&gt;
| A URL pointing to an image that shows the item.&lt;br /&gt;
| NO&lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| text&lt;br /&gt;
| Contains the International Article Number (EAN) when applicable.&lt;br /&gt;
| NO&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====Address value type====&lt;br /&gt;
&lt;br /&gt;
The &#039;&#039;&#039;shippingAddress&#039;&#039;&#039; property is a compound value type with a specific set of properties. This is essentially a Javascript object with specified keys below. No keys are mandatory in this value type.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 5: The address value type properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Property name&lt;br /&gt;
! Property type&lt;br /&gt;
! Description&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! deliveryMethod&lt;br /&gt;
| text&lt;br /&gt;
| The delivery method, if applicable.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! country&lt;br /&gt;
| text&lt;br /&gt;
| The recipient&#039;s country code in ISO-3166-1 alpha-2 format.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! city&lt;br /&gt;
| text&lt;br /&gt;
| The complete name of the city of the recipient address.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! region&lt;br /&gt;
| text&lt;br /&gt;
| The region code of the recipient address in ISO-3166-2 format&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! zip&lt;br /&gt;
| text&lt;br /&gt;
| The zip code of the recipient address.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! street&lt;br /&gt;
| text&lt;br /&gt;
| The shipping street address with house number and other details.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! street2&lt;br /&gt;
| text&lt;br /&gt;
| The address, continued.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! fullName&lt;br /&gt;
| text&lt;br /&gt;
| The full civil or official name of the recipient.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
! phone&lt;br /&gt;
| text&lt;br /&gt;
| The phone number of the recipient.&lt;br /&gt;
| No&lt;br /&gt;
|-&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
===Events related to content browsing===&lt;br /&gt;
&lt;br /&gt;
A portion of all events are related to browsing through a Your webshop’s content: viewing pages, promotions, clicking on products and product details, customization of products, etc. These are specifically: &#039;&#039;&#039;contentView, clickProduct, clickProductDetail, customizeProduct, clickPromo&#039;&#039;&#039;. &lt;br /&gt;
All properties may be used in each event, where You find YES in te corresnponding table the property usage is mandatory. Only 3 properties are overall mandatory, these are: &#039;&#039;&#039;id, contentType and name&#039;&#039;&#039;. Please note that for the contentType property, you are only able to choose from a number of predefined values: Page, Product, Article, Promotion, Banner and Misc. The following table shows the property requirements for these.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 6: Properties of events related to content browsing&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!&lt;br /&gt;
!colspan = &amp;quot;5&amp;quot;| Event&lt;br /&gt;
|-&lt;br /&gt;
! Property&lt;br /&gt;
! contentView&lt;br /&gt;
! clickProduct&lt;br /&gt;
! clickProductDetail&lt;br /&gt;
! customizeProduct&lt;br /&gt;
! clickPromo&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES*&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES*&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES*&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| YES*&lt;br /&gt;
| YES&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| YES&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
! &lt;br /&gt;
|colspan = &amp;quot;5&amp;quot;| * Required only in case of Product type when using the contentView event.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
===Purchase related events===&lt;br /&gt;
&lt;br /&gt;
These events refer to purchase intentions and effective checkouts and purchases. These events also share a number of common properties. &lt;br /&gt;
&lt;br /&gt;
====addToCart/removeFromCart====&lt;br /&gt;
&lt;br /&gt;
Both events have the same event set and the required properties are the same as well.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 7: addToCart/removeFromCart event properties&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Property&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| &lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====initiateCheckout, addPaymentInfo, initiatePurchase, purchase====&lt;br /&gt;
&lt;br /&gt;
These events refer to checkout and payment info change user events. The allowed properties are generally the same with only one exception: the &#039;&#039;&#039;paymentMethod&#039;&#039;&#039; property is only allowed in the &#039;&#039;&#039;addPaymentInfo&#039;&#039;&#039; event, in other events it is unavailable. &lt;br /&gt;
&lt;br /&gt;
Generally two properties are mandatory throughout all events in this particular group: &#039;&#039;&#039;contents&#039;&#039;&#039; and &#039;&#039;&#039;step&#039;&#039;&#039;, referring to the items in the basket and the step in the buying process. After checkout is initiated the &#039;&#039;&#039;revenue&#039;&#039;&#039; and &#039;&#039;&#039;currency&#039;&#039;&#039; also becomes mandatory property.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 8: Properties of initiateCheckout, addPaymentInfo, initiatePurchase and purchase events&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!&lt;br /&gt;
!colspan=&amp;quot;4&amp;quot;|event&lt;br /&gt;
|-&lt;br /&gt;
! Property&lt;br /&gt;
! initiateCheckout&lt;br /&gt;
! addPaymentInfo&lt;br /&gt;
! initiatePurchase&lt;br /&gt;
! purchase&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! step&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! paymentMethod&lt;br /&gt;
| UNAVAILABLE&lt;br /&gt;
| YES&lt;br /&gt;
| UNAVAILABLE&lt;br /&gt;
| UNAVAILABLE&lt;br /&gt;
|-&lt;br /&gt;
! revenue&lt;br /&gt;
| &lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| &lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! coupon&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! creative&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! description&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! imageUrl&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! list&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! option&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! orderNumber&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! position&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! quantity&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! shipping&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! shippingAddress&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! tax&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
| &lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====Search event====&lt;br /&gt;
&lt;br /&gt;
For product search event tracking one can use the search event. The parameters here are all optional except for one: that is the &#039;&#039;&#039;searchString&#039;&#039;&#039;. The following tables lists all allowed properties for this particular event.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 9: Properties of search event&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Key&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! searchString&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! totalResults&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| &lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
====signUp event====&lt;br /&gt;
&lt;br /&gt;
Upon user signup one may fire the signUp event to record signups for theri webshop. All but three properties are optional. Mandatory properties are: &#039;&#039;&#039;id&#039;&#039;&#039;, &#039;&#039;&#039;contentType&#039;&#039;&#039; and &#039;&#039;&#039;name&#039;&#039;&#039;. Other attributes are denoted in the following table.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Table 10: Properties of signUp event&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Key&lt;br /&gt;
! Required&lt;br /&gt;
|-&lt;br /&gt;
! contentType&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! id&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! name&lt;br /&gt;
| YES&lt;br /&gt;
|-&lt;br /&gt;
! contents&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! customerValue&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! currency&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! ean&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! brand&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! category&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! variant&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! unit&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! unitPrice&lt;br /&gt;
| &lt;br /&gt;
|-&lt;br /&gt;
! totalItemPrice&lt;br /&gt;
| &lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Baloghn</name></author>
	</entry>
</feed>