<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/AppsAdReportRow",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "data:apple-ads-platform-api:AppsAdReportRow"
  },
  "title" : "AppsAdReportRow"
}
-->

# AppsAdReportRow

A single row in an Apps ad-level report, containing ad metadata, total metrics, and optional granular time-series metrics.

```
object AppsAdReportRow
```

## Discussion

The `metadata` field captures ad identifiers and configuration at report time. The `totalMetrics` field contains the aggregated performance figures across the full reporting period.

### Example

```json
{
  "metadata": {
    "id": 555666777,
    "name": "AwayFinder - Search Ad",
    "deleted": false,
    "status": "ENABLED",
    "systemStatus": "RUNNING",
    "systemStatusReasons": [],
    "systemStatusLimitingReasons": [],
    "adAccountId": 123456789,
    "campaignId": 234567890,
    "adGroupId": 345678901,
    "creationTime": "2025-01-10T08:00:00.000",
    "modificationTime": "2025-02-01T12:30:00.000",
    "displayStatus": "RUNNING",
    "creative": {
      "id": 456789012,
      "creativeType": "DEFAULT_PRODUCT_PAGE",
      "systemStatus": "VALID"
    },
    "countryOrRegion": "US",
    "storefront": "US"
  },
  "totalMetrics": {
    "localSpend": {
      "amount": "482.50",
      "currency": "USD"
    },
    "impressions": 41230,
    "taps": 980,
    "ttr": 0.0238,
    "cpt": {
      "amount": "0.49",
      "currency": "USD"
    },
    "cpm": {
      "amount": "11.71",
      "currency": "USD"
    },
    "tapInstalls": 312,
    "tapInstallCPI": {
      "amount": "1.55",
      "currency": "USD"
    },
    "totalNewDownloads": 298,
    "totalRedownloads": 41,
    "viewInstalls": 27,
    "totalInstalls": 339,
    "tapNewDownloads": 285,
    "tapRedownloads": 27,
    "viewNewDownloads": 13,
    "viewRedownloads": 14,
    "totalAvgCPI": {
      "amount": "1.42",
      "currency": "USD"
    },
    "totalInstallRate": 0.346,
    "tapInstallRate": 0.318,
    "tapPreOrdersPlaced": 5,
    "viewPreOrdersPlaced": 1,
    "totalPreOrdersPlaced": 6
  },
  "granularMetrics": [
    {
      "date": "2025-02-01",
      "localSpend": {
        "amount": "17.25",
        "currency": "USD"
      },
      "impressions": 1450,
      "taps": 34,
      "ttr": 0.0234,
      "cpt": {
        "amount": "0.51",
        "currency": "USD"
      },
      "cpm": {
        "amount": "11.90",
        "currency": "USD"
      },
      "tapInstalls": 11,
      "tapInstallCPI": {
        "amount": "1.57",
        "currency": "USD"
      },
      "totalNewDownloads": 10,
      "totalRedownloads": 2,
      "viewInstalls": 1,
      "totalInstalls": 12,
      "tapNewDownloads": 10,
      "tapRedownloads": 1,
      "viewNewDownloads": 0,
      "viewRedownloads": 1,
      "totalAvgCPI": {
        "amount": "1.44",
        "currency": "USD"
      },
      "totalInstallRate": 0.353,
      "tapInstallRate": 0.324,
      "tapPreOrdersPlaced": 0,
      "viewPreOrdersPlaced": 0,
      "totalPreOrdersPlaced": 0
    }
  ]
}
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)