Skip to main content
All CollectionsBlueprintsConfiguration
Getting more control over Blueprint launches with feature flags
Getting more control over Blueprint launches with feature flags

Use feature flags for precise control and customization of Blueprint elements.

Updated over a week ago

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.


Creating feature flags in Blueprints

  1. Go to Blueprints in the top menu.

  2. Select a Blueprint. Note: You should see the Tags pane in the right sidebar.

  3. Click + Blueprint Tag/Folder.

  4. Select Flags in the dropdown (default selection is Text).

  5. Input a name for the feature flag group and click the + icon. Note: In the screenshot, it's called Campaigns since we are creating flags to enable/disable different campaigns.

  6. Your feature flag group will appear with a toggle icon next to it. To add specific flags to the group, hover over the group's name and click the pencil icon.

  7. 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.

  8. (Optional) A feature flag called "Example" gets generated by default. You can delete the "Example" flag by clicking the pencil icon to the left of the flag group name and then the trash can icon to the left of the flag. Click Close Window to return back to the Blueprint tags list.

  9. Click the toggle icon next to a feature flag group to view the list of flags.

Note: Feature flags are typically turned off at the Blueprint level to avoid having all accounts contain the flagged element (campaign, ad group, etc.).


Creating feature flags in an ingestion sheet

  1. Open an ingestion sheet (see sample).

  2. Add a new column and name the header using this naming structure: flag:setname.flagname (e.g., flag:Adgroup Creation.Luxury Apartments).

  3. 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

  1. Navigate to the Valid When field for a campaign, ad group, or ad.

  2. In the tags pane, hover over a feature flag and click on the clipboard icon to copy the flag to your clipboard.

  3. Paste the feature flag into the Valid When field. Note: Feature flag syntax is [Feature Flag Group 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

From the Launch Queue

  1. Go to Launch in the top menu.

  2. Under the Review & Launch tab, click the toggle icon under the Features column for an account.

  3. Toggle on the desired feature flags.

  4. Click OK.

After an account has launched

  1. Go to Manage in the top menu.

  2. Click on an account in the list.

  3. Click Account Settings in the top-right—then the Blueprints tab and the Feature Flags tab.

  4. Expand open a feature collection.

  5. Toggle on the desired feature flags.

  6. Click Save.

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

Via an ingestion sheet

  1. Open an ingestion sheet (see sample).

  2. Add a new column and name the header featureFlag:setname.flagname (e.g., featureFlag:Adgroup Creation.Luxury Apartments)

  3. In each row, enter True to turn the feature flag on and False to turn the feature flag off.

Did this answer your question?