Uber Developers

Uber

Developers

Keyword Performance Report

The Keyword Performance report shows how each keyword performed in your campaigns. It provides keyword-level metrics including bid information, helping you identify top-performing keywords and eliminate underperformers to optimize spend.

¶ Report Details

Report Type ID: GR_KEYWORD_PERFORMANCE

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
source: Keyword source (e.g., Automated or Manual)
keyword: Keyword text
bid_type: Bid type (e.g., Spend-based, Goal-based, or Manual bidding)
cpc_bid: CPC bid amount

Supported Time Units: WEEKLY, MONTHLY, SUMMARY

¶ 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
`cost_per_click`	Average cost per click (Spend / Clicks)
`click_through_rate`	Click-through rate (Clicks / Impressions)
`conversion_rate_14d`	Conversion rate (Orders / Clicks) within 14-day click window
`avg_order_value_14d`	Average order value (Sales / Orders) within 14-day click window
`cost_per_order_14d`	Cost per order (Spend / Orders) within 14-day click window

¶ Time Range Configuration

Weekly Reports

Start Date: Must be a Monday
End Date: Must be the next Monday
Example: "start_time": "2026-07-06T00:00:00Z", "end_time": "2026-07-13T00:00:00Z"

Monthly Reports

Start Date: Must be the first day of a month
End Date: Must be the first day of the next month
Example: "start_time": "2026-07-01T00:00:00Z", "end_time": "2026-08-01T00:00:00Z"

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_KEYWORD_PERFORMANCE",
    "time_range": {
      "start_time": "2026-07-06T00:00:00Z",
      "end_time": "2026-07-13T00:00:00Z"
    },
    "columns": [
      "ad_account_id",
      "campaign_id",
      "ad_group_id",
      "currency_code",
      "source",
      "keyword",
      "bid_type",
      "cpc_bid",
      "impressions",
      "clicks",
      "ad_spend",
      "orders_14d",
      "sales_14d",
      "roas_14d",
      "cost_per_click",
      "click_through_rate",
      "conversion_rate_14d",
      "avg_order_value_14d",
      "cost_per_order_14d"
    ],
    "time_unit": "WEEKLY",
    "file_format": "CSV"
  }'

¶ Example Response

{
  "report_id": "352c915c-d875-57c7-9a13-ae8f9273a7d2"
}

Report Details

Available Metrics

Time Range Configuration

Filter Operators

Example Request

Example Response

Uber

Developers