The Ad Performance by Audience Tenure report segments performance by customer tenure categories, helping you understand how different customer segments respond to your advertising.

¶ Report Details

Report Type ID: AD_PERFORMANCE_BY_AUDIENCE_TENURE

Use Cases:

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

Dimensions:

• ad_account_id, campaign_id, ad_group_id: Campaign hierarchy
• audience_segment: Audience segment (new, existing, lapsed)
• currency_code: Currency for monetary values

Supported Time Units: DAILY, WEEKLY, MONTHLY, SUMMARY

¶ Available Metrics

• impressions
• clicks
• ad_spend
• orders_7d_on_click_date
• sales_7d_on_click_date
• exposed_orders_7d_on_impression_date
• exposed_sales_7d_on_impression_date
• orders_7d_on_order_date
• sales_7d_on_order_date
• exposed_orders_7d_on_order_date
• exposed_sales_7d_on_order_date
• roas_7d_on_click_date
• exposed_roas_7d_on_impression_date
• roas_7d_on_order_date
• exposed_roas_7d_on_order_date
• cost_per_click
• cost_per_order_7d_on_click_date
• cost_per_exposed_order_7d_on_impression_date
• cost_per_order_7d_on_order_date
• cost_per_exposed_order_7d_on_order_date
• avg_order_value_7d_on_click_date
• exposed_avg_order_value_7d_on_impression_date
• avg_order_value_7d_on_order_date
• exposed_avg_order_value_7d_on_order_date
• click_through_rate
• click_to_order_rate_7d_on_click_date
• exposed_click_to_order_rate_7d_on_impression_date
• click_to_order_rate_7d_on_order_date
• exposed_click_to_order_rate_7d_on_order_date
• new_to_brand_customers
• 42d_lapsed_to_brand_customers
• 42d_existing_to_brand_customers
• exposed_new_to_brand_customers
• exposed_42d_lapsed_to_brand_customers
• exposed_42d_existing_to_brand_customers
• audience_clicked
• audience_exposed
• customers_7d_on_click_date
• exposed_customers_7d_on_impression_date

¶ Time Range Configuration

When configuring time ranges, follow these guidelines for proper aggregation:

Daily and Summary Reports

• Start Date: Any valid date
• End Date: Any valid date after start date
• Example: "start_time": "2025-07-15T00:00:00Z", "end_time": "2025-07-20T00:00:00Z"

Weekly Reports

• Start Date: Must be a Monday
• End Date: Must be the next Monday
• Example: "start_time": "2025-07-21T00:00:00Z", "end_time": "2025-07-28T00: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": "2025-07-01T00:00:00Z", "end_time": "2025-08-01T00: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": "AD_PERFORMANCE_BY_AUDIENCE_TENURE",
    "time_range": {
      "start_time": "2025-07-01T00:00:00Z",
      "end_time": "2025-08-01T00:00:00Z"
    },
    "columns": [
      "campaign_id",
      "ad_group_id",
      "audience_segment",
      "impressions",
      "clicks",
      "ad_spend",
      "sales_7d_on_click_date",
      "orders_7d_on_click_date",
      "new_to_brand_customers",
      "42d_existing_to_brand_customers"
    ],
    "time_unit": "MONTHLY",
    "file_format": "CSV"
  }'

¶ Example Response

{
  "report_id": "8a2e38b2-59fb-5242-a0ec-e913a42150b5"
}

¶ Related Reports

• Ad Performance - Overall campaign performance analysis
• Ad Performance by Location - Geographic performance breakdown