The Uber Ads API offers several report types to analyze different aspects of your advertising performance. Each report type provides specific dimensions and metrics tailored to different use cases.

¶ Available Report Types

¶ Ad Performance (ad_performance)

Core performance metrics across your advertising campaigns, ad groups, and placements.

Use Cases:

• Overall campaign performance analysis
• Placement effectiveness comparison
• Budget optimization decisions

Dimensions:

• ad_account_id, campaign_id, ad_group_id: Campaign hierarchy
• currency_code: Currency for monetary values
• placement_l1, placement_l2: Ad placement (Browse, Search)

Available Metrics: View all ad performance metrics

¶ Ad Performance by Location (ad_performance_by_location)

Location-specific performance metrics to understand geographic effectiveness.

Use Cases:

• Geographic performance analysis
• Store-level optimization
• Regional budget allocation

Dimensions:

• ad_account_id, campaign_id, ad_group_id: Campaign hierarchy
• location_uuid: Specific store/location identifier
• currency_code: Currency for monetary values

Available Metrics: View all location performance metrics

¶ Ad Performance by Keyword (ad_performance_by_keyword)

Keyword-level performance for search advertising campaigns.

Use Cases:

• Keyword bid optimization
• Search term analysis
• Match type performance comparison

Dimensions:

• ad_account_id, campaign_id, ad_group_id: Campaign hierarchy
• currency_code: Currency for monetary values
• match_type: Keyword matching (EXACT, PHRASE, BROAD)
• keyword: Targeted keyword phrase

Available Metrics: View all keyword performance metrics

¶ Ad Keyword Identification (ad_keyword_identification)

Search term insights to identify new keyword opportunities.

Use Cases:

• Keyword discovery
• Search term analysis
• Competitive positioning insights

Dimensions:

• ad_account_id: Account identifier
• search_term: Actual user search query

Available Metrics: View all keyword identification metrics

¶ Ad Performance by Tenure (ad_performance_by_tenure)

Customer tenure-based performance analysis to understand audience segments.

Use Cases:

• Customer lifetime value analysis
• Audience segmentation insights
• Retention marketing effectiveness

Dimensions:

• ad_account_id, campaign_id, ad_group_id: Campaign hierarchy
• audience_tenure: Customer segment (new, existing, lapsed, returning)
• currency_code: Currency for monetary values

Available Metrics: View all tenure performance metrics

¶ Time Granularity Support

All report types support these time granularities:

• Daily: Day-by-day breakdown
• Weekly: Week-by-week aggregation
• Monthly: Month-by-month aggregation
• Summary: Total aggregation across date range

¶ Report Configuration

When generating reports, specify:

1. Report Type: Choose from the types above
2. Time Range: Start and end dates
3. Time Unit: Granularity (daily/weekly/monthly/summary)
4. Columns: Specific metrics to include
5. Filters (optional): Filter by dimensions or metrics

For detailed API usage, see the Generate Report endpoint documentation.