Audience producer: PULL

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

For partners

Comments