Page Comparison

Product View

Method Objective

Status

colour	Yellow
title	required

The method gives the system an understanding of the product viewed by the user.

Syntax and parameters

Code Block

language	java
theme	FadeToGrey

Params view = new Params();
view
    .put(new Params.Item(product_id))
    .put(new Params.RecommendedBy(Params.RecommendedBy.TYPE.RECOMMENDATION, recommeder_code));
PersonaClick.track(Params.TrackEvent.VIEW, view);

NameTypeRequirementDescriptionproduct_idstringrequiredThe ID of the current productrecommender_codestringrequired is some casesThis property should have a unique code for the product recommendations block if the current product was opened from the recommendation block. The unique code is available in the PersonaClick account in the "data-recommender-code" attribute of each block.

Example of use

Code Block

language	java
theme	FadeToGrey

Params view = new Params();
view
    .put(new Params.Item("100500"))
    .put(new Params.RecommendedBy(Params.RecommendedBy.TYPE.RECOMMENDATION, "b934b6ba2eb6202b8922d6a3fb8b3271"));
PersonaClick.track(Params.TrackEvent.VIEW, view);

Category View

Method Objective

Status

colour	Yellow
title	required

The method gives the system an understanding of the category viewed by the user.

Warning
The API will respond with an error for categories unknown to the system. The system only knows the categories from the product feed (XML) or the HTTP import of the category list.

Syntax and parameters

Code Block

language	java
theme	FadeToGrey

PersonaClick.track(Params.TrackEvent.CATEGORY, (new Params()).put(Params.Parameter.CATEGORY_ID, category_id));

NameTypeRequirementDescriptioncategory_idstringrequiredThe ID of the current category.

Example of use

Code Block

language	java
theme	FadeToGrey

PersonaClick.track(Params.TrackEvent.CATEGORY, (new Params()).put(Params.Parameter.CATEGORY_ID, "146"));

Adding a product to the cart

Product View

Method Objective

Status

colour	Yellow
title	required

The method gives the system an understanding of the product added to the cart viewed by the user.

Syntax and parameters

Code Block

language	java
theme	FadeToGrey

Params cartview = new Params();
view
 cart   	.put(new Params.Item(product_id)
		.set(Params.Item.COLUMN.FASHION_SIZE, fashion_size)
		.set(Params.Item.COLUMN.AMOUNT, amount)
	)
	)
    .put(new Params.RecommendedBy(Params.RecommendedBy.TYPE.RECOMMENDATION{type}, recommendertype_codevalue));
PersonaClick.track(Params.TrackEvent.CARTVIEW, cartview);

added to the cart for current product was added to the cart recommendation

Name	Type	Requirement	Description
product_id	string	required	The ID of the current product
amount	string	optionally	Quantity of product. Default: 1.
fashion_size	string	optionally	The parameter allows specifying the size of the product related to the Apparel & Accessories niche.
recommender_code	string	required in some cases	This property
{type}	string	required is some cases	Types of recommendation source. Available values (case sensitive): RECOMMENDATION - if the currently viewed product is from the recommendations widget INSTANT_SEARCH - if the currently viewed product is from the Instant Search widget FULL_SEARCH - if the currently viewed product is from the Full Search page
type_value	string	required is some cases	This parameter can contain one of the values: This parameter should have a unique code	of the product recommendations block if the	currently viewed product is from the	recommendations block. The unique code is available in the PersonaClick account in the "data-recommender-code" attribute of each block.

Example

This parameter should have a search query in the value if the product is viewed from the Instant or Full Search tool.

Examples of use

Code Block

language	java
theme	FadeToGrey

Params cart = new Params();
cart
	.put(new Params.Item("100500")
		.set(Params.Item.COLUMN.FASHION_SIZE, "M")
		.set(Params.Item.COLUMN.AMOUNT, 2)
	)
	// from a recommender widget
Params view = new Params();
view
    .put(new Params.RecommendedBy(Params.RecommendedBy.TYPE.RECOMMENDATION, "b934b6ba2eb6202b8922d6a3fb8b3271Item("100500"));
PersonaClick.track(Params.TrackEvent.CART, cart);

Removing a product from the cart

Method Objective

Status

colour	Yellow
title	required

The method gives the system an understanding of the product removed from the cart by the user.

Syntax and parameters

Code Block

language	applescript
theme	FadeToGrey

sdk.track(event: .productRemovedFromCart(id: product_id)) { callback }

NameTypeRequirementDescriptionproduct_idstringrequiredThe ID of the product removed from the cartcallbackfunctionoptionallyCallback function to catch success or error

Example of use

Code Block

language	applescript
theme	FadeToGrey

sdk.track(event: .productRemovedFromCart(id: "100500")) { trackResponse in
    print("Product removed from the cart callback")
    switch trackResponse {
        case let .success(response):
            print("Successful")
        case let .failure(error):
            switch error {
                case .custom(let customError):
                    print("Error: ", customError)
                default:
                    print("Error: ", error.localizedDescription)
            }
            fatalError("Task failed successfully")
    }
}

Update the current cart

Method Objective

The method updates the whole cart on the system side.

Tip
Use this method when the user, for example, changes the quantity of a product in the cart or completely purges the cart. Also, this method can be used as an alternative to the "Add to cart" and "Remove from cart" methods if you have access to the entire cart when these events occur for a specific product.

Syntax and parameters

Code Block

language	applescript
theme	FadeToGrey

sdk.track(event: .synchronizeCart(ids: product_ids)) { callback }

NameTypeRequirementDescriptionproduct_idsarrayrequiredThe ID of the product in the cartcallbackfunctionoptionallyCallback function to catch success or error

Example of use

Code Block

language	applescript
theme	FadeToGrey

sdk.track(event: .synchronizeCart(ids: ["146", "100500", "12345"])) { trackResponse in
    print("Cart synchronized callback")
    switch trackResponse {
        case let .success(response):
            print("Successful")
        case let .failure(error):
            switch error {
                case .custom(let customError):
                    print("Error: ", customError)
                default:
                    print("Error: ", error.localizedDescription)
            }
            fatalError("Task failed successfully")
    }
}

Successful checkout

Method Objective

Status

colour	Yellow
title	required

The method gives the system information about the successful checkout, its products, and other information related to the checkout.

Syntax and parameters

Code Block

language	applescript
theme	FadeToGrey

sdk.track(event: .orderCreated(orderId, totalValue, products)) { callback }

Request parameters

NameTypeRequirementDescriptionproductsarrayrequiredAn array of purchased products. See the table below for details.orderIdstringoptionallyInternal store Order ID. If not specified, the system will create its internal ID. Synchronization of order statuses, in this case, won't be available.totalValuenumberoptionallyThe final order value, including all discounts. If not specified, the system will calculate the order value based on prices from the product feed.

Product properties:

NameTypeRequirementDiscriptionidstringrequiredProduct ID.amountnumberrequiredProduct Quantity.

Example of use

Code Block

language	applescript
theme	FadeToGrey

sdk.track(event: .orderCreated(orderId: "N100500", totalValue: 750, products: [(id: "37", amount: 3), (id: "187", amount: 1)])) { trackResponse in
    print("Order is created callback")
    switch trackResponse {
        case let .success(response):
            print("Successful")
        case let .failure(error):
            switch error {
                case .custom(let customError):
                    print("Error: ", customError)
                default:
                    print("Error: ", error.localizedDescription)
            }
            fatalError("Task failed successfully")
    }
}

Adding a product to the wishlist

Method Objective

The method gives the system an understanding the user has added a product to the wishlist.

Syntax and parameters

Code Block

language	applescript
theme	FadeToGrey

sdk.track(event: .productAddedToFavorities(id: product_id)) { callback }

NameTypeRequirementDescriptionproduct_idstringrequiredThe ID of the product added to the wishlistcallbackfunctionoptionallyCallback function to catch success or error

Example of use

Code Block

language	applescript
theme	FadeToGrey

sdk.track(event: .productAddedToFavorities(id: "100500")) { trackResponse in
    print("Product added to the wishlist callback")
    switch trackResponse {
        case let .success(response):
            print("Successful")
        case let .failure(error):
            switch error {
                case .custom(let customError):
                    print("Error: ", customError)
                default:
                    print("Error: ", error.localizedDescription)
            }
            fatalError("Task failed successfully")
    }
}

Removing a product from the wishlist

Method Objective

The method gives the system an understanding the user has removed a product from the wishlist.

Syntax and parameters

Code Block

language	applescript
theme	FadeToGrey

sdk.track(event: .productRemovedToFavorities(id: product_id)) { callback }

NameTypeRequirementDescriptionproduct_idstringrequiredThe ID of the product removed from the wishlistcallbackfunctionoptionallyCallback function to catch success or error

Example of use

Code Block

language	applescript
theme	FadeToGrey

sdk.track(event: .productRemovedToFavorities(id: "100500")) { trackResponse in
    print("Product removed from the wishlist callback")
    switch trackResponse {
        case let .success(response):
            print("Successful")
        case let .failure(error):
            switch error {
                case .custom(let customError):
                    print("Error: ", customError)
                default:
                    print("Error: ", error.localizedDescription)
            }
            fatalError("Task failed successfully")
    }
}

Custom event

Method Objective

The method gives the system an understanding that some user event has happened.

Note
Before you can use custom events, you must create them in the PersonaClick account: Settings > Custom events.

Syntax and parameters

Code Block

language	applescript
theme	FadeToGrey

sdk.trackEvent(event: custom_event_key, category, label, value)

NameTypeRequirementDescriptioncustom_event_keystringrequiredUnique custom event key. Must be pre-created in the PersonaClick account: Settings > Custom events.categorystringoptionallyA category is a name that you supply as a way to group some event's properties.labelstringoptionallyWith labels, you can provide additional information for events that you need.valuenumberoptionallyThe value property can be any integer and can be used to send a specific value in an event.Examples

    .put(new Params.RecommendedBy(Params.RecommendedBy.TYPE.RECOMMENDATION, "b934b6ba2eb6202b8922d6a3fb8b3271"));
PersonaClick.track(Params.TrackEvent.VIEW, view);

// from the Instant Search
Params view = new Params();
view
	.put(new Params.Item("146"))
	.put(new Params.RecommendedBy(Params.RecommendedBy.TYPE.INSTANT_SEARCH, "shoes"));
PersonaClick.track(Params.TrackEvent.VIEW, view);

// from the Full Search
Params view = new Params();
view
	.put(new Params.Item("1978"))
	.put(new Params.RecommendedBy(Params.RecommendedBy.TYPE.FULL_SEARCH, "jacket"));
PersonaClick.track(Params.TrackEvent.VIEW, view);

Category View

Method Objective

Status

colour	Yellow
title	required

The method gives the system an understanding of the category viewed by the user.

Warning
The API will respond with an error for categories unknown to the system. The system only knows the categories from the product feed (XML) or the HTTP import of the category list.

Syntax and parameters

Code Block

language	java
theme	FadeToGrey

PersonaClick.track(Params.TrackEvent.CATEGORY, (new Params()).put(Params.Parameter.CATEGORY_ID, category_id));

Name	Type	Requirement	Description
category_id	string	required	The ID of the current category.

Example of use

Code Block

language	java
theme	FadeToGrey

PersonaClick.track(Params.TrackEvent.CATEGORY, (new Params()).put(Params.Parameter.CATEGORY_ID, "146"));

Adding a product to the cart

Method Objective

Status

colour	Yellow
title	required

The method gives the system an understanding of the product added to the cart by the user.

Syntax and parameters

Code Block

language	java
theme	FadeToGrey

Params cart = new Params();
cart
	.put(new Params.Item(product_id)
		.set(Params.Item.COLUMN.AMOUNT, amount)
	)
	.put(new Params.RecommendedBy(Params.RecommendedBy.TYPE.{type}, type_value));
PersonaClick.track(Params.TrackEvent.CART, cart);

Name

Type

Requirement

Description

product_id

string

required

The ID of the product added to the cart

amount

string

optionally

The total value of the amount of product added to the cart. Default: 1.

Tip

For example:

A user has added the current product to the cart in the amount of 3 pieces. The request should have the "amount" value of 3.
Then the user decides to add 2 more pieces of the current product (bringing the total to 5). The second request should have the "amount" value of 5.

{type}

string

required in some cases

Types of recommendation source. Available values (case sensitive):

RECOMMENDATION - if the currently added to cart product is from the recommendations widget
INSTANT_SEARCH - if the currently added to cart product is from the Instant Search widget
FULL_SEARCH - if the currently added to cart product is from the Full Search page

type_value

string

required in some cases

This parameter can contain one of the values:

This parameter should have a unique code of the product recommendations block if the currently added to cart product is from the recommendations block. The unique code is available in the PersonaClick account in the "data-recommender-code" attribute of each block.
This parameter should have a search query in the value if the product is added to cart from the Instant or Full Search tool.

Examples of use

Code Block

language	java
theme	FadeToGrey

// from a recommender widget
Params cart = new Params();
cart
	.put(new Params.Item("100500")
		.set(Params.Item.COLUMN.AMOUNT, 2)
	)
	.put(new Params.RecommendedBy(Params.RecommendedBy.TYPE.RECOMMENDATION, "b934b6ba2eb6202b8922d6a3fb8b3271"));
PersonaClick.track(Params.TrackEvent.CART, cart);

// from the Instant Search
Params cart = new Params();
cart
	.put(new Params.Item("146")
		.set(Params.Item.COLUMN.AMOUNT, 3)
	)
	.put(new Params.RecommendedBy(Params.RecommendedBy.TYPE.INSTANT_SEARCH, "shoes"));
PersonaClick.track(Params.TrackEvent.CART, cart);

// from the Full Search
Params cart = new Params();
cart
	.put(new Params.Item("1978")
		.set(Params.Item.COLUMN.AMOUNT, 1)
	)
	.put(new Params.RecommendedBy(Params.RecommendedBy.TYPE.FULL_SEARCH, "jacket"));
PersonaClick.track(Params.TrackEvent.CART, cart);

Removing a product from the cart

Method Objective

Status

colour	Yellow
title	required

The method gives the system an understanding of the product removed from the cart by the user.

Syntax and parameters

Code Block

language	java
theme	FadeToGrey

PersonaClick.track(Params.TrackEvent.REMOVE_FROM_CART, product_id);

Name	Type	Requirement	Description
product_id	string	required	The ID of the product removed from the cart

Example of use

Code Block

language	java
theme	FadeToGrey

PersonaClick.track(Params.TrackEvent.REMOVE_FROM_CART, "100500");

Update the current cart

Method Objective

Status


colour	Yellow
title	required

The method updates the whole cart on the system side.

Note
This method is required for use on the cart page when the user does certain actions there: when the user visits the page, changes the quantity of a product in the cart, removes a product from the cart, or clears the cart completely.

Tip
This method can be used on the product page as an alternative to the "Add to cart" and "Remove from cart" methods if you have access to the entire cart on the product page.

Syntax and parameters

Code Block

language	applescript
theme	FadeToGrey

Params full_cart = new Params();
full_cart
    .put(Params.Parameter.FULL_CART, true)
    .put(new Params.Item(product_id)
        .set(Params.Item.COLUMN.AMOUNT, amount)
    )
    .put(new Params.Item(product_id)
        .set(Params.Item.COLUMN.AMOUNT, amount)
    );
PersonaClick.track(Params.TrackEvent.CART, full_cart);

Name	Type	Requirement	Description
product_id	string	required	The ID of the product added to the cart
amount	string	optionally	Quantity of product. Default: 1.

Example of use

Code Block

language	applescript
theme	FadeToGrey

Params full_cart = new Params();
full_cart
    .put(Params.Parameter.FULL_CART, true)
    .put(new Params.Item("146")
        .set(Params.Item.COLUMN.AMOUNT, 2)
    )
    .put(new Params.Item("100500")
        .set(Params.Item.COLUMN.AMOUNT, 3)
    );
PersonaClick.track(Params.TrackEvent.CART, full_cart);

Successful checkout

Method Objective

Status

colour	Yellow
title	required

The method gives the system information about the successful checkout, its products, and other information related to the checkout.

Syntax and parameters

Code Block

language	java
theme	FadeToGrey

Params purchase = new Params();
purchase
	.put(new Params.Item(product_id).set(Params.Item.COLUMN.AMOUNT, amount).set(Params.Item.COLUMN.PRICE, price))
	.put(Params.Parameter.ORDER_ID, order_id)
	.put(Params.Parameter.ORDER_PRICE, order_price)
    .put(Params.Parameter.DELIVERY_ADDRESS, delivery_address)
    .put(Params.Parameter.DELIVERY_TYPE, delivery_type)
    .put(Params.Parameter.PROMOCODE, promocode)
    .put(Params.Parameter.PAYMENT_TYPE, payment_type)
    .put(Params.Parameter.TAX_FREE, tax_free);
PersonaClick.track(Params.TrackEvent.PURCHASE, purchase);

Request parameters

Name

Type

Requirement

Description

product_id

string

required

Product ID

amount

number

required

Product quantity

price

number

optionally

Product price

order_id

string

optionally

Internal store Order ID. If not specified, the system will create its internal ID. Synchronization of order statuses, in this case, won't be available.

Note
Please note that order IDs in UUID format aren't displayed in the dashboard. Instead of UUDI, "---" will be displayed. To avoid this, add any prefix to this.

order_price

number

optionally

The final order value, including all discounts. If not specified, the system will calculate the order value based on prices from the product feed.

delivery_address

string

optionally

Delivery address. Any text.

delivery_type

string

optionally

Delivery Type, e.g. "courier", "self_pickup", "delivery", "pickup_point", etc.

promocode

string

optionally

Promo code that was used.

Tip
If a promo code from the list uploaded to the account has been used, it'll be marked as used.

payment_type

string

optionally

Payment method. Any string value. For example: "cash", "card", "wire".

tax_free

boolean

optionally

It sets whether the order was placed with Tax-Free or not.

Example of use

Code Block

language	java
theme	FadeToGrey

Params purchase = new Params();
purchase
	.put(new Params.Item("37").set(Params.Item.COLUMN.AMOUNT, 3).set(Params.Item.COLUMN.PRICE, 140.55))
	.put(new Params.Item("187").set(Params.Item.COLUMN.AMOUNT, 1).set(Params.Item.COLUMN.PRICE, 328.35))
	.put(Params.Parameter.ORDER_ID, "N100500")
	.put(Params.Parameter.ORDER_PRICE, 750)
	.put(Params.Parameter.PROMOCODE, "BIRTHDAY")
	.put(Params.Parameter.DELIVERY_TYPE, "delivery")
	.put(Params.Parameter.PAYMENT_TYPE, "cart");
PersonaClick.track(Params.TrackEvent.PURCHASE, purchase);

Search Request

Method Objective

The method gives the system an understanding of the user's search queries.

Syntax and parameters

Code Block

language	java
theme	FadeToGrey

PersonaClick.track(Params.TrackEvent.SEARCH, new Params().put(Params.Parameter.SEARCH_QUERY, search_query));

Request parameters

Name	Type	Requirement	Description
search_query	string	required	Search query phrase.

Example of use

Code Block

language	java
theme	FadeToGrey

PersonaClick.track(Params.TrackEvent.SEARCH, new Params().put(Params.Parameter.SEARCH_QUERY, "to be or not to be"));

Adding a product to the wishlist

Method Objective

The method gives the system an understanding the user has added a product to the wishlist.

Syntax and parameters

Code Block

language	java
theme	FadeToGrey

PersonaClick.track(Params.TrackEvent.WISH, product_id);

Name	Type	Requirement	Description
product_id	string	required	The ID of the product added to the wishlist

Example of use

Code Block

language	java
theme	FadeToGrey

PersonaClick.track(Params.TrackEvent.WISH, "100500");

Removing a product from the wishlist

Method Objective

The method gives the system an understanding the user has removed a product from the wishlist.

Syntax and parameters

Code Block

language	java
theme	FadeToGrey

PersonaClick.track(Params.TrackEvent.REMOVE_FROM_WISH, product_id);

Name	Type	Requirement	Description
product_id	string	required	The ID of the product removed from the wishlist

Example of use

Code Block

language	java
theme	FadeToGrey

PersonaClick.track(Params.TrackEvent.REMOVE_FROM_WISH, "100500");

Update the current wishlist

Method Objective

The method updates the whole wishlist on the system side.

Syntax and parameters

Code Block

language	applescript
theme	FadeToGrey

Params full_wish = new Params();
full_wish
    .put(Params.Parameter.FULL_WISH, true)
    .put(new Params.Item(product_id))
    .put(new Params.Item(product_id));
PersonaClick.track(Params.TrackEvent.WISH, full_wish);

Name	Type	Requirement	Description
product_id	string	required	The ID of the product added to the wish

Example of use

Code Block

language	applescript
theme	FadeToGrey

sdk.trackEvent(event: "my_event")

Code Block

language	applescript
theme	FadeToGrey

sdk.trackEvent(event: "my_event", category: "my_category", label: "my_label", value: 100500)

Source Tracking

Params full_wish = new Params();
full_wish
    .put(Params.Parameter.FULL_WISH, true)
    .put(new Params.Item("146"))
    .put(new Params.Item("100500"));
PersonaClick.track(Params.TrackEvent.WISH, full_wish);

Custom event

Method Objective

The method gives the system an understanding that the user jumped from the campaign message: bulk, chain, transactionalsome user event has happened.

Note
Before you can use custom events, you must create them in the PersonaClick account: Settings > Custom events.

Syntax and parameters

Code Block

language	applescriptjava
theme	FadeToGrey

sdkPersonaClick.trackSource(sourcetrack(custom_event_key, category, label, codevalue);

Unique campaign code

Name

Type

Requirement

Description

sourcecustom_event_key

enum string

required

One of the string enum values. Available values:

.bulk
.chain
.transactional

Tip
The "src.type" value in the "payload" of the campaign should be used to define the value for this parameter. See Payload Examples.

code

string

required

Tip
The "src.id" value in the "payload" of the campaign should be used to define the value for this parameter. See Payload Examples.

Example of use

Code Block

language	applescript
theme	FadeToGrey

sdk.trackSource(source: .chain, code: "100500146")

Unique custom event key. Must be pre-created in the PersonaClick account: Settings > Custom events.
category	string	optionally	A category is a name that you supply as a way to group some event's properties.
label	string	optionally	With labels, you can provide additional information for events that you need.
value	number	optionally	The value property can be any integer and can be used to send a specific value in an event.

Examples of use

Code Block

language	java
theme	FadeToGrey

PersonaClick.track("my_event");

Code Block

language	java
theme	FadeToGrey

PersonaClick.track("my_event", "my_category", "my_label", 100500);

Column

Page Navigation

Table of Contents

maxLevel	2

minLevel

indent

2

0px
style	none

Related Pages

dics

Filter by label (Content by label)

classpersonaclick-fixed-positionprintablefalse

showLabels	false
showSpace	false
sort	title
cql	label = "tracking"

Page Comparison

Versions Compared

Old Version 7

New Version Current

Key

Product View

Method Objective

Syntax and parameters

Example of use

Category View

Method Objective

Syntax and parameters

Example of use

Product View

Method Objective

Syntax and parameters

Examples of use

Removing a product from the cart

Method Objective

Syntax and parameters

Example of use

Update the current cart

Method Objective

Example of use

Successful checkout

Method Objective

Syntax and parameters

Request parameters

Example of use

Adding a product to the wishlist

Method Objective

Syntax and parameters

Example of use

Removing a product from the wishlist

Method Objective

Syntax and parameters

Example of use

Custom event

Method Objective

Syntax and parameters

Category View

Method Objective

Syntax and parameters

Example of use

Adding a product to the cart

Method Objective

Syntax and parameters

Examples of use

Removing a product from the cart

Method Objective

Syntax and parameters

Example of use

Update the current cart

Method Objective

Example of use

Successful checkout

Method Objective

Syntax and parameters

Request parameters

Example of use

Search Request

Method Objective

Syntax and parameters

Request parameters

Example of use

Adding a product to the wishlist

Method Objective

Syntax and parameters

Example of use

Removing a product from the wishlist

Method Objective

Syntax and parameters

Example of use

Update the current wishlist

Method Objective

Syntax and parameters

Example of use

Custom event

Method Objective

Syntax and parameters