# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Reporting API V1 Reports API
  version: 1.0.0
extends: openapi/mediamath-reports-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 26
- target: $.paths['/app_transparency'].get
  update:
    x-apievangelist-phrasing:
      intent: Query the app transparency report
      effect: read
      questions:
      - Which mobile apps did my MediaMath ads actually run in?
      - Can I see spend and impressions broken out by app for a campaign?
      instructions:
      - text: Pull the app transparency report showing which apps my ads served in.
      - text: Show app-level delivery for my campaigns from the app transparency report.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/app_transparency/meta'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the app transparency report fields
      effect: read
      questions:
      - What dimensions and metrics does the app transparency report support?
      - Which fields are required before I query app transparency data?
      instructions:
      - text: List the fields available in the app transparency report.
      - text: Get the metadata for the app transparency report so I know which parameters it needs.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/brain_feature_summary/meta'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the Brain feature summary report
      effect: read
      questions:
      - How can I see which impression features the Brain weighs most when optimizing?
      - Is there a report that summarizes the Brain's feature importance for a campaign?
      instructions:
      - text: Pull the Brain feature summary report.
      - text: Show me how the Brain's optimization features rank in the feature summary report.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/brain_feature_value/meta'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the Brain feature value report
      effect: read
      questions:
      - Which specific sites, creatives or exchanges push the Brain's predictions up or down most?
      - Can I see the top 100 and bottom 100 feature values affecting Brain predictions?
      instructions:
      - text: Pull the Brain feature value report with the top and bottom feature values.
      - text: Show which individual feature values most help or hurt the Brain's predictions.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/by_hour'].get
  update:
    x-apievangelist-phrasing:
      intent: Get hourly performance metrics
      effect: read
      questions:
      - Can I get campaign performance down to the hour instead of by day?
      - What were my impressions and spend hour by hour yesterday?
      instructions:
      - text: Get hourly performance by {dimensions} starting {start_date} for {filter}.
        slots:
          dimensions: query.dimensions
          start_date: query.start_date
          filter: query.filter
      - text: Pull the by-hour report rolled up by {time_rollup} over {time_window} filtered to {filter}.
        slots:
          time_rollup: query.time_rollup
          time_window: query.time_window
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/by_hour/meta'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the by-hour report fields
      effect: read
      questions:
      - Which dimensions can I break the hourly performance report out by?
      - What time windows and rollups does the by-hour report allow?
      instructions:
      - text: Show the metadata for the by-hour performance report.
      - text: Fetch the by-hour report's available dimensions and metrics using session cookie {session_cookie}.
        slots:
          session_cookie: header.Cookie
      method: generated
      generated: '2026-10-01'
- target: $.paths['/day_part'].get
  update:
    x-apievangelist-phrasing:
      intent: Get performance by time of day and weekday
      effect: read
      questions:
      - Which times of day and days of the week perform best for my ads?
      - Can I compare conversions on weekends versus weekdays?
      instructions:
      - text: Get day-part performance by {dimensions} from {start_date} for {filter}.
        slots:
          dimensions: query.dimensions
          start_date: query.start_date
          filter: query.filter
      - text: Break out performance by hour of day and day of week over {time_window} for {filter}.
        slots:
          time_window: query.time_window
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/day_part/meta'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the day part report fields
      effect: read
      questions:
      - What metrics are available in the day part report?
      - Which intervals does the time-of-day report support?
      instructions:
      - text: Show the metadata for the day part report.
      - text: List the day part report's dimensions and metrics using session cookie {session_cookie}.
        slots:
          session_cookie: header.Cookie
      method: generated
      generated: '2026-10-01'
- target: $.paths['/deals'].get
  update:
    x-apievangelist-phrasing:
      intent: Get private marketplace deal metrics
      effect: read
      questions:
      - How many bid opportunities on my private marketplace deals actually turned into won impressions?
      - Can I track the path from biddable to win for a specific deal?
      instructions:
      - text: Get deal metrics by {dimensions} starting {start_date} for {filter}.
        slots:
          dimensions: query.dimensions
          start_date: query.start_date
          filter: query.filter
      - text: Show biddable-to-win funnel for my PMP deals over {time_window} filtered to {filter}.
        slots:
          time_window: query.time_window
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/deals/meta'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the deals report fields
      effect: read
      questions:
      - Which metrics does the deals report expose for PMP deals?
      - What dimensions can I group private marketplace deal data by?
      instructions:
      - text: Show the metadata for the deals report.
      - text: List the deals report fields using session cookie {session_cookie}.
        slots:
          session_cookie: header.Cookie
      method: generated
      generated: '2026-10-01'
- target: $.paths['/device_technology'].get
  update:
    x-apievangelist-phrasing:
      intent: Get performance by device and browser
      effect: read
      questions:
      - How does my campaign perform across browsers, operating systems and connection types?
      - Can I get device brand and model in the technology report using the v2 version?
      instructions:
      - text: Get device technology performance by {dimensions} from {start_date} for {filter}.
        slots:
          dimensions: query.dimensions
          start_date: query.start_date
          filter: query.filter
      - text: Break out performance by browser and operating system rolled up by {time_rollup} for {filter}.
        slots:
          time_rollup: query.time_rollup
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/device_technology/meta'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the device technology report fields
      effect: read
      questions:
      - What's the difference between v1 and v2 of the device technology report?
      - Which device fields like brand or model can I report on?
      instructions:
      - text: Show the metadata for the device technology report.
      - text: List device technology report dimensions using session cookie {session_cookie}.
        slots:
          session_cookie: header.Cookie
      method: generated
      generated: '2026-10-01'
- target: $.paths['/geo'].get
  update:
    x-apievangelist-phrasing:
      intent: Get performance by geography
      effect: read
      questions:
      - Which countries, regions or metro areas drive the most conversions?
      - Can I see campaign spend split by metro area?
      instructions:
      - text: Get geo performance by {dimensions} from {start_date} for {filter}.
        slots:
          dimensions: query.dimensions
          start_date: query.start_date
          filter: query.filter
      - text: Break out my campaign results by country and region over {time_window} for {filter}.
        slots:
          time_window: query.time_window
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/geo/meta'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the geo report fields
      effect: read
      questions:
      - Which geographic dimensions does the geo report support?
      - What intervals can I pull geographic performance for?
      instructions:
      - text: Show the metadata for the geo report.
      - text: List geo report dimensions and metrics using session cookie {session_cookie}.
        slots:
          session_cookie: header.Cookie
      method: generated
      generated: '2026-10-01'
- target: $.paths['/performance'].get
  update:
    x-apievangelist-phrasing:
      intent: Get standard campaign performance metrics
      effect: read
      questions:
      - How do I pull impressions, clicks and spend for my campaigns in campaign currency?
      - Can I aggregate campaign performance by week or month instead of day?
      instructions:
      - text: Get performance metrics by {dimensions} from {start_date} for {filter}.
        slots:
          dimensions: query.dimensions
          start_date: query.start_date
          filter: query.filter
      - text: Pull the standard performance report rolled up by {time_rollup} over {time_window} for {filter}.
        slots:
          time_rollup: query.time_rollup
          time_window: query.time_window
          filter: query.filter
      - text: Get performance for {filter} showing {metrics} sorted by {order}.
        slots:
          filter: query.filter
          metrics: query.metrics
          order: query.order
      method: generated
      generated: '2026-10-01'
- target: $.paths['/performance/meta'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the performance report fields
      effect: read
      questions:
      - Which dimensions and metrics are in the standard performance report?
      - What date ranges and rollups does the performance report allow?
      instructions:
      - text: Show the metadata for the standard performance report.
      - text: List performance report fields using session cookie {session_cookie}.
        slots:
          session_cookie: header.Cookie
      method: generated
      generated: '2026-10-01'
- target: $.paths['/reach_frequency'].get
  update:
    x-apievangelist-phrasing:
      intent: Get reach and frequency metrics
      effect: read
      questions:
      - How many unique users did my ads reach, and how often did each see them?
      - Does seeing an ad more times change click and conversion behavior?
      instructions:
      - text: Get reach and frequency by {dimensions} from {start_date} for {filter}.
        slots:
          dimensions: query.dimensions
          start_date: query.start_date
          filter: query.filter
      - text: Show unique reach and average frequency over {time_window} for {filter}.
        slots:
          time_window: query.time_window
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/reach_frequency/meta'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the reach and frequency report fields
      effect: read
      questions:
      - Which metrics does the reach and frequency report provide?
      - What windows can unique reach be calculated over?
      instructions:
      - text: Show the metadata for the reach and frequency report.
      - text: List reach and frequency report fields using session cookie {session_cookie}.
        slots:
          session_cookie: header.Cookie
      method: generated
      generated: '2026-10-01'
- target: $.paths['/site_transparency'].get
  update:
    x-apievangelist-phrasing:
      intent: Get performance by inventory domain
      effect: read
      questions:
      - Which website domains did my ads run on and how did each perform?
      - Can I find low-performing domains to block?
      instructions:
      - text: Get site transparency data by {dimensions} from {start_date} for {filter}.
        slots:
          dimensions: query.dimensions
          start_date: query.start_date
          filter: query.filter
      - text: Show performance by domain over {time_window} for {filter}.
        slots:
          time_window: query.time_window
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/site_transparency/meta'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the site transparency report fields
      effect: read
      questions:
      - Which fields can I use in the site transparency report?
      - What intervals is domain-level performance available in?
      instructions:
      - text: Show the metadata for the site transparency report.
      - text: List site transparency report fields using session cookie {session_cookie}.
        slots:
          session_cookie: header.Cookie
      method: generated
      generated: '2026-10-01'
- target: $.paths['/watermark'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Brain learning spend metrics
      effect: read
      questions:
      - How much of my spend went toward the Brain's learning activities?
      - Can I see watermark impressions by strategy per day?
      instructions:
      - text: Get watermark metrics by {dimensions} from {start_date} for {filter}.
        slots:
          dimensions: query.dimensions
          start_date: query.start_date
          filter: query.filter
      - text: Show learning impressions and spend per strategy over {time_window} for {filter}.
        slots:
          time_window: query.time_window
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/watermark/meta'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the watermark report fields
      effect: read
      questions:
      - Which dimensions does the watermark report break learning spend out by?
      - What metrics are in the watermark report?
      instructions:
      - text: Show the metadata for the watermark report.
      - text: List watermark report fields using session cookie {session_cookie}.
        slots:
          session_cookie: header.Cookie
      method: generated
      generated: '2026-10-01'
- target: $.paths['/win_loss'].get
  update:
    x-apievangelist-phrasing:
      intent: Get auction win/loss metrics
      effect: read
      questions:
      - Why am I losing auctions on certain exchanges or deals?
      - Can I see bid and win rates by strategy and exchange by hour?
      instructions:
      - text: Get win/loss metrics by {dimensions} from {start_date} for {filter}.
        slots:
          dimensions: query.dimensions
          start_date: query.start_date
          filter: query.filter
      - text: Show auction win rates by strategy and exchange over {time_window} for {filter}.
        slots:
          time_window: query.time_window
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/win_loss/meta'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the win/loss report fields
      effect: read
      questions:
      - Which strategy, exchange and deal dimensions are in the win/loss report?
      - What auction metrics can the win/loss report return?
      instructions:
      - text: Show the metadata for the win/loss report.
      - text: List win/loss report fields using session cookie {session_cookie}.
        slots:
          session_cookie: header.Cookie
      method: generated
      generated: '2026-10-01'
- target: $.paths['/win_loss_creative'].get
  update:
    x-apievangelist-phrasing:
      intent: Get auction win/loss metrics by creative
      effect: read
      questions:
      - Which of my creatives are losing auctions most often?
      - Can I see hourly win rates broken out by creative?
      instructions:
      - text: Get win/loss by creative for {dimensions} from {start_date} for {filter}.
        slots:
          dimensions: query.dimensions
          start_date: query.start_date
          filter: query.filter
      - text: Show creative-level auction win rates over {time_window} for {filter}.
        slots:
          time_window: query.time_window
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/win_loss_creative/meta'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the win/loss by creative report fields
      effect: read
      questions:
      - Which creative dimensions does the win/loss by creative report support?
      - What metrics are available when reporting auction losses per creative?
      instructions:
      - text: Show the metadata for the win/loss by creative report.
      - text: List win/loss by creative report fields using session cookie {session_cookie}.
        slots:
          session_cookie: header.Cookie
      method: generated
      generated: '2026-10-01'