Entity Write File Format

  • The Entity Write File Format is deprecated and users must use the DV360 API for programmatic creation and updating of line items.

  • This report does not include YouTube data.

  • Several columns in the table are read-only and ignored on upload, while others are writable for updating line item information.

  • The table provides detailed information on various line item parameters including IDs, names, status, timestamps, budgets, pacing, frequency settings, bid price, and partner revenue.

  • Targeting information such as audience targeting IDs and names are included but are read-only.

YouTube data will not be included in this report.

ColumnTypeWritableDescription
Line Item IDintegerNoNumeric ID value of the line item.
Partner NamestringNoThe name of the partner. Read-only, this value is ignored on upload.
Partner IDintegerNoNumeric ID value of the partner.
Advertiser NamestringNoThe name of the advertiser. Read-only, this value is ignored on upload.
IO NamestringNoThe name of the insertion order. Read-only, this value is ignored on upload.
Line Item NamestringYesThe name of the line item. Maximum length is 240 UTF-8 bytes.
Line Item TimestampintegerNoContains the timestamp for the line items. This is used by the system to verify that the line item has not changed between downloading and uploading.
Line Item StatusstringYesActive
Paused
Deleted
IO Start DatestringNoA timestamp for the flight start date of the insertion order in the format MM/DD/YYYY HH:mm.
IO End DatestringNoA timestamp for the flight end date of the insertion order in the format MM/DD/YYYY HH:mm.
IO Budget TypestringNoAmount
Impressions
IO Budget AmountfloatNoA positive budget amount for the budget type. This could be a simple integer impression value, or a float for a currency amount. Currencies will be shown in the advertiser's currency in standard units (not in 1/1,000,000s of a currency unit).
IO PacingstringNoDaily
Monthly
Flight
IO Pacing RatestringNoEven
ASAP
IO Pacing AmountstringNoValue corresponding to budget type.
Line Item Start DatestringYesA timestamp for the flight start date of the line item in the format MM/DD/YYYY HH:mm.
Line Item End DatestringYesA timestamp for the flight end date of the line item in the format MM/DD/YYYY HH:mm.
Line Item Budget TypestringYesUnlimited
Amount
Impressions
Line Item Budget AmountfloatYesA positive budget amount for the budget type. This could be a simple integer impression value, or a float for a currency amount. Currencies will be shown in the advertiser's currency in standard units (not in 1/1,000,000s of a currency unit).
Line Item PacingstringYesDaily
Monthly
Flight
Line Item Pacing RatestringYesASAP
Even
Ahead
Aggressive
Line Item Pacing AmountfloatYes
Line Item Frequency EnabledstringYesTrue
False
Line Item Frequency ExposuresintegerYesA positive integer amount for the number of impressions in a given LineItem Frequency Amount, that is, the x in "Show x impressions over y period".
Line Item Frequency PeriodstringYesMinutes
Hours
Days
Months
Line Item Frequency AmountintegerYesA positive integer amount for length of time of the LineItem Frequency Period type, that is, the y in "Show x impressions over y period".
Bid PricefloatYesA positive float amount for the bid price in the advertiser's currency in standard units (not in 1/1,000,000s of a currency unit).
Partner Revenue ModelStringTrueTMCM - Total Media Cost Markup
MCM - Media Cost Markup
CPM - Cost Per Thousand Impressions
Partner Revenue AmountfloatTrueA positive float value corresponding to the Partner Revenue Model.
Current Audience Targeting IDsstringNoThe user list IDs targeted by this line item. Read-only, this value is ignored on upload.
Current Audience Targeting NamesstringNoThe names of the user lists targeted by this line item. Read-only, this value is ignored on upload.