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 identifiercampaign_id: Campaign identifierad_group_id: Ad group identifier
Dimensions:
ad_account_id: Ad account identifiercampaign_id: Campaign identifierad_group_id: Ad group identifiercurrency_code: Currency codead_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"
}