Set Up for Destinations
Instructions for how to get started with the Interactions API as a Destination
The best and fastest way MIG communicates with Destinations is via joint Slack channel so MIG can provide support with set up and management of connections to the Interactions API as a Destination. Reach out to [email protected] to get the channel set up and have users added.
Setting up an Interactions API integration
Destinations are able to retrieve data from the Interactions API via a subscription to a Google Pub/Sub topic that MIG owns and maintains.
To set up a connection, you will need to share a Google Service Account with the DDx API in Slack or sent to [email protected] e.g., via a secure transfer method like OneTimeSecret. You will also need to verify which Interactions API-supported data formats you can accept.
When an initial connection has been set up, the DDx API team will perform a test and send data to you in a previously determined accepted format.
Once you determine that the test is successful, you will need to verify which Sources you can receive data from. When these steps have been completed, DDx API will be ready to send you production traffic and allow Data Owners to provision API Keys with you as a destination.
Receiving data from the Interactions API
MIG sends data to destinations through a Google Pub/Sub topic subscription. Data is continuously written to Pub/Sub as it is received.
A current version of the data formats that the Interactions API can deliver is available here. As requests are received by the Interactions API, the DDx API team validates the requests and the fields in the main body of the API call. Note, DDx API does not validate data included in the metadata_json field.
For more information on SLAs and replayability, please reach out to MIG at [email protected] or in a joint Slack channel.
Usage Policies
DDx API has developed policies around acceptable use of the Interactions API in order to make sure it can best serve the needs of all of its users. These policies govern DDx API's approach to data security, rate limiting, data quality, volume, etc. The latest version of these policies will be shared with you as part of your onboarding.
Updated 11 days ago