Function legacyDeliveryResponse

Parameters

• data: {
      context?: Omit<Omit<{}, "bank">, "authentication"> & {
          authentication?: unknown;
      };
      governance_context?: string;
      notification_type?: | "scheduled"
      | "final"
      | "delayed"
      | "adjusted"
      | "window_update";
      partial_data?: boolean;
      unavailable_count?: number;
      sequence_number?: number;
      next_expected_at?: string;
      reporting_period: { start: string; end: string };
      currency?: string;
      attribution_window?: {
          post_click?: {
              interval: number;
              unit: "campaign" | "seconds" | "minutes" | "hours" | "days";
          };
          post_view?: {
              interval: number;
              unit: "campaign"
              | "seconds"
              | "minutes"
              | "hours"
              | "days";
          };
          model?: AttributionModel;
      };
      aggregated_totals?: {
          impressions: number;
          spend: number;
          clicks?: number;
          completed_views?: number;
          views?: number;
          conversions?: number;
          conversion_value?: number;
          commissionable_value?: number;
          roas?: number;
          new_to_brand_rate?: number;
          cost_per_acquisition?: number;
          completion_rate?: number
          | null;
          reach?: number;
          reach_unit?: ReachUnit;
          frequency?: number;
          media_buy_count: number;
          metric_aggregates?: (
              | {
                  scope: "standard";
                  metric_id: AvailableMetric;
                  qualifier?: {
                      viewability_standard?: ViewabilityStandard;
                      completion_source?: CompletionSource;
                      attribution_methodology?: AttributionMethodology;
                      attribution_window?: { interval: ...; unit: ... };
                      lift_dimension?: LiftDimension;
                  };
                  value: number;
                  measurable_impressions?: number;
                  viewable_impressions?: number;
                  impressions?: number;
                  completed_views?: number;
                  spend?: number;
                  conversions?: number;
                  conversion_value?: number;
                  clicks?: number;
              }
              | {
                  scope: "vendor";
                  vendor: {
                      domain: string;
                      brand_id?: string;
                      countries?: string[];
                      industries?: string[];
                      data_subject_contestation?: {
                          url?: (...)
                          | (...);
                          email?: (...) | (...);
                          languages?: (...) | (...);
                      };
                      brand_kit_override?: {
                          logo?: (...)
                          | (...);
                          colors?: (...) | (...);
                          voice?: (...) | (...);
                          tagline?: (...) | (...);
                      };
                  };
                  metric_id: string;
                  qualifier?: Omit<Omit<(...), (...)>, "authentication"> & {
                      authentication?: unknown;
                  };
                  value: number;
                  measurable_impressions?: number;
              }
          )[];
      };
      media_buy_deliveries: {
          media_buy_id: string;
          status: | "active"
          | "rejected"
          | "failed"
          | "pending"
          | "completed"
          | "pending_creatives"
          | "pending_start"
          | "paused"
          | "canceled"
          | "reporting_delayed";
          expected_availability?: string;
          is_adjusted?: boolean;
          is_final?: boolean;
          finalized_at?: string;
          pricing_model?: PricingModel;
          pacing_index?: number;
          totals: {
              impressions?: number;
              spend?: number;
              clicks?: number;
              ctr?: number;
              views?: number;
              completed_views?: number;
              completion_rate?: number
              | null;
              conversions?: number;
              conversion_value?: number;
              commissionable_value?: number;
              roas?: number;
              cost_per_acquisition?: number;
              new_to_brand_rate?: number;
              leads?: number;
              incremental_sales_lift?: number;
              brand_lift?: number;
              foot_traffic?: number;
              conversion_lift?: number;
              brand_search_lift?: number;
              plays?: number;
              by_event_type?: {
                  event_type: EventType;
                  event_source_id?: string;
                  count: number;
                  value?: number;
              }[];
              grps?: number;
              reach?: number;
              reach_unit?: ReachUnit;
              reach_window?: {
                  kind: "cumulative"
                  | "period"
                  | "rolling";
                  period?: {
                      interval: number;
                      unit: "campaign" | "seconds" | "minutes" | "hours" | "days";
                  };
              };
              frequency?: number;
              quartile_data?: | {
                  q1_views?: number;
                  q2_views?: number;
                  q3_views?: number;
                  q4_views?: number;
              }
              | null;
              dooh_metrics?: {
                  loop_plays?: number;
                  screens_used?: number;
                  screen_time_seconds?: number;
                  sov_achieved?: number;
                  calculation_notes?: string;
                  venue_breakdown?: {
                      venue_id: string;
                      venue_name?: string;
                      venue_type?: string;
                      impressions: number;
                      loop_plays?: number;
                      screens_used?: number;
                  }[];
              };
              viewability?: {
                  vendor?: {
                      domain: string;
                      brand_id?: string;
                      countries?: string[];
                      industries?: string[];
                      data_subject_contestation?: {
                          url?: (...)
                          | (...);
                          email?: (...) | (...);
                          languages?: (...) | (...);
                      };
                      brand_kit_override?: {
                          logo?: (...)
                          | (...);
                          colors?: (...) | (...);
                          voice?: (...) | (...);
                          tagline?: (...) | (...);
                      };
                  };
                  measurable_impressions?: number;
                  viewable_impressions?: number;
                  viewable_rate?: number;
                  viewed_seconds?: number;
                  standard?: ViewabilityStandard;
              };
              engagements?: number;
              follows?: number;
              saves?: number;
              profile_visits?: number;
              engagement_rate?: number;
              cost_per_click?: number;
              cost_per_completed_view?: number;
              cpm?: number;
              downloads?: number;
              units_sold?: number;
              new_to_brand_units?: number;
              by_action_source?: {
                  action_source: ActionSource;
                  event_source_id?: string;
                  count: number;
                  value?: number;
              }[];
              vendor_metric_values?: {
                  vendor: {
                      domain: string;
                      brand_id?: string;
                      countries?: string[];
                      industries?: string[];
                      data_subject_contestation?: {
                          url?: (...)
                          | (...);
                          email?: (...) | (...);
                          languages?: (...) | (...);
                      };
                      brand_kit_override?: {
                          logo?: (...)
                          | (...);
                          colors?: (...) | (...);
                          voice?: (...) | (...);
                          tagline?: (...) | (...);
                      };
                  };
                  metric_id: string;
                  value: number;
                  unit?: string;
                  measurable_impressions?: number;
                  breakdown?: Omit<Omit<(...), (...)>, "authentication"> & {
                      authentication?: unknown;
                  };
              }[];
              effective_rate?: number;
          };
          by_package: {
              impressions?: number;
              spend?: number;
              clicks?: number;
              ctr?: number;
              views?: number;
              completed_views?: number;
              completion_rate?: number
              | null;
              conversions?: number;
              conversion_value?: number;
              commissionable_value?: number;
              roas?: number;
              cost_per_acquisition?: number;
              new_to_brand_rate?: number;
              leads?: number;
              incremental_sales_lift?: number;
              brand_lift?: number;
              foot_traffic?: number;
              conversion_lift?: number;
              brand_search_lift?: number;
              plays?: number;
              by_event_type?: {
                  event_type: EventType;
                  event_source_id?: string;
                  count: number;
                  value?: number;
              }[];
              grps?: number;
              reach?: number;
              reach_unit?: ReachUnit;
              reach_window?: {
                  kind: "cumulative"
                  | "period"
                  | "rolling";
                  period?: {
                      interval: number;
                      unit: "campaign" | "seconds" | "minutes" | "hours" | "days";
                  };
              };
              frequency?: number;
              quartile_data?: | {
                  q1_views?: number;
                  q2_views?: number;
                  q3_views?: number;
                  q4_views?: number;
              }
              | null;
              dooh_metrics?: {
                  loop_plays?: number;
                  screens_used?: number;
                  screen_time_seconds?: number;
                  sov_achieved?: number;
                  calculation_notes?: string;
                  venue_breakdown?: {
                      venue_id: string;
                      venue_name?: (...)
                      | (...);
                      venue_type?: (...) | (...);
                      impressions: number;
                      loop_plays?: (...) | (...);
                      screens_used?: (...) | (...);
                  }[];
              };
              viewability?: {
                  vendor?: {
                      domain: string;
                      brand_id?: string;
                      countries?: (...)[];
                      industries?: (...)[];
                      data_subject_contestation?: { url?: ...; email?: ...; languages?: ... };
                      brand_kit_override?: {
                          logo?: ...;
                          colors?: ...;
                          voice?: ...;
                          tagline?: ...;
                      };
                  };
                  measurable_impressions?: number;
                  viewable_impressions?: number;
                  viewable_rate?: number;
                  viewed_seconds?: number;
                  standard?: ViewabilityStandard;
              };
              engagements?: number;
              follows?: number;
              saves?: number;
              profile_visits?: number;
              engagement_rate?: number;
              cost_per_click?: number;
              cost_per_completed_view?: number;
              cpm?: number;
              downloads?: number;
              units_sold?: number;
              new_to_brand_units?: number;
              by_action_source?: {
                  action_source: ActionSource;
                  event_source_id?: string;
                  count: number;
                  value?: number;
              }[];
              vendor_metric_values?: {
                  vendor: {
                      domain: string;
                      brand_id?: string;
                      countries?: (...)[];
                      industries?: (...)[];
                      data_subject_contestation?: { url?: ...; email?: ...; languages?: ... };
                      brand_kit_override?: {
                          logo?: ...;
                          colors?: ...;
                          voice?: ...;
                          tagline?: ...;
                      };
                  };
                  metric_id: string;
                  value: number;
                  unit?: string;
                  measurable_impressions?: number;
                  breakdown?: Omit<(...), (...)> & { authentication?: ... };
              }[];
              package_id: string;
              pacing_index?: number;
              pricing_model?: PricingModel;
              rate?: number;
              currency?: string;
              delivery_status?: DeliveryStatus;
              paused?: boolean;
              is_final?: boolean;
              finalized_at?: string;
              measurement_window?: string;
              supersedes_window?: string;
              missing_metrics?: (
                  | {
                      scope: "standard";
                      metric_id: AvailableMetric;
                      qualifier?: {
                          viewability_standard?: ...;
                          completion_source?: ...;
                          attribution_methodology?: ...;
                          attribution_window?: ...;
                          lift_dimension?: ...;
                      };
                  }
                  | {
                      scope: "vendor";
                      vendor: {
                          domain: string;
                          brand_id?: (...)
                          | (...);
                          countries?: (...) | (...);
                          industries?: (...) | (...);
                          data_subject_contestation?: (...) | (...);
                          brand_kit_override?: (...) | (...);
                      };
                      metric_id: string;
                  }
              )[];
              by_catalog_item?: {
                  impressions?: number;
                  spend?: number;
                  clicks?: number;
                  ctr?: number;
                  views?: number;
                  completed_views?: number;
                  completion_rate?: number
                  | null;
                  conversions?: number;
                  conversion_value?: number;
                  commissionable_value?: number;
                  roas?: number;
                  cost_per_acquisition?: number;
                  new_to_brand_rate?: number;
                  leads?: number;
                  incremental_sales_lift?: number;
                  brand_lift?: number;
                  foot_traffic?: number;
                  conversion_lift?: number;
                  brand_search_lift?: number;
                  plays?: number;
                  by_event_type?: {
                      event_type: ...;
                      event_source_id?: ...;
                      count: ...;
                      value?: ...;
                  }[];
                  grps?: number;
                  reach?: number;
                  reach_unit?: ReachUnit;
                  reach_window?: { kind: (...)
                  | (...)
                  | (...); period?: (...) | (...) };
                  frequency?: number;
                  quartile_data?:
                      | {
                          q1_views?: (...)
                          | (...);
                          q2_views?: (...) | (...);
                          q3_views?: (...) | (...);
                          q4_views?: (...) | (...);
                      }
                      | null;
                  dooh_metrics?: {
                      loop_plays?: (...)
                      | (...);
                      screens_used?: (...) | (...);
                      screen_time_seconds?: (...) | (...);
                      sov_achieved?: (...) | (...);
                      calculation_notes?: (...) | (...);
                      venue_breakdown?: (...) | (...);
                  };
                  viewability?: {
                      vendor?: (...)
                      | (...);
                      measurable_impressions?: (...) | (...);
                      viewable_impressions?: (...) | (...);
                      viewable_rate?: (...) | (...);
                      viewed_seconds?: (...) | (...);
                      standard?: (...) | (...);
                  };
                  engagements?: number;
                  follows?: number;
                  saves?: number;
                  profile_visits?: number;
                  engagement_rate?: number;
                  cost_per_click?: number;
                  cost_per_completed_view?: number;
                  cpm?: number;
                  downloads?: number;
                  units_sold?: number;
                  new_to_brand_units?: number;
                  by_action_source?: {
                      action_source: ...;
                      event_source_id?: ...;
                      count: ...;
                      value?: ...;
                  }[];
                  vendor_metric_values?: {
                      vendor: ...;
                      metric_id: ...;
                      value: ...;
                      unit?: ...;
                      measurable_impressions?: ...;
                      breakdown?: ...;
                  }[];
                  content_id?: string;
                  content_id_type?: ContentIDType;
              }[];
              by_creative?: {
                  impressions?: number;
                  spend?: number;
                  clicks?: number;
                  ctr?: number;
                  views?: number;
                  completed_views?: number;
                  completion_rate?: number
                  | null;
                  conversions?: number;
                  conversion_value?: number;
                  commissionable_value?: number;
                  roas?: number;
                  cost_per_acquisition?: number;
                  new_to_brand_rate?: number;
                  leads?: number;
                  incremental_sales_lift?: number;
                  brand_lift?: number;
                  foot_traffic?: number;
                  conversion_lift?: number;
                  brand_search_lift?: number;
                  plays?: number;
                  by_event_type?: {
                      event_type: ...;
                      event_source_id?: ...;
                      count: ...;
                      value?: ...;
                  }[];
                  grps?: number;
                  reach?: number;
                  reach_unit?: ReachUnit;
                  reach_window?: { kind: (...)
                  | (...)
                  | (...); period?: (...) | (...) };
                  frequency?: number;
                  quartile_data?:
                      | {
                          q1_views?: (...)
                          | (...);
                          q2_views?: (...) | (...);
                          q3_views?: (...) | (...);
                          q4_views?: (...) | (...);
                      }
                      | null;
                  dooh_metrics?: {
                      loop_plays?: (...)
                      | (...);
                      screens_used?: (...) | (...);
                      screen_time_seconds?: (...) | (...);
                      sov_achieved?: (...) | (...);
                      calculation_notes?: (...) | (...);
                      venue_breakdown?: (...) | (...);
                  };
                  viewability?: {
                      vendor?: (...)
                      | (...);
                      measurable_impressions?: (...) | (...);
                      viewable_impressions?: (...) | (...);
                      viewable_rate?: (...) | (...);
                      viewed_seconds?: (...) | (...);
                      standard?: (...) | (...);
                  };
                  engagements?: number;
                  follows?: number;
                  saves?: number;
                  profile_visits?: number;
                  engagement_rate?: number;
                  cost_per_click?: number;
                  cost_per_completed_view?: number;
                  cpm?: number;
                  downloads?: number;
                  units_sold?: number;
                  new_to_brand_units?: number;
                  by_action_source?: {
                      action_source: ...;
                      event_source_id?: ...;
                      count: ...;
                      value?: ...;
                  }[];
                  vendor_metric_values?: {
                      vendor: ...;
                      metric_id: ...;
                      value: ...;
                      unit?: ...;
                      measurable_impressions?: ...;
                      breakdown?: ...;
                  }[];
                  creative_id: string;
                  weight?: number;
              }[];
              by_keyword?: {
                  impressions?: number;
                  spend?: number;
                  clicks?: number;
                  ctr?: number;
                  views?: number;
                  completed_views?: number;
                  completion_rate?: number
                  | null;
                  conversions?: number;
                  conversion_value?: number;
                  commissionable_value?: number;
                  roas?: number;
                  cost_per_acquisition?: number;
                  new_to_brand_rate?: number;
                  leads?: number;
                  incremental_sales_lift?: number;
                  brand_lift?: number;
                  foot_traffic?: number;
                  conversion_lift?: number;
                  brand_search_lift?: number;
                  plays?: number;
                  by_event_type?: {
                      event_type: ...;
                      event_source_id?: ...;
                      count: ...;
                      value?: ...;
                  }[];
                  grps?: number;
                  reach?: number;
                  reach_unit?: ReachUnit;
                  reach_window?: { kind: (...)
                  | (...)
                  | (...); period?: (...) | (...) };
                  frequency?: number;
                  quartile_data?:
                      | {
                          q1_views?: (...)
                          | (...);
                          q2_views?: (...) | (...);
                          q3_views?: (...) | (...);
                          q4_views?: (...) | (...);
                      }
                      | null;
                  dooh_metrics?: {
                      loop_plays?: (...)
                      | (...);
                      screens_used?: (...) | (...);
                      screen_time_seconds?: (...) | (...);
                      sov_achieved?: (...) | (...);
                      calculation_notes?: (...) | (...);
                      venue_breakdown?: (...) | (...);
                  };
                  viewability?: {
                      vendor?: (...)
                      | (...);
                      measurable_impressions?: (...) | (...);
                      viewable_impressions?: (...) | (...);
                      viewable_rate?: (...) | (...);
                      viewed_seconds?: (...) | (...);
                      standard?: (...) | (...);
                  };
                  engagements?: number;
                  follows?: number;
                  saves?: number;
                  profile_visits?: number;
                  engagement_rate?: number;
                  cost_per_click?: number;
                  cost_per_completed_view?: number;
                  cpm?: number;
                  downloads?: number;
                  units_sold?: number;
                  new_to_brand_units?: number;
                  by_action_source?: {
                      action_source: ...;
                      event_source_id?: ...;
                      count: ...;
                      value?: ...;
                  }[];
                  vendor_metric_values?: {
                      vendor: ...;
                      metric_id: ...;
                      value: ...;
                      unit?: ...;
                      measurable_impressions?: ...;
                      breakdown?: ...;
                  }[];
                  keyword?: string;
                  match_type?: MatchType;
              }[];
              by_geo?: {
                  impressions?: number;
                  spend?: number;
                  clicks?: number;
                  ctr?: number;
                  views?: number;
                  completed_views?: number;
                  completion_rate?: number
                  | null;
                  conversions?: number;
                  conversion_value?: number;
                  commissionable_value?: number;
                  roas?: number;
                  cost_per_acquisition?: number;
                  new_to_brand_rate?: number;
                  leads?: number;
                  incremental_sales_lift?: number;
                  brand_lift?: number;
                  foot_traffic?: number;
                  conversion_lift?: number;
                  brand_search_lift?: number;
                  plays?: number;
                  by_event_type?: {
                      event_type: ...;
                      event_source_id?: ...;
                      count: ...;
                      value?: ...;
                  }[];
                  grps?: number;
                  reach?: number;
                  reach_unit?: ReachUnit;
                  reach_window?: { kind: (...)
                  | (...)
                  | (...); period?: (...) | (...) };
                  frequency?: number;
                  quartile_data?:
                      | {
                          q1_views?: (...)
                          | (...);
                          q2_views?: (...) | (...);
                          q3_views?: (...) | (...);
                          q4_views?: (...) | (...);
                      }
                      | null;
                  dooh_metrics?: {
                      loop_plays?: (...)
                      | (...);
                      screens_used?: (...) | (...);
                      screen_time_seconds?: (...) | (...);
                      sov_achieved?: (...) | (...);
                      calculation_notes?: (...) | (...);
                      venue_breakdown?: (...) | (...);
                  };
                  viewability?: {
                      vendor?: (...)
                      | (...);
                      measurable_impressions?: (...) | (...);
                      viewable_impressions?: (...) | (...);
                      viewable_rate?: (...) | (...);
                      viewed_seconds?: (...) | (...);
                      standard?: (...) | (...);
                  };
                  engagements?: number;
                  follows?: number;
                  saves?: number;
                  profile_visits?: number;
                  engagement_rate?: number;
                  cost_per_click?: number;
                  cost_per_completed_view?: number;
                  cpm?: number;
                  downloads?: number;
                  units_sold?: number;
                  new_to_brand_units?: number;
                  by_action_source?: {
                      action_source: ...;
                      event_source_id?: ...;
                      count: ...;
                      value?: ...;
                  }[];
                  vendor_metric_values?: {
                      vendor: ...;
                      metric_id: ...;
                      value: ...;
                      unit?: ...;
                      measurable_impressions?: ...;
                      breakdown?: ...;
                  }[];
                  geo_level?: GeographicTargetingLevel;
                  system?: string;
                  country?: string;
                  geo_code?: string;
                  geo_name?: string;
              }[];
              by_geo_truncated?: boolean;
              by_device_type?: {
                  impressions?: number;
                  spend?: number;
                  clicks?: number;
                  ctr?: number;
                  views?: number;
                  completed_views?: number;
                  completion_rate?: number
                  | null;
                  conversions?: number;
                  conversion_value?: number;
                  commissionable_value?: number;
                  roas?: number;
                  cost_per_acquisition?: number;
                  new_to_brand_rate?: number;
                  leads?: number;
                  incremental_sales_lift?: number;
                  brand_lift?: number;
                  foot_traffic?: number;
                  conversion_lift?: number;
                  brand_search_lift?: number;
                  plays?: number;
                  by_event_type?: {
                      event_type: ...;
                      event_source_id?: ...;
                      count: ...;
                      value?: ...;
                  }[];
                  grps?: number;
                  reach?: number;
                  reach_unit?: ReachUnit;
                  reach_window?: { kind: (...)
                  | (...)
                  | (...); period?: (...) | (...) };
                  frequency?: number;
                  quartile_data?:
                      | {
                          q1_views?: (...)
                          | (...);
                          q2_views?: (...) | (...);
                          q3_views?: (...) | (...);
                          q4_views?: (...) | (...);
                      }
                      | null;
                  dooh_metrics?: {
                      loop_plays?: (...)
                      | (...);
                      screens_used?: (...) | (...);
                      screen_time_seconds?: (...) | (...);
                      sov_achieved?: (...) | (...);
                      calculation_notes?: (...) | (...);
                      venue_breakdown?: (...) | (...);
                  };
                  viewability?: {
                      vendor?: (...)
                      | (...);
                      measurable_impressions?: (...) | (...);
                      viewable_impressions?: (...) | (...);
                      viewable_rate?: (...) | (...);
                      viewed_seconds?: (...) | (...);
                      standard?: (...) | (...);
                  };
                  engagements?: number;
                  follows?: number;
                  saves?: number;
                  profile_visits?: number;
                  engagement_rate?: number;
                  cost_per_click?: number;
                  cost_per_completed_view?: number;
                  cpm?: number;
                  downloads?: number;
                  units_sold?: number;
                  new_to_brand_units?: number;
                  by_action_source?: {
                      action_source: ...;
                      event_source_id?: ...;
                      count: ...;
                      value?: ...;
                  }[];
                  vendor_metric_values?: {
                      vendor: ...;
                      metric_id: ...;
                      value: ...;
                      unit?: ...;
                      measurable_impressions?: ...;
                      breakdown?: ...;
                  }[];
                  device_type?: DeviceType;
              }[];
              by_device_type_truncated?: boolean;
              by_device_platform?: {
                  impressions?: number;
                  spend?: number;
                  clicks?: number;
                  ctr?: number;
                  views?: number;
                  completed_views?: number;
                  completion_rate?: number
                  | null;
                  conversions?: number;
                  conversion_value?: number;
                  commissionable_value?: number;
                  roas?: number;
                  cost_per_acquisition?: number;
                  new_to_brand_rate?: number;
                  leads?: number;
                  incremental_sales_lift?: number;
                  brand_lift?: number;
                  foot_traffic?: number;
                  conversion_lift?: number;
                  brand_search_lift?: number;
                  plays?: number;
                  by_event_type?: {
                      event_type: ...;
                      event_source_id?: ...;
                      count: ...;
                      value?: ...;
                  }[];
                  grps?: number;
                  reach?: number;
                  reach_unit?: ReachUnit;
                  reach_window?: { kind: (...)
                  | (...)
                  | (...); period?: (...) | (...) };
                  frequency?: number;
                  quartile_data?:
                      | {
                          q1_views?: (...)
                          | (...);
                          q2_views?: (...) | (...);
                          q3_views?: (...) | (...);
                          q4_views?: (...) | (...);
                      }
                      | null;
                  dooh_metrics?: {
                      loop_plays?: (...)
                      | (...);
                      screens_used?: (...) | (...);
                      screen_time_seconds?: (...) | (...);
                      sov_achieved?: (...) | (...);
                      calculation_notes?: (...) | (...);
                      venue_breakdown?: (...) | (...);
                  };
                  viewability?: {
                      vendor?: (...)
                      | (...);
                      measurable_impressions?: (...) | (...);
                      viewable_impressions?: (...) | (...);
                      viewable_rate?: (...) | (...);
                      viewed_seconds?: (...) | (...);
                      standard?: (...) | (...);
                  };
                  engagements?: number;
                  follows?: number;
                  saves?: number;
                  profile_visits?: number;
                  engagement_rate?: number;
                  cost_per_click?: number;
                  cost_per_completed_view?: number;
                  cpm?: number;
                  downloads?: number;
                  units_sold?: number;
                  new_to_brand_units?: number;
                  by_action_source?: {
                      action_source: ...;
                      event_source_id?: ...;
                      count: ...;
                      value?: ...;
                  }[];
                  vendor_metric_values?: {
                      vendor: ...;
                      metric_id: ...;
                      value: ...;
                      unit?: ...;
                      measurable_impressions?: ...;
                      breakdown?: ...;
                  }[];
                  device_platform?: DevicePlatform;
              }[];
              by_device_platform_truncated?: boolean;
              by_audience?: {
                  impressions?: number;
                  spend?: number;
                  clicks?: number;
                  ctr?: number;
                  views?: number;
                  completed_views?: number;
                  completion_rate?: number
                  | null;
                  conversions?: number;
                  conversion_value?: number;
                  commissionable_value?: number;
                  roas?: number;
                  cost_per_acquisition?: number;
                  new_to_brand_rate?: number;
                  leads?: number;
                  incremental_sales_lift?: number;
                  brand_lift?: number;
                  foot_traffic?: number;
                  conversion_lift?: number;
                  brand_search_lift?: number;
                  plays?: number;
                  by_event_type?: {
                      event_type: ...;
                      event_source_id?: ...;
                      count: ...;
                      value?: ...;
                  }[];
                  grps?: number;
                  reach?: number;
                  reach_unit?: ReachUnit;
                  reach_window?: { kind: (...)
                  | (...)
                  | (...); period?: (...) | (...) };
                  frequency?: number;
                  quartile_data?:
                      | {
                          q1_views?: (...)
                          | (...);
                          q2_views?: (...) | (...);
                          q3_views?: (...) | (...);
                          q4_views?: (...) | (...);
                      }
                      | null;
                  dooh_metrics?: {
                      loop_plays?: (...)
                      | (...);
                      screens_used?: (...) | (...);
                      screen_time_seconds?: (...) | (...);
                      sov_achieved?: (...) | (...);
                      calculation_notes?: (...) | (...);
                      venue_breakdown?: (...) | (...);
                  };
                  viewability?: {
                      vendor?: (...)
                      | (...);
                      measurable_impressions?: (...) | (...);
                      viewable_impressions?: (...) | (...);
                      viewable_rate?: (...) | (...);
                      viewed_seconds?: (...) | (...);
                      standard?: (...) | (...);
                  };
                  engagements?: number;
                  follows?: number;
                  saves?: number;
                  profile_visits?: number;
                  engagement_rate?: number;
                  cost_per_click?: number;
                  cost_per_completed_view?: number;
                  cpm?: number;
                  downloads?: number;
                  units_sold?: number;
                  new_to_brand_units?: number;
                  by_action_source?: {
                      action_source: ...;
                      event_source_id?: ...;
                      count: ...;
                      value?: ...;
                  }[];
                  vendor_metric_values?: {
                      vendor: ...;
                      metric_id: ...;
                      value: ...;
                      unit?: ...;
                      measurable_impressions?: ...;
                      breakdown?: ...;
                  }[];
                  audience_id?: string;
                  audience_source?: AudienceSource;
                  audience_name?: string;
              }[];
              by_audience_truncated?: boolean;
              by_demographic?: {
                  impressions?: number;
                  spend?: number;
                  clicks?: number;
                  ctr?: number;
                  views?: number;
                  completed_views?: number;
                  completion_rate?: number
                  | null;
                  conversions?: number;
                  conversion_value?: number;
                  commissionable_value?: number;
                  roas?: number;
                  cost_per_acquisition?: number;
                  new_to_brand_rate?: number;
                  leads?: number;
                  incremental_sales_lift?: number;
                  brand_lift?: number;
                  foot_traffic?: number;
                  conversion_lift?: number;
                  brand_search_lift?: number;
                  plays?: number;
                  by_event_type?: {
                      event_type: ...;
                      event_source_id?: ...;
                      count: ...;
                      value?: ...;
                  }[];
                  grps?: number;
                  reach?: number;
                  reach_unit?: ReachUnit;
                  reach_window?: { kind: (...)
                  | (...)
                  | (...); period?: (...) | (...) };
                  frequency?: number;
                  quartile_data?:
                      | {
                          q1_views?: (...)
                          | (...);
                          q2_views?: (...) | (...);
                          q3_views?: (...) | (...);
                          q4_views?: (...) | (...);
                      }
                      | null;
                  dooh_metrics?: {
                      loop_plays?: (...)
                      | (...);
                      screens_used?: (...) | (...);
                      screen_time_seconds?: (...) | (...);
                      sov_achieved?: (...) | (...);
                      calculation_notes?: (...) | (...);
                      venue_breakdown?: (...) | (...);
                  };
                  viewability?: {
                      vendor?: (...)
                      | (...);
                      measurable_impressions?: (...) | (...);
                      viewable_impressions?: (...) | (...);
                      viewable_rate?: (...) | (...);
                      viewed_seconds?: (...) | (...);
                      standard?: (...) | (...);
                  };
                  engagements?: number;
                  follows?: number;
                  saves?: number;
                  profile_visits?: number;
                  engagement_rate?: number;
                  cost_per_click?: number;
                  cost_per_completed_view?: number;
                  cpm?: number;
                  downloads?: number;
                  units_sold?: number;
                  new_to_brand_units?: number;
                  by_action_source?: {
                      action_source: ...;
                      event_source_id?: ...;
                      count: ...;
                      value?: ...;
                  }[];
                  vendor_metric_values?: {
                      vendor: ...;
                      metric_id: ...;
                      value: ...;
                      unit?: ...;
                      measurable_impressions?: ...;
                      breakdown?: ...;
                  }[];
                  demographic: string;
                  demographic_system: DemographicSystem;
                  age?: {
                      min?: (...)
                      | (...);
                      max?: (...) | (...);
                      include_unknown: boolean;
                  };
              }[];
              by_demographic_truncated?: boolean;
              by_demographic_suppressed?: boolean;
              by_placement?: {
                  impressions?: number;
                  spend?: number;
                  clicks?: number;
                  ctr?: number;
                  views?: number;
                  completed_views?: number;
                  completion_rate?: number
                  | null;
                  conversions?: number;
                  conversion_value?: number;
                  commissionable_value?: number;
                  roas?: number;
                  cost_per_acquisition?: number;
                  new_to_brand_rate?: number;
                  leads?: number;
                  incremental_sales_lift?: number;
                  brand_lift?: number;
                  foot_traffic?: number;
                  conversion_lift?: number;
                  brand_search_lift?: number;
                  plays?: number;
                  by_event_type?: {
                      event_type: ...;
                      event_source_id?: ...;
                      count: ...;
                      value?: ...;
                  }[];
                  grps?: number;
                  reach?: number;
                  reach_unit?: ReachUnit;
                  reach_window?: { kind: (...)
                  | (...)
                  | (...); period?: (...) | (...) };
                  frequency?: number;
                  quartile_data?:
                      | {
                          q1_views?: (...)
                          | (...);
                          q2_views?: (...) | (...);
                          q3_views?: (...) | (...);
                          q4_views?: (...) | (...);
                      }
                      | null;
                  dooh_metrics?: {
                      loop_plays?: (...)
                      | (...);
                      screens_used?: (...) | (...);
                      screen_time_seconds?: (...) | (...);
                      sov_achieved?: (...) | (...);
                      calculation_notes?: (...) | (...);
                      venue_breakdown?: (...) | (...);
                  };
                  viewability?: {
                      vendor?: (...)
                      | (...);
                      measurable_impressions?: (...) | (...);
                      viewable_impressions?: (...) | (...);
                      viewable_rate?: (...) | (...);
                      viewed_seconds?: (...) | (...);
                      standard?: (...) | (...);
                  };
                  engagements?: number;
                  follows?: number;
                  saves?: number;
                  profile_visits?: number;
                  engagement_rate?: number;
                  cost_per_click?: number;
                  cost_per_completed_view?: number;
                  cpm?: number;
                  downloads?: number;
                  units_sold?: number;
                  new_to_brand_units?: number;
                  by_action_source?: {
                      action_source: ...;
                      event_source_id?: ...;
                      count: ...;
                      value?: ...;
                  }[];
                  vendor_metric_values?: {
                      vendor: ...;
                      metric_id: ...;
                      value: ...;
                      unit?: ...;
                      measurable_impressions?: ...;
                      breakdown?: ...;
                  }[];
                  placement_id?: string;
                  placement_name?: string;
                  publisher_domain?: string;
              }[];
              by_placement_truncated?: boolean;
              by_spot?: {
                  impressions?: number;
                  spend?: number;
                  clicks?: number;
                  ctr?: number;
                  views?: number;
                  completed_views?: number;
                  completion_rate?: number
                  | null;
                  conversions?: number;
                  conversion_value?: number;
                  commissionable_value?: number;
                  roas?: number;
                  cost_per_acquisition?: number;
                  new_to_brand_rate?: number;
                  leads?: number;
                  incremental_sales_lift?: number;
                  brand_lift?: number;
                  foot_traffic?: number;
                  conversion_lift?: number;
                  brand_search_lift?: number;
                  plays?: number;
                  by_event_type?: {
                      event_type: ...;
                      event_source_id?: ...;
                      count: ...;
                      value?: ...;
                  }[];
                  grps?: number;
                  reach?: number;
                  reach_unit?: ReachUnit;
                  reach_window?: { kind: (...)
                  | (...)
                  | (...); period?: (...) | (...) };
                  frequency?: number;
                  quartile_data?:
                      | {
                          q1_views?: (...)
                          | (...);
                          q2_views?: (...) | (...);
                          q3_views?: (...) | (...);
                          q4_views?: (...) | (...);
                      }
                      | null;
                  dooh_metrics?: {
                      loop_plays?: (...)
                      | (...);
                      screens_used?: (...) | (...);
                      screen_time_seconds?: (...) | (...);
                      sov_achieved?: (...) | (...);
                      calculation_notes?: (...) | (...);
                      venue_breakdown?: (...) | (...);
                  };
                  viewability?: {
                      vendor?: (...)
                      | (...);
                      measurable_impressions?: (...) | (...);
                      viewable_impressions?: (...) | (...);
                      viewable_rate?: (...) | (...);
                      viewed_seconds?: (...) | (...);
                      standard?: (...) | (...);
                  };
                  engagements?: number;
                  follows?: number;
                  saves?: number;
                  profile_visits?: number;
                  engagement_rate?: number;
                  cost_per_click?: number;
                  cost_per_completed_view?: number;
                  cpm?: number;
                  downloads?: number;
                  units_sold?: number;
                  new_to_brand_units?: number;
                  by_action_source?: {
                      action_source: ...;
                      event_source_id?: ...;
                      count: ...;
                      value?: ...;
                  }[];
                  vendor_metric_values?: {
                      vendor: ...;
                      metric_id: ...;
                      value: ...;
                      unit?: ...;
                      measurable_impressions?: ...;
                      breakdown?: ...;
                  }[];
                  spot_id: string;
                  aired_at: string;
                  network?: string;
                  station?: string;
                  daypart?: string;
              }[];
              by_spot_truncated?: boolean;
              daily_breakdown?: {
                  date: string;
                  impressions: number;
                  spend: number;
                  conversions?: number;
                  conversion_value?: number;
                  commissionable_value?: number;
                  roas?: number;
                  new_to_brand_rate?: number;
              }[];
          }[];
          windows?: {
              window_start: string;
              window_end: string;
              totals: {
                  impressions?: number;
                  spend?: number;
                  clicks?: number;
                  ctr?: number;
                  views?: number;
                  completed_views?: number;
                  completion_rate?: number
                  | null;
                  conversions?: number;
                  conversion_value?: number;
                  commissionable_value?: number;
                  roas?: number;
                  cost_per_acquisition?: number;
                  new_to_brand_rate?: number;
                  leads?: number;
                  incremental_sales_lift?: number;
                  brand_lift?: number;
                  foot_traffic?: number;
                  conversion_lift?: number;
                  brand_search_lift?: number;
                  plays?: number;
                  by_event_type?: {
                      event_type: EventType;
                      event_source_id?: (...) | (...);
                      count: number;
                      value?: (...) | (...);
                  }[];
                  grps?: number;
                  reach?: number;
                  reach_unit?: ReachUnit;
                  reach_window?: {
                      kind: "cumulative"
                      | "period"
                      | "rolling";
                      period?: { interval: ...; unit: ... };
                  };
                  frequency?: number;
                  quartile_data?: | {
                      q1_views?: number;
                      q2_views?: number;
                      q3_views?: number;
                      q4_views?: number;
                  }
                  | null;
                  dooh_metrics?: {
                      loop_plays?: number;
                      screens_used?: number;
                      screen_time_seconds?: number;
                      sov_achieved?: number;
                      calculation_notes?: string;
                      venue_breakdown?: (...)[];
                  };
                  viewability?: {
                      vendor?: {
                          domain: ...;
                          brand_id?: ...;
                          countries?: ...;
                          industries?: ...;
                          data_subject_contestation?: ...;
                          brand_kit_override?: ...;
                      };
                      measurable_impressions?: number;
                      viewable_impressions?: number;
                      viewable_rate?: number;
                      viewed_seconds?: number;
                      standard?: ViewabilityStandard;
                  };
                  engagements?: number;
                  follows?: number;
                  saves?: number;
                  profile_visits?: number;
                  engagement_rate?: number;
                  cost_per_click?: number;
                  cost_per_completed_view?: number;
                  cpm?: number;
                  downloads?: number;
                  units_sold?: number;
                  new_to_brand_units?: number;
                  by_action_source?: {
                      action_source: ActionSource;
                      event_source_id?: (...)
                      | (...);
                      count: number;
                      value?: (...) | (...);
                  }[];
                  vendor_metric_values?: {
                      vendor: {
                          domain: ...;
                          brand_id?: ...;
                          countries?: ...;
                          industries?: ...;
                          data_subject_contestation?: ...;
                          brand_kit_override?: ...;
                      };
                      metric_id: string;
                      value: number;
                      unit?: (...)
                      | (...);
                      measurable_impressions?: (...) | (...);
                      breakdown?: (...) | (...);
                  }[];
              };
              by_package?: {
                  impressions?: number;
                  spend?: number;
                  clicks?: number;
                  ctr?: number;
                  views?: number;
                  completed_views?: number;
                  completion_rate?: number
                  | null;
                  conversions?: number;
                  conversion_value?: number;
                  commissionable_value?: number;
                  roas?: number;
                  cost_per_acquisition?: number;
                  new_to_brand_rate?: number;
                  leads?: number;
                  incremental_sales_lift?: number;
                  brand_lift?: number;
                  foot_traffic?: number;
                  conversion_lift?: number;
                  brand_search_lift?: number;
                  plays?: number;
                  by_event_type?: (...)[];
                  grps?: number;
                  reach?: number;
                  reach_unit?: ReachUnit;
                  reach_window?: { kind: ...; period?: ... };
                  frequency?: number;
                  quartile_data?:
                      | { q1_views?: ...; q2_views?: ...; q3_views?: ...; q4_views?: ... }
                      | null;
                  dooh_metrics?: {
                      loop_plays?: ...;
                      screens_used?: ...;
                      screen_time_seconds?: ...;
                      sov_achieved?: ...;
                      calculation_notes?: ...;
                      venue_breakdown?: ...;
                  };
                  viewability?: {
                      vendor?: ...;
                      measurable_impressions?: ...;
                      viewable_impressions?: ...;
                      viewable_rate?: ...;
                      viewed_seconds?: ...;
                      standard?: ...;
                  };
                  engagements?: number;
                  follows?: number;
                  saves?: number;
                  profile_visits?: number;
                  engagement_rate?: number;
                  cost_per_click?: number;
                  cost_per_completed_view?: number;
                  cpm?: number;
                  downloads?: number;
                  units_sold?: number;
                  new_to_brand_units?: number;
                  by_action_source?: (...)[];
                  vendor_metric_values?: (...)[];
                  package_id: string;
              }[];
              is_final?: boolean;
              measurement_window?: string;
          }[];
          daily_breakdown?: {
              date: string;
              impressions: number;
              spend: number;
              conversions?: number;
              conversion_value?: number;
              commissionable_value?: number;
              roas?: number;
              new_to_brand_rate?: number;
          }[];
      }[];
      errors?: {
          code: string;
          message: string;
          field?: string;
          suggestion?: string;
          retry_after?: number;
          issues?: {
              pointer: string;
              message: string;
              keyword: string;
              schemaPath?: string;
              schema_id?: string;
              discriminator?: {
                  property_name: string;
                  value: (...)
                  | (...)
                  | (...)
                  | (...)
                  | (...);
              }[];
          }[];
          details?: Omit<Omit<{}, "bank">, "authentication"> & {
              authentication?: unknown;
          };
          recovery?: "transient"
          | "correctable"
          | "terminal";
          source?: "producer" | "sdk";
          sdk_id?: string;
      }[];
      sandbox?: boolean;
      ext?: Omit<Omit<{ [key: string]: unknown }, "bank">, "authentication"> & {
          authentication?: unknown;
      };
  }

  • Optionalcontext?: Omit<Omit<{}, "bank">, "authentication"> & { authentication?: unknown }

  • Optionalgovernance_context?: string

    Opaque authorization context issued only by an approved check_governance decision. Buyers attach it to governed requests across protocol roles (media buys, rights acquisitions, signal activations, creative services); receiving services persist it and forward it on subsequent execution and lifecycle checks. The context is the authoritative plan binding at service boundaries, so a service MUST NOT require a separate plan_id.

    Governance agents MUST emit a compact JWS per the AdCP JWS profile. Verifiers validate standard authorization claims such as signature, issuer, audience, expiry, and replay protection, but intermediaries MUST NOT interpret embedded governance state for business logic. A conditions or denied verdict never carries an authorization context.

    This is the primary correlation key for audit and reporting across the governance lifecycle.

  • Optionalnotification_type?: "scheduled" | "final" | "delayed" | "adjusted" | "window_update"

    Type of webhook notification (only present in webhook deliveries): scheduled = regular periodic update, final = campaign completed, delayed = data not yet available, adjusted = resending period with corrected data (same window), window_update = resending period with a wider measurement window (e.g., C3 superseding live, C7 superseding C3)

  • Optionalpartial_data?: boolean

    Indicates if any media buys in this webhook have missing/delayed data (only present in webhook deliveries)

  • Optionalunavailable_count?: number

    Number of media buys with reporting_delayed or failed status (only present in webhook deliveries when partial_data is true)

    Minimum

    0

  • Optionalsequence_number?: number

    Sequential notification number (only present in webhook deliveries, starts at 1)

    Minimum

    1

  • Optionalnext_expected_at?: string

    ISO 8601 timestamp for next expected notification (only present in webhook deliveries when notification_type is not 'final')

    Format

    date-time

  • reporting_period: { start: string; end: string }

    Half-open date range for the report: start is inclusive and end is exclusive. All periods use UTC timezone.

    • start: string

      ISO 8601 start timestamp in UTC (e.g., 2024-02-05T00:00:00Z)

      Format

      date-time

    • end: string

      Exclusive ISO 8601 end timestamp in UTC (e.g., 2024-02-06T00:00:00Z for a report covering 2024-02-05)

      Format

      date-time

  • Optionalcurrency?: string

    ISO 4217 currency code

    Pattern

    ^[A-Z]{3}$

  • Optionalattribution_window?: {
        post_click?: {
            interval: number;
            unit: "campaign" | "seconds" | "minutes" | "hours" | "days";
        };
        post_view?: {
            interval: number;
            unit: "campaign"
            | "seconds"
            | "minutes"
            | "hours"
            | "days";
        };
        model?: AttributionModel;
    }

    • Optionalpost_click?: {
          interval: number;
          unit: "campaign" | "seconds" | "minutes" | "hours" | "days";
      }

      Post-click attribution window. Conversions occurring within this duration after a click are attributed to the ad.

      • interval: number

        Number of time units. Must be 1 when unit is 'campaign'.

      • unit: "campaign" | "seconds" | "minutes" | "hours" | "days"

        Time unit. 'seconds' for sub-minute precision. 'campaign' spans the full campaign flight.

    • Optionalpost_view?: {
          interval: number;
          unit: "campaign" | "seconds" | "minutes" | "hours" | "days";
      }

      Post-view attribution window. Conversions occurring within this duration after an ad impression (without click) are attributed to the ad.

      • interval: number

        Number of time units. Must be 1 when unit is 'campaign'.

      • unit: "campaign" | "seconds" | "minutes" | "hours" | "days"

        Time unit. 'seconds' for sub-minute precision. 'campaign' spans the full campaign flight.

    • Optionalmodel?: AttributionModel

  • Optionalaggregated_totals?: {
        impressions: number;
        spend: number;
        clicks?: number;
        completed_views?: number;
        views?: number;
        conversions?: number;
        conversion_value?: number;
        commissionable_value?: number;
        roas?: number;
        new_to_brand_rate?: number;
        cost_per_acquisition?: number;
        completion_rate?: number | null;
        reach?: number;
        reach_unit?: ReachUnit;
        frequency?: number;
        media_buy_count: number;
        metric_aggregates?: (
            | {
                scope: "standard";
                metric_id: AvailableMetric;
                qualifier?: {
                    viewability_standard?: ViewabilityStandard;
                    completion_source?: CompletionSource;
                    attribution_methodology?: AttributionMethodology;
                    attribution_window?: { interval: ...; unit: ... };
                    lift_dimension?: LiftDimension;
                };
                value: number;
                measurable_impressions?: number;
                viewable_impressions?: number;
                impressions?: number;
                completed_views?: number;
                spend?: number;
                conversions?: number;
                conversion_value?: number;
                clicks?: number;
            }
            | {
                scope: "vendor";
                vendor: {
                    domain: string;
                    brand_id?: string;
                    countries?: string[];
                    industries?: string[];
                    data_subject_contestation?: {
                        url?: (...)
                        | (...);
                        email?: (...) | (...);
                        languages?: (...) | (...);
                    };
                    brand_kit_override?: {
                        logo?: (...)
                        | (...);
                        colors?: (...) | (...);
                        voice?: (...) | (...);
                        tagline?: (...) | (...);
                    };
                };
                metric_id: string;
                qualifier?: Omit<Omit<(...), (...)>, "authentication"> & {
                    authentication?: unknown;
                };
                value: number;
                measurable_impressions?: number;
            }
        )[];
    }

    Combined metrics across all returned media buys. Only included in API responses (get_media_buy_delivery), not in webhook notifications.

    • impressions: number

      Total impressions delivered across all media buys

      Minimum

      0

    • spend: number

      Total amount spent across all media buys

      Minimum

      0

    • Optionalclicks?: number

      Total clicks across all media buys (if applicable)

      Minimum

      0

    • Optionalcompleted_views?: number

      Total audio/video completions across all media buys (if applicable)

      Minimum

      0

    • Optionalviews?: number

      Total views across all media buys (if applicable)

      Minimum

      0

    • Optionalconversions?: number

      Total conversions across all media buys (if applicable)

      Minimum

      0

    • Optionalconversion_value?: number

      Total conversion value across all media buys (if applicable)

      Minimum

      0

    • Optionalcommissionable_value?: number

      Total settled conversion value eligible for revenue-share commission across all media buys (if applicable)

      Minimum

      0

    • Optionalroas?: number

      Aggregate return on ad spend across all media buys (total conversion_value / total spend)

      Minimum

      0

    • Optionalnew_to_brand_rate?: number

      Fraction of total conversions across all media buys from first-time brand buyers (weighted by conversion volume, not a simple average of per-buy rates)

      Minimum

      0

      Maximum

      1

    • Optionalcost_per_acquisition?: number

      Aggregate cost per conversion across all media buys (total spend / total conversions)

      Minimum

      0

    • Optionalcompletion_rate?: number | null

      Aggregate completion rate across all media buys (weighted by impressions, not a simple average of per-buy rates). Null indicates the metric is not applicable to the aggregated buys (e.g. all non-video inventory).

      Minimum

      0

      Maximum

      1

    • Optionalreach?: number

      Deduplicated reach across all media buys (if the seller can deduplicate across buys; otherwise sum of per-buy reach). Only present when all media buys share the same reach_unit. Omitted when reach units are heterogeneous — use per-buy reach values instead.

      Minimum

      0

    • Optionalreach_unit?: ReachUnit

      Unit of measurement for reach. Only present when all aggregated media buys use the same reach_unit.

    • Optionalfrequency?: number

      Average frequency per reach unit across all media buys (impressions / reach when cross-buy deduplication is available). Only present when reach is present.

      Minimum

      0

    • media_buy_count: number

      Number of media buys included in the response

      Minimum

      0

    • Optionalmetric_aggregates?: (
          | {
              scope: "standard";
              metric_id: AvailableMetric;
              qualifier?: {
                  viewability_standard?: ViewabilityStandard;
                  completion_source?: CompletionSource;
                  attribution_methodology?: AttributionMethodology;
                  attribution_window?: { interval: ...; unit: ... };
                  lift_dimension?: LiftDimension;
              };
              value: number;
              measurable_impressions?: number;
              viewable_impressions?: number;
              impressions?: number;
              completed_views?: number;
              spend?: number;
              conversions?: number;
              conversion_value?: number;
              clicks?: number;
          }
          | {
              scope: "vendor";
              vendor: {
                  domain: string;
                  brand_id?: string;
                  countries?: string[];
                  industries?: string[];
                  data_subject_contestation?: {
                      url?: (...)
                      | (...);
                      email?: (...) | (...);
                      languages?: (...) | (...);
                  };
                  brand_kit_override?: {
                      logo?: (...)
                      | (...);
                      colors?: (...) | (...);
                      voice?: (...) | (...);
                      tagline?: (...) | (...);
                  };
              };
              metric_id: string;
              qualifier?: Omit<Omit<(...), (...)>, "authentication"> & {
                  authentication?: unknown;
              };
              value: number;
              measurable_impressions?: number;
          }
      )[]

      Cross-buy delivery aggregates partitioned by qualifier. Row-symmetric with package.committed_metrics and by_package[].missing_metrics — same atomic unit (scope, metric_id, qualifier) — so reconciliation collapses to a row-level join on the tuple. Granularity rule: one row per (metric_id, full-qualifier-set), reported at the finest available granularity; buyers re-aggregate up if they want a coarser view. Used only for metrics with non-empty qualifier sets — unqualified metrics (impressions, spend, media_buy_count, etc.) remain at the top of aggregated_totals. Mutual exclusion MUST: for any metric_id appearing in metric_aggregates, the corresponding top-level scalar in aggregated_totals MUST be omitted (not zeroed) — avoids duplicate sources of truth. The qualifier vocabulary on this delivery surface is closed today (additionalProperties: false, same content as committed_metrics.qualifier) but is expected to diverge from contract qualifier in future minors as transparency disclosures buyers don't commit to ship delivery-only (e.g., tracker_firing pending #3832 resolution). Each row carries a value plus inlined per-metric component fields (e.g., measurable_impressions and viewable_impressions for viewable_rate; spend and conversions for cost_per_acquisition). Per-buy totals keeps its flat shape — each buy is single-qualifier by definition; only the aggregate spans qualifiers. Qualifier-set drift across reports: when a campaign gains a new qualifier mid-flight (e.g., adds tracker_firing partitioning in week 2), prior periods' rows remain valid at their original granularity; buyers SHOULD NOT retroactively repartition.

  • media_buy_deliveries: {
        media_buy_id: string;
        status:
            | "active"
            | "rejected"
            | "failed"
            | "pending"
            | "completed"
            | "pending_creatives"
            | "pending_start"
            | "paused"
            | "canceled"
            | "reporting_delayed";
        expected_availability?: string;
        is_adjusted?: boolean;
        is_final?: boolean;
        finalized_at?: string;
        pricing_model?: PricingModel;
        pacing_index?: number;
        totals: {
            impressions?: number;
            spend?: number;
            clicks?: number;
            ctr?: number;
            views?: number;
            completed_views?: number;
            completion_rate?: number
            | null;
            conversions?: number;
            conversion_value?: number;
            commissionable_value?: number;
            roas?: number;
            cost_per_acquisition?: number;
            new_to_brand_rate?: number;
            leads?: number;
            incremental_sales_lift?: number;
            brand_lift?: number;
            foot_traffic?: number;
            conversion_lift?: number;
            brand_search_lift?: number;
            plays?: number;
            by_event_type?: {
                event_type: EventType;
                event_source_id?: string;
                count: number;
                value?: number;
            }[];
            grps?: number;
            reach?: number;
            reach_unit?: ReachUnit;
            reach_window?: {
                kind: "cumulative"
                | "period"
                | "rolling";
                period?: {
                    interval: number;
                    unit: "campaign" | "seconds" | "minutes" | "hours" | "days";
                };
            };
            frequency?: number;
            quartile_data?: | {
                q1_views?: number;
                q2_views?: number;
                q3_views?: number;
                q4_views?: number;
            }
            | null;
            dooh_metrics?: {
                loop_plays?: number;
                screens_used?: number;
                screen_time_seconds?: number;
                sov_achieved?: number;
                calculation_notes?: string;
                venue_breakdown?: {
                    venue_id: string;
                    venue_name?: string;
                    venue_type?: string;
                    impressions: number;
                    loop_plays?: number;
                    screens_used?: number;
                }[];
            };
            viewability?: {
                vendor?: {
                    domain: string;
                    brand_id?: string;
                    countries?: string[];
                    industries?: string[];
                    data_subject_contestation?: {
                        url?: (...)
                        | (...);
                        email?: (...) | (...);
                        languages?: (...) | (...);
                    };
                    brand_kit_override?: {
                        logo?: (...)
                        | (...);
                        colors?: (...) | (...);
                        voice?: (...) | (...);
                        tagline?: (...) | (...);
                    };
                };
                measurable_impressions?: number;
                viewable_impressions?: number;
                viewable_rate?: number;
                viewed_seconds?: number;
                standard?: ViewabilityStandard;
            };
            engagements?: number;
            follows?: number;
            saves?: number;
            profile_visits?: number;
            engagement_rate?: number;
            cost_per_click?: number;
            cost_per_completed_view?: number;
            cpm?: number;
            downloads?: number;
            units_sold?: number;
            new_to_brand_units?: number;
            by_action_source?: {
                action_source: ActionSource;
                event_source_id?: string;
                count: number;
                value?: number;
            }[];
            vendor_metric_values?: {
                vendor: {
                    domain: string;
                    brand_id?: string;
                    countries?: string[];
                    industries?: string[];
                    data_subject_contestation?: {
                        url?: (...)
                        | (...);
                        email?: (...) | (...);
                        languages?: (...) | (...);
                    };
                    brand_kit_override?: {
                        logo?: (...)
                        | (...);
                        colors?: (...) | (...);
                        voice?: (...) | (...);
                        tagline?: (...) | (...);
                    };
                };
                metric_id: string;
                value: number;
                unit?: string;
                measurable_impressions?: number;
                breakdown?: Omit<Omit<(...), (...)>, "authentication"> & {
                    authentication?: unknown;
                };
            }[];
            effective_rate?: number;
        };
        by_package: {
            impressions?: number;
            spend?: number;
            clicks?: number;
            ctr?: number;
            views?: number;
            completed_views?: number;
            completion_rate?: number
            | null;
            conversions?: number;
            conversion_value?: number;
            commissionable_value?: number;
            roas?: number;
            cost_per_acquisition?: number;
            new_to_brand_rate?: number;
            leads?: number;
            incremental_sales_lift?: number;
            brand_lift?: number;
            foot_traffic?: number;
            conversion_lift?: number;
            brand_search_lift?: number;
            plays?: number;
            by_event_type?: {
                event_type: EventType;
                event_source_id?: string;
                count: number;
                value?: number;
            }[];
            grps?: number;
            reach?: number;
            reach_unit?: ReachUnit;
            reach_window?: {
                kind: "cumulative"
                | "period"
                | "rolling";
                period?: {
                    interval: number;
                    unit: "campaign" | "seconds" | "minutes" | "hours" | "days";
                };
            };
            frequency?: number;
            quartile_data?: | {
                q1_views?: number;
                q2_views?: number;
                q3_views?: number;
                q4_views?: number;
            }
            | null;
            dooh_metrics?: {
                loop_plays?: number;
                screens_used?: number;
                screen_time_seconds?: number;
                sov_achieved?: number;
                calculation_notes?: string;
                venue_breakdown?: {
                    venue_id: string;
                    venue_name?: (...)
                    | (...);
                    venue_type?: (...) | (...);
                    impressions: number;
                    loop_plays?: (...) | (...);
                    screens_used?: (...) | (...);
                }[];
            };
            viewability?: {
                vendor?: {
                    domain: string;
                    brand_id?: string;
                    countries?: (...)[];
                    industries?: (...)[];
                    data_subject_contestation?: { url?: ...; email?: ...; languages?: ... };
                    brand_kit_override?: {
                        logo?: ...;
                        colors?: ...;
                        voice?: ...;
                        tagline?: ...;
                    };
                };
                measurable_impressions?: number;
                viewable_impressions?: number;
                viewable_rate?: number;
                viewed_seconds?: number;
                standard?: ViewabilityStandard;
            };
            engagements?: number;
            follows?: number;
            saves?: number;
            profile_visits?: number;
            engagement_rate?: number;
            cost_per_click?: number;
            cost_per_completed_view?: number;
            cpm?: number;
            downloads?: number;
            units_sold?: number;
            new_to_brand_units?: number;
            by_action_source?: {
                action_source: ActionSource;
                event_source_id?: string;
                count: number;
                value?: number;
            }[];
            vendor_metric_values?: {
                vendor: {
                    domain: string;
                    brand_id?: string;
                    countries?: (...)[];
                    industries?: (...)[];
                    data_subject_contestation?: { url?: ...; email?: ...; languages?: ... };
                    brand_kit_override?: {
                        logo?: ...;
                        colors?: ...;
                        voice?: ...;
                        tagline?: ...;
                    };
                };
                metric_id: string;
                value: number;
                unit?: string;
                measurable_impressions?: number;
                breakdown?: Omit<(...), (...)> & { authentication?: ... };
            }[];
            package_id: string;
            pacing_index?: number;
            pricing_model?: PricingModel;
            rate?: number;
            currency?: string;
            delivery_status?: DeliveryStatus;
            paused?: boolean;
            is_final?: boolean;
            finalized_at?: string;
            measurement_window?: string;
            supersedes_window?: string;
            missing_metrics?: (
                | {
                    scope: "standard";
                    metric_id: AvailableMetric;
                    qualifier?: {
                        viewability_standard?: ...;
                        completion_source?: ...;
                        attribution_methodology?: ...;
                        attribution_window?: ...;
                        lift_dimension?: ...;
                    };
                }
                | {
                    scope: "vendor";
                    vendor: {
                        domain: string;
                        brand_id?: (...)
                        | (...);
                        countries?: (...) | (...);
                        industries?: (...) | (...);
                        data_subject_contestation?: (...) | (...);
                        brand_kit_override?: (...) | (...);
                    };
                    metric_id: string;
                }
            )[];
            by_catalog_item?: {
                impressions?: number;
                spend?: number;
                clicks?: number;
                ctr?: number;
                views?: number;
                completed_views?: number;
                completion_rate?: number
                | null;
                conversions?: number;
                conversion_value?: number;
                commissionable_value?: number;
                roas?: number;
                cost_per_acquisition?: number;
                new_to_brand_rate?: number;
                leads?: number;
                incremental_sales_lift?: number;
                brand_lift?: number;
                foot_traffic?: number;
                conversion_lift?: number;
                brand_search_lift?: number;
                plays?: number;
                by_event_type?: {
                    event_type: ...;
                    event_source_id?: ...;
                    count: ...;
                    value?: ...;
                }[];
                grps?: number;
                reach?: number;
                reach_unit?: ReachUnit;
                reach_window?: { kind: (...)
                | (...)
                | (...); period?: (...) | (...) };
                frequency?: number;
                quartile_data?:
                    | {
                        q1_views?: (...)
                        | (...);
                        q2_views?: (...) | (...);
                        q3_views?: (...) | (...);
                        q4_views?: (...) | (...);
                    }
                    | null;
                dooh_metrics?: {
                    loop_plays?: (...)
                    | (...);
                    screens_used?: (...) | (...);
                    screen_time_seconds?: (...) | (...);
                    sov_achieved?: (...) | (...);
                    calculation_notes?: (...) | (...);
                    venue_breakdown?: (...) | (...);
                };
                viewability?: {
                    vendor?: (...)
                    | (...);
                    measurable_impressions?: (...) | (...);
                    viewable_impressions?: (...) | (...);
                    viewable_rate?: (...) | (...);
                    viewed_seconds?: (...) | (...);
                    standard?: (...) | (...);
                };
                engagements?: number;
                follows?: number;
                saves?: number;
                profile_visits?: number;
                engagement_rate?: number;
                cost_per_click?: number;
                cost_per_completed_view?: number;
                cpm?: number;
                downloads?: number;
                units_sold?: number;
                new_to_brand_units?: number;
                by_action_source?: {
                    action_source: ...;
                    event_source_id?: ...;
                    count: ...;
                    value?: ...;
                }[];
                vendor_metric_values?: {
                    vendor: ...;
                    metric_id: ...;
                    value: ...;
                    unit?: ...;
                    measurable_impressions?: ...;
                    breakdown?: ...;
                }[];
                content_id?: string;
                content_id_type?: ContentIDType;
            }[];
            by_creative?: {
                impressions?: number;
                spend?: number;
                clicks?: number;
                ctr?: number;
                views?: number;
                completed_views?: number;
                completion_rate?: number
                | null;
                conversions?: number;
                conversion_value?: number;
                commissionable_value?: number;
                roas?: number;
                cost_per_acquisition?: number;
                new_to_brand_rate?: number;
                leads?: number;
                incremental_sales_lift?: number;
                brand_lift?: number;
                foot_traffic?: number;
                conversion_lift?: number;
                brand_search_lift?: number;
                plays?: number;
                by_event_type?: {
                    event_type: ...;
                    event_source_id?: ...;
                    count: ...;
                    value?: ...;
                }[];
                grps?: number;
                reach?: number;
                reach_unit?: ReachUnit;
                reach_window?: { kind: (...)
                | (...)
                | (...); period?: (...) | (...) };
                frequency?: number;
                quartile_data?:
                    | {
                        q1_views?: (...)
                        | (...);
                        q2_views?: (...) | (...);
                        q3_views?: (...) | (...);
                        q4_views?: (...) | (...);
                    }
                    | null;
                dooh_metrics?: {
                    loop_plays?: (...)
                    | (...);
                    screens_used?: (...) | (...);
                    screen_time_seconds?: (...) | (...);
                    sov_achieved?: (...) | (...);
                    calculation_notes?: (...) | (...);
                    venue_breakdown?: (...) | (...);
                };
                viewability?: {
                    vendor?: (...)
                    | (...);
                    measurable_impressions?: (...) | (...);
                    viewable_impressions?: (...) | (...);
                    viewable_rate?: (...) | (...);
                    viewed_seconds?: (...) | (...);
                    standard?: (...) | (...);
                };
                engagements?: number;
                follows?: number;
                saves?: number;
                profile_visits?: number;
                engagement_rate?: number;
                cost_per_click?: number;
                cost_per_completed_view?: number;
                cpm?: number;
                downloads?: number;
                units_sold?: number;
                new_to_brand_units?: number;
                by_action_source?: {
                    action_source: ...;
                    event_source_id?: ...;
                    count: ...;
                    value?: ...;
                }[];
                vendor_metric_values?: {
                    vendor: ...;
                    metric_id: ...;
                    value: ...;
                    unit?: ...;
                    measurable_impressions?: ...;
                    breakdown?: ...;
                }[];
                creative_id: string;
                weight?: number;
            }[];
            by_keyword?: {
                impressions?: number;
                spend?: number;
                clicks?: number;
                ctr?: number;
                views?: number;
                completed_views?: number;
                completion_rate?: number
                | null;
                conversions?: number;
                conversion_value?: number;
                commissionable_value?: number;
                roas?: number;
                cost_per_acquisition?: number;
                new_to_brand_rate?: number;
                leads?: number;
                incremental_sales_lift?: number;
                brand_lift?: number;
                foot_traffic?: number;
                conversion_lift?: number;
                brand_search_lift?: number;
                plays?: number;
                by_event_type?: {
                    event_type: ...;
                    event_source_id?: ...;
                    count: ...;
                    value?: ...;
                }[];
                grps?: number;
                reach?: number;
                reach_unit?: ReachUnit;
                reach_window?: { kind: (...)
                | (...)
                | (...); period?: (...) | (...) };
                frequency?: number;
                quartile_data?:
                    | {
                        q1_views?: (...)
                        | (...);
                        q2_views?: (...) | (...);
                        q3_views?: (...) | (...);
                        q4_views?: (...) | (...);
                    }
                    | null;
                dooh_metrics?: {
                    loop_plays?: (...)
                    | (...);
                    screens_used?: (...) | (...);
                    screen_time_seconds?: (...) | (...);
                    sov_achieved?: (...) | (...);
                    calculation_notes?: (...) | (...);
                    venue_breakdown?: (...) | (...);
                };
                viewability?: {
                    vendor?: (...)
                    | (...);
                    measurable_impressions?: (...) | (...);
                    viewable_impressions?: (...) | (...);
                    viewable_rate?: (...) | (...);
                    viewed_seconds?: (...) | (...);
                    standard?: (...) | (...);
                };
                engagements?: number;
                follows?: number;
                saves?: number;
                profile_visits?: number;
                engagement_rate?: number;
                cost_per_click?: number;
                cost_per_completed_view?: number;
                cpm?: number;
                downloads?: number;
                units_sold?: number;
                new_to_brand_units?: number;
                by_action_source?: {
                    action_source: ...;
                    event_source_id?: ...;
                    count: ...;
                    value?: ...;
                }[];
                vendor_metric_values?: {
                    vendor: ...;
                    metric_id: ...;
                    value: ...;
                    unit?: ...;
                    measurable_impressions?: ...;
                    breakdown?: ...;
                }[];
                keyword?: string;
                match_type?: MatchType;
            }[];
            by_geo?: {
                impressions?: number;
                spend?: number;
                clicks?: number;
                ctr?: number;
                views?: number;
                completed_views?: number;
                completion_rate?: number
                | null;
                conversions?: number;
                conversion_value?: number;
                commissionable_value?: number;
                roas?: number;
                cost_per_acquisition?: number;
                new_to_brand_rate?: number;
                leads?: number;
                incremental_sales_lift?: number;
                brand_lift?: number;
                foot_traffic?: number;
                conversion_lift?: number;
                brand_search_lift?: number;
                plays?: number;
                by_event_type?: {
                    event_type: ...;
                    event_source_id?: ...;
                    count: ...;
                    value?: ...;
                }[];
                grps?: number;
                reach?: number;
                reach_unit?: ReachUnit;
                reach_window?: { kind: (...)
                | (...)
                | (...); period?: (...) | (...) };
                frequency?: number;
                quartile_data?:
                    | {
                        q1_views?: (...)
                        | (...);
                        q2_views?: (...) | (...);
                        q3_views?: (...) | (...);
                        q4_views?: (...) | (...);
                    }
                    | null;
                dooh_metrics?: {
                    loop_plays?: (...)
                    | (...);
                    screens_used?: (...) | (...);
                    screen_time_seconds?: (...) | (...);
                    sov_achieved?: (...) | (...);
                    calculation_notes?: (...) | (...);
                    venue_breakdown?: (...) | (...);
                };
                viewability?: {
                    vendor?: (...)
                    | (...);
                    measurable_impressions?: (...) | (...);
                    viewable_impressions?: (...) | (...);
                    viewable_rate?: (...) | (...);
                    viewed_seconds?: (...) | (...);
                    standard?: (...) | (...);
                };
                engagements?: number;
                follows?: number;
                saves?: number;
                profile_visits?: number;
                engagement_rate?: number;
                cost_per_click?: number;
                cost_per_completed_view?: number;
                cpm?: number;
                downloads?: number;
                units_sold?: number;
                new_to_brand_units?: number;
                by_action_source?: {
                    action_source: ...;
                    event_source_id?: ...;
                    count: ...;
                    value?: ...;
                }[];
                vendor_metric_values?: {
                    vendor: ...;
                    metric_id: ...;
                    value: ...;
                    unit?: ...;
                    measurable_impressions?: ...;
                    breakdown?: ...;
                }[];
                geo_level?: GeographicTargetingLevel;
                system?: string;
                country?: string;
                geo_code?: string;
                geo_name?: string;
            }[];
            by_geo_truncated?: boolean;
            by_device_type?: {
                impressions?: number;
                spend?: number;
                clicks?: number;
                ctr?: number;
                views?: number;
                completed_views?: number;
                completion_rate?: number
                | null;
                conversions?: number;
                conversion_value?: number;
                commissionable_value?: number;
                roas?: number;
                cost_per_acquisition?: number;
                new_to_brand_rate?: number;
                leads?: number;
                incremental_sales_lift?: number;
                brand_lift?: number;
                foot_traffic?: number;
                conversion_lift?: number;
                brand_search_lift?: number;
                plays?: number;
                by_event_type?: {
                    event_type: ...;
                    event_source_id?: ...;
                    count: ...;
                    value?: ...;
                }[];
                grps?: number;
                reach?: number;
                reach_unit?: ReachUnit;
                reach_window?: { kind: (...)
                | (...)
                | (...); period?: (...) | (...) };
                frequency?: number;
                quartile_data?:
                    | {
                        q1_views?: (...)
                        | (...);
                        q2_views?: (...) | (...);
                        q3_views?: (...) | (...);
                        q4_views?: (...) | (...);
                    }
                    | null;
                dooh_metrics?: {
                    loop_plays?: (...)
                    | (...);
                    screens_used?: (...) | (...);
                    screen_time_seconds?: (...) | (...);
                    sov_achieved?: (...) | (...);
                    calculation_notes?: (...) | (...);
                    venue_breakdown?: (...) | (...);
                };
                viewability?: {
                    vendor?: (...)
                    | (...);
                    measurable_impressions?: (...) | (...);
                    viewable_impressions?: (...) | (...);
                    viewable_rate?: (...) | (...);
                    viewed_seconds?: (...) | (...);
                    standard?: (...) | (...);
                };
                engagements?: number;
                follows?: number;
                saves?: number;
                profile_visits?: number;
                engagement_rate?: number;
                cost_per_click?: number;
                cost_per_completed_view?: number;
                cpm?: number;
                downloads?: number;
                units_sold?: number;
                new_to_brand_units?: number;
                by_action_source?: {
                    action_source: ...;
                    event_source_id?: ...;
                    count: ...;
                    value?: ...;
                }[];
                vendor_metric_values?: {
                    vendor: ...;
                    metric_id: ...;
                    value: ...;
                    unit?: ...;
                    measurable_impressions?: ...;
                    breakdown?: ...;
                }[];
                device_type?: DeviceType;
            }[];
            by_device_type_truncated?: boolean;
            by_device_platform?: {
                impressions?: number;
                spend?: number;
                clicks?: number;
                ctr?: number;
                views?: number;
                completed_views?: number;
                completion_rate?: number
                | null;
                conversions?: number;
                conversion_value?: number;
                commissionable_value?: number;
                roas?: number;
                cost_per_acquisition?: number;
                new_to_brand_rate?: number;
                leads?: number;
                incremental_sales_lift?: number;
                brand_lift?: number;
                foot_traffic?: number;
                conversion_lift?: number;
                brand_search_lift?: number;
                plays?: number;
                by_event_type?: {
                    event_type: ...;
                    event_source_id?: ...;
                    count: ...;
                    value?: ...;
                }[];
                grps?: number;
                reach?: number;
                reach_unit?: ReachUnit;
                reach_window?: { kind: (...)
                | (...)
                | (...); period?: (...) | (...) };
                frequency?: number;
                quartile_data?:
                    | {
                        q1_views?: (...)
                        | (...);
                        q2_views?: (...) | (...);
                        q3_views?: (...) | (...);
                        q4_views?: (...) | (...);
                    }
                    | null;
                dooh_metrics?: {
                    loop_plays?: (...)
                    | (...);
                    screens_used?: (...) | (...);
                    screen_time_seconds?: (...) | (...);
                    sov_achieved?: (...) | (...);
                    calculation_notes?: (...) | (...);
                    venue_breakdown?: (...) | (...);
                };
                viewability?: {
                    vendor?: (...)
                    | (...);
                    measurable_impressions?: (...) | (...);
                    viewable_impressions?: (...) | (...);
                    viewable_rate?: (...) | (...);
                    viewed_seconds?: (...) | (...);
                    standard?: (...) | (...);
                };
                engagements?: number;
                follows?: number;
                saves?: number;
                profile_visits?: number;
                engagement_rate?: number;
                cost_per_click?: number;
                cost_per_completed_view?: number;
                cpm?: number;
                downloads?: number;
                units_sold?: number;
                new_to_brand_units?: number;
                by_action_source?: {
                    action_source: ...;
                    event_source_id?: ...;
                    count: ...;
                    value?: ...;
                }[];
                vendor_metric_values?: {
                    vendor: ...;
                    metric_id: ...;
                    value: ...;
                    unit?: ...;
                    measurable_impressions?: ...;
                    breakdown?: ...;
                }[];
                device_platform?: DevicePlatform;
            }[];
            by_device_platform_truncated?: boolean;
            by_audience?: {
                impressions?: number;
                spend?: number;
                clicks?: number;
                ctr?: number;
                views?: number;
                completed_views?: number;
                completion_rate?: number
                | null;
                conversions?: number;
                conversion_value?: number;
                commissionable_value?: number;
                roas?: number;
                cost_per_acquisition?: number;
                new_to_brand_rate?: number;
                leads?: number;
                incremental_sales_lift?: number;
                brand_lift?: number;
                foot_traffic?: number;
                conversion_lift?: number;
                brand_search_lift?: number;
                plays?: number;
                by_event_type?: {
                    event_type: ...;
                    event_source_id?: ...;
                    count: ...;
                    value?: ...;
                }[];
                grps?: number;
                reach?: number;
                reach_unit?: ReachUnit;
                reach_window?: { kind: (...)
                | (...)
                | (...); period?: (...) | (...) };
                frequency?: number;
                quartile_data?:
                    | {
                        q1_views?: (...)
                        | (...);
                        q2_views?: (...) | (...);
                        q3_views?: (...) | (...);
                        q4_views?: (...) | (...);
                    }
                    | null;
                dooh_metrics?: {
                    loop_plays?: (...)
                    | (...);
                    screens_used?: (...) | (...);
                    screen_time_seconds?: (...) | (...);
                    sov_achieved?: (...) | (...);
                    calculation_notes?: (...) | (...);
                    venue_breakdown?: (...) | (...);
                };
                viewability?: {
                    vendor?: (...)
                    | (...);
                    measurable_impressions?: (...) | (...);
                    viewable_impressions?: (...) | (...);
                    viewable_rate?: (...) | (...);
                    viewed_seconds?: (...) | (...);
                    standard?: (...) | (...);
                };
                engagements?: number;
                follows?: number;
                saves?: number;
                profile_visits?: number;
                engagement_rate?: number;
                cost_per_click?: number;
                cost_per_completed_view?: number;
                cpm?: number;
                downloads?: number;
                units_sold?: number;
                new_to_brand_units?: number;
                by_action_source?: {
                    action_source: ...;
                    event_source_id?: ...;
                    count: ...;
                    value?: ...;
                }[];
                vendor_metric_values?: {
                    vendor: ...;
                    metric_id: ...;
                    value: ...;
                    unit?: ...;
                    measurable_impressions?: ...;
                    breakdown?: ...;
                }[];
                audience_id?: string;
                audience_source?: AudienceSource;
                audience_name?: string;
            }[];
            by_audience_truncated?: boolean;
            by_demographic?: {
                impressions?: number;
                spend?: number;
                clicks?: number;
                ctr?: number;
                views?: number;
                completed_views?: number;
                completion_rate?: number
                | null;
                conversions?: number;
                conversion_value?: number;
                commissionable_value?: number;
                roas?: number;
                cost_per_acquisition?: number;
                new_to_brand_rate?: number;
                leads?: number;
                incremental_sales_lift?: number;
                brand_lift?: number;
                foot_traffic?: number;
                conversion_lift?: number;
                brand_search_lift?: number;
                plays?: number;
                by_event_type?: {
                    event_type: ...;
                    event_source_id?: ...;
                    count: ...;
                    value?: ...;
                }[];
                grps?: number;
                reach?: number;
                reach_unit?: ReachUnit;
                reach_window?: { kind: (...)
                | (...)
                | (...); period?: (...) | (...) };
                frequency?: number;
                quartile_data?:
                    | {
                        q1_views?: (...)
                        | (...);
                        q2_views?: (...) | (...);
                        q3_views?: (...) | (...);
                        q4_views?: (...) | (...);
                    }
                    | null;
                dooh_metrics?: {
                    loop_plays?: (...)
                    | (...);
                    screens_used?: (...) | (...);
                    screen_time_seconds?: (...) | (...);
                    sov_achieved?: (...) | (...);
                    calculation_notes?: (...) | (...);
                    venue_breakdown?: (...) | (...);
                };
                viewability?: {
                    vendor?: (...)
                    | (...);
                    measurable_impressions?: (...) | (...);
                    viewable_impressions?: (...) | (...);
                    viewable_rate?: (...) | (...);
                    viewed_seconds?: (...) | (...);
                    standard?: (...) | (...);
                };
                engagements?: number;
                follows?: number;
                saves?: number;
                profile_visits?: number;
                engagement_rate?: number;
                cost_per_click?: number;
                cost_per_completed_view?: number;
                cpm?: number;
                downloads?: number;
                units_sold?: number;
                new_to_brand_units?: number;
                by_action_source?: {
                    action_source: ...;
                    event_source_id?: ...;
                    count: ...;
                    value?: ...;
                }[];
                vendor_metric_values?: {
                    vendor: ...;
                    metric_id: ...;
                    value: ...;
                    unit?: ...;
                    measurable_impressions?: ...;
                    breakdown?: ...;
                }[];
                demographic: string;
                demographic_system: DemographicSystem;
                age?: {
                    min?: (...)
                    | (...);
                    max?: (...) | (...);
                    include_unknown: boolean;
                };
            }[];
            by_demographic_truncated?: boolean;
            by_demographic_suppressed?: boolean;
            by_placement?: {
                impressions?: number;
                spend?: number;
                clicks?: number;
                ctr?: number;
                views?: number;
                completed_views?: number;
                completion_rate?: number
                | null;
                conversions?: number;
                conversion_value?: number;
                commissionable_value?: number;
                roas?: number;
                cost_per_acquisition?: number;
                new_to_brand_rate?: number;
                leads?: number;
                incremental_sales_lift?: number;
                brand_lift?: number;
                foot_traffic?: number;
                conversion_lift?: number;
                brand_search_lift?: number;
                plays?: number;
                by_event_type?: {
                    event_type: ...;
                    event_source_id?: ...;
                    count: ...;
                    value?: ...;
                }[];
                grps?: number;
                reach?: number;
                reach_unit?: ReachUnit;
                reach_window?: { kind: (...)
                | (...)
                | (...); period?: (...) | (...) };
                frequency?: number;
                quartile_data?:
                    | {
                        q1_views?: (...)
                        | (...);
                        q2_views?: (...) | (...);
                        q3_views?: (...) | (...);
                        q4_views?: (...) | (...);
                    }
                    | null;
                dooh_metrics?: {
                    loop_plays?: (...)
                    | (...);
                    screens_used?: (...) | (...);
                    screen_time_seconds?: (...) | (...);
                    sov_achieved?: (...) | (...);
                    calculation_notes?: (...) | (...);
                    venue_breakdown?: (...) | (...);
                };
                viewability?: {
                    vendor?: (...)
                    | (...);
                    measurable_impressions?: (...) | (...);
                    viewable_impressions?: (...) | (...);
                    viewable_rate?: (...) | (...);
                    viewed_seconds?: (...) | (...);
                    standard?: (...) | (...);
                };
                engagements?: number;
                follows?: number;
                saves?: number;
                profile_visits?: number;
                engagement_rate?: number;
                cost_per_click?: number;
                cost_per_completed_view?: number;
                cpm?: number;
                downloads?: number;
                units_sold?: number;
                new_to_brand_units?: number;
                by_action_source?: {
                    action_source: ...;
                    event_source_id?: ...;
                    count: ...;
                    value?: ...;
                }[];
                vendor_metric_values?: {
                    vendor: ...;
                    metric_id: ...;
                    value: ...;
                    unit?: ...;
                    measurable_impressions?: ...;
                    breakdown?: ...;
                }[];
                placement_id?: string;
                placement_name?: string;
                publisher_domain?: string;
            }[];
            by_placement_truncated?: boolean;
            by_spot?: {
                impressions?: number;
                spend?: number;
                clicks?: number;
                ctr?: number;
                views?: number;
                completed_views?: number;
                completion_rate?: number
                | null;
                conversions?: number;
                conversion_value?: number;
                commissionable_value?: number;
                roas?: number;
                cost_per_acquisition?: number;
                new_to_brand_rate?: number;
                leads?: number;
                incremental_sales_lift?: number;
                brand_lift?: number;
                foot_traffic?: number;
                conversion_lift?: number;
                brand_search_lift?: number;
                plays?: number;
                by_event_type?: {
                    event_type: ...;
                    event_source_id?: ...;
                    count: ...;
                    value?: ...;
                }[];
                grps?: number;
                reach?: number;
                reach_unit?: ReachUnit;
                reach_window?: { kind: (...)
                | (...)
                | (...); period?: (...) | (...) };
                frequency?: number;
                quartile_data?:
                    | {
                        q1_views?: (...)
                        | (...);
                        q2_views?: (...) | (...);
                        q3_views?: (...) | (...);
                        q4_views?: (...) | (...);
                    }
                    | null;
                dooh_metrics?: {
                    loop_plays?: (...)
                    | (...);
                    screens_used?: (...) | (...);
                    screen_time_seconds?: (...) | (...);
                    sov_achieved?: (...) | (...);
                    calculation_notes?: (...) | (...);
                    venue_breakdown?: (...) | (...);
                };
                viewability?: {
                    vendor?: (...)
                    | (...);
                    measurable_impressions?: (...) | (...);
                    viewable_impressions?: (...) | (...);
                    viewable_rate?: (...) | (...);
                    viewed_seconds?: (...) | (...);
                    standard?: (...) | (...);
                };
                engagements?: number;
                follows?: number;
                saves?: number;
                profile_visits?: number;
                engagement_rate?: number;
                cost_per_click?: number;
                cost_per_completed_view?: number;
                cpm?: number;
                downloads?: number;
                units_sold?: number;
                new_to_brand_units?: number;
                by_action_source?: {
                    action_source: ...;
                    event_source_id?: ...;
                    count: ...;
                    value?: ...;
                }[];
                vendor_metric_values?: {
                    vendor: ...;
                    metric_id: ...;
                    value: ...;
                    unit?: ...;
                    measurable_impressions?: ...;
                    breakdown?: ...;
                }[];
                spot_id: string;
                aired_at: string;
                network?: string;
                station?: string;
                daypart?: string;
            }[];
            by_spot_truncated?: boolean;
            daily_breakdown?: {
                date: string;
                impressions: number;
                spend: number;
                conversions?: number;
                conversion_value?: number;
                commissionable_value?: number;
                roas?: number;
                new_to_brand_rate?: number;
            }[];
        }[];
        windows?: {
            window_start: string;
            window_end: string;
            totals: {
                impressions?: number;
                spend?: number;
                clicks?: number;
                ctr?: number;
                views?: number;
                completed_views?: number;
                completion_rate?: number
                | null;
                conversions?: number;
                conversion_value?: number;
                commissionable_value?: number;
                roas?: number;
                cost_per_acquisition?: number;
                new_to_brand_rate?: number;
                leads?: number;
                incremental_sales_lift?: number;
                brand_lift?: number;
                foot_traffic?: number;
                conversion_lift?: number;
                brand_search_lift?: number;
                plays?: number;
                by_event_type?: {
                    event_type: EventType;
                    event_source_id?: (...) | (...);
                    count: number;
                    value?: (...) | (...);
                }[];
                grps?: number;
                reach?: number;
                reach_unit?: ReachUnit;
                reach_window?: {
                    kind: "cumulative"
                    | "period"
                    | "rolling";
                    period?: { interval: ...; unit: ... };
                };
                frequency?: number;
                quartile_data?: | {
                    q1_views?: number;
                    q2_views?: number;
                    q3_views?: number;
                    q4_views?: number;
                }
                | null;
                dooh_metrics?: {
                    loop_plays?: number;
                    screens_used?: number;
                    screen_time_seconds?: number;
                    sov_achieved?: number;
                    calculation_notes?: string;
                    venue_breakdown?: (...)[];
                };
                viewability?: {
                    vendor?: {
                        domain: ...;
                        brand_id?: ...;
                        countries?: ...;
                        industries?: ...;
                        data_subject_contestation?: ...;
                        brand_kit_override?: ...;
                    };
                    measurable_impressions?: number;
                    viewable_impressions?: number;
                    viewable_rate?: number;
                    viewed_seconds?: number;
                    standard?: ViewabilityStandard;
                };
                engagements?: number;
                follows?: number;
                saves?: number;
                profile_visits?: number;
                engagement_rate?: number;
                cost_per_click?: number;
                cost_per_completed_view?: number;
                cpm?: number;
                downloads?: number;
                units_sold?: number;
                new_to_brand_units?: number;
                by_action_source?: {
                    action_source: ActionSource;
                    event_source_id?: (...)
                    | (...);
                    count: number;
                    value?: (...) | (...);
                }[];
                vendor_metric_values?: {
                    vendor: {
                        domain: ...;
                        brand_id?: ...;
                        countries?: ...;
                        industries?: ...;
                        data_subject_contestation?: ...;
                        brand_kit_override?: ...;
                    };
                    metric_id: string;
                    value: number;
                    unit?: (...)
                    | (...);
                    measurable_impressions?: (...) | (...);
                    breakdown?: (...) | (...);
                }[];
            };
            by_package?: {
                impressions?: number;
                spend?: number;
                clicks?: number;
                ctr?: number;
                views?: number;
                completed_views?: number;
                completion_rate?: number
                | null;
                conversions?: number;
                conversion_value?: number;
                commissionable_value?: number;
                roas?: number;
                cost_per_acquisition?: number;
                new_to_brand_rate?: number;
                leads?: number;
                incremental_sales_lift?: number;
                brand_lift?: number;
                foot_traffic?: number;
                conversion_lift?: number;
                brand_search_lift?: number;
                plays?: number;
                by_event_type?: (...)[];
                grps?: number;
                reach?: number;
                reach_unit?: ReachUnit;
                reach_window?: { kind: ...; period?: ... };
                frequency?: number;
                quartile_data?:
                    | { q1_views?: ...; q2_views?: ...; q3_views?: ...; q4_views?: ... }
                    | null;
                dooh_metrics?: {
                    loop_plays?: ...;
                    screens_used?: ...;
                    screen_time_seconds?: ...;
                    sov_achieved?: ...;
                    calculation_notes?: ...;
                    venue_breakdown?: ...;
                };
                viewability?: {
                    vendor?: ...;
                    measurable_impressions?: ...;
                    viewable_impressions?: ...;
                    viewable_rate?: ...;
                    viewed_seconds?: ...;
                    standard?: ...;
                };
                engagements?: number;
                follows?: number;
                saves?: number;
                profile_visits?: number;
                engagement_rate?: number;
                cost_per_click?: number;
                cost_per_completed_view?: number;
                cpm?: number;
                downloads?: number;
                units_sold?: number;
                new_to_brand_units?: number;
                by_action_source?: (...)[];
                vendor_metric_values?: (...)[];
                package_id: string;
            }[];
            is_final?: boolean;
            measurement_window?: string;
        }[];
        daily_breakdown?: {
            date: string;
            impressions: number;
            spend: number;
            conversions?: number;
            conversion_value?: number;
            commissionable_value?: number;
            roas?: number;
            new_to_brand_rate?: number;
        }[];
    }[]

    Array of delivery data for media buys. When used in webhook notifications, may contain multiple media buys aggregated by publisher. When used in get_media_buy_delivery API responses, typically contains requested media buys.

  • Optionalerrors?: {
        code: string;
        message: string;
        field?: string;
        suggestion?: string;
        retry_after?: number;
        issues?: {
            pointer: string;
            message: string;
            keyword: string;
            schemaPath?: string;
            schema_id?: string;
            discriminator?: {
                property_name: string;
                value: (...) | (...) | (...) | (...) | (...);
            }[];
        }[];
        details?: Omit<Omit<{}, "bank">, "authentication"> & {
            authentication?: unknown;
        };
        recovery?: "transient"
        | "correctable"
        | "terminal";
        source?: "producer" | "sdk";
        sdk_id?: string;
    }[]

    Task-specific errors and warnings (e.g., missing delivery data, reporting platform issues)

  • Optionalsandbox?: boolean

    When true, this response contains simulated data from sandbox mode.

  • Optionalext?: Omit<Omit<{ [key: string]: unknown }, "bank">, "authentication"> & {
        authentication?: unknown;
    }

• Optionalsummary: string