Usage

For partners to submit usage data for billing

Input fields

For further information on a field, click its name in the column to be taken to its definition in the Data Dictionary.

FieldData ValuePriority
utc_datetimestringRequired
activity_typestringRequired
impressionsinteger
currencystring
net_revenue_to_scope3integer
clientstring
deal_idstringRequired
if deal_name provided
po_numberinteger
deal_namestring
campaign_idstringRequired
if campaign_name provided
campaign_namestring
advertiser_idstringRequired
if advertiser_name provided
advertiser_namestring
campaign_group_idstringRequired
if campaign_group_name provided
campaign_group_namestring
line_item_idstringRequired
if line_item_name provided
line_item_namestring
[insertion_order_id\](https://docs.scope3.com/docs/data-dictionary#insertion_order_id)stringRequired
if insertion_order_name provided
insertion_order_namestring

Example

For a client with both volume-based and rev-share terms (for instance, $0.02 for measurement and a 70/30 rev-share for optimization), impressions are optional for rev-share rows but are fine to pass if helpful.

date,activity_type,impressions,currency,net_revenue_to_scope3,client
2023-09-01,MEASUREMENT,123322,,,bayer
2023-09-01,MEASUREMENT,8372810,,,unilever
2023-09-01,OPTIMIZATION,,USD,87.82,ford