Measure. Analyze. Optimize.

EVENT STRUCTURE FOR OCI

Website

Prepared For

DOCUMENT VER. 3.2

JANUARY 31, 2023
DAAM AL-ARABIA
Jeddah, Saudi Arabia
DAAM.COM.SA

DIGITAL ANALYTICS AND MARKETING OPTIMIZATION

Contents
Enhanced E-Commerce Events ........................................................................ 2
Measure Promotions .......................................................................................... 2
Promotion Impressions............................................................................................. 2
Promotion Clicks ....................................................................................................... 2
Measure eCommerce Events ............................................................................ 3
Measure Product Impressions.................................................................................. 3
Measure Product Clicks ............................................................................................ 4
Measuring Internal Search ........................................................................................ 4
Measuring Product Details View .............................................................................. 5
Measuring Additions to Cart .................................................................................... 5
Measuring Removing from Cart................................................................................ 7
Add To Wishlist ......................................................................................................... 7
Measuring Cart View ................................................................................................. 8
Measuring Checkout .......................................................................................... 8
Begin checkout (Step #1 – Begin Checkout) ........................................................... 9
Checkout (Step #2 - Shipping Address) ................................................................. 10
Checkout (Step #3 - Payment) ................................................................................ 11
Measure Transactions/Purchases ......................................................................... 12
Custom Events ..................................................................................................13
Measure Coupon Redemption Attempts ................................................................ 13
Measure Global Variables: ...................................................................................... 13
Measure Login Attempts ......................................................................................... 13
Measuring Signup Attempts ................................................................................... 13

DAAM CONFIDENTIAL AND PROPRIETARY JEDDAH – SAUDI ARABIA

[email protected] WWW.DAAM.COM.SA TEL: +966-12-6396544

DAAM.COM.SA

DIGITAL ANALYTICS AND MARKETING OPTIMIZATION

Enhanced E-Commerce Events

Measure Promotions
DEVELOPER INSTRUCTION
Promotion Impressions
event: "view_promotion",
user_id: '1234567', Measuring Promotion
ecommerce: { Impressions allows tracking
items: [
{
impressions of internal site
creative_name: "https://nahdionline.com/media/SnaptecBanner/banner_image1666517690.jpg", // The banners. Send array of all
image URL src. impressions and replace
creative_slot: "hp_main_slider_1", // The banner slot index
location_id: "HP Main Slider", // The widget location (slider position within the page) highlighted values with the
promotion_id: "123456", actual values of each
promotion_name: "Best Offers", promotion.
},
{
(On Banner show up)
creative_name: "https://nahdionline.com/media/SnaptecBanner/banner_image1667461331.jpg",
creative_slot: "hp_featured_2",
location_id: "HP Featured",
promotion_id: "112554",
promotion_name: "Bioderma",
},
]
}

Promotion Clicks
Measuring Promotion Clicks
allows tracking clicks on
event: "select_promotion", internal site promotions such
user_id: '1234567',
as banners displayed on the
ecommerce: {
items: [ site itself advertising.
{ (On Banner Click)
creative_name:
"https://nahdionline.com/media/SnaptecBanner/banner_image1667461331.jpg",
creative_slot: "hp_featured_2",
location_id: "HP Featured",
promotion_id: "112554",
promotion_name: "Bioderma offers",
}
]
}

DAAM CONFIDENTIAL AND PROPRIETARY JEDDAH – SAUDI ARABIA

[email protected] WWW.DAAM.COM.SA TEL: +966-12-6396544

DAAM.COM.SA

DIGITAL ANALYTICS AND MARKETING OPTIMIZATION

Measure eCommerce Events

Measure Product Impressions DEVELOPER INSTRUCTION

event: "view_item_list",
user_id: '1234567',
ecommerce: { Measure Product Impression
item_list_id: "body_butters", // The unique id of list if exist when usrs view a product on
item_list_name: "Body Butters", // The list i.e."Selected Products" the listing page.
items: [
{ Send Array of all items shown
item_id: "2606",
item_name: 'Fruit Works Strawberry & Kiwi Body Butter 235g", and replace highlighted values
index: 0, with the actual values of the
coupon: "50% discount", Product.
currency: "SAR",
discount: 325.00, (On product list show up)
item_brand: "Grace Cole",
item_category: "Skin Care ",
item_category2: "Facial Care",
item_category3: "",
item_category4: "", The same event applies for all
item_category5: "", PLPs and custom listing like
item_list_id: "body_butters", special, newly arrived, related
item_list_name: "Body Butters",
item_variant: "black",
products, top selling. etc.
fulfilment_source: "Hupstore",
availability: "in-stock",
price: 324.00,
},
{
item_id: "258",
item_name: "Sanctuary Spa Luxurious Body Butter 300ml",
index: 1,
coupon: "50% discount",
currency: "SAR",
discount: 450.00,
item_brand: "Sanctuary",
item_category: "Skin Care",
item_category2: "Facial Care",
item_category3: "Women Care",
item_category4: "",
item_category5: "",
item_list_id: "body_butters",
item_list_name: "Body Butters",
item_variant: "black",
fulfilment_source: "UAE DC",
availability: "in-stock",
price: 449.00,
}]
}

DAAM CONFIDENTIAL AND PROPRIETARY JEDDAH – SAUDI ARABIA

[email protected] WWW.DAAM.COM.SA TEL: +966-12-6396544

DAAM.COM.SA

DIGITAL ANALYTICS AND MARKETING OPTIMIZATION

Measure Product Clicks

event: "select_item",
user_id: '1234567', DEVELOPER INSTRUCTION
ecommerce: {
item_list_id: "body_butters",
item_list_name: "Body Butters",
items: [ Measure product clicks when
{
item_id: "2606",
a user chooses an item (i.e.
item_name: 'Fruit Works Strawberry & Kiwi Body Butter 235g", product) defined with the
index: 0, relevant fields.
coupon: "50% discount",
currency: "SAR", Replace highlighted values
discount: 325.00,
item_brand: "Grace Cole",
with the actual values of the
item_category: "Skin Care ", Product.
item_category2: "Facial Care",
item_category3: "", (On product click)
item_category4: "",
item_category5: "",
item_list_id: "body_butters",
item_list_name: "Body Butters",
item_variant: "black",
fulfilment_source: "Hupstore",
availability: "in-stock",
price: 324.00,
}
]
}

Measuring Internal Search (On search)

'event': 'search',
user_id: '1234567',
search_term: 'Panadol', //the search query
'result': '36', //The Count of Products returned to the user.

DAAM CONFIDENTIAL AND PROPRIETARY JEDDAH – SAUDI ARABIA

[email protected] WWW.DAAM.COM.SA TEL: +966-12-6396544

DAAM.COM.SA

DIGITAL ANALYTICS AND MARKETING OPTIMIZATION

Measuring Product Details View

event: "view_item",
user_id: '1234567', DEVELOPER INSTRUCTION
ecommerce: {
items: [
{
item_id: "2606", Measure this step when
item_name: 'Fruit Works Strawberry & Kiwi Body Butter 235g", users view the product
coupon: "50% discount",
currency: "SAR",
details page. A product
discount: 325.00, defined with the relevant
item_brand: "Grace Cole", fields.
item_category: "Skin Care ",
item_category2: "Facial Care", (On PDP page view)
item_category3: "",
item_category4: "",
item_category5: "",
item_list_id: "body_butters",
item_list_name: "Body Butters",
item_variant: "black",
fulfilment_source: "Hupstore",
availability: "in-stock",
price: 324.00,
}
]
}

DAAM CONFIDENTIAL AND PROPRIETARY JEDDAH – SAUDI ARABIA

[email protected] WWW.DAAM.COM.SA TEL: +966-12-6396544

DAAM.COM.SA

DIGITAL ANALYTICS AND MARKETING OPTIMIZATION

Measuring Additions to Cart

event: "add_to_cart",
user_id: '1234567', DEVELOPER INSTRUCTION
ecommerce: {
currency: "SAR",
value: 648.00, // Price * Quantity
items: [ Measure a product being
{
item_id: "2606",
added to a shopping cart
item_name: 'Fruit Works Strawberry & Kiwi Body Butter 235g", with item (i.e. product)
coupon: "50% discount", defined with the relevant
currency: "SAR",
discount: 325.00,
fields.
item_brand: "Grace Cole",
item_category: "Skin Care ",
(On AddToCart)
item_category2: "Facial Care",
item_category3: "",
item_category4: "",
item_category5: "",
item_list_id: "body_butters",
item_list_name: "Body Butters",
item_variant: "black",
fulfilment_source: "Hupstore",
availability: "in-stock",
price: 324.00,
quantity: 2
}
]
}

DAAM CONFIDENTIAL AND PROPRIETARY JEDDAH – SAUDI ARABIA

[email protected] WWW.DAAM.COM.SA TEL: +966-12-6396544

DAAM.COM.SA

DIGITAL ANALYTICS AND MARKETING OPTIMIZATION

Measuring Removing from Cart

event: "remove_from_cart",
user_id: '1234567', DEVELOPER INSTRUCTION
ecommerce: {
currency: "SAR",
value: 648.00, // Price * Quantity
items: [
{ Measure removing a Product
item_id: "2606", from a Cart by logging an
item_name: 'Fruit Works Strawberry & Kiwi Body Butter 235g",
coupon: "50% discount",
event with item defined with
currency: "SAR", the relevant fields.
discount: 325.00,
item_brand: "Grace Cole", (On deleting a product OR on
item_category: "Skin Care ", reducing the quantity)
item_category2: "Facial Care",
item_category3: "",
item_category4: "",
item_category5: "",
item_list_id: "body_butters",
item_list_name: "Body Butters",
item_variant: "black",
fulfilment_source: "Hupstore",
availability: "out-of-stock",
price: 324.00,
quantity: 1
}]
}

Add To Wishlist
event: "add_to_wishlist",
user_id: '1234567',
ecommerce: {
currency: "SAR",
value: 324.00, // The monetary value of the event.
items: [
{
item_id: "2606",
item_name: 'Fruit Works Strawberry & Kiwi Body Butter 235g",
coupon: "50% discount",
currency: "SAR",
discount: 325.00,
item_brand: "Grace Cole",
item_category: "Skin Care ",
item_category2: "Facial Care",
item_category3: "",
item_category4: "",
item_category5: "",
price: 324.00,
}]
}

DAAM CONFIDENTIAL AND PROPRIETARY JEDDAH – SAUDI ARABIA

[email protected] WWW.DAAM.COM.SA TEL: +966-12-6396544

DAAM.COM.SA

DIGITAL ANALYTICS AND MARKETING OPTIMIZATION

Measuring Cart View

event: "view_cart",
user_id: '1234567',
ecommerce: { DEVELOPER INSTRUCTION
currency: "SAR",
value: 1222.00, // The total value of the cart Measure cart views when a
items: [ user subsequently views the
{ cart, log the view_cart event
item_id: "2606",
item_name: 'Fruit Works Strawberry & Kiwi Body Butter 235g", with all items in the cart.
coupon: "50% discount",
currency: "SAR", (On Cart page view)
discount: 325.00,
item_brand: "Grace Cole",
item_category: "Skin Care ",
item_category2: "Facial Care",
item_category3: "",
item_category4: "",
item_category5: "",
item_list_id: "body_butters",
item_list_name: "Body Butters",
item_variant: "black",
fulfilment_source: "Hupstore",
availability: "in-stock",
price: 324.00,
quantity: 1
},
{
item_id: "258",
item_name: "Sanctuary Spa Luxurious Body Butter 300ml",
coupon: "50% discount",
currency: "SAR",
discount: 450.00,
item_brand: "Sanctuary",
item_category: "Skin Care",
item_category2: "Facial Care",
item_category3: "Women Care",
item_category4: "",
item_category5: "",
item_list_id: "body_butters",
item_list_name: "Body Butters",
item_variant: "black",
fulfilment_source: "UAE DC",
availability: "in-stock",
price: 449.00,
quantity: 2
}]
}

DAAM CONFIDENTIAL AND PROPRIETARY JEDDAH – SAUDI ARABIA

[email protected] WWW.DAAM.COM.SA TEL: +966-12-6396544

DAAM.COM.SA

DIGITAL ANALYTICS AND MARKETING OPTIMIZATION

Measuring Checkout
DEVELOPER INSTRUCTION
Begin checkout (Step #1 – Begin Checkout)
event: "begin_checkout", DEVELOPER INSTRUCTION
user_id: '1234567', Measure the first step in a
ecommerce: { checkout process by logging a
currency: "SAR",
value: 1222.00, // The Total value of the Cart BEGIN CHECKOUT event
coupon: "KSA92", //Order coupon or website Level Coupon if used with all items in the cart
items: [ defined with the relevant fields:
{
item_id: "2606",
Step #1: Begin Checkout
item_name: 'Fruit Works Strawberry & Kiwi Body Butter 235g",
coupon: "50% discount",
currency: "SAR",
(On "Proceed to Checkout"
discount: 325.00, button click)
item_brand: "Grace Cole",
item_category: "Skin Care ",
item_category2: "Facial Care",
item_category3: "",
item_category4: "",
item_category5: "",
item_list_id: "body_butters",
item_list_name: "Body Butters",
item_variant: "black",
fulfilment_source: "Hupstore",
availability: "in-stock",
price: 324.00,
quantity: 1
},
{
item_id: "258",
item_name: "Sanctuary Spa Luxurious Body Butter 300ml",
coupon: "50% discount",
currency: "SAR",
discount: 450.00,
item_brand: "Sanctuary",
item_category: "Skin Care",
item_category2: "Facial Care",
item_category3: "Women Care",
item_category4: "",
item_category5: "",
item_list_id: "body_butters",
item_list_name: "Body Butters",
item_variant: "black",
fulfilment_source: "UAE DC",
availability: "in-stock",
price: 449.00,
quantity: 2
}]
}

DAAM CONFIDENTIAL AND PROPRIETARY JEDDAH – SAUDI ARABIA

[email protected] WWW.DAAM.COM.SA TEL: +966-12-6396544

DAAM.COM.SA

DIGITAL ANALYTICS AND MARKETING OPTIMIZATION

Checkout (Step #2 - Shipping Address)

event: "add_shipping_info", DEVELOPER INSTRUCTION
user_id: '1234567',
ecommerce: {
currency: "SAR",
value: 1222.00, // The Total value of the Cart
coupon: "KSA92", //Order coupon or website Level Coupon if used Measure the second step in
shipping_tier: "Home delivery", //the shipping tier could be Home delivery or the checkout process choose
Store pickup the shipping address by
items: [
{ logging a checkout event with
item_id: "2606", all items in the cart specified in
item_name: 'Fruit Works Strawberry & Kiwi Body Butter 235g", the relevant fields:
coupon: "50% discount",
currency: "SAR", Step #2: Shipping Address
discount: 325.00,
item_brand: "Grace Cole", (On “Next” button click)
item_category: "Skin Care ",
item_category2: "Facial Care",
item_category3: "",
item_category4: "",
item_category5: "",
item_list_id: "body_butters",
item_list_name: "Body Butters",
item_variant: "black",
fulfilment_source: "Hupstore",
availability: "in-stock",
price: 324.00,
quantity: 1
},
{
item_id: "258",
item_name: "Sanctuary Spa Luxurious Body Butter 300ml",
coupon: "50% discount",
currency: "SAR",
discount: 450.00,
item_brand: "Sanctuary",
item_category: "Skin Care",
item_category2: "Facial Care",
item_category3: "Women Care",
item_category4: "",
item_category5: "",
item_list_id: "body_butters",
item_list_name: "Body Butters",
item_variant: "black",
fulfilment_source: "UAE DC",
availability: "in-stock",
price: 449.00,
quantity: 2
}]
}

10

DAAM CONFIDENTIAL AND PROPRIETARY JEDDAH – SAUDI ARABIA

[email protected] WWW.DAAM.COM.SA TEL: +966-12-6396544

DAAM.COM.SA

DIGITAL ANALYTICS AND MARKETING OPTIMIZATION

Checkout (Step #3 - Payment)

event: "add_payment_info",
user_id: '1234567', DEVELOPER INSTRUCTION
ecommerce: {
currency: "SAR",
value: 1222.00,// The Total value of the Cart
coupon: "KSA92", //Order coupon or website Level Coupon if used
payment_type: "Credit Card", // the payment type could be Credit Card,
Measure the third step in the
Tamara or Tabby. checkout process choose the
items: [ payment method by logging a
{
item_id: "2606",
Checkout event with all items
item_name: 'Fruit Works Strawberry & Kiwi Body Butter 235g", (i.e. products) specified in the
coupon: "50% discount", relevant fields:
currency: "SAR",
discount: 325.00, Step #3: Payment
item_brand: "Grace Cole",
item_category: "Skin Care ", (On "Place Order" button click)
item_category2: "Facial Care",
item_category3: "",
item_category4: "",
item_category5: "",
item_list_id: "body_butters",
item_list_name: "Body Butters",
item_variant: "black",
fulfilment_source: "Hupstore",
availability: "in-stock",
price: 324.00,
quantity: 1
},
{
item_id: "258",
item_name: "Sanctuary Spa Luxurious Body Butter 300ml",
coupon: "50% discount",
currency: "SAR",
discount: 450.00,
item_brand: "Sanctuary",
item_category: "Skin Care",
item_category2: "Facial Care",
item_category3: "Women Care",
item_category4: "",
item_category5: "",
item_list_id: "body_butters",
item_list_name: "Body Butters",
item_variant: "black",
fulfilment_source: "UAE DC",
availability: "in-stock",
price: 449.00,
quantity: 2
}]
}

11

DAAM CONFIDENTIAL AND PROPRIETARY JEDDAH – SAUDI ARABIA

[email protected] WWW.DAAM.COM.SA TEL: +966-12-6396544

DAAM.COM.SA

DIGITAL ANALYTICS AND MARKETING OPTIMIZATION

Measure Transactions/Purchases
event: "purchase",
user_id: '1234567', DEVELOPER INSTRUCTION
ecommerce: {
transaction_id: "506012",
value: 1222.00, // The Total value of the order
tax: 183.00, // The VAT value of the order Measure purchases by logging
shipping: 0.00, //Shipping Cost
currency: "SAR",
a Purchase event with one or
coupon: "KSA92", //Order coupon or website Level Coupon if used more items (i.e. loop for each
items: [ product in the cart) defined
{
with the relevant field.
item_id: "2606",
item_name: 'Fruit Works Strawberry & Kiwi Body Butter 235g",
On “Order success Screen”
coupon: "50% discount",
currency: "SAR",
discount: 325.00,
item_brand: "Grace Cole",
item_category: "Skin Care ",
item_category2: "Facial Care",
item_category3: "",
item_category4: "",
item_category5: "",
item_list_id: "body_butters",
item_list_name: "Body Butters",
item_variant: "black",
fulfilment_source: "Hupstore",
availability: "in-stock",
price: 324.00,
quantity: 1
},
{
item_id: "258",
item_name: "Sanctuary Spa Luxurious Body Butter 300ml",
coupon: "50% discount",
currency: "SAR",
discount: 450.00,
item_brand: "Sanctuary",
item_category: "Skin Care",
item_category2: "Facial Care",
item_category3: "Women Care",
item_category4: "",
item_category5: "",
item_list_id: "body_butters",
item_list_name: "Body Butters",
item_variant: "black",
fulfilment_source: "UAE DC",
availability: "in-stock",
price: 449.00,
quantity: 2
}]
}

12

DAAM CONFIDENTIAL AND PROPRIETARY JEDDAH – SAUDI ARABIA

[email protected] WWW.DAAM.COM.SA TEL: +966-12-6396544

DAAM.COM.SA

DIGITAL ANALYTICS AND MARKETING OPTIMIZATION

Custom Events

Measure Coupon Redemption Attempts DEVELOPER INSTUCTION

event: 'add_coupon',
user_id: '1234567',
Track this stage where
coupon_code: 'KSA2023', // The coupon code. visitors redeem a coupon to
result: 'Coupon Success' //If coupon Failed, include the reason determine the coupons
'discount_value': 12.00 which are most and least
effective in driving sales.
Measure Global Variables: (On apply coupon attempt)

event: 'global_variables',
event_source: 'Website', (On all page load)
language: 'EN', // The website interface language
user_id: '1234567', Measure different important
email: '[email protected]', parameters by logging the
phone: '+966595753370', Global Variables event with
gender: 'Male', the relevant fields.
city: 'Jeddah',
district: 'Al-Salama',
Trigger Login event when user

Measure Login Attempts attempt to login. Fill user_id if login

succeed.
(On Login Attempt)
event: 'login',
method: 'Mobile', //or Email .. ect.
result: 'Login Success', //If Login Failed, include the reason i.e. ‘Login Failed: Trigger Signup event when user
valid OTP, Incorrect mobile number’ attempt to signup. Fill userId if
signup succeed.
(On Signup Attempt)

Measuring Signup Attempts

event: 'sign_up',
method: 'Email', //or Mobile... etc.
result: 'Signup Success', //If Signup Failed, include the reason i.e. ‘Signup Failed: Email
Already Used’
user_id: 'User1234', // empty if failed

13

DAAM CONFIDENTIAL AND PROPRIETARY JEDDAH – SAUDI ARABIA

[email protected] WWW.DAAM.COM.SA TEL: +966-12-6396544

DAAM.COM.SA

DIGITAL ANALYTICS AND MARKETING OPTIMIZATION

14

DAAM CONFIDENTIAL AND PROPRIETARY JEDDAH – SAUDI ARABIA

[email protected] WWW.DAAM.COM.SA TEL: +966-12-6396544