The campaign audiences resource allows segmenting your store's promotions based on defining target audiences meeting specific criteria. For more information on this feature, check out Campaign audiences.

Follow the steps below to create a new campaign audience:

1. In the VTEX Admin, go to Promotions > Campaign audience, or type Campaign audience in the search bar at the top of the page.
2. Click New Campaign Audience.
3. Fill in the general campaign audience data as described in the General data section.
4. Next to Target audience, click on Create new target audience.
5. Fill in the fields described in the Create new target audience section.
6. Click Save.

After creating a campaign audience, you have to associate it with a campaign promotion to take effect. Follow the steps described in the Creating a campaign promotion guide.

When creating a new campaign audience, you must enter the following information in the What are the general campaign audience data? section:

• Status: The current status of the campaign audience.
  • Active: Available to use in your store's campaign promotions.
  • Inactive: Unavailable to use in your store's campaign promotions.
• Name: Name of the campaign audience.
• Description: Internal description of the campaign audience.
• Expiration date: The amount of time the campaign audience is valid in your store.
  • Start Date: Start date scheduled for activating the campaign audience.
  • Start Hour: Start hour scheduled for activating the campaign audience.
  • End Date: End date scheduled for deactivating the campaign audience.
  • End Hour: End hour scheduled for deactivating the campaign audience.

When scheduling a campaign audience, the Start Date or Start Hour must be subsequent to your current date or hour.

The time zone will be the same as the one on the user's device when creating the campaign audience — you cannot adjust the hour to a different time zone.

Configuring the target audience allows you to segment users based on specific conditions. For more information on the target audience for campaign audiences, please read the article Campaign audience.

After clicking Create New Target Audience, you must follow the instructions below:

1. Fill in the fields related to the target audience. Please see the sections listed below for details on each field's meaning:
   • Define your target audience: Name the target audience.
   • Items to use for this target audience: Limit the items associated with this target audience.
   • Conditions for your target audience to be applied: Fill in the criteria on which customers will be included in the defined target audience.
2. At the bottom of the target audience configuration section, click Update. The created audience will be listed in the Target audience section. If you want to edit it, click it and make the necessary changes. If you want to delete it, click the bin icon .
3. If you want to create more target audiences for the campaign audience, click Create new Target Audience again and repeat steps 1 and 2. If not, go to step 4.
4. If you created more than one target audience, you must select the relationship between them in the campaign audience:
   • or: The campaign audience will consist of customers fitting any target audience.
   • and: The campaign audience will consist of customers fitting all the target audiences, summing up all their criteria.

• Name: Name of the target audience.

• Categories, Brands, Collections and SKUs: Allows adding or removing one or more categories, brands, collections, products and SKUs from the target audience using the Equal to or Different from criteria.

  The items must meet all selected prerequisites for the customer to be part of the target audience.

• At least __ products meet the criteria above: Determines how many items corresponding to the defined criteria must be in the shopping cart for a customer to be in the target audience. All previous criteria must be Equal to to enable this configuration.

For example: The target audience includes items whose brand is Nike, as illustrated below. The configuration also indicates that at least 3 items must meet the criteria. Therefore, a customer must have at least 3 items in the shopping cart to be included in the target audience.

• Minimum order value: Minimum value the items in the cart must have in total. The total considers the sum of the prices of cart items that meet all the campaign audience criteria.

• Maximum order value: Maximum value the items in the cart must have in total. This total considers the sum of the prices of cart items that meet all the campaign audience criteria.

• Item price between __ and __: Minimum and maximum price for each item in the cart. The campaign audience will be activated if the item value is within the range of the set values.

• Use restriction BINs: The campaign audience will be activated if the credit card Bank Identification Number (BIN) corresponds to the filled-in characters. The BIN refers to the first 6 or 8 digits on a credit card and is used to identify the bank and the card label.

• Marketing Tags:: this field prevents activating the campaign audience if the purchase is made using the VTEX Subscriptions module.

• Customer cluster: The customer will be part of the target audience if they are included in the selected cluster. It is important to highlight that the cluster name must be written exactly as in the Master Data. Spelling errors will prevent the configuration from working correctly.

• Maximum number of installments: The campaign audience will be activated if the selected number of installments is lower or equal to the maximum number allowed.

• Only if it's a first buy: The campaign audience will be activated only if this is the customer's first purchase from the store.

• Apply the discount even if the user is not logged in?: This field is displayed when the Only if it's a first buy option is checked. If the field above is checked, the customer will be included in the target audience even if they are not logged in using an email and password. When the field is unchecked, the customer will only be included in the target audience if they sign in with an email and password previously used to access the store.

• Price "from" and "to" are the same or Price "from" and "to" are different: Refers to the values listed in the product list price. You can only select one of the two options.

• Shipping to postal code should Include / Exclude from __ to __: Allows including or excluding shipping code ranges for order shipment. The campaign audience will be activated if the shipping code meets the rule set for the target audience.

• Affiliates: Allows selecting affiliates from a list. A campaign audience will be activated if the purchase is made in one of those affiliate marketplaces.

  The Affiliates option only applies if the affiliate is a VTEX store.

• utm_source: Allows selecting the desired utm_source or creating a new one to be linked to the campaign audience. The campaign audience will be activated if customer navigation is made using the utm_source corresponding to any entered values. It is important to note that customers can only enter one utm_source at checkout.

• utm_campaign: Allows selecting the desired utm_campaign or creating a new one to be linked to the campaign audience. The discount will be granted if the customer navigation uses a utm_campaign corresponding to the entered value.

• Shipping method: Allows selecting the shipping option for the target audience. For example: standard or express. The campaign audience will be activated if the customer selects one of the defined shipping options when completing an order.

• Apply selected discount only when one of the above carriers is selected by the customer: The campaign audience will be activated only after the customer selects the order delivery method.

• Payment system: Allows selecting the payment methods that will be included in the target audience. The campaign audience will be activated if the payment method selected by the customer is the one configured for this target audience.

  Campaign audiences defined by Payment system or Maximum number of installments will not apply to orders paid using two credit cards or vouchers.

• Campaign audiences
• List of campaign audiences
• Creating a campaign audience