Skip to main content

Page types

Pages supported by Rokt Ecommerce

This table shows common page types supported by Rokt Ecommerce, as well as if a page type is considered transactional or non-transactional.

Page typeTransaction or non-transactionCart status
Product selectionTransactionIn-cart
UpsellTransactionIn-cart
Customer detailsTransactionIn-cart
ShippingTransactionIn-cart
Payment detailsTransactionIn-cart
Cart reviewTransactionIn-cart
ConfirmationTransactionPost-cart
Booking detailsNon-transactionPost-cart
Landing pageNon-transactionNon-cart
Enquiry formNon-transactionNon-cart

Page variants

Variants are groupings of placements that should appear together on a page. Many variants will hold only one placement: the standard auto launch overlay widget which appears on the confirmation page. In the world of multiple placements, a variant will commonly hold one overlay placement and at least one embedded placement-but could be any combination of placements which should appear on the page.

There are three pieces of information that we need to know when adding a placement to a page variant:

  • What placement to show? (Select from a list of available placements in the account)
  • When to show the placement? (Activation event)
  • Where to show the placement? (Target element)

This information is necessary to both render a placement and allow users to save the page. There are two rules for constructing page variants:

  • You are restricted to 1 overlay placement which loads automatically. We'd never want to show two overlay placements at once to a customer.
  • Embedded placements cannot have the same target element within a variant

What's a target element?

A target element defines where you want to show Rokt content on your page. We do this by anchoring the placement to an HTML element. The placement will render on the page where the CSS selector matches the defined selector for that placement in the page variant settings. You can elect to define an element when linking your placement to a page or implement a default element id suggested by Rokt as a placeholder when integrating the Rokt tag on your site.

Target element is an optional field for overlay placements which launch automatically when a page loads. The placement will load over the entire page, so anchoring them to a specific element on a partner's page is not necessary.

What's an activation event?

An activation event is used to determine when you want to show Rokt content on your page. There are a few different activation event options offered by Rokt:

We currently support two activation events:

  • Activate automatically - the placement will automatically be activated when the page loads.
  • Activate manually - the placement will not activate until the partner calls rokt.activate() function on a partner's page.

You select an activation event type for each individual placement per page-variant. A single placement can have different activation events depending on the page-variant selected. For example, a partner may want to load a overlay placement automatically on the confirmation page, but launch the same placement manually on the view booking details page.

Was this article helpful?