---
title: "List all reports"
method: GET
path: "/ads/{connection_id}/report"
tags: ["ads", "report"]
---

# List all reports

`GET /ads/{connection_id}/report`

## Path parameters

- `connection_id` string, required

## Query parameters

- `limit` number
- `offset` number
- `updated_gte` string
- `sort` string
- `order` string
- `query` string
- `org_id` string
- `campaign_id` string
- `group_id` string
- `ad_id` string
- `type` string
- `dimension` string
- `start_gte` string
- `end_lt` string
- `fields` string[]
- `raw` string

## Response `200`

Successful

- AdsReport[]
  - `id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `currency` string
  - `metrics` AdsReportMetrics[]
    - `value` number
    - `type` 'CLICKS' | 'IMPRESSIONS' | 'CONVERSIONS' | 'COST' | 'CTR' | 'CPC' | 'CONVERSION_VALUE' | 'CPA' | 'ROAS' | 'CPM' | 'ECPM' | 'ENGAGEMENT' | 'VIDEO_COMPLETIONS' | 'VIDEO_VIEWS' | 'LEADS' | 'ENGAGEMENTS' | 'SAVES' | 'LIKES' | 'SHARES' | 'COMMENTS' | 'FOLLOWS' | 'POST_CLICK_CONVERSIONS' | 'VIEW_THROUGH_CONVERSIONS' | 'ALL_CONVERSIONS' | 'ALL_CONVERSION_VALUE' | 'INTERACTIONS' | 'REVENUE' | 'MEDIA_COST' | 'TOTAL_MEDIA_COST' | 'VIDEO_PLAYS' | 'VIDEO_QUARTILE_25' | 'VIDEO_QUARTILE_50' | 'VIDEO_QUARTILE_75' | 'VIDEO_QUARTILE_100' | 'VIDEO_AVG_TIME_WATCHED' | 'VIDEO_THRUPLAY' | 'VIEWABLE_IMPRESSIONS' | 'MEASURABLE_IMPRESSIONS' | 'VIEWABILITY_RATE' | 'BILLABLE_IMPRESSIONS' | 'DATA_FEES' | 'PLATFORM_FEES' | 'PROFIT' | 'LANDING_PAGE_CLICKS' | 'LEAD_FORM_OPENS' | 'AD_UNIT_CLICKS' | 'CARD_CLICKS' | 'CARD_IMPRESSIONS' | 'COMMENT_LIKES' | 'COMPANY_PAGE_CLICKS' | 'ACTION_CLICKS' | 'TEXT_URL_CLICKS' | 'OTHER_ENGAGEMENTS' | 'OPENS' | 'TOTAL_ENGAGEMENTS' | 'UNIQUE_IMPRESSIONS' | 'UNIQUE_CLICKS' | 'VIRAL_IMPRESSIONS' | 'VIRAL_CLICKS' | 'VIRAL_LIKES' | 'VIRAL_COMMENTS' | 'VIRAL_SHARES' | 'VIRAL_FOLLOWS' | 'VIRAL_VIDEO_PLAYS' | 'VIRAL_VIDEO_VIEWS' | 'VIRAL_VIDEO_COMPLETIONS' | 'VIRAL_VIDEO_QUARTILE_25' | 'VIRAL_VIDEO_QUARTILE_50' | 'VIRAL_VIDEO_QUARTILE_75' | 'VIRAL_LEADS' | 'VIRAL_LEAD_FORM_OPENS' | 'VIRAL_LANDING_PAGE_CLICKS' | 'VIRAL_CONVERSIONS' | 'VIRAL_POST_CLICK_CONVERSIONS' | 'VIRAL_VIEW_THROUGH_CONVERSIONS' | 'VIRAL_ENGAGEMENTS' | 'GMAIL_SECONDARY_CLICKS' | 'AVERAGE_CPV' | 'VIDEO_VIEWS_FROM_SEARCH' | 'CROSS_DEVICE_CONVERSIONS' | 'ABSOLUTE_TOP_IMPRESSION_SHARE' | 'TOP_IMPRESSION_SHARE' | 'ABSOLUTE_TOP_IMPRESSION_RATE_PERCENT' | 'TOP_IMPRESSION_RATE_PERCENT' | 'VIDEO_FULLSCREENS' | 'VIDEO_PAUSES' | 'VIDEO_MUTES' | 'VIDEO_SKIPS' | 'COMPANION_CLICKS' | 'COMPANION_VIEWS' | 'ACTIVE_VIEW_AVG_TIME' | 'ELIGIBLE_IMPRESSIONS' | 'EARNED_VIEWS' | 'UNIQUE_VIEWERS' | 'COST_USD' | 'VIRAL_CARD_CLICKS' | 'VIRAL_CARD_IMPRESSIONS' | 'VIRAL_COMPANY_PAGE_CLICKS' | 'VIRAL_VIDEO_FULLSCREENS' | 'VIRAL_OTHER_ENGAGEMENTS' | 'LEAD_GEN_CONTACT_SHARES' | 'LEAD_GEN_INTERESTED_CLICKS' | 'CM360_POST_CLICK_REVENUE' | 'CM360_POST_VIEW_REVENUE' | 'SCROLLS' | 'MEDIA_FEE_1' | 'MEDIA_FEE_2' | 'MEDIA_FEE_3' | 'MEDIA_FEE_4' | 'MEDIA_FEE_5' | 'ACTIVE_VIEW_DIST_UNMEASURABLE' | 'ACTIVE_VIEW_DIST_UNVIEWABLE' | 'ACTIVE_VIEW_DIST_VIEWABLE' | 'ACTIVE_VIEW_AUDIBLE_VISIBLE_COMPLETE' | 'ACTIVE_VIEW_VISIBLE_10S' | 'NOT_MEASURABLE_IMPRESSIONS' | 'NOT_VIEWABLE_IMPRESSIONS' | '1D_VIEW' | '1D_CLICK' | '7D_VIEW' | '7D_CLICK' | '14D_CLICK' | '28D_VIEW' | '28D_CLICK' | '30D_CLICK' | 'VISITS' | 'AUDIO_MUTES'
    - `dimension` 'DATE' | 'PLATFORM' | 'PLATFORM_POSITION' | 'DEVICE'
    - `dimension_value` string
    - `campaign` PropertyAdsReportMetricsCampaign
      - `id` string
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `name` string
      - `organization_id` string
      - `status` 'UNSPECIFIED' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED' | 'DRAFT' | 'SCHEDULED_FOR_DELETION' | 'PROCESSING' | 'PROCESSING_FAILED'
      - `effective_status` 'UNSPECIFIED' | 'SERVING' | 'LIMITED' | 'LEARNING' | 'PAUSED' | 'PENDING' | 'ENDED' | 'MISCONFIGURED' | 'NOT_ELIGIBLE' | 'ARCHIVED' | 'REMOVED'
      - `start_at` string, date-time
      - `end_at` string, date-time
      - `budget_amount` number
      - `budget_period` 'DAILY' | 'MONTHLY' | 'TOTAL' | 'LIFETIME'
      - `budget_unit` 'UNSPECIFIED' | 'CURRENCY' | 'IMPRESSIONS'
      - `total_spend_amount` number
      - `targeting` PropertyAdsReportMetricsCampaignTargeting
        - `geographic` PropertyAdsReportMetricsCampaignTargetingGeographic
          - `countries` TargetRef[]
            - `id` string
            - `name` string
          - `regions` TargetRef[]
            - `id` string
            - `name` string
          - `cities` CityTarget[]
            - `id` string, required
            - `name` string
            - `radius` number
            - `radius_unit` 'MILES' | 'KILOMETERS'
          - `postal_codes` TargetRef[]
            - `id` string
            - `name` string
          - `us_dmas` TargetRef[]
            - `id` string
            - `name` string
          - `excluded_countries` TargetRef[]
            - `id` string
            - `name` string
          - `excluded_regions` TargetRef[]
            - `id` string
            - `name` string
          - `excluded_cities` CityTarget[]
            - `id` string, required
            - `name` string
            - `radius` number
            - `radius_unit` 'MILES' | 'KILOMETERS'
          - `excluded_postal_codes` TargetRef[]
            - `id` string
            - `name` string
          - `excluded_us_dmas` TargetRef[]
            - `id` string
            - `name` string
          - `location_types` string[]
          - `presence_type` 'PRESENCE' | 'PRESENCE_OR_INTEREST'
        - `demographic` PropertyAdsReportMetricsCampaignTargetingDemographic — Demographic targeting (Meta: age_min, age_max, genders)
          - `age_min` number
          - `age_max` number
          - `male` boolean
          - `female` boolean
        - `audience` PropertyAdsReportMetricsCampaignTargetingAudience
          - `custom_audiences` TargetRef[]
            - `id` string
            - `name` string
          - `excluded_custom_audiences` TargetRef[]
            - `id` string
            - `name` string
          - `lookalike_audiences` LookalikeAudience[]
            - `id` string, required
            - `name` string
            - `similarity` number
            - `source_audience_id` string
          - `interests` TargetRef[]
            - `id` string
            - `name` string
          - `excluded_interests` TargetRef[]
            - `id` string
            - `name` string
          - `behaviors` TargetRef[]
            - `id` string
            - `name` string
          - `excluded_behaviors` TargetRef[]
            - `id` string
            - `name` string
          - `combination_spec` AudienceCombination[]
            - `interests` TargetRef[]
              - …
            - `behaviors` TargetRef[]
              - …
            - `references` TargetRef[]
              - …
            - `life_events` TargetRef[]
              - …
        - `placement` PropertyAdsReportMetricsCampaignTargetingPlacement
          - `platforms` string[]
          - `facebook_positions` string[]
          - `instagram_positions` string[]
          - `messenger_positions` string[]
          - `audience_network_positions` string[]
        - `device` PropertyAdsReportMetricsCampaignTargetingDevice
          - `types` TargetRef[]
            - `id` string
            - `name` string
          - `user_device` TargetRef[]
            - `id` string
            - `name` string
          - `user_os` TargetRef[]
            - `id` string
            - `name` string
          - `carriers` TargetRef[]
            - `id` string
            - `name` string
        - `language` TargetRef[]
          - `id` string
          - `name` string
        - `content` PropertyAdsReportMetricsCampaignTargetingContent
          - `keywords` AdsKeyword[]
            - `text` string, required
            - `match_type` 'BROAD' | 'PHRASE' | 'EXACT'
          - `excluded_keywords` AdsKeyword[]
            - `text` string, required
            - `match_type` 'BROAD' | 'PHRASE' | 'EXACT'
          - `topics` TargetRef[]
            - `id` string
            - `name` string
          - `excluded_topics` TargetRef[]
            - `id` string
            - `name` string
          - `urls` string[]
          - `excluded_urls` string[]
          - `video` PropertyAdsReportMetricsCampaignTargetingContentVideo
            - `youtube_videos` string[]
            - `excluded_youtube_videos` string[]
            - `youtube_channels` string[]
            - `excluded_youtube_channels` string[]
            - `positions` string[]
            - `player_sizes` string[]
            - `durations` string[]
        - `brand_safety` PropertyAdsReportMetricsCampaignTargetingBrandSafety — Brand safety (Meta: excluded_publisher_categories, etc.; Google
          - `excluded_publisher_categories` string[]
          - `excluded_content_labels` string[] — Google Ads ContentLabelType
          - `brand_safety_content_filter_levels` string[]
          - `publisher_visibility_categories` string[]
          - `block_list_ids` string[]
        - `schedule` AdSchedule[]
          - `day_of_week` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY', required
          - `start_hour` number, required
          - `start_minute` number
          - `end_hour` number, required
          - `end_minute` number
          - `bid_modifier` number
        - `optimization` PropertyAdsReportMetricsCampaignTargetingOptimization — Optimization (Meta: targeting_automation; Google: observation vs targeting mode)
          - `mode` 'TARGETING' | 'OBSERVATION'
          - `advantage_audience` boolean
          - `advantage_placements` boolean
          - `targeting_optimization_expansion_all` boolean
      - `goal` 'UNSPECIFIED' | 'BRAND_AWARENESS' | 'ENGAGEMENT' | 'REACH' | 'WEBSITE_TRAFFIC' | 'LEADS' | 'SALES' | 'APP_PROMOTION'
      - `planned_spend_amount` number
      - `frequency_cap` PropertyAdsReportMetricsCampaignFrequencyCap
        - `is_unlimited` boolean
        - `time_unit` 'UNSPECIFIED' | 'LIFETIME' | 'MONTHS' | 'WEEKS' | 'DAYS' | 'HOURS' | 'MINUTES'
        - `time_unit_count` number
        - `max_impressions` number
        - `max_views` number
      - `advertising_channel_type` 'TEXT' | 'IMAGE' | 'VIDEO' | 'RESPONSIVE' | 'SHOPPING' | 'APP' | 'CALL' | 'CAROUSEL' | 'SOCIAL' | 'DISPLAY' | 'SEARCH' | 'AUDIO' | 'YOUTUBE' | 'NATIVE' | 'CTV' | 'DOOH'
      - `campaign_budget_identifier` string
      - `currency` string
      - `category` string
      - `has_eu_political_ads` boolean
      - `labels` string[]
      - `raw` object
    - `group` PropertyAdsReportMetricsGroup
      - `id` string
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `name` string
      - `parent_id` string
      - `campaign_id` string
      - `organization_id` string
      - `insertionorder_id` string
      - `status` 'UNSPECIFIED' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED' | 'DRAFT' | 'SCHEDULED_FOR_DELETION' | 'PROCESSING' | 'PROCESSING_FAILED'
      - `effective_status` 'UNSPECIFIED' | 'SERVING' | 'LIMITED' | 'LEARNING' | 'PAUSED' | 'PENDING' | 'ENDED' | 'MISCONFIGURED' | 'NOT_ELIGIBLE' | 'ARCHIVED' | 'REMOVED'
      - `targeting` PropertyAdsReportMetricsGroupTargeting
        - `geographic` PropertyAdsReportMetricsGroupTargetingGeographic
          - `countries` TargetRef[]
            - `id` string
            - `name` string
          - `regions` TargetRef[]
            - `id` string
            - `name` string
          - `cities` CityTarget[]
            - `id` string, required
            - `name` string
            - `radius` number
            - `radius_unit` 'MILES' | 'KILOMETERS'
          - `postal_codes` TargetRef[]
            - `id` string
            - `name` string
          - `us_dmas` TargetRef[]
            - `id` string
            - `name` string
          - `excluded_countries` TargetRef[]
            - `id` string
            - `name` string
          - `excluded_regions` TargetRef[]
            - `id` string
            - `name` string
          - `excluded_cities` CityTarget[]
            - `id` string, required
            - `name` string
            - `radius` number
            - `radius_unit` 'MILES' | 'KILOMETERS'
          - `excluded_postal_codes` TargetRef[]
            - `id` string
            - `name` string
          - `excluded_us_dmas` TargetRef[]
            - `id` string
            - `name` string
          - `location_types` string[]
          - `presence_type` 'PRESENCE' | 'PRESENCE_OR_INTEREST'
        - `demographic` PropertyAdsReportMetricsGroupTargetingDemographic — Demographic targeting (Meta: age_min, age_max, genders)
          - `age_min` number
          - `age_max` number
          - `male` boolean
          - `female` boolean
        - `audience` PropertyAdsReportMetricsGroupTargetingAudience
          - `custom_audiences` TargetRef[]
            - `id` string
            - `name` string
          - `excluded_custom_audiences` TargetRef[]
            - `id` string
            - `name` string
          - `lookalike_audiences` LookalikeAudience[]
            - `id` string, required
            - `name` string
            - `similarity` number
            - `source_audience_id` string
          - `interests` TargetRef[]
            - `id` string
            - `name` string
          - `excluded_interests` TargetRef[]
            - `id` string
            - `name` string
          - `behaviors` TargetRef[]
            - `id` string
            - `name` string
          - `excluded_behaviors` TargetRef[]
            - `id` string
            - `name` string
          - `combination_spec` AudienceCombination[]
            - `interests` TargetRef[]
              - …
            - `behaviors` TargetRef[]
              - …
            - `references` TargetRef[]
              - …
            - `life_events` TargetRef[]
              - …
        - `placement` PropertyAdsReportMetricsGroupTargetingPlacement
          - `platforms` string[]
          - `facebook_positions` string[]
          - `instagram_positions` string[]
          - `messenger_positions` string[]
          - `audience_network_positions` string[]
        - `device` PropertyAdsReportMetricsGroupTargetingDevice
          - `types` TargetRef[]
            - `id` string
            - `name` string
          - `user_device` TargetRef[]
            - `id` string
            - `name` string
          - `user_os` TargetRef[]
            - `id` string
            - `name` string
          - `carriers` TargetRef[]
            - `id` string
            - `name` string
        - `language` TargetRef[]
          - `id` string
          - `name` string
        - `content` PropertyAdsReportMetricsGroupTargetingContent
          - `keywords` AdsKeyword[]
            - `text` string, required
            - `match_type` 'BROAD' | 'PHRASE' | 'EXACT'
          - `excluded_keywords` AdsKeyword[]
            - `text` string, required
            - `match_type` 'BROAD' | 'PHRASE' | 'EXACT'
          - `topics` TargetRef[]
            - `id` string
            - `name` string
          - `excluded_topics` TargetRef[]
            - `id` string
            - `name` string
          - `urls` string[]
          - `excluded_urls` string[]
          - `video` PropertyAdsReportMetricsGroupTargetingContentVideo
            - `youtube_videos` string[]
            - `excluded_youtube_videos` string[]
            - `youtube_channels` string[]
            - `excluded_youtube_channels` string[]
            - `positions` string[]
            - `player_sizes` string[]
            - `durations` string[]
        - `brand_safety` PropertyAdsReportMetricsGroupTargetingBrandSafety — Brand safety (Meta: excluded_publisher_categories, etc.; Google
          - `excluded_publisher_categories` string[]
          - `excluded_content_labels` string[] — Google Ads ContentLabelType
          - `brand_safety_content_filter_levels` string[]
          - `publisher_visibility_categories` string[]
          - `block_list_ids` string[]
        - `schedule` AdSchedule[]
          - `day_of_week` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY', required
          - `start_hour` number, required
          - `start_minute` number
          - `end_hour` number, required
          - `end_minute` number
          - `bid_modifier` number
        - `optimization` PropertyAdsReportMetricsGroupTargetingOptimization — Optimization (Meta: targeting_automation; Google: observation vs targeting mode)
          - `mode` 'TARGETING' | 'OBSERVATION'
          - `advantage_audience` boolean
          - `advantage_placements` boolean
          - `targeting_optimization_expansion_all` boolean
      - `bid_amount` number
      - `bid_strategy` PropertyAdsReportMetricsGroupBidStrategy — YOUTUBE_AND_PARTNERS
        - `type` 'FIXED_BID' | 'MAXIMIZE_SPEND' | 'PERFORMANCE_GOAL' | 'YOUTUBE_AND_PARTNERS', required
        - `fixed_bid_amount` number
        - `performance_goal_type` 'UNSPECIFIED' | 'CPA' | 'CPC' | 'VIEWABLE_CPM' | 'CUSTOM_ALGO' | 'CIVA' | 'IVO_TEN' | 'AV_VIEWED' | 'REACH'
        - `performance_goal_amount` number
        - `max_average_cpm_bid_amount` number
        - `custom_bidding_algorithm_id` string
        - `raise_bid_for_deals` boolean
        - `youtube_and_partners_type` 'UNSPECIFIED' | 'MANUAL_CPV' | 'MANUAL_CPM' | 'TARGET_CPA' | 'TARGET_CPM' | 'RESERVE_CPM' | 'MAXIMIZE_LIFT' | 'MAXIMIZE_CONVERSIONS' | 'TARGET_CPV' | 'TARGET_ROAS' | 'MAXIMIZE_CONVERSION_VALUE'
        - `youtube_and_partners_value` string
        - `target_roas` number
      - `budget_amount` number
      - `budget_period` 'DAILY' | 'MONTHLY' | 'TOTAL' | 'LIFETIME'
      - `budget_allocation_type` 'UNSPECIFIED' | 'AUTOMATIC' | 'FIXED' | 'UNLIMITED'
      - `start_at` string, date-time
      - `end_at` string, date-time
      - `budget_unit` 'UNSPECIFIED' | 'CURRENCY' | 'IMPRESSIONS'
      - `budget_max_amount` number
      - `type` 'TEXT' | 'IMAGE' | 'VIDEO' | 'RESPONSIVE' | 'SHOPPING' | 'APP' | 'CALL' | 'CAROUSEL' | 'SOCIAL' | 'DISPLAY' | 'SEARCH' | 'AUDIO' | 'YOUTUBE' | 'NATIVE' | 'CTV' | 'DOOH'
      - `has_eu_political_ads` boolean
      - `pacing` PropertyAdsReportMetricsGroupPacing
        - `period` 'UNSPECIFIED' | 'DAILY' | 'FLIGHT'
        - `type` string
        - `daily_max_amount` number
        - `daily_max_impressions` number
      - `frequency_cap` PropertyAdsReportMetricsGroupFrequencyCap
        - `is_unlimited` boolean
        - `time_unit` 'UNSPECIFIED' | 'LIFETIME' | 'MONTHS' | 'WEEKS' | 'DAYS' | 'HOURS' | 'MINUTES'
        - `time_unit_count` number
        - `max_impressions` number
        - `max_views` number
      - `creative_ids` string[]
      - `optimization_goal` 'REACH' | 'IMPRESSIONS' | 'LINK_CLICKS' | 'LANDING_PAGE_VIEWS' | 'CONVERSIONS' | 'LEAD_GENERATION' | 'APP_INSTALLS' | 'APP_ENGAGEMENT' | 'VIDEO_VIEWS' | 'ENGAGEMENT' | 'PAGE_LIKES' | 'MESSAGES'
      - `billing_event` 'IMPRESSIONS' | 'LINK_CLICKS' | 'VIDEO_VIEWS' | 'APP_INSTALLS' | 'ENGAGEMENT' | 'PAGE_LIKES' | 'MESSAGES' | 'POST_ENGAGEMENT' | 'PURCHASE' | 'NONE'
      - `currency` string
      - `promoted` AdsPromoted[]
        - `id` string, required
        - `name` string
        - `type` 'PAGE_ID' | 'APP_ID' | 'STORE_URL' | 'PIXEL_ID' | 'CUSTOM_CONVERSION_ID' | 'CATALOG_ID' | 'PRODUCT_SET_ID' | 'PRIORITIZED_SET_ID' | 'EVENT_ID' | 'OFFER_ID' | 'LEAD_FORM_ID' | 'MESSAGING_CHANNEL_ID' | 'PRODUCT_ID' | 'TWEET_ID' | 'AD_GROUP_TYPE', required
        - `raw` object
      - `language_locale` string
      - `creative_selection` 'OPTIMIZED' | 'ROUND_ROBIN'
      - `raw` object
    - `ad` PropertyAdsReportMetricsAd
      - `id` string
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `name` string
      - `campaign_id` string
      - `group_id` string
      - `organization_id` string
      - `status` 'UNSPECIFIED' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED' | 'DRAFT' | 'SCHEDULED_FOR_DELETION' | 'PROCESSING' | 'PROCESSING_FAILED'
      - `ad_type` 'TEXT' | 'IMAGE' | 'VIDEO' | 'RESPONSIVE' | 'SHOPPING' | 'APP' | 'CALL' | 'CAROUSEL' | 'SOCIAL' | 'DISPLAY' | 'SEARCH' | 'AUDIO' | 'YOUTUBE' | 'NATIVE' | 'CTV' | 'DOOH'
      - `advertiser_name` string
      - `creative_ids` string[]
      - `creative_asset_url` string
      - `ad_copy` string
      - `headline` string
      - `description` string
      - `cta` string
      - `final_url` string
      - `display_url` string
      - `path1` string
      - `path2` string
      - `promoted` AdsPromoted[]
        - `id` string, required
        - `name` string
        - `type` 'PAGE_ID' | 'APP_ID' | 'STORE_URL' | 'PIXEL_ID' | 'CUSTOM_CONVERSION_ID' | 'CATALOG_ID' | 'PRODUCT_SET_ID' | 'PRIORITIZED_SET_ID' | 'EVENT_ID' | 'OFFER_ID' | 'LEAD_FORM_ID' | 'MESSAGING_CHANNEL_ID' | 'PRODUCT_ID' | 'TWEET_ID' | 'AD_GROUP_TYPE', required
        - `raw` object
      - `logo_creative_id` string
      - `raw` object
    - `creative` PropertyAdsReportMetricsCreative
      - `id` string
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `name` string
      - `campaign_id` string
      - `group_id` string
      - `item_id` string
      - `organization_id` string
      - `status` 'UNSPECIFIED' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED' | 'DRAFT' | 'SCHEDULED_FOR_DELETION' | 'PROCESSING' | 'PROCESSING_FAILED'
      - `creative_type` 'UNSPECIFIED' | 'STANDARD' | 'EXPANDABLE' | 'VIDEO' | 'NATIVE' | 'AUDIO' | 'PUBLISHER_HOSTED' | 'ASSET_BASED' | 'IMAGE' | 'DOCUMENT'
      - `hosting_source` 'UNSPECIFIED' | 'CM' | 'THIRD_PARTY' | 'HOSTED' | 'RICH_MEDIA' | 'PUBLISHER_HOSTED'
      - `width` number
      - `height` number
      - `asset_urls` string[] — Hosted asset mode (best-effort, provider-specific
      - `link_url` string
      - `url_tags` string
      - `body` string
      - `title` string
      - `cta` string
      - `third_party_tag` string
      - `vast_tag_url` string
      - `external_creative_reference` string
      - `external_placement_reference` string
      - `external_ad_reference` string
      - `promoted` AdsPromoted[]
        - `id` string, required
        - `name` string
        - `type` 'PAGE_ID' | 'APP_ID' | 'STORE_URL' | 'PIXEL_ID' | 'CUSTOM_CONVERSION_ID' | 'CATALOG_ID' | 'PRODUCT_SET_ID' | 'PRIORITIZED_SET_ID' | 'EVENT_ID' | 'OFFER_ID' | 'LEAD_FORM_ID' | 'MESSAGING_CHANNEL_ID' | 'PRODUCT_ID' | 'TWEET_ID' | 'AD_GROUP_TYPE', required
        - `raw` object
      - `path1` string
      - `path2` string
      - `data` string
      - `labels` string[]
      - `raw` object
    - `insertionorder` PropertyAdsReportMetricsInsertionorder
      - `id` string
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `name` string
      - `organization_id` string
      - `campaign_id` string
      - `status` 'UNSPECIFIED' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED' | 'DRAFT' | 'SCHEDULED_FOR_DELETION' | 'PROCESSING' | 'PROCESSING_FAILED'
      - `pacing` PropertyAdsReportMetricsInsertionorderPacing
        - `period` 'UNSPECIFIED' | 'DAILY' | 'FLIGHT'
        - `type` string
        - `daily_max_amount` number
        - `daily_max_impressions` number
      - `frequency_cap` PropertyAdsReportMetricsInsertionorderFrequencyCap
        - `is_unlimited` boolean
        - `time_unit` 'UNSPECIFIED' | 'LIFETIME' | 'MONTHS' | 'WEEKS' | 'DAYS' | 'HOURS' | 'MINUTES'
        - `time_unit_count` number
        - `max_impressions` number
        - `max_views` number
      - `kpi` PropertyAdsReportMetricsInsertionorderKpi
        - `type` 'UNSPECIFIED' | 'CPM' | 'CPC' | 'CPA' | 'CTR' | 'VIEWABILITY' | 'CPIAVC' | 'CPE' | 'CPV' | 'CLICK_CVR' | 'IMPRESSION_CVR' | 'VCPM' | 'VTR' | 'AUDIO_COMPLETION_RATE' | 'VIDEO_COMPLETION_RATE' | 'CPCL' | 'CPCV' | 'TOS10' | 'MAXIMIZE_PACING' | 'CUSTOM_IMPRESSION_VALUE_OVER_COST' | 'OTHER'
        - `amount` number
        - `percentage` number
        - `string_value` string
        - `algorithm_id` string
      - `budget_unit` 'UNSPECIFIED' | 'CURRENCY' | 'IMPRESSIONS'
      - `budget_segments` AdsInsertionorderBudgetSegment[]
        - `budget_amount` number
        - `description` string
        - `start_at` string, date-time
        - `end_at` string, date-time
      - `bid_strategy` PropertyAdsReportMetricsInsertionorderBidStrategy — YOUTUBE_AND_PARTNERS
        - `type` 'FIXED_BID' | 'MAXIMIZE_SPEND' | 'PERFORMANCE_GOAL' | 'YOUTUBE_AND_PARTNERS', required
        - `fixed_bid_amount` number
        - `performance_goal_type` 'UNSPECIFIED' | 'CPA' | 'CPC' | 'VIEWABLE_CPM' | 'CUSTOM_ALGO' | 'CIVA' | 'IVO_TEN' | 'AV_VIEWED' | 'REACH'
        - `performance_goal_amount` number
        - `max_average_cpm_bid_amount` number
        - `custom_bidding_algorithm_id` string
        - `raise_bid_for_deals` boolean
        - `youtube_and_partners_type` 'UNSPECIFIED' | 'MANUAL_CPV' | 'MANUAL_CPM' | 'TARGET_CPA' | 'TARGET_CPM' | 'RESERVE_CPM' | 'MAXIMIZE_LIFT' | 'MAXIMIZE_CONVERSIONS' | 'TARGET_CPV' | 'TARGET_ROAS' | 'MAXIMIZE_CONVERSION_VALUE'
        - `youtube_and_partners_value` string
        - `target_roas` number
      - `reference` string
      - `raw` object
    - `keyword` PropertyAdsReportMetricsKeyword
      - `id` string, required
      - `name` string
      - `text` string
      - `match_type` string
      - `engine_id` string
      - `landing_page` string
    - `placement` PropertyAdsReportMetricsPlacement
      - `id` string, required
      - `name` string
  - `start_at` string, date-time
  - `end_at` string, date-time
  - `organization_id` string
  - `raw` object

---

[API](https://skmtc.net/unified/apis/unified-to-api.md) · [All operations](https://skmtc.net/unified/apis/unified-to-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unified/unified-to-api/versions/1f72720916e4/schema)