This page details the targeting schema and options for Sponsored Listings campaigns.

¶ Targeting Schema Requirements

Sponsored Listings follows a specific 3-level schema structure. You must follow this exact structure or your request will be rejected with a validation error.

Important: Each level corresponds to a criteria object in your targeting configuration. Levels are optional - you can use just Level 1, or nest to Level 2, or nest all the way to Level 3 depending on your targeting needs.

Level 1 (Root Level - Required)

• Operator: Must be AND
• Negation: Must be false
• Number of options: Minimum 0 (targeting is optional), no maximum enforced

Level 2 (First Nested Level - Optional)

• Operator: Must be OR
• Negation: Can be either true or false
• Number of options: Minimum 1 required, no maximum enforced

Level 3 (Maximum Nesting Depth - Optional)

• Operator: Must be OR
• Negation: Can be either true or false
• Number of options: Minimum 1 required, no maximum enforced
• Important: You cannot nest beyond this level - attempting Level 4 will result in an error

¶ Available Targeting Types

You can only use these targeting types for Sponsored Listings:

Order Frequency

• Targets users based on their order history within a specific time range
• Allowed past days values: Must be exactly 7, 14, 30, 45, 60, or 90 (no other values accepted)
• Bounds are non-inclusive: If you set lower_bound=0 and upper_bound=3, this targets users with 1-2 orders (not 0 or 3)

Uber One

• Targets users who have an active Uber One membership subscription

New to Location

• Targets users who have not ordered from your location in the last 365 days

New to Brand

• Targets users who have not ordered from your brand in the last 365 days

Existing to Location

• Targets users who ordered from your location in the last 42 days

¶ Targeting Examples

Example 1: Simple targeting without nesting

Targets Uber One members who are new to your location:

{
  "targeting": {
    "negation": false,
    "operator": "AND",
    "criteria": [
      {
        "new_to_location": {}
      },
      {
        "uber_one": {}
      }
    ]
  }
}

Example 2: One level of nesting

Targets Uber One members who are either new to your location OR new to your brand:

{
  "targeting": {
    "negation": false,
    "operator": "AND",
    "criteria": [
      {
        "criteria": {
          "negation": false,
          "operator": "OR",
          "criteria": [
            {
              "new_to_location": {}
            },
            {
              "new_to_brand": {}
            }
          ]
        }
      },
      {
        "uber_one": {}
      }
    ]
  }
}

Example 3: Maximum nesting depth (3 levels)

Targets Uber One members who are either new to your location OR NOT users who placed 4-10 orders in the past 30 days:

{
  "targeting": {
    "negation": false,
    "operator": "AND",
    "criteria": [
      {
        "criteria": {
          "negation": false,
          "operator": "OR",
          "criteria": [
            {
              "new_to_location": {}
            },
            {
              "criteria": {
                "negation": true,
                "operator": "OR",
                "criteria": [
                  {
                    "order_frequency": {
                      "lower_bound": 3,
                      "upper_bound": 10,
                      "time_range": {
                        "past_days_range": {
                          "start_day": 0,
                          "end_day": 30
                        }
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      },
      {
        "uber_one": {}
      }
    ]
  }
}