Using the Audience Segments API, customers and data providers have control to onboard and activate the data they need to target in MediaMath Platform. As it's a self-service solution, turnaround time for updates is reduced from business days to minutes. The API is built using industry standard, open source REST APIs and is a scaleable way to handle all requests for both global and permissioned taxonomies. The service brings transparency to data activation at MediaMath, allowing customers and data providers oversight of relevant 1st and 3rd party audience data sets as well as the permissioning of those data sets.
Audience Segments API (2.0)
There are two ways to expose the data onboarded via server-to-server within MediaMath Platform:
- Taxonomies
- These can be global, meaning all MediaMath customers will have access to the segments within the taxonomy in MediaMath Platform.
- These can be permissioned so that only select MediaMath customers have access to the segments within the taxonomy in MediaMath Platform.
- External Data Segments
- These represent a single segment and are always permissioned.
- These are also referred to as Data Pixels.
It's possible to use both methods to achieve a mix of global and permissioned taxonomies & external data segments to suit your needs and the needs of your customers.
Note: The S2S data transfer is the same for both global and permissioned taxonomies, as well as external data segments.
Taxonomies are presented in MediaMath Platform as a hierarchical tree, where the first node (root node) is the data provider's name. Within the tree, media traders can expand selections of categories of segments and view an estimated audience size (the number of unique users) and a CPM price (USD by default).
In this view, the Audience Targeting view has been annotated to show the elements of a taxonomy:
Similar to global taxonomies, permissioned taxonomies are also presented in MediaMath Platform as a hierarchical tree, where the first node (root node) is the data provider's name. Within the tree, media traders can expand selections of categories of segments and view an estimated audience size (the number of unique users) and a CPM price (USD by default).
Permissioned taxonomies can include first and/or third party segments and are 'permissioned' or shared with specified entities, organizations, agencies and/or advertisers in MediaMath Platform.
As all taxonomy management utilizes the same underlying MediaMath API, the information shared in this section applies to both global and permissioned taxonomies, with the exception of the visibility of the taxonomy & permissioning.
Taxonomies are managed using one of two methods:
- a CSV file provided to MediaMath Support by the data provider,
- using the API.
For data providers not integrated with the API, taxonomies can be managed using a CSV file.
| Column Name | Example Value | Description | Type |
|---|---|---|---|
full_path | |Data.com|Age|30-35| | Pipe delimited node representation from root (must start with a pipe character) | String |
code | 12345 | Data provider's segment identifier, which should be unique to this segment | Integer |
uniques | 1000000 | Number of unique users in this segment (rounded estimate) | Integer |
wholesale_cpm | 0.80 | The CPM (Cost per Thousand Impressions) that MediaMath will pay the data provider, in US Dollars | Decimal (2dp) |
retail_cpm | 1.10 | The CPM (Cost per Thousand Impressions) that Buyers will pay MediaMath, in US Dollars. This is the value that is shown to buyers in the MediaMath Platform Audience Targeting Tab | Decimal (2dp) |
buyable | 1 | Used to separate segments from non-purchasable categories (which aid navigation in MediaMath Platform). When "1" it will be buyable; when "0" it is not buyable and only requires full_path field to be populated. | Integer 1 or 0 |
Note: The full_path always starts with a pipe.
| full_path | code | uniques | wholesale_cpm | retail_cpm | buyable |
|---|---|---|---|---|---|
| |BlueKai | 0 | ||||
| |BlueKai|Group 1 | 0 | ||||
| |BlueKai|Group 1|Segment 1 | 0 | ||||
| |BlueKai|Group 1|Segment 2 | 0 | ||||
| |BlueKai|Group 1|Segment 3 | 245244 | 661,664 | 0.85 | 1 | 1 |
| |BlueKai|Group 1|Segment 4 | 245245 | 3,585,118 | 0.85 | 1 | 1 |
| |BlueKai|Group 1|Segment 5 | 245246 | 5,247,410 | 0.85 | 1 | 1 |
| |BlueKai|Group 2 | 0 | ||||
| |BlueKai|Group 2|Segment 6 | 245247 | 34,355 | 0.85 | 1 | 1 |
| |BlueKai|Group 2|Segment 7 | 245248 | 13,248 | 0.85 | 1 | 1 |
| |BlueKai|Group 2|Segment 8 | 245249 | 8,242,543 | 0.85 | 1 | 1 |
| |BlueKai|Group 2|Segment 9 | 245250 | 9,857,983 | 0.85 | 1 | 1 |
| |BlueKai|Group 2|Segment 10 | 245251 | 34,324 | 0.85 | 1 | 1 |
To provide a taxonomy - global or permissioned - for your data in MediaMath Platform:
- Following the format above, produce a CSV containing your segments
- Validate the CSV file format
- Submit the properly formatted CSV, along with your vendor ID (obtained from the partnerships team) to MediaMath Support
- If requesting an update to an existing taxonomy, provide the taxonomy ID in your request as well
An external data segment (also known as a data pixel) is the output of a pixel mapping process that results in the creation of a single, permissioned audience segment. In contrast to a permissioned taxonomy, which can be managed via API and contain N segments, an external data segment represents one audience segment and is defined within the Onboard section of the Audiences module in MediaMath Platform.
External data segments are permissioned to specific agencies (MediaMath entity structure): organization > agency > advertiser) so all advertisers within the agency will have access to the external data segment. Prior to getting started, the data provider needs to be added to the agency in MediaMath Platform. To have a data provider added, contact your MediaMath representative.
If the data provider already has the appropriate access, follow these steps to get your external data segments created:
- Define an audience segment by creating an External Data Segment in the Onboard tab within the MediaMath Platform Audience module.
- Provide the pixel IDs created in step 1 to your data provider.
- Data provider will then submit a ticket directly to
pixelmapping@mediamath.com, including the following. Include each external data segment mapping in the body of the email (or Support ticket) in the line-separated format below.
Note: Requests to pixelmapping@mediamath.com are handled via an automated process, as long as the formatting below is followed in the subject and body of your email. If the format does not conform, requests will be handled within 1 business day.
External Data Segment Example Request
Subject Line: Data Provider Pixel Mapping Request
Description:
Please map the following
ns:8473,mm:679001
ns:8474,mm:679002
ns:8675,mm:679003
ns = the name space of the first pixel being mapped, refer below or reach out to MediaMath support if the namespace is unknown.
mm = MediaMath Namespace. This will always be "mm" in the mapping request.
XXXXXX = the partner's segment code sent to MediaMath via S2S.
YYYYYY = the MathTag ID ("MT_ID") associated with the MediaMath external data segment pixel created in step one.
Download OpenAPI description
Overview
URL
developers@mediamath.com
License
Languages
Servers
https://api.mediamath.com/dmp/v2.0/