Endpoints that allow Acoustic Exchange to pull audience data from the endpoint are considered a pull-type audience producer. To initiate the data exchange and related tasks, Acoustic Exchange calls APIs that are implemented by the endpoint.
Often, cloud-based business applications (also referred to as SaaS applications) connect to Acoustic Exchange as a pull-type audience producer.
The following table identifies the APIs that nay endpoint provider must implement to support actions that are expected of a pull-type audience producer.
| Action by the endpoint | API (Acoustic Exchange calls) |
|---|---|
|
Provide a list of audiences (segments) that are available to provide audience data. |
GET /v1/segments |
| Provide details about a specific source audience. | GET /v1/segments/{segmentId} |
| Upload available data to Acoustic Exchange. If no data is available, Acoustic Exchange requests that you create a data upload job. | GET /v1/segments/{segmentId}/data |
| Create a job to upload audience data when it becomes available. | POST /v1/jobs |
| Provide job status. Acoustic Exchange polls for job status. It continues to poll when data upload begins and until the upload completes. | GET /v1/jobs/{jobCategory} |
| Upload the requested audience data. | POST /v1/jobs/{jobId}/data |
Comments
0 comments
Article is closed for comments.