Overview

The Data Marketplace API is provided as a way for Magenta Advertising Platform to ingest partner data and make it available for Audience Marketplace customers to use when building custom segments.

The API allows a data partner to define a set of Attributes associated with mobile advertising identifiers (IDFA and Google Play Ad Id are currently supported). Each of these Attributes can be thought of as segments or tags associated with a set of device identifiers; users on the Audience Marketplace can then incorporate these Attributes into the custom segments they build.

It is critically important to work with Audience Marketplace to decide on which Attributes to make available from your data set. Each Attribute must be given a name and a description, both of which will be seen by Audience Marketplace users.

For each Attribute, you will use the APIs described on the Attribute documentation page to first declare the Attribute to Audience Marketplace, setting all the necessary metadata. You do this one time, and can update, remove, or create new Attributes over time as needed.

Once you have created the Attributes on our platform, you can proceed to creating data files that tell the platform which advertising identifiers should be associated with each attribute (see the File Format section for details). Once your data files are ready for ingestion, you will upload them to an Amazon S3 bucket whose credentials we will supply to you, and then use the Import API to tell Audience Marketplace to ingest. You can also use APIs to check on ingestion status at the file level or at the Attribute level.

We hope you find this API straightforward to use. Please reach out to your Magenta Advertising Platform contact with any questions.

Authentication

All authentication to the API is done via an API key that is issued to each partner. The API key must be included as part of an Authorization header in the format of a Bearer token.

Authorization: Bearer

Request Access

For access to the API please email [email protected].