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

# BrandsCampaignReportRow

A single row in an Apple Maps campaign report, containing campaign metadata, total metrics, and optional granular time-series metrics.

```
object BrandsCampaignReportRow
```

## Discussion

For `brands` reports, supported `groupBy` dimensions are `deviceClass`, `locationId`, and `supplyPlacement`. These appear as dimension values within the `metadata` object.

### Example

```json
{
  "totalMetrics": {
    "localSpend": {
      "amount": "845.50",
      "currency": "USD"
    },
    "impressions": 620000,
    "taps": 9800,
    "ttr": 0.0158,
    "cpt": {
      "amount": "0.09",
      "currency": "USD"
    },
    "cpm": {
      "amount": "1.36",
      "currency": "USD"
    },
    "getDirections": {
      "tap": 320
    },
    "call": {
      "tap": 145
    },
    "share": {
      "tap": 95
    }
  },
  "granularMetrics": [
    {
      "date": "2025-01-10",
      "localSpend": {
        "amount": "420.25",
        "currency": "USD"
      },
      "impressions": 310000,
      "taps": 4900,
      "ttr": 0.0158,
      "cpt": {
        "amount": "0.09",
        "currency": "USD"
      },
      "cpm": {
        "amount": "1.36",
        "currency": "USD"
      },
      "getDirections": {
        "tap": 160
      },
      "call": {
        "tap": 72
      },
      "share": {
        "tap": 48
      }
    }
  ],
  "metadata": {
    "id": 555666777,
    "promotedObjectType": "BUSINESS_BRAND",
    "promotedObjectId": "123456789",
    "name": "AwayFinder Apple Maps Campaign",
    "status": "ENABLED",
    "deleted": false,
    "displayStatus": "RUNNING",
    "modificationTime": "2025-01-10T08:00:00.000",
    "creationTime": "2025-01-05T08:00:00.000",
    "adAccountId": 987654321,
    "systemStatus": "RUNNING",
    "billingEvent": "IMPRESSIONS",
    "dailyBudget": {
      "value": {
        "amount": "50.00",
        "currency": "USD"
      }
    },
    "startTime": "2025-01-10T08:00:00.000",
    "endTime": "2025-12-31T08:00:00.000",
    "bidStrategy": {
      "bidStrategyType": "MANUAL_CPT",
      "bid": {
        "amount": "1.50",
        "currency": "USD"
      }
    },
    "deviceClass": "IPHONE",
    "locationId": "123456789",
    "supplyPlacement": "MAPS_SEARCH_RESULTS"
  }
}
```

---

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)