DataLabel.org API Information

This page describes the upload API for advertising audiences and provides information about data formatting. Data must be uploaded in a Comma Separated Value (CSV) format with strings enclosed in double quotation marks. At present the system will produce data in CSV or JSON format, but will only accept CSV for upload.

Follow below links for further information and details.

Flat File Structure

Audience information must be delivered via CSV as noted above. The preferred format is a comma separated file, with column headings in the first row. Failing to specify a header row may result in rejected or corrupted results. Upload files may contain one or more records. String values should be enclosed in double quotes.

Some fields accept multiple values. Multi-value fields must be presented as a single string of enum code values, separated by semicolons and enclosed in double quotes.

Audience Fields

CSV Field Field Full Name Data Type Description
audience_id Provider's Audience ID String Audience segment's unique internal ID as specified by the Provider.
provider_domain Provider Domain String - top level domain Domain associated with the business entity making the attribute determination.
provider_name Provider Name String Name of the business entity making the attribute determination.
provider_email Provider Contact Email String - email Email address where provider can field inquiries about segment / cohort.
audience_name Provider's Audience Name String Provider's descriptive name of audience attribute contained in the segment / cohort.
taxonomy_id_list Standardized Audience ID(s) String - delimited ID list Semicolon separated list of the standardized IDs that, in combination, best describe audience attribute (as selected from IAB Tech Lab Audience Taxonomy 1.1 [LINK]). Audience taxonomy IDs with "Purchase Intent Classification" modifiers would be delimited via pipe character. Order of Audience IDs should be sequential, and order of modifiers attached to an ID should be alphabetical. Ex: "123|PIFI2|PIPV1;456|PIFI3;789|PIPV1".
audience_criteria Audience Segmentation Criteria String - free text max 500 chars Description of the rules applied by the seller that govern inclusion of data points into the online audience segment. Sellers may wish to include provenance, recency, and frequency logic, as well as core differentiating factors that a buyer may want to evaluate during purchase decision.
audience_precision_levels Audience Precision Levels String - Enum value(s) The level of granularity to which an audience was resolved. One or more code values from the Precision Level enumeration.
audience_scope Audience Scope String - Enum value(s) The contexts within which an attribute was determined. One or more code values from the Audience Scope enumeration.
originating_domain Originating Domain String - Enum value(s) Domain of the digital property where the audience originates.
audience_size Audience Size Number Estimated count of addressable units specified within "Audience Precision Level" field.
id_types ID Type(s) String - Enum value(s) The ID currencies that were analyzed in order to determine an audience attribute. One or more code values from the Audience ID Type enumeration.
geocode_list Geography String Semicolon separated list of the geographies in which the attribute data was collected. Values are from ISO-3166-1-alpha-3 code list.
privacy_compliance_mechanisms Privacy Compliance Mechanisms Used String - Enum value(s) Declaration of consumer data transparency and consent tools that provider applies. One or more code values from the Compliance Mechanism enumeration.
privacy_policy_url Privacy Policy String - web address Hyperlink to the seller's privacy policy.
iab_techlab_compliant IAB Tech Lab Compliant Flag Boolean Read-only response value indicating if the originating entity has passed IAB Tech Lab compliance program.
data_sources Data Source(s) String - Enum value(s) Origin of the raw data used to compile the audience. One or more code values from the Audience Detail Source enumeration.
audience_inclusion_methodology Data Inclusion Methodology String - Enum value(s) Description of seller's relationship to the audience attribute / information being sold. One or more code values from the Inclusion enumeration.
audience_expansion Audience Expansion Boolean Was look-a-like modeling used to include 'similar' IDs? Yes/No or True/False value
device_expansion Cross-device Expansion Boolean Was the segment expanded to include IDs thought to be associated with the devices of the same user, household, or business? Yes/No or True/False value
audience_refresh Audience Refresh Cadence String - Enum value Cadence of the audience refresh. One code value from the Time Period enumeration.
lookback_window Source Lookback Window String - Enum value Period in the past that a qualifying event can occur for inclusion in audience. One code value from the Time Period enumeration.
onboarder_match_keys Input ID / Match Key String - Enum value(s) Input ID/ Match Key used by the Onboarder for matching. One or more code values from the Match Key enumeration.
onboarder_audience_expansion Pre-onboarding Audience Expansion Tri-state value (Yes|No|N/A) Was look-a-like modeling used to include "similar" IDs before the data was matched to a digital identifier?
onboarder_device_expansion Pre-onboarding Cross Device Expansion Tri-state value (Yes|No|N/A) Was the audience expanded to include affiliated devices and IDs before the data was matched to a digital identifier?
onboarder_audience_precision_level Pre-onboarding Audience Precision Level String - Enum value(s) The level of granularity to which an audience was resolved before it was onboarded. One or more code values from the Precision Level enumeration.