Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Product View
Method Objective
Product View
Method Objective
Status | ||||||
---|---|---|---|---|---|---|
|
Syntax and parameters
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("view", params); |
Name | Type | Requirement | Description |
---|---|---|---|
params | Object | required | Object with request parameters. |
Request parameters
Name | Type | Requirement | Description | ||||
---|---|---|---|---|---|---|---|
id | number/string | required | The ID of the current product. | stock | boolean | optionally | Availability of the current product for purchase. |
recommended_by | string | required in some cases | If used, the value must be one of:
See examples below. | ||||
recommended_code | string | required in some cases | If used, the value must be one of:
See examples below. |
Examples of use
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("view", {
id: "100500",
stock: true,
recommended_by: "dynamic",
recommended_code: "c6d2fe5fdca0c8e51d10b07523bc07"
}); |
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("view", { id: "146", stockrecommended_by: false, recommended_by: "instant_search", recommended_code: "mobile pho" }); |
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("view", {
id: "100500",
stock: true,
recommended_by: "full_search",
recommended_code: "mobile phone 5G"
}); |
Category View
Method Objective
Status | ||||||
---|---|---|---|---|---|---|
|
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 | ||||
---|---|---|---|---|
| ||||
pcsdk.track("category", id); |
Request parameters
Name | Type | Requirement | Description |
---|---|---|---|
id | number/string | required | The ID of the current category. |
Example of use
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("category", "146"); |
Adding a product to the cart
Method Objective
Status | ||||||
---|---|---|---|---|---|---|
|
Syntax and parameters
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("cart", params); |
Name | Type | Requirement | Description |
---|---|---|---|
params | Object | required | Object with request parameters. |
Request parameters
Name | Type | Requirement | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id | number/string | required | The ID of the product added to the cart. | ||||||||||
amount | number | optionally | Quantity The total value of the amount of product added to the cart. Default: 1. | stock
| boolean | optionally | Availability of the current product for purchase. | recommended_by | string | required in some cases |
| ||
recommended_by | string | required in some cases | If used, the value must be one of:
See examples below. | ||||||||||
recommended_code | string | required in some cases | If used, the value must be one of:
See examples below. |
Examples of use
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("cart", { id: "100500", amount: 3, stock: true, recommended_by: "dynamic", recommended_code: "c6d2fe5fdca0c8e51d10b07523bc07" }); |
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("cart", { id: "100500", amount: 3, stock: true, recommended recommended_by: "instant_search", recommended_code: "mobile pho" }); |
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("cart", { id: "100500", amount: 3, stock: true, recommended_by: "full_search", recommended_code: "mobile phone 5G" }); |
Removing a product from the cart
Method Objective
Status | ||||||
---|---|---|---|---|---|---|
|
Syntax and parameters
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("remove_from_cart", id); |
Request parameters
Name | Type | Requirement | Description |
---|---|---|---|
id | number/string | required | The ID of the product removed from the cart. |
Example of use
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("remove_from_cart", "100500"); |
Update the current cart
Method Objective
TheStatus | ||||||
---|---|---|---|---|---|---|
|
Tipnote |
---|
Use this method This method is required for use on the cart page when the user , for example, does certain actions there: when the user visits the page, changes the quantity of a product in the cart or completely purges , removes a product from the cart, or clears the cart . Also, this 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 when these events occur for a specific producton the product page. |
Syntax and parameters
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("cart", params); |
Name | Type | Requirement | Description |
---|---|---|---|
params | Object array | required | Object array with request parameters. |
Request parameters
Each object in the array can contain the following properties.
Name | Type | Requirement | Description |
---|---|---|---|
id | number/string | required | The ID of the product in the cart. |
amount | number | optionally | Quantity of the product. |
Example of use
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("cart", [ { id: "100500", amount: 3 }, { id: "146", amount: 1 } ]); |
Successful checkout
Method Objective
Status | ||||||
---|---|---|---|---|---|---|
|
Syntax and parameters
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("purchase", params); |
Name | Type | Requirement | Description |
---|---|---|---|
params | Object | required | Object with request parameters. |
Request parameters
Name | Type | Requirement | Description | ||||
---|---|---|---|---|---|---|---|
products | array | required | An array of purchased products. See the table below for details.order | ||||
custom | number/stringobject | 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. | order_price | number | optionally | The final order value, including all discounts. If Custom properties of the order. The properties should be pre-created: Account > Settings > Order properties The following data types are supported: - string - integer - date (YYYY-MM-DD) See example below. |
order | number/string | optionally | Internal store Order ID. If not specified, the system will calculate the order value based on prices from the product feed. | ||||
order_cash | number | optionally | The amount of money the user spent to pay for the order. | ||||
order_bonuses | number | optionally | The number of bonuses the user spent to pay for the order. | ||||
order_delivery | number | optionally | Shipping cost. | ||||
order_discount | number | optionally | Discount amount. | ||||
promocode | string | optionally | Promo code that was used. | ||||
delivery_type | string | optionally | Shipping method. Available values:
| ||||
payment_type | string | optionally | Payment method. Any string value. For example: "cash", "card", "wire". |
Product properties:
The unit price of the product. If not specified, the system will use the price from the product feed.
language | js |
---|---|
theme | FadeToGrey |
create its internal ID. Synchronization of order statuses, in this case, won't be available.
| |||||
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. | ||
order_cash | number | optionally | The amount of money the user spent to pay for the order. | ||
order_bonuses | number | optionally | The number of bonuses the user spent to pay for the order. | ||
order_delivery | number | optionally | Shipping cost. | ||
order_discount | number | optionally | Discount amount (in money). | ||
promocode | string | optionally | Promo code that was used.
| ||
delivery_type | string | optionally | Delivery Type, e.g. "courier", "self_pickup", "delivery", "pickup_point", etc. | ||
delivery_address | string | optionally | Delivery address. Any text. | ||
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. |
Product properties:
Name | Type | Requirement | Discription |
---|---|---|---|
id | number/string | required | Product ID. |
amount | number | required | Product Quantity. |
price | number | optionally | The unit price of the product. If not specified, the system will use the price from the product feed. |
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("purchase", { products: [ {id: "37", price: 100, amount: 3, stock: true}, {id: "187", price: 500, amount: 1, stock: false, custom: { fashion_size: "XL" }}} ], "custom": { ], "order_comment": "N100500"Delivery after 15:00, 2nd floor, apt. 222", order_price: 750, order_cash"boxes": 6502, order_bonuses: 100, order"refund_deliverydate": 0,"2021-09-21" order_discount: 50, promocode: "BIRTHDAY", delivery_type: "delivery", payment_type: "cart" }); |
},
order: "N100500",
order_price: 750,
order_cash: 650,
order_bonuses: 100,
order_delivery: 0,
order_discount: 50,
promocode: "BIRTHDAY",
delivery_type: "delivery",
payment_type: "cart"
}); |
Search Request
Method Objective
The method gives the system an understanding of the user's search queries.
Syntax and parameters
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("search", search_query); |
Request parameters
Name | Type | Requirement | Description |
---|---|---|---|
search_query | string | required | Search query phrase. |
Example of use
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("search", "to be or not to be"); |
Adding a product to the wishlist
Method Objective
The method gives the system an understanding of the user 's search querieshas added a product to the wishlist.
Syntax and parameters
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("searchwish", search_queryid); |
Request parameters
Name | Type | Requirement | Description |
---|---|---|---|
search_queryid | number/string | requiredSearch | query phraseThe ID of the product added to the wishlist. |
Example of use
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("searchwish", "to be or not to be "100500"); |
Removing a product
tofrom the wishlist
Method Objective
The method gives the system an understanding the user has added removed a product to from the wishlist.
Syntax and parameters
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("remove_wish", id); |
Request parameters
Name | Type | Requirement | Description |
---|---|---|---|
id | number/string | required | The ID of the product added to removed from the wishlist. |
Example of use
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("remove_wish", "100500"); |
Update the current wishlist
Method Objective
The method gives the system an understanding the user has removed a product from the wishlistupdates the whole wishlist on the system side.
Syntax and parameters
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.track("remove_wish", idids); |
Request parameters
Name | Type | Requirement | Description | |||||
---|---|---|---|---|---|---|---|---|
ids | Array | id | number/string | required | The ID of the product removed from therequired | Array with wish list product IDs.
|
Example of use
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
// synchronizing a wishlist pcsdk.track("wish", ["100500", "146"]); // clearing a wishlist pcsdk.track("remove_wish", "100500"[]); |
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 | ||||
---|---|---|---|---|
| ||||
pcsdk.trackEvent(custom_event_key, params); |
Name | Type | Requirement | Description |
---|---|---|---|
custom_event_key | string | required | Unique custom event key. Must be pre-created in the PersonaClick account: Settings > Custom events. |
params | Object | required | Object with request parameters. |
Request parameters
Name | Type | Requirement | Description |
---|---|---|---|
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 | ||||
---|---|---|---|---|
| ||||
pcsdk.trackEvent("my_event"); |
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.trackEvent("my_event", { category: "my_category", label: "my_label", value: 100500 }); |
Push Notification Received
Method Objective
The method gives the system an understanding that the user has received a push notification.
Syntax and parameters
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.notificationReceived(params); |
Name | Type | Requirement | Description |
---|---|---|---|
params | Object | required | Object with request parameters. |
Request parameters
Name | Type | Requirement | Description |
---|---|---|---|
type | string | required | Message Type. Values are available in the payload of a message:
See examples of payloads in the Payload Structure section. |
code | string | required | Message ID. Values are available in the payload of a message:
See examples of payloads in the Payload Structure section. |
Example of use
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.notificationReceived({type: "bulk", code: "01dadf45c301599865b402602f9dcf8f"}); |
Push Notification Clicked
Method Objective
The method gives the system an understanding that the user has clicked a push notification.
Syntax and parameters
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.notificationClicked(params); |
Name | Type | Requirement | Description |
---|---|---|---|
params | Object | required | Object with request parameters. |
Request parameters
Name | Type | Requirement | Description |
---|---|---|---|
type | string | required | Message Type. Values are available in the payload of a message:
See examples of payloads in the Payload Structure section. |
code | string | required | Message ID. Values are available in the payload of a message:
See examples of payloads in the Payload Structure section. |
Example of use
Code Block | ||||
---|---|---|---|---|
| ||||
pcsdk.notificationClicked({type: "chain", code: "5b40261dadf45c309902f9dcf8f10865"}); |
Column | ||||
---|---|---|---|---|
Page Navigation
|
|
Related Pages |
|
|