Changing Exponea API
We recently changed Exponea API to Engagement API, reflecting our move from Exponea to Bloomreach Engagement. We don't want to confuse you, but you may still stumble upon the former 'Exponea' term. Please, consider it interchangeable with Engagement.
What is Engagement API?
Engagement API allows web tracking and enables other systems to access the platform and manipulate the system and its data.
Any remote system can call the Engagement API by an HTTP method. It must provide an authentication key to access the API. Then, based on the permissions granted by the project administrator, different sets of features are available.
Requests can be processed immediately or put into a queue. Reads are usually immediately evaluated, while writes are queued for later.
What can you use the API for?
Engagement API enables tracking from websites and other sources.
To better address your GDPR needs, we also added GDPR features to anonymize and export customers. We offer methods to manipulate catalogs, imports, and emails and to retrieve Bloomreach Engagement calculated customer properties (including recommendations) and analyses.
API is not meant for big volume imports or exports of data
Programmatically tracking a high volume of data, such as pushing historical purchase data, violates our fair use policy. Use Imports for this purpose
Programmatically retrieving customer data (e.g. all events of all customers) is also considered abuse. For this purpose, use Data Exports or Exponea BigQuery.
Issues during the firing of API requests
If you are experiencing CORS issues during Firing API requests from your website, refer to this article to learn how to fix it.