Usage

For partners to submit usage data for billing

Input Fields

FieldValueRequired?Comments
utc_datetimeDate in UTC. Preference is YYYY-MM-DD 01:10:15 but can support other formats.:white-check-mark:For monthly updates, use the first day of the month
activity_typeThe billable activity - see Data Dictionary:white-check-mark:This should match the contract setup in Scope3 - ask your CSM if unclear
impressionsThe number of billable impressionsFor volume-based contracts
currencyThe billing currency (eg USD or EUR)For revshare contractsMust match what is in the contract
net_revenue_to_scope3The revenue payable to Scope3For revshare contracts
clientSee Sharing Data with ClientsA unique identifier that can be used to reference customer's client - could be a billing ID or an account name
po_numberThe PO number to include on the invoiceIf a PO number is required on the invoice, it can be added here
deal_idstringRequired if deal_name providedtransaction
deal_namestringtransaction
campaign_idstringRequired if campaign_name providedtransaction
campaign_namestringtransaction
advertiser_idstringRequired if advertiser_name providedtransaction
advertiser_namestringtransaction
campaign_group_idstringRequired if campaign_group_name providedtransaction
campaign_group_namestringtransaction
line_item_idstringRequired if line_item_name providedtransaction
line_item_namestringtransaction
insertion_order_idstringRequired if insertion_order_name providedtransaction
insertion_order_namestringtransaction

Example

For a client that has both volume-based and revshare terms (for instance, $0.02 for measurement and a 70/30 revshare for optimization). Note that impressions are optional for revshare 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