MOLOCO Analytics API

openapi: 3.2.0
info:
  title: Moloco Analytics API
  version: '1.10'
  contact:
    name: Moloco Inc.
    url: https://www.moloco.com
  description: 'Operations tagged Analytics across 2 of this provider''s published API definitions: moloco-ads-campaign-management-api.json, moloco-ads-campaign-management-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.moloco.cloud
security:
- Bearer: []
tags:
- name: Analytics
paths:
  /cm/v1/analytics-detail:
    post:
      summary: Provide the detail of ad performance analytics.
      description: Provide the detail of ad performance analytics.
      operationId: DspApi_QueryAnalyticsDetail
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messagesQueryAnalyticsDetailResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/googlerpcStatus'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/messagesQueryAnalyticsDetailRequest'
        required: true
      tags:
      - Analytics
    servers:
    - url: https://api.moloco.cloud
  /cm/v1/analytics-overview:
    post:
      summary: Provide the overview of ad performance analytics.
      description: Provide the overview of ad performance analytics.
      operationId: DspApi_QueryAnalyticsOverview
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messagesQueryAnalyticsOverviewResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/googlerpcStatus'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/messagesQueryAnalyticsOverviewRequest'
        required: true
      tags:
      - Analytics
    servers:
    - url: https://api.moloco.cloud
  /cm/v1/analytics-skadnetwork:
    post:
      summary: Provide the SKAdNetwork ad performance analytics.
      description: Provide the SKAdNetwork ad performance analytics.
      operationId: DspApi_QueryAnalyticsSKAdNetwork
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messagesQueryAnalyticsSKAdNetworkResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/googlerpcStatus'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/messagesQueryAnalyticsSKAdNetworkRequest'
        required: true
      tags:
      - Analytics
    servers:
    - url: https://api.moloco.cloud
components:
  schemas:
    dspAnalyticsDetailDimensionFilter:
      type: object
      properties:
        dimension:
          $ref: '#/components/schemas/dspAnalyticsDetailDimension'
          description: Dimension to filter on.
        operator:
          $ref: '#/components/schemas/dspAnalyticsDetailDimensionFilterOperator'
        values:
          type: array
          items:
            type: string
          description: Values to filter by the dimension.
      description: AnalyticsDetailDimensionFilter specifies a filter for the detailed analytics dimensions.
    dspAnalyticsSKAdNetworkMetric:
      type: string
      enum:
      - UNKNOWN_METRIC
      - IMPRESSIONS
      - CLICKS
      - INSTALLS
      - INSTALLS_CT
      - MMP_CONVERSIONS
      - TARGET_ACTIONS
      - SPEND
      - REVENUE
      - SKAN_INSTALLS
      - SKAN_ACTIONS
      - SKAN_REVENUE
      - CTR
      - IPM
      - CPC
      - CPI
      - CPA
      - CPCONV
      - SKAN_CPA
      - SKAN_IPM
      - SKAN_CPI
      - SKAN_CONVERSION_VALUE_RATIO
      default: UNKNOWN_METRIC
      description: "Metric enumerates available metrics.\n\n - UNKNOWN_METRIC: This value is not part of the API specification.\n - IMPRESSIONS: DEFAULT METRICS\n - CTR: RATIO METRICS"
    dspAnalyticsDetailJob:
      type: object
      properties:
        id:
          type: string
          description: The ID of the job.
      description: The job information executed for the detailed analytics query request.
    dspAnalyticsSKAdNetworkMetricColumn:
      type: object
      properties:
        impressions:
          type: string
          format: int64
          description: The total number of impressions.
        clicks:
          type: string
          format: int64
          description: The total number of clicks.
        installs:
          type: string
          format: int64
          description: The total number of installs.
        installs_ct:
          type: string
          format: int64
          description: The total number of click-through installs.
        mmp_conversions:
          type: string
          format: int64
          description: The total number counted based on the MMP kpi action event in Campaign.
        target_actions:
          type: string
          format: int64
          description: The total number of CPA Campaign's target actions.
        spend:
          type: number
          format: double
          description: The total ads spending for the current row.
        revenue:
          type: number
          format: double
          description: The total revenue for the current row.
        skan_actions:
          type: string
          format: int64
          description: The total number of SKAdNetwork actions for the current row.
        skan_installs:
          type: string
          format: int64
          description: The total number of SKAdNetwork installs for the current row.
        skan_revenue:
          type: number
          format: double
          description: 'The total SKAdNetwork revenue for the current row.

            From the API version 1.5.1, it will be calculated as the average of the minimum and maximum sum values within the revenue interval of conversion events.

            For previous API versions, it will return the maximum sum value within the revenue interval of conversion events.'
        ctr:
          type: number
          format: double
          description: The total ads CTR for the current row.
        ipm:
          type: number
          format: double
          description: The total ads IPM for the current row.
        cpc:
          type: number
          format: double
          description: The total ads CPC for the current row.
        cpi:
          type: number
          format: double
          description: The total ads CPI for the current row.
        cpa:
          type: number
          format: double
          description: The total ads CPA for the current row.
        cpconv:
          type: number
          format: double
          description: The total ads CPConv for the current row.
        skan_ipm:
          type: number
          format: double
          description: The total ads SKAdNetwork IPM for the current row.
        skan_cpi:
          type: number
          format: double
          description: The total ads SKAdNetwork CPI for the current row.
        skan_cpa:
          type: number
          format: double
          description: The total ads SKAdNetwork CPA for the current row.
        skan_conversion_value_ratio:
          type: number
          format: double
          description: The rate of SKAN Conversion Values (0 ~ 63) to the total postbacks.
      description: MetricColumn represents a structured column containing metric numbers.
    messagesQueryAnalyticsOverviewResponse:
      type: object
      properties:
        rows:
          type: array
          items:
            type: object
            $ref: '#/components/schemas/dspAnalyticsOverviewRow'
        num_rows:
          type: string
          format: int64
          description: The number of the rows returned.
    dspAnalyticsOverviewSubPublisherColumnType:
      type: string
      enum:
      - UNKNOWN_TYPE
      - APP
      - SITE
      default: UNKNOWN_TYPE
      description: ' - UNKNOWN_TYPE: This value is not part of the API specification.'
    dspAnalyticsDetailMetricFilter:
      type: object
      properties:
        metric:
          $ref: '#/components/schemas/dspAnalyticsDetailMetric'
          description: Metric to filter on.
        operator:
          $ref: '#/components/schemas/dspAnalyticsDetailMetricFilterOperator'
        value:
          type: string
          description: Value to filter by the metric.
      description: AnalyticsDetailMetricFilter specifies a filter for the detailed analytics metrics.
    dspAnalyticsDetailAdAccountColumn:
      type: object
      properties:
        id:
          type: string
          description: Unique ID of an ad-account.
        title:
          type: string
          description: Descriptive name of an ad-account.
        currency:
          $ref: '#/components/schemas/adcloudcommonCurrency'
          description: Contract currency in ISO-4217.
      description: AdAccountColumn represents a structured column containing ad-account information.
    dspAnalyticsSKAdNetworkMetricFilter:
      type: object
      properties:
        metric:
          $ref: '#/components/schemas/dspAnalyticsSKAdNetworkMetric'
          description: Metric to filter on.
        operator:
          $ref: '#/components/schemas/dspAnalyticsSKAdNetworkMetricFilterOperator'
        value:
          type: string
          description: Value to filter by the metric.
      description: AnalyticsSKAdNetworkMetricFilter specifies a filter for the SKAdNetwork analytics metrics.
    dspAnalyticsSKAdNetworkJob:
      type: object
      properties:
        id:
          type: string
          description: The ID of the job.
      description: The job information executed for the SKAdNetwork analytics query request.
    googlerpcStatus:
      type: object
      properties:
        code:
          type: integer
          format: int32
        message:
          type: string
        details:
          type: array
          items:
            type: object
            $ref: '#/components/schemas/protobufAny'
    dspAnalyticsDetailCampaignColumn:
      type: object
      properties:
        id:
          type: string
          description: Unique ID of a campaign.
        title:
          type: string
          description: Descriptive name of a campaign.
        type:
          type: string
          description: Type of a campaign.
        target_countries:
          type: array
          items:
            type: string
          description: Target country code list in ISO-3166 Alpha-3.
        bid_country:
          type: string
          description: Bid country code in ISO-3166 Alpha-3.
        country:
          type: string
          description: Representative target country code in ISO-3166 Alpha-3.
        goal_type:
          type: string
          description: Goal Type of a campaign.
        is_cross_promo:
          type: boolean
          description: Flag indicating whether the campaign is cross promo campaign.
      description: CampaignColumn represents a structured column containing campaign information.
    dspAnalyticsOverviewType:
      type: string
      enum:
      - USER_ACQUISITION
      - REENGAGEMENT
      default: USER_ACQUISITION
    dspAnalyticsOverviewMetricRevenue:
      type: object
      properties:
        d1:
          type: number
          format: double
          description: Cumulative revenue by day 1.
        d3:
          type: number
          format: double
          description: Cumulative revenue by day 3.
        d7:
          type: number
          format: double
          description: Cumulative revenue by day 7.
        d14:
          type: number
          format: double
          description: Cumulative revenue by day 14.
        d30:
          type: number
          format: double
          description: Cumulative revenue by day 30.
      description: MetricRevenue represents a structured column containing revenue metrics.
    dspAnalyticsDetailMetricFilterOperator:
      type: string
      enum:
      - UNKNOWN_METRIC_OPERATOR
      - EQ
      - GT
      - GE
      - LT
      - LE
      default: UNKNOWN_METRIC_OPERATOR
      description: Operator for the metric filter.
    dspAnalyticsSKAdNetworkCampaignColumn:
      type: object
      properties:
        id:
          type: string
          description: Unique ID of a Campaign.
        title:
          type: string
          description: Descriptive name of a Campaign.
        type:
          type: string
          description: Type of a Campaign.
        target_countries:
          type: array
          items:
            type: string
          description: Target country code list in ISO-3166 Alpha-3.
        country:
          type: string
          description: Representative target country code in ISO-3166 Alpha-3.
      description: CampaignColumn represents a structured column containing Campaign information.
    AnalyticsSKAdNetworkSKANConversionColumn:
      type: object
      properties:
        conversion_value:
          type: string
          description: SKAdNetwork fine-grained conversion value. ToString([0, 63]) or "NULL".
        version:
          type: string
          description: SKAdNetwork version. (e.g, 2.0, 2.1, 2.2).
        fidelity_type:
          type: string
          description: 'Raw SKAdNetwork fidelity type defined in Apple''s following document.

            https://developer.apple.com/documentation/storekit/skadnetwork/receiving_ad_attributions_and_postbacks

            As of June 2021, values are ToString([0, 1]) or "NULL".'
        conversion_count:
          type: string
          format: int64
          description: 'The total number of SKAdNetwork conversions.


            It counts all SKAdNetwork conversions having did-win value as null for before version 3.0, and true for version 3.0 and later.

            See did-win flag in the [following document](https://developer.apple.com/documentation/storekit/skadnetwork/verifying_an_install-validation_postback?language=objc) for further details.'
        non_winning_conversion_count:
          type: string
          format: int64
          description: 'The total number of non-winning SKAdNetwork conversions.

            It counts all SKAdNetwork conversions having did-win value as false for version 3.0 and later.

            See did-win flag in the [following document](https://developer.apple.com/documentation/storekit/skadnetwork/verifying_an_install-validation_postback?language=objc) for further details.'
        conversion_events:
          type: array
          items:
            type: object
            $ref: '#/components/schemas/AnalyticsSKAdNetworkSKANConversionEventColumn'
          description: SKAdNetwork Conversion Events associated with this specific conversion_value.
      description: SKANConversionColumn represents a structured column containing SKAdNetwork conversion value and its count for the current row.
    dspAnalyticsOverviewSiteColumn:
      type: object
      properties:
        id:
          type: string
          description: Unique ID of a Site.
        title:
          type: string
          description: Descriptive name of a Site.
        domain:
          type: string
          description: Domain of the site.
      description: SiteColumn represents a structured column containing site information.
    dspAnalyticsOverviewSubPublisherColumn:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/dspAnalyticsOverviewSubPublisherColumnType'
          description: Type of a sub-publisher. This will be either App or Site.
      description: SubPublisherColumn represents a structured column containing sub-publisher information.
    dspAnalyticsOverviewCreativeGroupColumn:
      type: object
      properties:
        id:
          type: string
          description: Unique ID of a creative-group.
        title:
          type: string
          description: Descriptive name of a creative-group.
        is_dca:
          type: boolean
          description: Flag indicating whether the creative-group is a DCA (Dynamic Creative Assembly) creative-group.
      description: CreativeGroupColumn represents a structured column containing creative-group information.
    dspAnalyticsOverviewMetricFilterOperator:
      type: string
      enum:
      - UNKNOWN_METRIC_OPERATOR
      - EQ
      - GT
      - GE
      - LT
      - LE
      default: UNKNOWN_METRIC_OPERATOR
      description: Operator for the metric filter.
    dspAnalyticsDetailDimension:
      type: string
      enum:
      - UNKNOWN_DIMENSION
      - DATE
      - HOUR
      - TIMEZONE
      - AD_ACCOUNT_ID
      - AD_ACCOUNT_TITLE
      - AD_ACCOUNT_CURRENCY
      - APP_OR_SITE_ID
      - APP_OR_SITE_TITLE
      - APP_TYPE
      - APP_OS
      - APP_STORE_ID
      - SITE_DOMAIN
      - CAMPAIGN_ID
      - CAMPAIGN_TITLE
      - CAMPAIGN_TYPE
      - CAMPAIGN_TARGET_COUNTRIES
      - CAMPAIGN_BID_COUNTRY
      - CAMPAIGN_COUNTRY
      - CAMPAIGN_GOAL_TYPE
      - AD_GROUP_ID
      - AD_GROUP_TITLE
      - CREATIVE_GROUP_ID
      - CREATIVE_GROUP_TITLE
      - CREATIVE_GROUP_IS_DCA
      - CREATIVE_ID
      - CREATIVE_TITLE
      - CREATIVE_TYPE
      - CREATIVE_MAIN_ASSET_LOCATION
      - CREATIVE_FORMAT
      - CREATIVE_VIDEO_DURATION_SECONDS
      - CREATIVE_VIDEO_END_CARD_TYPE
      - CREATIVE_IS_DCA
      - EXCHANGE_ID
      - SUB_PUBLISHER_ID
      - SUB_PUBLISHER_TITLE
      - INVENTORY_TYPE
      - TRAFFIC_LAT
      default: UNKNOWN_DIMENSION
      description: "Dimension enumerates available dimensions.\n\n - UNKNOWN_DIMENSION: This value is not part of the API specification.\n - AD_ACCOUNT_ID: AD_ACCOUNT\n - APP_OR_SITE_ID: APP_OR_SITE\n - CAMPAIGN_ID: CAMPAIGN\n - AD_GROUP_ID: AD_GROUP\n - CREATIVE_GROUP_ID: CREATIVE_GROUP\n - CREATIVE_ID: CREATIVE\n - EXCHANGE_ID: EXCHANGE\n - INVENTORY_TYPE: INVENTORY\n - TRAFFIC_LAT: TRAFFIC"
    messagesQueryAnalyticsSKAdNetworkResponse:
      type: object
      properties:
        rows:
          type: array
          items:
            type: object
            $ref: '#/components/schemas/dspAnalyticsSKAdNetworkRow'
          description: Result rows for the requested query.
        job:
          $ref: '#/components/schemas/dspAnalyticsSKAdNetworkJob'
          description: The job information executed for the SKAdNetwork analytics query request.
    AnalyticsSKAdNetworkSKANConversionDimension:
      type: string
      enum:
      - UNKNOWN_SKAN_CONVERSION_DIMENSION
      - CONVERSION_VALUE
      - VERSION
      - FIDELITY_TYPE
      default: UNKNOWN_SKAN_CONVERSION_DIMENSION
      description: "SKANConversionDimension enumerates available SKAN conversion related dimensions.\n\n - UNKNOWN_SKAN_CONVERSION_DIMENSION: This value is not part of the API specification."
    dspAnalyticsOverviewMetricCount:
      type: object
      properties:
        d1:
          type: string
          format: int64
          description: Cumulative count by day 1.
        d3:
          type: string
          format: int64
          description: Cumulative count by day 3.
        d7:
          type: string
          format: int64
          description: Cumulative count by day 7.
        d14:
          type: string
          format: int64
          description: Cumulative count by day 14.
        d30:
          type: string
          format: int64
          description: Cumulative count by day 30.
      description: MetricCount represents a structured column containing count metrics.
    dspAnalyticsSKAdNetworkAppColumn:
      type: object
      properties:
        id:
          type: string
          description: Unique ID of an App.
        title:
          type: string
          description: Descriptive name of an App.
        store_id:
          type: string
          description: Store ID of an App.
      description: AppColumn represents a structured column containing app information.
    dspAnalyticsOverviewMetric:
      type: string
      enum:
      - UNKNOWN_ORDER_BY_COLUMN
      - IMPRESSIONS
      - ENGAGED_VIEWS
      - CLICKS
      - INSTALLS
      - TARGET_ACTIONS
      - CONVERSIONS
      - SPEND
      - REVENUE
      - CTR
      - IPM
      - CPC
      - CPI
      - CPA
      - CPCONV
      - D1_KPI_ACTION
      - D1_KPI_USER
      - D1_PURCHASE
      - D1_PURCHASER
      - D1_REVENUE
      - D1_ROAS
      - D1_CPA
      - D3_KPI_ACTION
      - D3_KPI_USER
      - D3_PURCHASE
      - D3_PURCHASER
      - D3_REVENUE
      - D3_ROAS
      - D3_CPA
      - D7_KPI_ACTION
      - D7_KPI_USER
      - D7_PURCHASE
      - D7_PURCHASER
      - D7_REVENUE
      - D7_ROAS
      - D7_CPA
      - D14_KPI_ACTION
      - D14_KPI_USER
      - D14_PURCHASE
      - D14_PURCHASER
      - D14_REVENUE
      - D14_ROAS
      - D14_CPA
      - D30_KPI_ACTION
      - D30_KPI_USER
      - D30_PURCHASE
      - D30_PURCHASER
      - D30_REVENUE
      - D30_ROAS
      - D30_CPA
      - PAGE_VISITS
      - SESSIONS
      - CPS
      - CPPV
      - PVPI
      - DRIVEN_INSTALLS
      - MOLOCO_MEASURED_INSTALLS
      - MOLOCO_MEASURED_EQUAL_PRIORITY_WINDOW_INSTALLS
      - LANDING_2H
      - CPRE
      - UNIQUE_VISITORS
      - UNIQUE_PURCHASERS
      - CPUV
      - CPUP
      - PAGE_VISITS_1D
      - PAGE_VISITS_3D
      - PAGE_VISITS_7D
      - PAGE_VISITS_14D
      default: UNKNOWN_ORDER_BY_COLUMN
      description: "Metric enumerates available metrics.\n\n - UNKNOWN_ORDER_BY_COLUMN: This value is not part of the API specification.\n - D1_KPI_ACTION: D1\n - D3_KPI_ACTION: D3\n - D7_KPI_ACTION: D7\n - D14_KPI_ACTION: D14\n - D30_KPI_ACTION: D30\n - PAGE_VISITS: CTV-WEB METRICS + CTV-WEB RATIO METRICS\n - LANDING_2H: RE-ENGAGEMENT METRICS\n - UNIQUE_VISITORS: UNIQUE USER METRICS\n - PAGE_VISITS_1D: PAGE VISITS COHORT METRICS"
    dspAnalyticsSKAdNetworkRow:
      type: object
      properties:
        date:
          type: string
          description: The date in the local timezone with 'YYYY-MM-DD' format.
        hour:
          type: integer
          format: int32
          description: Hour in the local timezone.
        timezone:
          type: string
          description: Timezone.
        ad_account:
          $ref: '#/components/schemas/dspAnalyticsSKAdNetworkAdAccountColumn'
          description: AdAccount column.
        app:
          $ref: '#/components/schemas/dspAnalyticsSKAdNetworkAppColumn'
          description: App column.
        campaign:
          $ref: '#/components/schemas/dspAnalyticsSKAdNetworkCampaignColumn'
          description: Campaign column.
        traffic:
          $ref: '#/components/schemas/dspAnalyticsSKAdNetworkTrafficColumn'
          description: Traffic column.
        metric:
          $ref: '#/components/schemas/dspAnalyticsSKAdNetworkMetricColumn'
          description: Metric column.
        skan_conversions:
          type: array
          items:
            type: object
            $ref: '#/components/schemas/AnalyticsSKAdNetworkSKANConversionColumn'
          description: List of SKAdNetwork Conversion Column.
      description: Row defines one row of the overview query result.
    dspAnalyticsSKAdNetworkDimension:
      type: string
      enum:
      - UNKNOWN_DIMENSION
      - DATE
      - HOUR
      - TIMEZONE
      - AD_ACCOUNT_ID
      - AD_ACCOUNT_TITLE
      - AD_ACCOUNT_CURRENCY
      - APP_ID
      - APP_TITLE
      - APP_STORE_ID
      - CAMPAIGN_ID
      - CAMPAIGN_TITLE
      - CAMPAIGN_TYPE
      - CAMPAIGN_TARGET_COUNTRIES
      - CAMPAIGN_COUNTRY
      - TRAFFIC_LAT
      - TRAFFIC_SKAN_REQ
      - TRAFFIC_SKAN_BID
      - TRAFFIC_MMP_EFFECTIVE
      default: UNKNOWN_DIMENSION
      description: "Dimension enumerates available dimensions.\n\n - UNKNOWN_DIMENSION: This value is not part of the API specification.\n - AD_ACCOUNT_ID: AD_ACCOUNT\n - APP_ID: APP\n - CAMPAIGN_ID: CAMPAIGN\n - TRAFFIC_LAT: TRAFFIC"
    dspAnalyticsSKAdNetworkOrderByFilter:
      type: object
      properties:
        dimension:
          $ref: '#/components/schemas/dspAnalyticsSKAdNetworkDimension'
          description: Dimension column.
        metric:
          $ref: '#/components/schemas/dspAnalyticsSKAdNetworkMetric'
          description: Metric column.
        is_descending:
          type: boolean
          description: Whether it is descending order.
      description: AnalyticsSKAdNetworkOrderByFilter specifies a filter for the SKAdNetwork analytics order by.
    dspAnalyticsDetailDimensionFilterOperator:
      type: string
      enum:
      - UNKNOWN_DIMENSION_OPERATOR
      - IN
      - NOT_IN
      default: UNKNOWN_DIMENSION_OPERATOR
      description: Operator for the dimension filter.
    dspAnalyticsDetailSiteColumn:
      type: object
      properties:
        id:
          type: string
          description: Unique ID of a Site.
        title:
          type: string
          description: Descriptive name of a Site.
        domain:
          type: string
          description: Domain of the site.
      description: SiteColumn represents a structured column containing site information.
    messagesQueryAnalyticsOverviewRequest:
      type: object
      properties:
        ad_account_id:
          type: string
          description: (Required) The AdAccount ID to generate the overview.
        date_range:
          $ref: '#/components/schemas/adcloudcommonDateInterval'
          description: '(Required) Date range for the overview to generate. Both start and end dates are inclusive.

            The specified timezone in the request will be used.


            Note the allowed maximum duration for the date range is 101 days (184 days for the version >= v1.7.2).'
        dimensions:
          type: array
          items:
            $ref: '#/components/schemas/dspAnalyticsOverviewDimension'
          description: '(Required) A list of dimensions. At least one dimension must be selected.

            Following dimensions are only available for the version >= v1.7.2:

            - Campaign_GoalType

            - CreativeGroup-related dimensions

            - Creative-related dimensions

            - Exchange_ID

            - SubPublisher_Type

            - Inventory_Type

            For the earlier version, they won''t be supported.'
        metrics:
          type: array
          items:
            $ref: '#/components/schemas/dspAnalyticsOverviewMetric'
          description: '(Required) A list of metrics. At least one metric must be selected.

            Cohort metrics are only available for the version >= v1.7.2.'
        order_by_filters:
          type: array
          items:
            type: object
            $ref: '#/components/schemas/dspAnalyticsOverviewOrderByFilter'
          description: (Optional) Order by conditions.
        limit:
          type: string
          format: int64
          description: "(Optional) A maximum possible number of rows in the response.\nWhen this field is left empty or equal to 0, it will return the following number of rows:\n  - For the version < 1.7.1: all rows of summary will be sent through the response.\n  - For the version >= 1.7.1: 10000 will be applied as a default.\n  - For the version >= 1.7.1: If the limit value is bigger than 10000, then 10000 will be applied as an upper limit."
        dimension_filters:
          type: array
          items:
            type: object
            $ref: '#/components/schemas/dspAnalyticsOverviewDimensionFilter'
          description: (Optional) A set of filtering conditions of dimensions.
        metric_filters:
          type: array
          items:
            type: object
            $ref: '#/components/schemas/dspAnalyticsOverviewMetricFilter'
          description: (Optional) A set of filtering conditions of metrics.
        type:
          $ref: '#/components/schemas/dspAnalyticsOverviewType'
          title: '(Optional) Type of the analytics overview.

            If absent, API request will be treated as UA'
      title: '///////////////////////////////////////////////////////

        Analytics Overview'
      required:
      - ad_account_id
      - date_range
      - dimensions
      - metrics
    dspAnalyticsSKAdNetworkMetricFilterOperator:
      type: string
      enum:
      - UNKNOWN_METRIC_OPERATOR
      - EQ
      - GT
      - GE
      - LT
      - LE
      default: UNKNOWN_METRIC_OPERATOR
      description: Operator for the metric filter.
    dspAnalyticsOverviewCreativeColumn:
      type: object
      properties:
        id:
          type: string
          description: Unique ID of a creative.
        title:
          type: string
          description: Descriptive name of a creative.
        type:
          type: string
          description: Type of a creative.
        main_asset_url:
          type: string
          description: URL of the main asset of a creative.
        format:
          type: string
          description: Format of a creative.
        video_duration_seconds:
          type: integer
          format: int32
          description: Duration of a video creative.
        video_end_card_type:
          type: string
          description: End card type of a video creative.
        is_dca:
          type: boolean
          description: Flag indicating whether the creative is a DCA (Dynamic Creative Assembly) creative.
      description: CreativeColumn represents a structured column containing creative information.
    dspAnalyticsDetailMetricColumn:
      type: object
      properties:
        impressions:
          type: string
          format: int64
          description: The total number of impressions.
        engaged_views:
          type: string
          format: int64
          description: The total number of engaged views.
        engaged_clicks:
          type: string
          format: int64
          description: The total number of engaged clicks.
        clicks:
          type: string
          format: int64
          description: The total number of clicks.
        installs:
          type: string
          format: int64
          description: The total number of installs.
        installs_ct:
          type: string
          format: int64
          description: The total number of click-through installs.
        conversions:
          type: string
          format: int64
          description: The total number of conversions selected by a user.
        target_actions:
          type: string
          format: int64
          description: The total number of CPA Campaign's target actions.
        spend:
          type: number
          format: double
          description: The total ads spending for the current row.
        revenue:
          type: number
          format: double
          description: The total revenue for the current row.
        ctr:
          type: number
          format: double
          description: The total ads CTR for the current row.
        ipm:
          type: number
          format: double
          description: The total ads IPM for the current row.
        cpc:
          type: number
          format: double
          description: The total ads CPC for the current row.
        cpi:
          type: number
          format: double
          description: The total ads CPI for the current row.
        cpa:
          type: number
          format: double
          description: The total ads CPA for the current row.
        cpconv:
          type: number
          format: double
          description: The total ads CPConv for the current row.
        vtr:
          type: number
          format: double
          description: The total VTR for the current row.
        cpcv:
          type: number
          format: double
          description: The total ads CPCV for the current row.
        cps:
          type: number
          format: double
          description: The total ads CPS for the current row.
        cppv:
          type: number
          format: double
          description: The total ads CPPV for the current row.
        pvpi:
          type: number
          format: double
          description: The total ads PVPI for the 

# --- truncated at 32 KB (68 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/moloco/refs/heads/main/openapi/moloco-analytics-api-openapi.yml