Reserved Display
Overview
Moloco provides three scheduled bulk data exports for Reserved Display:
- Order configuration snapshots.
- Line item configuration snapshots.
- Line item daily performance metrics.
Version Information
If you are already using Bulk Data Export please examine the data storage path to find your version number. The version (v1, v2, or v3) can be found after the name of your platform’s storage bucket.
- _gs://mcm-export-my-platform-name/v2/... (indicates data export version 2.0)
Version 3.0 Reserved Display data export
Reserved Display exports are delivered as Parquet files in a Google Cloud Storage bucket under the gs://mcm-export-{platform} prefix.
These exports are intended to support analytics, reporting, reconciliation, and integration with customer systems by separating:
- configuration snapshot data for Orders and Line Items.
- daily delivery and performance metrics at the Line Item level.
Data Formats and Storage Paths
All data is stored in parquet format, delivered each day using the following path structure:
gs://{bucket}/{version}/{export_type}/{date}/{file_name}
Parameters | Description |
|---|---|
| The name of the MCM bucket for your platform. |
| The version number (for example, |
| Reflects the data contents, campaign configuration or ad performance. |
| YYYY-MM-DD (e.g., |
| The name of the parquet data file(s). Multiple data files names are incremented by 1. |
Order configuration snapshot
Cadence: daily
Path: gs://mcm-export-{platform}/v3/campaign_config_snapshot/ad_type/reserved_display/order/YYYY-MM-DD/data-*
Purpose: daily snapshot of Reserved Display Order configuration
Reserved Display Order Configuration
| Field Name | Type | Mode | Description |
|---|---|---|---|
| date_tz | DATE | REQUIRED | The date in the customer's timezone. |
| ad_account_id | STRING | REQUIRED | The ad account (advertiser/brand) that owns the order |
| order_id | STRING | REQUIRED | Unique identifier of the order |
| order_title | STRING | REQUIRED | Descriptive name of the order |
| insertion_order_url | STRING | NULLABLE | URL referencing the Insertion Order document (used as a memo/label) |
| schedule_start | STRING | REQUIRED | Scheduled start time of the campaign (ISO 8601) |
| schedule_end | STRING | REQUIRED | Scheduled end time of the campaign (ISO 8601) |
| budget | RECORD | REQUIRED | Order-level budget (see below) |
| budget.period | STRING | REQUIRED | TOTAL only |
| budget.amount_micro | INTEGER | REQUIRED | Budget amount in micro units, in the platform's currency |
| created_at | STRING | REQUIRED | Timestamp when the order was created |
| updated_at | STRING | REQUIRED | Timestamp when the order was last updated |
Line item configuration snapshot
- Cadence: daily
- Path:
gs://mcm-export-{platform}/v3/campaign_config_snapshot/ad_type/reserved_display/line_item/YYYY-MM-DD/data- - Purpose: daily snapshot of Reserved Display Line Item configuration
Reserved Display Line Item
| Field Name | Type | Mode | Description |
|---|---|---|---|
| date_tz | DATE | REQUIRED | The date in the customer's timezone. |
| ad_account_id | STRING | REQUIRED | The ad account that owns the line item |
| order_id | STRING | REQUIRED | The parent order's ID |
| line_item_id | STRING | REQUIRED | Unique identifier of the line item |
| line_item_title | STRING | REQUIRED | Descriptive name of the line item |
| inventory_id | STRING | NULLABLE | The ad inventory (placement) this line item targets |
| assets | RECORD (array) | REQUIRED | Reserved Display creative asset(s) attached to the line item |
| assets[].asset_id | STRING | REQUIRED | Unique ID of the creative asset |
| assets[].active | BOOLEAN | REQUIRED | Whether the asset is active (true) or inactive (false) |
| landing_pages | RECORD (array) | REQUIRED | Landing destination(s) when a user clicks the ad |
| landing_pages[].type | STRING | REQUIRED | Landing type. For Reserved Display, CUSTOM_URL is supported |
| landing_pages[].active | BOOLEAN | REQUIRED | Whether the landing option is active |
| landing_pages[].setting | STRING | NULLABLE | Configuration value for the landing type (e.g., the URL itself) |
| schedule_start | STRING | REQUIRED | Scheduled start time of the line item |
| schedule_end | STRING | REQUIRED | Scheduled end time of the line item |
| ad_schedule | RECORD | NULLABLE | Dayparting (time-of-day / day-of-week) configuration |
| ad_schedule.dayparts[].day_of_week | STRING | REQUIRED | Day of the week (e.g., MONDAY) |
| ad_schedule.dayparts[].start_time.hour | INTEGER | REQUIRED | Start hour (0–23) |
| ad_schedule.dayparts[].end_time.hour | INTEGER | REQUIRED | End hour (0–23) |
| budget | RECORD | NULLABLE | Line item-level budget (overrides order budget when set) |
| budget.period | STRING | NULLABLE | TOTAL only |
| budget.amount_micro | INTEGER | NULLABLE | Budget amount in micro units |
| target_cpm | STRING | NULLABLE | Target cost per mille, in micro units |
| target_impression | INTEGER | NULLABLE | Target impressions for the line item |
| pacing | STRING | NULLABLE | Delivery pacing strategy: EVEN, ACCELERATED, or ASAP |
| priority | INTEGER | REQUIRED | Delivery priority — value between 1 and 10 |
| frequency_cap | RECORD | NULLABLE | Limit on how many times a single user may see this ad |
| frequency_cap.reset_period | STRING | REQUIRED | Window over which the cap resets: Hour, Day, Week, Month, or Lifetime |
| frequency_cap.max_impressions | INTEGER | REQUIRED | Maximum impressions allowed per user within the reset period |
| targeting | RECORD | NULLABLE | Targeting configuration |
| targeting.custom_setting.custom_target_list[].key_id | STRING | REQUIRED | Custom targeting key |
| targeting.custom_setting.custom_target_list[].value_id_list | ARRAY of STRING | REQUIRED | Allowed values for the custom targeting key |
| enabling_state | STRING | REQUIRED | ENABLED or DISABLED |
| created_at | STRING | REQUIRED | Timestamp when the line item was created |
| updated_at | STRING | REQUIRED | Timestamp when the line item was last updated |
Line item daily performance metrics
The Line item daily export provides aggregated daily performance metrics for Reserved Display at the line item level.
- Cadence: daily, for prior-day data.
- Path:
gs://mcm-export-{platform}/v3/report/ad_type/reserved_display/line_item_daily/YYYY-MM-DD/data-*. - Purpose: aggregated daily delivery metrics for Reserved Display line items.
| Field name | Description |
|---|---|
| platform_id | platform identifier |
| line_item_id | unique identifier of the line item |
| order_id | unique identifier of the parent order |
| date_tz | date the metrics apply to, in the platform’s timezone |
| timezone | imezone associated with the exported row |
| impressions | daily impression count |
| clicks | daily click count |
| reach | daily reach count |
NOTE
- Reserved Display metric data is exported daily for the previous day. Moloco can provide prior-day data as early as 2:00 AM local time, but customers should not treat 2:00 AM as the recommended production pull time.
- There may be a small gap between what users see in Campaign Manager and what appears in the daily export because the export is cut off at the end of the previous day.
- Moloco’s pipeline may retry and update the latest file timestamp. If your downstream process pulls files based on the latest timestamp, make sure to deduplicate records before using the data.
How to use the three exports together
The three Reserved Display exports are designed to be used together.
- Use the Order configuration snapshot for order-level schedule and budget context.
- Use the Line item configuration snapshot for line item setup details such as inventory, assets, landing pages, pacing, targeting, and frequency caps.
- Use the Line item daily export for daily delivery and performance metrics such as impressions, clicks, and reach.
- If you’d like to join the daily metric export with the configuration snapshot exports, you can do so by using
order_idandline_item_id.
Updated 2 days ago