[Targeting] 1st Party Audience targeting for Adswizz

Overview

This feature enables you to define 1st Party Data Targeting for Adswizz bookings directly in ADvendio. It allows for custom key-value targeting configurations, which are frequently provided by agencies. These can now be easily stored and submitted as part of your Campaign Item setup or defined in reusable Targeting Sets or AdSpecs.

🙋‍♀️ What is 1st Party Data Targeting?

Adswizz supports audience targeting using 1st Party Data through Key-Value pairs in the format:

KEY = VALUE1, VALUE2

Or to exclude:

KEY != VALUE1, VALUE2

In ADvendio, these values can now be typed directly into a designated field in Campaign Items or added via predefined values in Ad Specs.

👩‍💻 How to Use 1st Party Data Targeting in Campaign Items

Step 1: Open a Media Campaign and Navigate to Campaign Items

1. Go to your Media Campaign.

2. Open the Campaign Builder to directly modify your Campaign Items

Step 2: Locate the Field "Custom Key Values"

This field is where you will enter your 1st Party Targeting data.

🧩 Format:
Use KEY = VALUE1, VALUE2 or KEY != VALUE1, VALUE2
Separate multiple key-value entries by line breaks.

interest = music, news location != california, nevada

Open

🗂 Using 1st Party Data Targeting in Ad Specs as Pre-Config

You can also predefine 1st Party Data Targeting strings in Ad Specs.

• This helps save time if you reuse the same targeting frequently.

• The Ad Spec Targeting, will automatically be included in your targeting, when submiting a Campaign Item from ADvendio

• The values defined in Ad Specs will be combined with Campaign Item entries using an AND logic.

To set 1st Party Audiences on an ad spec, locate the Key Value field and enter in the same format as described above.

Add the following field:

• API Name: ADvendio__KeyValues__c

• Label: Key Values

Open

🤖 Behavior and Rules

• Only IS_ANY_OF (=) and IS_NOT_ANY_OF (!=) comparisons are supported.

• All Key-Value entries will be sent as SITE_VARIABLE targeting type to Adswizz.

• Targeting is always combined with AND logic between Ad Spec and Campaign Item inputs.

🔧 Admin Setup

Step 1: Make the Field Visible in the Campaign Builder

To make the "Custom Key Values" field available to your users in the Campaign Builder, follow the instructions in the setup documentation below:

🔗 Setup of the Campaign Builder Structure – Tabs and Columns

Add the following field:

• API Name: ADvendio__CustomKeyValues__c

• Label: Custom Key Values

Step 2: Optional – Add to Page Layout

To ensure the field is also visible on Campaign Item records:

1. Go to Object Manager > Campaign Item in Salesforce Setup.

2. Add Custom Key Values field to the desired page layout(s).

OR

1. Go to Object Manager > Ad Spec in Salesforce Setup.

2. Add Key Values field to the desired page layout(s).

📝 Notes

• This feature does not currently support custom combinations with Audience Segments.

• Keys and values are not validated or stored in ADvendio; they are passed as-is to Adswizz.

• Ensure formatting matches Adswizz expectations to avoid rejections during booking.