Valid when statements empower you to show the right ad elements at the right time. They can be used for campaigns, ad groups, and ads. They work like "if statements": If it's true, the content is enabled; if it's false, it stays disabled. If there's no statement, the campaign, ad group, or ad is automatically enabled. Valid when statements can be used in various ways, but most often with feature flags.
Follow along with the video or use the instructions below.
Creating valid when statements
For campaigns and ad groups
Go to Blueprints in the top menu.
Choose a Blueprint, then a campaign or ad group.
Click Valid When to expose the field.
For creatives
Go to Blueprints in the top menu.
Choose a Blueprint, then a campaign, ad group, and ad (creative).
In the Creatives section, locate the Valid When field.
Writing valid when statements
Use the guidance below to create valid when statements for campaigns, ad groups, and creatives. When finished, be sure to save within the Blueprint.
Valid when statements are made up of elements (e.g., feature flags and tags) and functions that set conditions for enabling the campaign, ad group, or ad.
Feature flags
When using feature flags in valid when statements, the syntax is [Feature Flag Group Name.Flag Name].
Examples:
[Campaigns.Discovery Test]
[Campaigns.Display Test]
Valid when functions
Use functions in valid when statements to indicate how the platform should interpret the included tags and feature flags:
AND
OR
EQUALS or =
ENDS WITH
CONTAINS
DOES NOT CONTAIN
DOES NOT EQUAL or !=
GREATER THAN or >
LESS THAN or < (spaces on both sides required)
GREATER THAN OR EQUAL or >=
LESS THAN OR EQUAL or <=
Note: Spaces are required before and after certain signs: =, !=, >, <, >=, <=. For example, [Campaigns.Discovery Test] AND [Campaigns.Display Test]
Examples of valid when statements
AND
Use AND to include multiple parameters in the valid when statement.
Example: [Campaigns.Discovery Test] AND [Campaigns.Display Test]
This valid when statement enables campaigns if both feature flags are toggled on.
OR
Use OR to include both a data source and a feature flag.
Example: [Campaign Channels] CONTAINS Search OR [Campaign Channels.Search]
This valid when statement enables campaigns if either the data source tag [Campaign Channels] includes Search or if the [Campaign Channels.Search] feature flag is toggled on.
CONTAINS
Use CONTAINS with tags to filter for defined variables.
Example: [OEM Campaign] CONTAINS [inventory.make]
This valid when statement enables campaigns if they contain the specified make(s) in the [inventory.make] tag.
Note: You can see when a valid when statement is in effect for a campaign by hovering over the robot icon in the Blueprint column in Manage.
