Contents

BrandsMetrics

Metrics for brands promoted object type.

Declaration

object BrandsMetrics

Properties

NameTypeDescription
datedate

Report date in YYYY-MM-DD format.

localSpendMoney

Total spend. See Money.

impressionsint64

Total ad impressions.

tapsint64

Total ad taps.

ttrnumber

Tap-through rate.

cptMoney

Average cost per tap. See Money.

cpmMoney

Average cost per thousand impressions. See Money.

firstActionsActionMetrics

First-time action counts. See ActionMetrics.

firstActionsPerTapRateMetrics

First-action rates per tap. See RateMetrics.

firstActionsPerImpressionRateMetrics

First-action rates per impression. See RateMetrics.

costPerFirstActionCostMetrics

Cost per first action. See CostMetrics.

actionsActionMetrics

Total action counts. See ActionMetrics.

costPerActionCostMetrics

Cost per action. See CostMetrics.

getDirectionsActionMetrics

Get-directions action counts. See ActionMetrics.

tapURLActionMetrics

Tap-URL action counts. See ActionMetrics.

callActionMetrics

Call action counts. See ActionMetrics.

shareActionMetrics

Share action counts. See ActionMetrics.

getTheAppActionMetrics

Get-the-app action counts. See ActionMetrics.

galleryEngagementActionMetrics

Gallery engagement action counts. See ActionMetrics.

actionsPerTapRateMetrics

Total actions per tap rate. See RateMetrics.

actionsPerImpressionRateMetrics

Total actions per impression rate. See RateMetrics.

Discussion

The BrandsMetrics object is the base metrics for brands campaign reports. It includes spend, impression, and tap metrics shared with apps, plus brands-specific engagement actions (get directions, tap URL, call, share, get the app, gallery engagement) and their associated rate and cost breakdowns.

All action count fields reference ActionMetrics objects. Cost fields reference CostMetrics. Rate fields reference RateMetrics. Monetary spend fields reference Money.

Example

{
  "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
  }
}

See Also