Skip to main content

How to Use Naming Conventions in WorkMagic

Updated over 3 weeks ago

Naming conventions in WorkMagic let you turn messy ad names into clean, reusable properties you can use to group, filter, and compare performance across platforms.

What you can do with the Naming Convention:

  • Define reusable properties such as {Country}, {Product}, {Launch date}, {Discount}.

  • Parse those properties from your existing ad, ad set/ad group, or campaign names.

  • Use the same property names across platforms (Meta, Google, TikTok, etc.) so dashboards stay consistent.

Creating a new naming convention

  1. Go to Settings > Naming convention.

  2. On the Naming convention tab. You will see:

    1. If no ad platforms are connected A single empty state asks you to connect ad platforms first.

    2. If ad platforms are connected A card for each connected platform (for example, Meta Ads, Google Ads, TikTok Ads), each with its own naming convention area.

Note: properties with the same name across platforms will be treated as a single property group in dashboards.

3. Click Add naming convention.

A modal opens with the setup steps.

Step 1 - Set the property name

  • Enter a Property name (for example: Launch date, Country, Product, Discount).

  • The property name must be unique within the same ad platform.

    • You can reuse the same property name on different platforms (for example {Country} on Meta and {Country} on Google).

    • When the same property name exists on multiple platforms, WorkMagic treats them as one property group on dashboards.

If you see the message “Each property name must be unique within the same ad platform”, change the property name or edit the existing one instead of creating a duplicate.

Step 2 - Select ad platform(s)

  • In Ad platform, choose one or more connected platforms from the dropdown (Meta Ads, Google Ads, TikTok Ads, Snapchat Ads, Pinterest Ads, AppLovin, Microsoft Ads).

  • Multi-select is supported, so you can define the same property for several platforms at once.

Step 3 - Select the naming level

  • In Select a level, choose one of:

    • Campaign

    • Ad set / Ad group

    • Ad

WorkMagic will parse names at this level only.

Step 4 - Choose the naming method

In Select a method, pick one of:

  • Position-based naming Values are extracted based on their fixed position in a separator-based string. Example ad name: GlowBoost_Video_MiraJane_Prospecting_ShopNow_2025-06-01.

  • Key-value naming Values are extracted from key:value pairs. Example ad name: p:GlowBoost_f:Video_i:MiraJane_c:Prospecting_cta:ShopNow_d:2025-06-01.

WorkMagic automatically loads an Example of {campaign/ad/ad set} name based on the selected platform and level, so you can see a real name while you configure the rule.

Step 5 - Configure the naming rules

After you choose the method, you define how WorkMagic should parse values.

5.1 Supported naming methods

WorkMagic supports the two most common ad naming practices.

1. Position-based naming

Your ad name is split by a separator, and each position has a fixed meaning.

Examples:

  • LEC_Viviana_New_ThisSideIsWith_Video_None_Testimonial

  • RedFlashSalePDP | Signature | Static | OnModel | OnSale | Bone | Female

You can say:

  • Position 1 = Funnel stage

  • Position 2 = Product

  • Position 3 = Format

  • …and so on.

2. Key-value naming

Your ad name uses key:value pairs. Each key is an identifier for a specific property.

Example:

  • p:GlowBoost_f:Video_i:MiraJane_c:Prospecting_cta:ShopNow_d:2025-06-01

You can say:

  • Key p = Product

  • Key f = Format

  • Key i = Influencers

  • Key c = Campaign type

  • Key cta = Call to Action

  • Key d = Launch date

  • And map each of these keys to a property in WorkMagic.

5.2 Configuring position-based naming

1. Choose the separator

In Property separator, choose how your ad names are split:

  • Hyphen -

  • Underscore _

  • Pipe |

  • Greater than >

  • Single space

  • Or Add other separator to create a custom symbol

Custom separators:

  • Must be symbol(s) (for example / or :). Text is not allowed.

  • Are saved to your separator list and can be deleted later.

  • You can add multiple custom separators if needed.

WorkMagic validates custom separators and only accepts symbols.

2. Define positions as properties

Once platform, level, method, and separator are set:

  • Position 1 is created automatically.

  • Enter the Property name for Position 1 (for example Launch date).

  • When all inputs are set, WorkMagic starts parsing and shows Examples of value detected from up to 10 real names.

Click Add property to add more positions:

  • Each new property copies the previous settings and increments the Position sequence automatically.

  • You can change the position number manually, including skipping positions if your structure has gaps.

  • Parsing refreshes when you change the position.

3. How “Examples of value detected” works

  • Parsing starts automatically when:

    • Ad platform is selected

    • Level is selected

    • Method is position-based

    • Separator is chosen

    • A position sequence is set

  • WorkMagic:

    • Shows a loading state while it analyzes ad names.

    • Parses up to 10 sample names and displays up to 10 example values for that property.

  • If no matching values are found, creation is still allowed. The property will be saved, but may show zero matches until your ad names follow the pattern.

4. Save and run parsing

  • Click Confirm to save the naming convention.

  • In the platform list, the property will show:

    • Parsing in progress

      • Parsing usually takes 1h to complete.

      • WorkMagic continues to scan names in the background.

      • The row shows a live count of detected values and the enumeration count.

    • Analysis completed

      • The row shows the total number of unique values.

      • You can open the property to view all values.

  • Update analysis runs regularly in the background to pick up new or changed names and refresh the detected values.

5.3 Configuring key-value naming

The setup is similar but focused on key:value pairs.

1. Shared fields

When you choose Key-value naming:

  • Property name, Ad platform, Level, and Property separator work the same as in position-based naming.

Choose the separator that separates key:value pairs (for example _ or |).

2. Define the identifier (key)

For each property:

  • Enter the Identifier (the key in your naming convention), for example:

    • p for Product

    • c for Country

    • d for Launch date

  • When ad platform, level, method, separator, and identifier are all set, WorkMagic starts parsing automatically.

WorkMagic then:

  • Looks for this identifier in your names (for example p:).

  • Extracts the value after the identifier.

  • Shows Examples of value detected using up to 10 sample names, with a loading state while analysis runs.

  • Allows creation even when no matches are found.

3. Add more key-value properties

  • Click Add property to define another key:

    • Ad platform and level are pre-filled.

    • Method and separator stay the same.

    • The Identifier field is blank so you can enter a new key.

4. Save and run parsing

  • Click Confirm to save.

  • Parsing status and value counts behave the same as for position-based naming:

    • Parsing in progress during analysis.

    • Analysis completed with the total number of unique values and a way to view them.

    • Periodic Update analysis to refresh values.

Viewing and managing naming conventions

After saving, each ad platform card shows a list of its properties.

What you see in the list

For each property:

  • Property name For example {Launch date}, {Ad type}, {Country}, {Product}, {Discount}, {Format}, {Influencer}.

  • Enumeration values and counts

    • If parsing is still running, you see a parsing status with a live count.

    • When parsing is finished, you see the number of unique values and can open the property to view them.

Filters and level switcher

At the top of the platform card:

  • Method filter Appears if the platform uses more than one method. Defaults to All.

  • Separator filter Appears if the platform uses multiple separators. Defaults to All.

  • Campaign / Ad set / Ad switcher Appears if the platform has naming conventions defined at more than one level. The highest level (usually Campaign) is shown by default.

Adding a new property from the list

  • Click Add property inside a platform card.

  • The modal opens with Ad platform and Level already filled.

  • You only need to set:

    • Property name

    • Method (position-based or key-value)

    • Separator

    • Position or identifier

  • Confirm to save and start parsing.

Editing a property

  • Click the Edit icon next to a property.

You can:

  • Change the Property name.

  • Change Separator, Position sequence, or Identifier.

Review examples and save changes.

You cannot change:

  • Ad platform

  • Level

  • Method (position-based vs key-value)

If those need to change, delete the property and create a new one.

Deleting a property

You can delete a property in two places:

  • From the list view (trash icon).

  • From the Edit property modal (Delete button).

In both cases:

  1. Click Delete.

  2. Confirm in the second confirmation pop-up.

Once deleted, the property and its values will no longer appear in dashboards or filters.

How naming conventions are used in dashboards

After properties are created and parsing has completed:

  • In the Ads dashboard:

    • Your custom properties are available as Group by fields.

    • You can filter using these properties (for example, show only {Country} = US or {Launch date} = 2025-06-01).

  • In Creative Insights:

    • Properties can be used as filters to break down performance by product, format, country, influencer, and more.

If the same property name exists on multiple platforms (for example {Country} on Meta, Google, and TikTok), they are treated as a single unified property in dashboards, making cross-channel analysis much simpler.

Troubleshooting

1. No example values are showing for my property

  • Check that:

    • Ad platform, level, method, and separator are set.

    • For position-based naming, the Position sequence is correct.

    • For key-value naming, the Identifier matches your actual naming (for example p if your names use p:).

  • If your live ad names do not yet follow the pattern, WorkMagic will return zero matches. The property can still be created and will start matching once your naming is updated.

2. I cannot reuse a property name on the same platform

  • Each property name must be unique per ad platform.

  • If you need a similar property, either:

    • Rename the existing property, or

    • Use a slightly different name (for example Launch date (campaign) vs Launch date (ad)).

Did this answer your question?