K Khan
Jun 22, 2021
(4 votes)

ODP handy reference guide - Web SDK

A quick reference guide, developers might need before starting a new ODP/Zaius implementation based on https://docs.developers.zaius.com/

It will be worthy to watch https://www.david-tec.com/2021/05/video-adding-optimizely-data-platform-to-optimizely-commerce-cloud/


ODP/Zaius provides two forms of authentication:

  • Public (Tracker ID) - is used for most API calls that send data
  • Private - is used for querying data

Keys are scoped at the account level. When you revoke a private API key, your existing key is available for 12 hours as a grace period. Public API Key and Tracker ID are synonymous.

Batch Requests

Bulk data push should be done in batch, every request can include up to 500 distinct objects. As an example, at 500 customers per request with 10 requests per second as a rate limit, you can process 5,000 customer updates per second. For higher rate limits contact support.


Consent may impact attempts to send marketing campaigns to the identifier. If noted as opted-out, certain marketing services or channels may skip the identifier, even when qualified for the campaign. Customers who have opted out cannot receive marketing messages. Only transactional messages will be received by these customers.


zaius.consent({  consent: true,  identifier_field_name: 'email',  identifier_value: 'tyler@zaius.com',  update_reason: '',  update_ts: 123456789,  event_data: {}  });

Messaging Lists

Group customers for the purposes of tracking their communication preferences.


To Create/Update/View Customer’s profile. Cookie with name ‘vuid’ contains the reference to profile id.

Anonymize - will reset the cookie identifier associated with the browser. Use this when a user logs out or on shared devices between form submissions that include identifiers.


    email: "johnny.zaius@zaius.com"
    first_name: "Johnny",
    last_name: "Zaius",
    gender: "M"


Customer behaviors are tracked as events. Events are composed of a Type(a categorical name associated with the event), Action(activity a user did within that event type), and additional metadata via fields on the event,  at minimum, events require an event type and an identifier to associate the event with a customer. There are two types of events, custom, and standard,

Custom event:


zaius.event("your_event_type_here", { 
    action: "your_event_action_here",
    example_custom_field: "example_value"

Standard events:

These are pre-defined event type/action and expected by Zaius to be accompanied with certain fields. The usage of these events makes the usage of Zaius simpler for common use cases. Zaius does not recommend or formally support Order events via the Web SDK to ensure that ad blockers do not block the purchase event. Zaius only supports sending Order refunds, returns & cancellations via API or CSV to ensure that ad blockers do not block these critical events. https://docs.developers.zaius.com/api/

Event TYPE Activity Example
account login
zaius.event("account", { action: "login" });
zaius.event("account", { action: "logout" });
zaius.event("account", { action: "register" });
zaius.event("account", { action: "update" });
Anonymize will reset the cookie identifier associated with the browser. Use this when a user logs out or on shared devices between form submissions that include identifiers.
Zaius will automatically parse the appropriate page path information.
navigation search
zaius.event("navigation", { 
    action: "search", 
    search_term:"cameras, vcr",
    category: "electronics > consumer"
zaius.event("navigation", { 
    action: "sort"
zaius.event("navigation", { 
    action: "filter"
consent opt-in
  consent: true,
  identifier_field_name: 'email',
  identifier_value: 'tyler@zaius.com',
  update_reason: '',
  update_ts: 123456789,
  event_data: {}


product_id is required on all events with an event type of product

product detail
zaius.event("product", { action: "detail", product_id: "product-2143" });
zaius.event("product", { action: "add_to_cart", product_id: "product-2143" });
zaius.event("product", { action: "remove_from_cart", product_id: "product-2143" });
zaius.event("product", { action: "add_to_wishlist", product_id: "product-2143" });
zaius.event("product", { action: "remove_from_wishlist", product_id: "product-2143" });
advertisement impression
zaius.event("advertisement", { action: "impression" });
zaius.event("advertisement", { action: "click" });

Messaging Lists allow you to group customers for the purposes of tracking their communication preferences. For example, allowing customers to subscribe to your company newsletter or for holiday news. 

Zaius does not require customers to be subscribed to a List to receive emails.

// subscribe johnny@zaius.com to newsletter list
zaius.subscribe({list_id: 'newsletter', email: 'johnny@zaius.com'});

// unsubscribe johnny@zaius.com from newsletter list
zaius.unsubscribe({list_id: 'newsletter', email: 'johnny@zaius.com'});

// subscribe johnny@zaius.com to three lists at once
  list_id: ["newsletter", "promotion", "product_update"], 
  email: "johnny@zaius.com"

// unsubscribe johnny@zaius.com from multiple lists at once
  list_id: ["newsletter", "product_update"], 
  email: "johnny@zaius.com"

  // subscribe Johnny to all lists
  list_id: ["newsletter", "promotion", "product_update"],
  email: "johnny@zaius.com",
  // update Johnny's record to include his full name
  first_name: "Johnny",
  last_name: "Zaius",
  // store information on the subscribe events
  event_custom_field: "my custom value",
  custom_number_field: 123

// zaius.unsubscribe also fully supports this syntax.
Jun 22, 2021


David Knipe
David Knipe Jun 22, 2021 01:08 PM

Thanks for sharing, all useful information! I have updated https://www.david-tec.com/2021/05/adding-optimizely-data-platform-to-optimizely-commerce-cloud/ to reference this guide :)

K Khan
K Khan Jun 23, 2021 05:43 PM

Glad you liked, and thanks for giving this post space there :)

Johnny Mullaney
Johnny Mullaney Feb 9, 2022 03:09 PM

Thanks for writing this guide Khurran, very useful!

If a customer logs in, do you know if it is best practice to push both a login event and a customer event:

zaius.event("account", { action: "login" });
    email: "johnny.zaius@zaius.com"
    first_name: "Johnny",
    last_name: "Zaius",
    gender: "M"

Similarly if a customer identifies their email through a guest checkout journey, i assume that we push a customer event such as the following to identify the session

    email: "johnny.zaius@zaius.com"

Thanks in advance :)

Brian Taylor
Brian Taylor Feb 9, 2022 05:55 PM

Only the login event unless there's a chance that you just captured something new about the customer. You only need to fire customer events to ask ODP to retain something new you've discovered about the customer and whatever you send will be merged with what ODP already knows.

Johnny Mullaney
Johnny Mullaney Feb 10, 2022 11:28 AM

Great, thanks Brian!

Please login to comment.
Latest blogs
Implementing EmbeddedLocalization in Optimizely CMS 12

My previous post on translation (Translating Optimizely CMS 12 UI components) gives an overview of how to implement the FileXmlLocalizationProvider...

Eric Herlitz | Jan 27, 2023 | Syndicated blog

Breaking changes in EPiServer.CMS.TinyMce 4.0.0

After upgrading to the latest version of EPiServer.CMS.TinyMce, the dropdown with formats disappears. Learn how to get it back!

Tomas Hensrud Gulla | Jan 27, 2023 | Syndicated blog

Translating Optimizely CMS 12 UI components

Optimizely CMS 12 have been out for a while now, but still some elements haven't been properly translated resulting in a GUI defaulting to english....

Eric Herlitz | Jan 26, 2023 | Syndicated blog

Image preview in Optimizely CMS12 all properties view

With these simple steps, you can now see an Image and its Metadata, including size and dimensions, when editing an Image property in Optimizely...

Tomas Hensrud Gulla | Jan 26, 2023 | Syndicated blog