Record Activity

POSTs will be immediatelty acknowledged with a 204 if the POST is successfully received and the JSON decoded.

Data errors within the JSON will not be acknowledged on this endpoint, but will be handled gracefully where possible.

Note the User Agent "ua" field should be accurate, as it is used to determine the form-factor & OS for analytics purposes.

POSTs are immediately acknowledged with a 204 if the POST is successfully received and the JSON decoded.

🚧

Data errors within the JSON are not acknowledged on this endpoint, but are handled gracefully where possible.

📘

The User Agent ua field should be accurate, as it is used to determine the form-factor and OS for analytics purposes.

When recording page activity using beacons you must provide the appropriate value for the following:

typ values

Signifies the type of event the beacon is tracking.

typ valueNameDescription
1PAGE_VIEWEDPage viewed, of type ptyp
7CUSTOM_SIGNALCustom signal
For example, requested brochure, visited a certain page.

ptyp values

Page tracking beacons data must declare what page type it represents using the ptyp field with one of the following values:

ptyp valueNameDescription
1PRODUCT_BROWSEBrowse page for any shopping cart. Includes one product ID.
2LOGINLogging in to a shopping account.
3LOGIN_THANKSAfter logging in to a shopping account.
4REGISTERRegister for a shopping account.
5REGISTER_THANKSAfter register for a shopping account.
6CARTCart page for any shopping cart. Includes 0 or more products.
7CHECKOUTCart page during the shopping process. Usually includes all carted products.
8PURCHASE_COMPLETECart page after payment has been made. No products.
9PRODUCT_LISTA page with a list of products on it, for example, a category page.
10ACCOUNT_EDITAccount settings page, for example, Magento account dashboard.
11NEWSLETTER_EDITPage where newsletter and mailing preferences are set or viewed.
12DNT_PREFERENCENot a real page, used to send us Do-not-track / nomail.
13CART_INPAGEIn-page cart update, for example, an ajax cart.
14EMAIL_SENDEmail send
For example, UBX webhook.
15EMAIL_OPENEmail open
For example, UBX webhook.
16EMAIL_CLICKEmail clickthrough
For example, UBX webhook.
17POPOVER_SHOWNPopover shown, for popover reporting.
18POPOVER_DISMISSPopover dismissed, for popover reporting
19POPOVER_SUBMITPopover submitted, for popover reporting
Path Params
string
required

Website ID for the account you are posting data to.

Body Params
string
enum
required

The data type being passed

Allowed:
data
required

The data for the event

Responses
204

Activity accepted

401

Unauthorized

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here!