Pushing Conversion Events
Authentication
All requests must be authenticated with an API Key.
Use the HTTP header Authorization with the API Key, where the API key you created in the MediaQX application.
See Managing API Keys.
Pushing Events
Base URL
The base URL for all API requests is:
https://conversions.app.mediaqx.com
Method
POST
URI
/events
Header
Payload
Payload Parameters
A conversion event shall include the list of identifiers as key-value pairs and detailed information about the event.
Identifiers
The targettable identifier(s) of the user who created the event. The identifiers can be first-party identifiers such as email, phone_number, or third-party identifiers such as maid, crm_id.
You can push your well-known first-party identifiers such as email and phone directly within the identifiers object, or add your third-party identifiers in the ext_id object.
At least one identifier is needed for the conversion event to be valid.
Events
Detailed information about the event triggered by the user.
IP address and timestamp need to be valid for the conversion event to be valid.
IPv6 is not supported for conversion events.
Response Types
Last updated