---
title: "Provide the SKAdNetwork ad performance analytics."
method: POST
path: "/cm/v1/analytics-skadnetwork"
tags: ["Analytics"]
---

# Provide the SKAdNetwork ad performance analytics.

`POST /cm/v1/analytics-skadnetwork`

Provide the SKAdNetwork ad performance analytics.

## Request body

- MessagesQueryAnalyticsSKAdNetworkRequest
  - `ad_account_id` string, required — (Required) The ad account id of campaigns to generate the SKAdNetwork analytics.
  - `timezone` string — (Optional) The timezone to generate the SKAdNetwork analytics. If not specified, UTC timezone will be used.
  - `date_range` AdcloudcommonDateInterval, required — Interval with start and end dates in the format of YYYY-MM-DD.
    - `start` string — Start date in the format of YYYY-MM-DD.
    - `end` string — End date in the format of YYYY-MM-DD.
  - `dimensions` DspAnalyticsSKAdNetworkDimension[], required — (Required) A list of dimensions. At least one dimension must be selected.
  - `skan_conversion_dimensions` AnalyticsSKAdNetworkSKANConversionDimension[], required — (Required) A list of SKAN conversion dimensions. At least one dimension must be selected.
  - `metrics` DspAnalyticsSKAdNetworkMetric[], required — (Required) A list of metrics. At least one metric must be selected.
  - `dimension_filters` DspAnalyticsSKAdNetworkDimensionFilter[] — (Optional) A set of filtering conditions of dimensions for the SKAdNetwork analytics.
    - `dimension` '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' — Dimension enumerates available dimensions. - UNKNOWN_DIMENSION: This value is not part of the API specification. - AD_ACCOUNT_ID: AD_ACCOUNT - APP_ID: APP - CAMPAIGN_ID: CAMPAIGN - TRAFFIC_LAT: TRAFFIC
    - `operator` 'UNKNOWN_DIMENSION_OPERATOR' | 'IN' | 'NOT_IN' — Operator for the dimension filter.
    - `values` string[] — Values to filter by the dimension.
  - `metric_filters` DspAnalyticsSKAdNetworkMetricFilter[] — (Optional) A set of filtering conditions of metrics for the SKAdNetwork analytics.
    - `metric` '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' — Metric enumerates available metrics. - UNKNOWN_METRIC: This value is not part of the API specification. - IMPRESSIONS: DEFAULT METRICS - CTR: RATIO METRICS
    - `operator` 'UNKNOWN_METRIC_OPERATOR' | 'EQ' | 'GT' | 'GE' | 'LT' | 'LE' — Operator for the metric filter.
    - `value` string — Value to filter by the metric.
  - `order_by_filters` DspAnalyticsSKAdNetworkOrderByFilter[] — (Optional) A list of sorting order specification for the SKAdNetwork analytics. The order of the messages matters as they are treated sequentially.
    - `dimension` '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' — Dimension enumerates available dimensions. - UNKNOWN_DIMENSION: This value is not part of the API specification. - AD_ACCOUNT_ID: AD_ACCOUNT - APP_ID: APP - CAMPAIGN_ID: CAMPAIGN - TRAFFIC_LAT: TRAFFIC
    - `metric` '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' — Metric enumerates available metrics. - UNKNOWN_METRIC: This value is not part of the API specification. - IMPRESSIONS: DEFAULT METRICS - CTR: RATIO METRICS
    - `is_descending` boolean — Whether it is descending order.
  - `limit` string, int64 — (Optional) A maximum possible number of rows in the response. When this field is left empty or equal to 0, it will return the following number of rows: - For the version < 1.7.1: all rows of summary will be sent through the response. - For the version >= 1.7.1: 10000 will be applied as a default. - For the version >= 1.7.1: If the limit value is bigger than 10000, then 10000 will be applied as an upper limit.

## Response `200`

A successful response.

- MessagesQueryAnalyticsSKAdNetworkResponse
  - `rows` DspAnalyticsSKAdNetworkRow[] — Result rows for the requested query.
    - `date` string — The date in the local timezone with 'YYYY-MM-DD' format.
    - `hour` integer — Hour in the local timezone.
    - `timezone` string — Timezone.
    - `ad_account` DspAnalyticsSKAdNetworkAdAccountColumn — AdAccountColumn represents a structured column containing ad-account information.
      - `id` string — Unique ID of an ad-account.
      - `title` string — Descriptive name of an ad-account.
      - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound.
    - `app` DspAnalyticsSKAdNetworkAppColumn — AppColumn represents a structured column containing app information.
      - `id` string — Unique ID of an App.
      - `title` string — Descriptive name of an App.
      - `store_id` string — Store ID of an App.
    - `campaign` DspAnalyticsSKAdNetworkCampaignColumn — CampaignColumn represents a structured column containing Campaign information.
      - `id` string — Unique ID of a Campaign.
      - `title` string — Descriptive name of a Campaign.
      - `type` string — Type of a Campaign.
      - `target_countries` string[] — Target country code list in ISO-3166 Alpha-3.
      - `country` string — Representative target country code in ISO-3166 Alpha-3.
    - `traffic` DspAnalyticsSKAdNetworkTrafficColumn — TrafficColumn represents a structured column containing LAT information.
      - `lat` boolean — Flag indicating whether LAT option is on or not.
      - `skan_req` boolean — Flag indicating whether bid request contains SKAdNetwork extension.
      - `skan_bid` boolean — Flag indicating whether bid response fills SKAdNetwork extensions.
      - `mmp_effective` boolean — Flag indicating whether MMP attribution is effective.
    - `metric` DspAnalyticsSKAdNetworkMetricColumn — MetricColumn represents a structured column containing metric numbers.
      - `impressions` string, int64 — The total number of impressions.
      - `clicks` string, int64 — The total number of clicks.
      - `installs` string, int64 — The total number of installs.
      - `installs_ct` string, int64 — The total number of click-through installs.
      - `mmp_conversions` string, int64 — The total number counted based on the MMP kpi action event in Campaign.
      - `target_actions` string, int64 — The total number of CPA Campaign's target actions.
      - `spend` number, double — The total ads spending for the current row.
      - `revenue` number, double — The total revenue for the current row.
      - `skan_actions` string, int64 — The total number of SKAdNetwork actions for the current row.
      - `skan_installs` string, int64 — The total number of SKAdNetwork installs for the current row.
      - `skan_revenue` number, double — 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` number, double — The total ads CTR for the current row.
      - `ipm` number, double — The total ads IPM for the current row.
      - `cpc` number, double — The total ads CPC for the current row.
      - `cpi` number, double — The total ads CPI for the current row.
      - `cpa` number, double — The total ads CPA for the current row.
      - `cpconv` number, double — The total ads CPConv for the current row.
      - `skan_ipm` number, double — The total ads SKAdNetwork IPM for the current row.
      - `skan_cpi` number, double — The total ads SKAdNetwork CPI for the current row.
      - `skan_cpa` number, double — The total ads SKAdNetwork CPA for the current row.
      - `skan_conversion_value_ratio` number, double — The rate of SKAN Conversion Values (0 ~ 63) to the total postbacks.
    - `skan_conversions` AnalyticsSKAdNetworkSKANConversionColumn[] — List of SKAdNetwork Conversion Column.
      - `conversion_value` string — SKAdNetwork fine-grained conversion value. ToString([0, 63]) or "NULL".
      - `version` string — SKAdNetwork version. (e.g, 2.0, 2.1, 2.2).
      - `fidelity_type` string — 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` string, int64 — 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` string, int64 — 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` AnalyticsSKAdNetworkSKANConversionEventColumn[] — SKAdNetwork Conversion Events associated with this specific conversion_value.
        - `name` string — Conversion event name.
        - `count` string, int64 — The total number of conversions for a specific event.
        - `revenue_min_sum` number, double — The min sum value of revenue interval in conversion event.
        - `revenue_max_sum` number, double — The max sum value of revenue interval in conversion event.
  - `job` DspAnalyticsSKAdNetworkJob — The job information executed for the SKAdNetwork analytics query request.
    - `id` string — The ID of the job.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/moloco/apis/moloco-ads-campaign-management-api.md) · [All operations](https://skmtc.net/moloco/apis/moloco-ads-campaign-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moloco/moloco-ads-campaign-management-api/revisions/5c85d0910ac0/schema)