Contents

BrandsAdReportRow

A single row in a Brands (Apple Maps) ad-level report, pairing ad metadata with total and granular performance metrics.

Declaration

object BrandsAdReportRow

Properties

NameTypeDescription
totalMetricsBrandsMetrics

See BrandsMetrics for details.

granularMetrics[BrandsMetrics]

Time-series metrics broken down by the requested granularity (for example, DAILY, WEEKLY). Present only when a granularity is specified in the request. When it isn’t, this field is absent and all data appears in totalMetrics instead.

metadataBrandsReportingAd

See BrandsReportingAd for details.

Discussion

The BrandsAdReportRow object is the brands counterpart to AppsAdReportRow. It uses BrandsMetrics, a richer metric set than the apps metrics that includes Maps location-action fields such as getDirections, call, and share alongside the standard impression and tap metrics.

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

{
  "totalMetrics": {
    "localSpend": {
      "amount": "845.50",
      "currency": "USD"
    },
    "impressions": 210000,
    "taps": 5200,
    "ttr": 0.0247,
    "cpt": {
      "amount": "0.16",
      "currency": "USD"
    },
    "cpm": {
      "amount": "4.03",
      "currency": "USD"
    },
    "firstActions": {
      "tap": 1300
    },
    "firstActionsPerTap": {
      "tap": 0.25
    },
    "firstActionsPerImpression": {
      "tap": 0.0062
    },
    "costPerFirstAction": {
      "tap": {
        "amount": "0.65",
        "currency": "USD"
      }
    },
    "actions": {
      "tap": 2100
    },
    "costPerAction": {
      "tap": {
        "amount": "0.40",
        "currency": "USD"
      }
    },
    "getDirections": {
      "tap": 620
    },
    "tapURL": {
      "tap": 410
    },
    "call": {
      "tap": 180
    },
    "share": {
      "tap": 95
    },
    "getTheApp": {
      "tap": 540
    },
    "galleryEngagement": {
      "tap": 255
    },
    "actionsPerTap": {
      "tap": 0.40
    },
    "actionsPerImpression": {
      "tap": 0.01
    }
  },
  "granularMetrics": [
    {
      "date": "2025-01-10",
      "localSpend": {
        "amount": "845.50",
        "currency": "USD"
      },
      "impressions": 210000,
      "taps": 5200,
      "ttr": 0.0247,
      "cpt": {
        "amount": "0.16",
        "currency": "USD"
      },
      "cpm": {
        "amount": "4.03",
        "currency": "USD"
      },
      "firstActions": {
        "tap": 1300
      },
      "firstActionsPerTap": {
        "tap": 0.25
      },
      "firstActionsPerImpression": {
        "tap": 0.0062
      },
      "costPerFirstAction": {
        "tap": {
          "amount": "0.65",
          "currency": "USD"
        }
      },
      "actions": {
        "tap": 2100
      },
      "costPerAction": {
        "tap": {
          "amount": "0.40",
          "currency": "USD"
        }
      },
      "getDirections": {
        "tap": 620
      },
      "tapURL": {
        "tap": 410
      },
      "call": {
        "tap": 180
      },
      "share": {
        "tap": 95
      },
      "getTheApp": {
        "tap": 540
      },
      "galleryEngagement": {
        "tap": 255
      },
      "actionsPerTap": {
        "tap": 0.40
      },
      "actionsPerImpression": {
        "tap": 0.01
      }
    }
  ],
  "metadata": {
    "id": 555666777,
    "name": "AwayFinder - Brands Ad",
    "deleted": false,
    "status": "ENABLED",
    "systemStatus": "RUNNING",
    "systemStatusReasons": [],
    "systemStatusLimitingReasons": [],
    "adAccountId": 123456789,
    "campaignId": 987654321,
    "adGroupId": 456789123,
    "creationTime": "2025-01-10T08:00:00.000",
    "modificationTime": "2025-01-10T08:00:00.000",
    "displayStatus": "RUNNING",
    "creative": {
      "id": 321654987,
      "creativeType": "LOCAL_ADS_SEARCH_CREATIVE",
      "systemStatus": "VALID"
    },
    "deviceClass": "IPHONE",
    "locationId": "location-98765",
    "supplyPlacement": "MAPS_SEARCH_RESULTS"
  }
}

See Also