--- title: "Pull an SKAdNetwork report from AdNetwork postbacks" method: GET path: "/v2/reports/sk_ad_network" tags: ["Reporting Metrics"] --- # Pull an SKAdNetwork report from AdNetwork postbacks `GET /v2/reports/sk_ad_network` ## Request - Base URL: `https://api.tenjin.com` - URL: `https://api.tenjin.com/v2/reports/sk_ad_network` - Auth: HTTP bearer Columns of a row by group_by, besides `date` (absent with `granularity=totals-daily`) and the requested metrics. A group_by of several values always includes `app`, and has the columns of each value. | group_by | Columns | | --- | --- | | `app` | `app_id`, `app_name`, `platform`, `bundle_id`, `store_id` | | `channel` | `ad_network_id`, `ad_network_name`, `ad_network_short_id` | | `campaign` | `campaign_id`, `campaign_name`, the `app` columns, `ad_network_id`, `ad_network_name` | | `conversion_value` | `conversion_value` | | `fidelity_type` | `fidelity_type` | | `sk_ad_network` | `sk_ad_network_id` | | `sk_campaign` | `sk_campaign_id` | | `sk_source_app` | `sk_source_app_id` | ## Query parameters - `start_date` string, date - `end_date` string, date - `app_ids` string[] - `channel_ids` integer[] - `granularity` 'daily' | 'totals-daily' - `group_by` string[] - `metrics` string[] - `metric_filters` string[] - `omit_blank_rows` boolean - `page` integer - `per_page` integer ## Response `200` The report - SkanReportDocument - `data` SkanReportResource[], required - `id` string, required - `type` 'sk_ad_network_report', required - `attributes` object, required: The dimension columns of the group_by, and the requested metrics; see the [Metric Definitions](https://api-docs.tenjin.com/metric_definitions#sk_ad_network) - `date` string, date: First day of the period; absent with granularity=totals-daily - `app_id` string, uuid, nullable: Id of the app. Group by app or campaign; every group_by of several values includes app - `app_name` string, nullable: Name of the app. Group by app or campaign - `platform` 'amazon' | 'android' | 'android_other' | 'ios' | 'windows' | 'unspecified' | 'null', nullable: Platform of the app. Group by app or campaign - `bundle_id` string, nullable: Bundle id of the app in its store. Group by app or campaign - `store_id` string, nullable: Id of the app in its store. Group by app or campaign - `ad_network_id` integer, nullable: Id of the channel. Group by channel or campaign - `ad_network_name` string, nullable: Name of the channel. Group by channel or campaign - `ad_network_short_id` string, nullable: URL-safe id of the channel. Group by channel - `campaign_id` string, uuid: Id of the campaign. Group by campaign - `campaign_name` string, nullable: Name of the campaign. Group by campaign - `conversion_value` integer, nullable: SKAdNetwork conversion value, from 0 to 63. Group by conversion_value - `fidelity_type` integer, nullable: 1 for StoreKit-rendered ads, 0 for view-through ads. Group by fidelity_type - `sk_ad_network_id` string, nullable: SKAdNetwork id of the ad network. Group by sk_ad_network - `sk_campaign_id` integer, nullable: SKAdNetwork campaign id, from 0 to 99. Group by sk_campaign - `sk_source_app_id` integer, nullable: Store id of the app that showed the ad. Group by sk_source_app - `conversion_value_count` integer, nullable: Conversions. When requested - `conversion_value_total` integer, nullable: Conversion Value Total. When requested - `conversion_value_avg` number, double, nullable: Conversion Value Average. When requested - `redownload_count` integer, nullable: Redownloads. When requested - `redownload_cv_total` integer, nullable: Redownload Conversion Value Total. When requested - `redownload_cv_avg` number, double, nullable: Redownload Conversion Value Average. When requested - `first_download_count` integer, nullable: First Downloads. When requested - `first_download_cv_total` integer, nullable: First Download Conversion Value Total. When requested - `first_download_cv_avg` number, double, nullable: First Download Conversion Value Average. When requested - `assists` integer, nullable: Assists. When requested - `redownload_assists` integer, nullable: Redownload Assists. When requested - `first_download_assists` integer, nullable: First Download Assists. When requested - `links` Links, required - `self` string, uri, required: URL of this request - `first` string, uri: URL of the first page of a list - `prev` string, uri: URL of the previous page of a list - `next` string, uri: URL of the next page of a list - `last` string, uri: URL of the last page of a list - `meta` SkanReportMeta, required - `count` integer, required: Number of rows on all pages - `per_page` integer, required: Number of rows per page - `start_date` string, date, required: The start_date param, or its default - `end_date` string, date, required: The end_date param, or its default - `metrics` string[], required: The requested metrics - `organization_id` string, uuid, required: Id of your organization - `app_ids` string[], required: The app_ids param - `granularity` 'daily' | 'totals-daily', required: The granularity param, or its default - `group_by` union, required: Internal dimension names: a string for one dimension, an array for several - 'app_id' | 'ad_network_id' | 'conversion_value' | 'fidelity_type' | 'sk_ad_network_id' | 'sk_campaign_id' | 'sk_source_app_id' | 'campaign_id' - SkanReportDimension[] - `ad_network_ids` integer[], required: The channel_ids param ## Other responses - `400`: A param is missing or invalid, a record is not found, or the request cannot be served - `401`: Missing or invalid credentials, or no access to the requested data - `403`: Invalid token, or the user's role does not allow the request - `429`: More than 100 report requests in a minute with one access token - `498`: Expired token, or a token with an invalid signature --- [API](https://skmtc.dev/tenjin/apis/reporting-metrics-api.md) - [All operations](https://skmtc.dev/tenjin/apis/reporting-metrics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tenjin/apis/reporting-metrics-api/revisions/cffd908625be?raw)