Three lines

Uber

Developers

Advertiser Metrics Report

The Advertiser Metrics report provides campaign-level performance data for retail ads. It includes cost model details and key efficiency metrics like CPC and CPM, helping you evaluate campaign performance and optimize budget allocation across campaigns and ad groups.

Report Details

Report Type ID: GR_ADVERTISER_METRICS

Filters:

  • ad_account_id: Ad account identifier
  • campaign_id: Campaign identifier
  • ad_group_id: Ad group identifier

Dimensions:

  • ad_account_id: Ad account identifier
  • campaign_id: Campaign identifier
  • ad_group_id: Ad group identifier
  • currency_code: Currency code
  • ad_campaign_cost_model: Campaign cost model (e.g., CPC or CPM)
  • ad_group_cost_model: Ad group cost model (e.g., CPC or CPM)

Supported Time Units: DAILY, SUMMARY

Lookback Limit: 180 days

Available Metrics

Metric Description
impressions Number of times the ad was shown
clicks Number of times the ad was clicked
ad_spend Total ad spend in local currency
units_sold_14d Number of units sold attributed within 14-day window
sales_14d Total sales attributed within 14-day window in local currency
roas_14d Return on ad spend (Sales / Spend) within 14-day window
avg_cost_per_click Average cost per click (Spend / Clicks)
avg_cost_per_mille Average cost per thousand impressions (Spend / Impressions x 1000)
click_through_rate Click-through rate (Clicks / Impressions)

Time Range Configuration

Daily and Summary Reports

  • Start Date: Any valid date
  • End Date: Any valid date after start date
  • Example: "start_time": "2026-07-01T00:00:00Z", "end_time": "2026-07-31T00:00:00Z"

Filter Operators

Supported operators: EQUAL, NOT_EQUAL, IN

Example Request

curl -X POST "https://api.uber.com/v1/ads/{account_id}/reporting/report" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "Accept: application/json" \
  -d '{
    "report_type": "GR_ADVERTISER_METRICS",
    "time_range": {
      "start_time": "2026-07-01T00:00:00Z",
      "end_time": "2026-07-31T00:00:00Z"
    },
    "columns": [
      "ad_account_id",
      "campaign_id",
      "ad_group_id",
      "currency_code",
      "ad_campaign_cost_model",
      "ad_group_cost_model",
      "impressions",
      "clicks",
      "ad_spend",
      "units_sold_14d",
      "sales_14d",
      "roas_14d",
      "avg_cost_per_click",
      "avg_cost_per_mille",
      "click_through_rate"
    ],
    "time_unit": "DAILY",
    "file_format": "CSV"
  }'

Example Response

{
  "report_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Uber

Developers
© 2026 Uber Technologies Inc.