4.20.1.2 Key Value and Audience Targeting in Campaign Builder

Ad Price Connection Id Assignments

The Targeting component in the Campaign Builder supports Connection Id Ad Price Assignments. This feature allows you to filter out targeting records based on the Connection Id assigned to them. When you enter a Category for a Connection Id in the UI, only the records connected to that Connection Id will be displayed.

For example, if you assign the Key "Age" to an Ad Price, you will no longer be able to see the other Key Values when you open the Key Value Targeting UI for the same Ad Price.

To create and set up Ad Price Connection ID Assignments, refer to this page https://advendio.atlassian.net/wiki/spaces/SO/pages/711557176.

Google Ad Manager CMS Key Values

Google Ad Manager is undergoing a migration process to transfer specific Key Values to a new technical background called CMS Key Values. These new CMS Key Values can be selected in the Key Value targeting feature. When working with GAM items in the Key Value UI, you will be able to select CMS Keys and Values, which will allow for seamless integration of new CMS Key Values into your existing grouping logic.

Targeting for Key Value / Audience Segments

Campaign Builder allows Targeting by Key Value and Audience Segments for Campaign Items

Option 1 - Key Value Adding from Group Menu:

Open

• Key Value and Audience Segments are located in the Campaign Builder Targeting section

• On the right-hand side of the Targeting section, you will see under Targeting

• By pressing menu you will access various targeting options for Campaign Item

  Open

  

• Select Key Values option at the bottom of the menu

• It will open a new section called Groups

• Press Add Key Value button and select the information needed in the fields: Name of Key Value and Value

• Press Add Group if you need to enter more Groups and additional key-value information

• Press Save and Back and you will see summarised key values under Targeting

Alternatively, you can select key values from Group menu, when pressing menu you will see the option Add Key Value, it will bring the same menu to add key-value data in Targeting.

Option 2 - Key Value Adding from Tree Menu:

• In Key Values targeting in the Groups menu select

• Choose to Add from Tree option (Alternatively, there is a button with the same name Add Key Value displayed at the bottom of the Group menu page)

• You might see options: Keys, Presets, Search

• In option Keys, you will see the Tree menu displayed with Key drop-down menu.

• Press > arrow next to the Key and open the Tree drop-down menu with associated Values located underneath

• To open up Values information select > arrow. For example, by selecting Key for Age in the Tree menu you will find Values for varied age groups (18-29, 30-39, 40-49, 50+).

• Tick the box with the Key option needed (Important to activate your Key selection)

• Tick the box with the Value option needed

• Press Add, then Save and Back

• Selected key values information will be summarised under Targeting opposite each Campaign Item

Free Form Key Value in Targeting

Freeform Key Values are enabled in Targeting and can be selected from AdServer and this new added value will be reflected in User Interface:

• To add a key value for Postal Codes, select Postal Codes in the Name of Key Value

• Enter the Postal Code number into the field Value. You can submit this value regardless if this is an existing Key Value or a new value.

• The data you have added will be reflected in the User Interface.

Audience Segment Presets

You can use Audience Segment Presets festure for GAM, Xandr, Freewheel, and Adswizz. It simplifies the process of selecting values in the LWC Key Values Targeting UI. You can link multiple Audience Segments and set different values using logical operators. The Audience Segment presets are considered during both availability checks and submit processes. It works similarly to KeyValue presets, with groups and operators.

Pasting Comma-Separated Values for Key Value and Audience Segment Targeting

This feature lets users paste multiple comma-separated key values or audience segment values into the system for automatic selection. Valid values are selected automatically, while invalid values remain in the input field for review.

Steps to Use:

1. In Campaign Builder open the targeting modal and paste values.

2. The system selects valid values.

3. Invalid values stay in the field and can be edited and corrected. A toast is displayed for invalid values: "There were invalid values included in your selection. Please review the selection."

Custom Grouping

You can now use a custom grouping tab for your Key Values and Audience Segment tree selections.

The custom grouping will show you Values sorted into custom categories.

To open the tabs make sure to select “Add from tree“ and then you should see the tabs “Key Values Custom Grouping“ and/or “Audience Segments Custom Grouping”.

Logical operators

Operators in Google Account Manager

For GAM available logical operators are:

AND logical operator is available inside of one group of values

OR logical operator is available between the values of two or more groups

Operators in Xandr/ Freewheel:

For Xandr and Freewheel available logical operators are:

AND/OR operators are used inside of one group of values, you can switch between these logical operators inside one group

AND/OR operators are used between values of two groups, you can switch between these logical operators between several groups' values

For Xandr items you can select additional operators between Keys and Values such as "less than," "less than or equal," "greater than," and "greater than or equal."

Setup

If you would like to define define different operators for your Xandr or FreeWheel targeting selection when opening it the first time then you can adjust or create the following feature setting:

• Feature Setting Name: AdServerTargetingDefaultConnectors

• Feature Name: MediaConfiguration

• Value:

  [ { "adserver":"APPNEXUS", "connector":"and" }, { "adserver":"FREEWHEEL", "connector":"or" } ]

• Description:

  • also applies to the Campaign Builder targeting

  • the values can be in either uppercase or lowercase

  • the connector defined here is the one that will be shown between groups. The one shown within groups will be inverted

Custom grouping

To set up custom grouping tabs for your Key Values and Audience Segment selection check out the new field on the Connection Ids called “Group“. This field is a multi-picklist field. You can go to the Setup of your org to add your own group names to this field.

Select for all relevant Values and Audience Segment Values Connection Ids a group if you like. Once the first Connection Id has a group selected, the tabs will show up in your tree selections for the relevant connection.

If you like to change the name of the tab please check out the following custom labels for translation:

• Name: AudienceSegmentCustomGrouping (category: Key Value Targeting LWC)

• Name: KeyValuesCustomGrouping (category: Key Value Targeting LWC)