Contents

BrandsAdGroupReportRow

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

Declaration

object BrandsAdGroupReportRow

Properties

NameTypeDescription
totalMetricsBrandsAdGroupMetrics

See BrandsAdGroupMetrics for details.

granularMetrics[BrandsAdGroupMetrics]

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.

metadataBrandsReportingAdGroup

See BrandsReportingAdGroup for details.

Discussion

The BrandsAdGroupReportRow object is the brands counterpart to AppsAdGroupReportRow. The metadata field captures ad group 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": 620000,
    "taps": 9800,
    "ttr": 0.0158,
    "cpt": {
      "amount": "0.09",
      "currency": "USD"
    },
    "cpm": {
      "amount": "1.36",
      "currency": "USD"
    },
    "firstActions": {
      "tap": 1450
    },
    "firstActionsPerTap": {
      "tap": 0.1480
    },
    "firstActionsPerImpression": {
      "tap": 0.0023
    },
    "costPerFirstAction": {
      "tap": {
        "amount": "0.58",
        "currency": "USD"
      }
    },
    "actions": {
      "tap": 2100
    },
    "costPerAction": {
      "tap": {
        "amount": "0.40",
        "currency": "USD"
      }
    },
    "getDirections": {
      "tap": 320
    },
    "tapURL": {
      "tap": 610
    },
    "call": {
      "tap": 145
    },
    "share": {
      "tap": 95
    },
    "getTheApp": {
      "tap": 780
    },
    "galleryEngagement": {
      "tap": 150
    },
    "actionsPerTap": {
      "tap": 0.2143
    },
    "actionsPerImpression": {
      "tap": 0.0034
    }
  },
  "granularMetrics": [
    {
      "date": "2025-01-10",
      "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"
      },
      "firstActions": {
        "tap": 1450
      },
      "firstActionsPerTap": {
        "tap": 0.1480
      },
      "firstActionsPerImpression": {
        "tap": 0.0023
      },
      "costPerFirstAction": {
        "tap": {
          "amount": "0.58",
          "currency": "USD"
        }
      },
      "actions": {
        "tap": 2100
      },
      "costPerAction": {
        "tap": {
          "amount": "0.40",
          "currency": "USD"
        }
      },
      "getDirections": {
        "tap": 320
      },
      "tapURL": {
        "tap": 610
      },
      "call": {
        "tap": 145
      },
      "share": {
        "tap": 95
      },
      "getTheApp": {
        "tap": 780
      },
      "galleryEngagement": {
        "tap": 150
      },
      "actionsPerTap": {
        "tap": 0.2143
      },
      "actionsPerImpression": {
        "tap": 0.0034
      }
    }
  ],
  "metadata": {
    "id": 123456789,
    "campaignId": 987654321,
    "adAccountId": 555666777,
    "name": "AwayFinder - Brands Ad Group",
    "status": "ENABLED",
    "deleted": false,
    "systemStatus": "RUNNING",
    "systemStatusReasons": ["PROCESSING"],
    "systemStatusLimitingReasons": [],
    "automatedKeywordsOptIn": false,
    "automatedKeywordsRequired": false,
    "pricingModel": "CPT",
    "displayStatus": "RUNNING",
    "modificationTime": "2025-01-10T08:00:00.000",
    "creationTime": "2025-01-05T08:00:00.000",
    "startTime": "2025-01-05T08:00:00.000",
    "endTime": "2025-06-30T08:00:00.000",
    "campaign": {},
    "bidStrategy": {
      "bidStrategyType": "MANUAL_CPT",
      "bid": {
        "amount": "2.50",
        "currency": "USD"
      }
    },
    "targeting": {
      "supplyPlacement": {
        "include": ["MAPS_SEARCH_RESULTS", "MAPS_SEARCH_HOME"]
      },
      "lifetimeStorefronts": {
        "include": ["US", "CA"]
      },
      "supplySource": {
        "include": ["MAPS"]
      },
      "promotedLocationGroup": {
        "include": ["555666777"]
      },
      "promotedLocation": {
        "include": ["123456789"]
      }
    },
    "deviceClass": "IPHONE",
    "locationId": "123456789",
    "supplyPlacement": "MAPS_SEARCH_RESULTS"
  }
}

See Also