Feature Flags

Take your Blueprint customization to the next level with feature flags. Feature flags offer greater flexibility and control over specific elements within a Blueprint, such as campaigns, ad groups, and ads. Enable feature flags with valid when statements.

For Example

Let's say you set up a Blueprint to run campaigns for multiple channels (e.g. Search, Display, etc.), but you don't want to launch on all channels at all times. A feature flag will allow you to select the campaigns you want to launch on the channels you want, when you want.

In This Article:

Creating Feature Flags

Creating Feature Flags via an ingestion sheet

Using Feature Flags in a Blueprint

Activating Feature Flags

Via an Ingestion Sheet

Creating Feature Flags

To create feature flags:

Go to Blueprints in the top menu in Backpack.
Select a Blueprint. Note: You should see the Tags pane in the right sidebar.
Click + Blueprint Tag/Folder.
Select Flags in the dropdown menu that appears.
Input a name for the feature flag collection and click the + icon. Note: In the screenshot, it's called Campaigns since we are creating flags to enable/disable different campaigns.
Your feature flag collection will appear with a ✔️/x next to it. To add specific flags to the collection, hover over the collection's name and click the pencil icon.
Input the flag's name in the New Flag Name field and click the + icon. In the screenshot, the flags reflect the names of the campaigns in the Blueprint.
(Optional) A feature flag called "Example" gets generated by default. You can delete the "Example" flag by clicking the trash can icon to the left of the flag.
Click Close Window to return back to the Blueprint tags list.
Click the ✔️/x icon next to your newly added feature flag set to expand open and view the list of flags.

Note: Feature flags are typically turned off at the Blueprint level since you don't want to have all your accounts containing the flagged element (campaign, ad group, etc.).

Creating Feature Flags via an ingestion sheet

To create a new feature flag set via an ingestion sheet:

Open up your ingestion sheet (see sample).
Add a new column and name the header flag:setname.flagname (e.g. flag:Adgroup Creation.Luxury Aparments)
In each row, enter True to turn the feature flag on and False to turn the feature flag off.

Using Feature Flags in a Blueprint

Navigate to the Valid When field for the campaign/ad group/ad you want to add the feature flag to.
In the Tags pane, hover over the feature flag you want to use and click on the 📋 icon. This will copy the feature flag to your clipboard.
Paste the feature flag into the Valid When field. Note: Feature flag syntax is [Feature Flag Collection Name.Flag Name]. For example, [Campaigns.Discovery Test].

Note: You don't need to add the function "EQUALS TRUE" to the feature flag. When a feature flag is added as a valid when statement, it's automatically set as "true."

Activating Feature Flags

You can activate feature flags on an account in a few of different ways:

From the Launch Queue

To activate feature flags from the Launch Queue:

Go to Launch in the top menu.
Under the Review & Launch tab, click the pill-shaped icon under the "Features" column for an account.
Toggle on the desired feature flags.
Click OK to confirm.

After an Account Has Launched

To turn on feature flags after an account has launched:

Go to Manage in the top menu.
Select an account from the list.
Click Account Settings in the top right—then the Blueprints tab and the Feature Flags tab.
Expand open a feature collection.
Toggle on the desired feature flags.
Click Save to finish.

Note: Turning on feature flags will republish the associated Blueprints. Check Launch Status to confirm.

Via an Ingestion Sheet

Open up your ingestion sheet (see sample).
Add a new column and name the header featureFlag:setname.flagname (e.g. featureFlag:Adgroup Creation.Luxury Aparments)
In each row, enter True to turn the feature flag on and False to turn the feature flag off.

Report abuse