Data Dictionary

How to provide data of various types to the Scope3 API

App Store

Supported app stores: apple-app-store, google-play-store, amazon, roku, samsung, lg, vizio, microsoft

Brand

TODO

Channel

Supported channels: display-web, display-app, streaming-video, social, display, mobile

Country

The 2-letter country code (see ISO reference)

Country Group Code

A group of countries. Supported codes: ANZ, EMEA, APAC, EU, or LATAM

Device Type

Supported device types: pc, tablet, phone,tv

Format

Supported formats: image, video, text, dynamic (added Oct 2023)

Network

Supported networks: fixed, mobile

Operating System

OS of consumer device. For example ios.

Organization (Seller, Buyer)

An organization is a company in the media and ad tech ecosystem. Examples: Hearst or The Trade Desk. We reference organizations through their canonical domain name. For instance, hearst.com or thetradedesk.com. We often refer to organizations based on their role in a transaction, for instance, as the seller or the buyer.

Region

TODO

Transaction Method

TODO

Transaction Type and Identifier

Data uploaded to Scope3 may describe a variety of media transactions: a campaign, a line item, a deal, or an insertion order, referenced by transaction_type field. The identifier of the transaction goes into the transaction_identifier field.

As an example, to upload data about Deal ID "big_campaign_aug_promo_21", you would pass:

{"transaction_type": "DEAL", "transaction_identifier": "big_campaign_aug_promo_21"}