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
orders_14d Number of orders attributed within 14-day click window
sales_14d Total sales attributed within 14-day click window in local currency
roas_14d Return on ad spend (Sales / Spend) within 14-day click 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)
cost_per_order_14d Cost per order (Spend / Orders) within 14-day click window
conversion_rate_14d Conversion rate (Orders / Clicks) within 14-day click window

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",
      "orders_14d",
      "sales_14d",
      "roas_14d",
      "avg_cost_per_click",
      "avg_cost_per_mille",
      "click_through_rate",
      "cost_per_order_14d",
      "conversion_rate_14d"
    ],
    "time_unit": "DAILY",
    "file_format": "CSV"
  }'

Example Response

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

Uber

Developers
© 2026 Uber Technologies Inc.