Barion-pixel-event-reference: Difference between revisions

From Barion Documentation
Jump to navigation Jump to search
m (added link to setEncryptedEmail)
m (linked to removeFromCart event page)
 
(13 intermediate revisions by the same user not shown)
Line 1: Line 1:
__NOTOC__
{{PageTitle|title= Barion Pixel event reference}}


= Barion Pixel event reference =
{| style="margin-left:2em;" align="right"
| __TOC__
|}


== Required Barion Pixel event handlers ==
== Required Barion Pixel event handlers ==
Line 10: Line 14:
[[setEncryptedEmail]]
[[setEncryptedEmail]]


setEncryptedPhone
[[setEncryptedPhone]]


contentView
[[contentView]]


addToCart
[[addToCart]]


initiateCheckout
[[initiateCheckout]]


initiatePurchase
[[initiatePurchase]]


purchase
[[purchase]]


categorySelection
[[categorySelection]]


search
[[search]]


addPaymentInfo
[[addPaymentInfo]]


removeFromCart
[[removeFromCart]]


== Recommended Barion Pixel event handlers ==
== Recommended Barion Pixel event handlers ==
Line 48: Line 52:
== Special types ==
== Special types ==


=== Custom events and properties ===
<h3 id="custom-events-and-properties">Custom events and properties</h3>


You can define your own custom events or properties, and include them in the Barion Full Pixel implementation.
You can define your own custom events or properties, and include them in the Barion Full Pixel implementation.
Line 94: Line 98:
A custom property can be passed to any standard Barion Full Pixel event.
A custom property can be passed to any standard Barion Full Pixel event.


=== content ===
<h3 id="content-object">content</h3>


{| class="wikitable"
{| class="wikitable"
Line 169: Line 173:
|
|
|-
|-
|ean
!ean
|string
|string
|The item's [https://www.ean-search.org/ International Article Number (EAN)].
|The item's [https://www.ean-search.org/ International Article Number (EAN)].
Line 188: Line 192:
|}
|}


=== address ===
<h3 id="address">address</h3>


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

Latest revision as of 10:04, 23 May 2024

Barion Pixel event reference

Required Barion Pixel event handlers

grantConsent

rejectConsent

setEncryptedEmail

setEncryptedPhone

contentView

addToCart

initiateCheckout

initiatePurchase

purchase

categorySelection

search

addPaymentInfo

removeFromCart

Recommended Barion Pixel event handlers

customizeProduct

setUserProperties

signUp

clickPromo

clickProduct

clickProductDetail

error

Special types

Custom events and properties

You can define your own custom events or properties, and include them in the Barion Full Pixel implementation.

Custom events

Anything you'd like to track about your customers' behavior on your webshop that the existing Barion Pixerl events don't cover.

Name Data type Description Required?
_eventAction string The user's action on the site. yes
_eventCategory string The self-defined categor for the event, such as "user_settings". no
_eventLabel string The label you associate with the event, such as "language_selection". no
_eventProperty string The custom property passed with the event's handler, such as "unit_format". no
_eventValue string The value of the event's custom property, such as "inches". no

Custom properties

The names of custom properties need to start with an underscore (_).

A custom property can be passed to any standard Barion Full Pixel event.

content

Name Data type Description Required? Note
contentType One of the following string options: "Page", "Product", "Article", "Promotion", "Banner", "Misc" The type of page that triggered the event. yes In case this is an item listing page, pass "Product". Otherwise, select the option that best matches the type of page. See the event's list property also.
currency string (ISO 4217 currency code) The currency that the associated item's price is listed in. yes Required if "contentType": "Product"
id string A unique identifier for the item associated with the event. yes
name string The full name associated with the item associated with the event.
Make sure that you use the same name across Barion Pixel events for the same item or promotional material.
yes
quantity float The quantity that is displayed on the page for the item on sale. yes Required if "contentType": "Product"
totalItemPrice float The total price of the item or items added to the cart, in the specified currency. yes
unit string The associated item's unit (e.g. piece, set, liter). yes Required if "contentType": "Product"
unitPrice float The price of a single unit of the item for sale, in the currency property. yes Required if "contentType": "Product"
brand string The item's brand. no
category string -separated subcategory chain (e.g. "clothes|shoes|winter") or the single category (e.g. "winter shoes") of the item for sale. no
description string A detailed description of the item. no
ean string The item's International Article Number (EAN). no
imageUrl string The URL of the item's image. no
variant string The variant of the item on sale that distinguishes it from other similar items (such as color, material, or time and date). no

address

Name Data type Description Required? Note
city string The full name of the recipient's city. no
countrry an ISO-3166-1 alpha-2 compliant string The recipient's country code. no
deliveryMethod string The method of delivery, if applicable. no
fullName string The recipient's legal name. no
phone string The recipient's phone number no
region an ISO-3166-2 compliant string The recipient's region code. no
street string The recipient's street address, including building number and street name. no
street2 string Further details in the recipient's street address (floor, door, bell, etc.). no
zipCode string The recipient's postal code. no