# 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 V2 Datasets API
  version: 1.0.0
extends: openapi/mediamath-datasets-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-02'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 10
- target: $.paths['/all-dimensions-and-metrics'].post
  update:
    x-apievangelist-phrasing:
      intent: Report performance across the widest set of dimensions
      effect: read
      questions:
      - Which report lets me break campaign spend and results out by the widest range of dimensions?
      - Can I pull standard performance metrics in campaign currency sliced by almost any dimension?
      - How do I get a paginated instead of streamed all-dimensions performance report?
      instructions:
      - text: Run the all-dimensions-and-metrics report for {filters} with fields {fields} rolled up {rollup}.
        slots:
          filters: requestBody.filters
          fields: requestBody.fields
          rollup: requestBody.rollup
      - text: Pull every-dimension performance in campaign currency for {filters} from {start_time} to {end_time}, rolled up {rollup}.
        slots:
          filters: requestBody.filters
          start_time: requestBody.start_time
          end_time: requestBody.end_time
          rollup: requestBody.rollup
      method: generated
      generated: '2026-10-02'
- target: $.paths['/brain-feature-summary'].post
  update:
    x-apievangelist-phrasing:
      intent: Summarize which Brain features drive a model
      effect: read
      questions:
      - Which features does the bidding Brain rank as most important for my campaign's model goal?
      - Can I see a summary of Brain feature positions and index for yesterday or month to date?
      - What does the Brain feature summary report break out by campaign?
      instructions:
      - text: Get the Brain feature summary for {filters} over {time_window}, rolled up {rollup}, with fields {fields}.
        slots:
          filters: requestBody.filters
          time_window: requestBody.time_window
          rollup: requestBody.rollup
          fields: requestBody.fields
      - text: Show the top-ranked Brain features for campaigns in {filters} rolled up {rollup}.
        slots:
          filters: requestBody.filters
          rollup: requestBody.rollup
      method: generated
      generated: '2026-10-02'
- target: $.paths['/brain-feature-value'].post
  update:
    x-apievangelist-phrasing:
      intent: Report bid impact of individual Brain feature values
      effect: read
      questions:
      - How much bid impact does each individual feature value have in the Brain model?
      - Can I see the mean and bid impact for specific Brain feature values on a campaign?
      - Which feature values push the Brain to bid higher or lower?
      instructions:
      - text: Get the Brain feature value report with bid impact for {filters} over {time_window}, rolled up {rollup}.
        slots:
          filters: requestBody.filters
          time_window: requestBody.time_window
          rollup: requestBody.rollup
      - text: List per-value Brain feature fields {fields} for {filters} rolled up {rollup}.
        slots:
          fields: requestBody.fields
          filters: requestBody.filters
          rollup: requestBody.rollup
      method: generated
      generated: '2026-10-02'
- target: $.paths['/day-part'].post
  update:
    x-apievangelist-phrasing:
      intent: Report performance by time of day and day of week
      effect: read
      questions:
      - What hours of the day and days of the week does my campaign perform best?
      - Can I break out impressions and spend by day part?
      - Which weekdays deliver the most conversions for my advertiser?
      instructions:
      - text: Run the day-part report for {filters} with fields {fields}, rolled up {rollup}.
        slots:
          filters: requestBody.filters
          fields: requestBody.fields
          rollup: requestBody.rollup
      - text: Show time-of-day and day-of-week performance for {filters} in time zone {time_zone}, rolled up {rollup}.
        slots:
          filters: requestBody.filters
          time_zone: requestBody.time_zone
          rollup: requestBody.rollup
      method: generated
      generated: '2026-10-02'
- target: $.paths['/deals'].post
  update:
    x-apievangelist-phrasing:
      intent: Report private marketplace deal delivery
      effect: read
      questions:
      - How many biddable opportunities on my private marketplace deals turned into won impressions?
      - Can I see hourly PMP deal metrics in UTC for a set of deal IDs?
      - Why does the deals report require exactly one organization filter and at least one deal ID?
      instructions:
      - text: Get the PMP deals report for {filters} with fields {fields}, rolled up {rollup}.
        slots:
          filters: requestBody.filters
          fields: requestBody.fields
          rollup: requestBody.rollup
      - text: Show biddable-to-win deal metrics for {filters} over {time_window}, rolled up {rollup}.
        slots:
          filters: requestBody.filters
          time_window: requestBody.time_window
          rollup: requestBody.rollup
      method: generated
      generated: '2026-10-02'
- target: $.paths['/performance'].post
  update:
    x-apievangelist-phrasing:
      intent: Report aggregated daily campaign performance
      effect: read
      questions:
      - How is my campaign performing to date in campaign currency?
      - Can I get the standard performance report rolled up by day, week or month?
      - What spend, impressions and conversions did my advertiser get month to date?
      instructions:
      - text: Run the standard daily performance report for {filters} with fields {fields}, rolled up {rollup}.
        slots:
          filters: requestBody.filters
          fields: requestBody.fields
          rollup: requestBody.rollup
      - text: Show campaign-to-date performance for {filters} over {time_window}, rolled up {rollup}.
        slots:
          filters: requestBody.filters
          time_window: requestBody.time_window
          rollup: requestBody.rollup
      method: generated
      generated: '2026-10-02'
- target: $.paths['/performance-hourly'].post
  update:
    x-apievangelist-phrasing:
      intent: Report campaign performance by hour
      effect: read
      questions:
      - How did my campaign perform hour by hour over the last few hours?
      - Can I get the aggregated performance report broken out by hour instead of by day?
      - What were today's hourly impressions and spend for my campaign?
      instructions:
      - text: Run the hourly performance report for {filters} with fields {fields}, rolled up {rollup}.
        slots:
          filters: requestBody.filters
          fields: requestBody.fields
          rollup: requestBody.rollup
      - text: Show hour-by-hour performance for {filters} over {time_window}, rolled up {rollup}.
        slots:
          filters: requestBody.filters
          time_window: requestBody.time_window
          rollup: requestBody.rollup
      method: generated
      generated: '2026-10-02'
- target: $.paths['/pixel-loads'].post
  update:
    x-apievangelist-phrasing:
      intent: Report pixel loads and uniques by referrer
      effect: read
      questions:
      - How many times did my event and data pixels fire, and for how many unique users?
      - Which referrers drive the most pixel loads for my advertiser?
      - Can I see daily pixel load counts broken out by referrer rank?
      instructions:
      - text: Get the pixel loads report for {filters} with fields {fields}, rolled up {rollup}.
        slots:
          filters: requestBody.filters
          fields: requestBody.fields
          rollup: requestBody.rollup
      - text: Show pixel loads and uniques by referrer for {filters} over {time_window}, rolled up {rollup}.
        slots:
          filters: requestBody.filters
          time_window: requestBody.time_window
          rollup: requestBody.rollup
      method: generated
      generated: '2026-10-02'
- target: $.paths['/reach-frequency'].post
  update:
    x-apievangelist-phrasing:
      intent: Report reach and ad exposure frequency
      effect: read
      questions:
      - How many unique users did my campaign reach, and how often did each see the ad?
      - Can I see performance broken out by frequency of ad exposure?
      - Is a time window mandatory when pulling reach and frequency?
      instructions:
      - text: Run the reach and frequency report for {filters} over {time_window} with fields {fields}, rolled up {rollup}.
        slots:
          filters: requestBody.filters
          time_window: requestBody.time_window
          fields: requestBody.fields
          rollup: requestBody.rollup
      - text: Show uniques by exposure frequency for {filters} over {time_window}, rolled up {rollup}.
        slots:
          filters: requestBody.filters
          time_window: requestBody.time_window
          rollup: requestBody.rollup
      method: generated
      generated: '2026-10-02'
- target: $.paths['/win-loss'].post
  update:
    x-apievangelist-phrasing:
      intent: Report auction win and loss metrics
      effect: read
      questions:
      - Why am I losing auctions before a bid is even placed?
      - Can I see pre-bid auction metrics that explain my win rate?
      - What does the win/loss report show about the auctions my campaign enters?
      instructions:
      - text: Run the win/loss auction report for {filters} with fields {fields}, rolled up {rollup}.
        slots:
          filters: requestBody.filters
          fields: requestBody.fields
          rollup: requestBody.rollup
      - text: Show auction win and loss metrics for {filters} from {start_time} to {end_time}, rolled up {rollup}.
        slots:
          filters: requestBody.filters
          start_time: requestBody.start_time
          end_time: requestBody.end_time
          rollup: requestBody.rollup
      method: generated
      generated: '2026-10-02'