Contents

BrandsSearchTermReportRow

A single row in a Brands search term report, pairing search-term metadata with total and granular performance metrics.

Declaration

object BrandsSearchTermReportRow

Properties

NameTypeDescription
totalMetricsBrandsMetrics

See BrandsMetrics for details.

granularMetrics[BrandsMetrics]

Time-series metrics broken down by the requested granularity. Present only when the request specifies a granularity. Otherwise, it’s omitted and all data appears in totalMetrics.

metadataBrandsReportingSearchTerm

See BrandsReportingSearchTerm for details.

Discussion

The BrandsSearchTermReportRow object is the brands counterpart to AppsSearchTermReportRow. The metadata field captures the search term text and its associated keyword, ad group, and location context at report time. The totalMetrics field contains the aggregated performance figures across the full reporting period.

Like all search term reports, brands search term reports require the ORTZ timezone. UTC isn’t supported. Search term entity reports also exclude the supplyPlacement and locationId dimensions from groupBy.

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": {
    "campaignId": 555666777,
    "adAccountId": 123456789,
    "searchTermText": "AwayFinder",
    "searchTermSource": "SEARCH",
    "keyword": {
      "locationId": "555666777",
      "matchType": "PHRASE"
    },
    "adGroupId": 987654321,
    "adGroup": {
      "name": "AwayFinder Brand Ad Group",
      "deleted": false
    },
    "countryOrRegion": "US",
    "deviceClass": "IPHONE"
  }
}

See Also