Skip to main content

Overview

The Data API is a REST API that allows to retrieve or write data stored on our remote servers. You can use the available endpoints to:

  • retrieve visit events for a given visitor.
  • send additional visit events for a given visitor, such as offline conversion events.
  • send and retrieve product data for a given sitecode.
  • store additional data for a given visitor, such as CRM or segmentation data.

We provide endpoints for 3 main categories of data:

The Visit endpoints allow to retrieve and send events (conversion, custom data, segments...) for a given visitor code. They can be used to import offline purchase data (such as physical store purchases) to Kameleoon.

  • /visit/visitor: this endpoint returns the activity feed for a given user. It can be used to retrieve visits data collected by Kameleoon such as experiments and personalizations being triggered for the user or targeted segments.
note

Please note that this endpoint can only be used as part of an add-on to our product (remote sync of data or cross-device history reconciliation), and it requires an additional fee to use. To access this feature, please contact your Customer Success Manager for pricing and licensing options.

  • /visit/forget: this endpoint can be used to remove data for several visitors.
  • /visit/events: this endpoint can be used to post data for a given visitor, such as conversion events, page view events etc.

The Product endpoints allow to retrieve and send product data for a given sitecode. They can be used to register product events such as view, add to cart or purchase events, or to obtain statistics about a given product (eg. how many times it was bought or viewed in the last hour or day).

  • /product/events: this endpoint can be used to post attributes (name, price etc.) and events (view, add to cart, purchase) for several products, which can then be retrieved and used for targeting or product recommendations purposes, by using the obtainProductData and obtainProductInteractions methods available in our Activation API. You can also use the productCounters and productData endpoints.
  • /product/productCounters: this endpoint can be used to retrieve counts (number of views, add to cart quantities, transaction quantities) for several products.
  • /product/productData: this endpoint can be used to retrieve attributes for several products.
note

You need to have access to the AI-Driven Personalization module. This module can either be subscribed to directly or added as an add-on to our Web Experimentation module. For more information, please get in touch with your Customer Success Manager.

The Map endpoints allow to store additional data for a given key (usually a visitor code or an internal User ID), which can then be retrieved and used for targeting and segmentation purposes, by using the retrieveDataFromRemoteSource method available in our Activation API and all our SDKs. You can also use the map endpoint to retrieve stored data for a given key.

  • /map/map: this endpoint can be used to retrieve data for a given key.
  • /map/maps: this endpoint can be used to post or retrieve data for several keys.
note

Please note that this is an add-on to our product, and it requires an additional fee to use. To access this feature, please contact your Customer Success Manager for pricing and licensing options.