Skip to main content

Documentation Index

Fetch the complete documentation index at: https://theoptimizer.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

The variation generation system is what makes the Facebook Campaign Launcher fundamentally different from Facebook Ads Manager. Instead of manually creating every campaign, ad set, and ad, you use one — or a combination — of three mechanisms to generate your full structure from a simple starting point.

Using Groups

Groups let you define multiple values for a targeting section, and the system generates a variation for each group automatically. In several sections across the campaign, ad set, and ad levels, you will see a Group Card — a row starting with one default group and a + button to add more. Each group you create represents a separate variation of the entity you are working on. Click on each group tab to customise its settings independently. For example, if you create two audience groups at the ad set level — one targeting the US and one targeting the UK — TheOptimizer produces two ad set variations, identical in every way except their audience targeting. Managing groups. Click the three-dot menu (⋯) on any group to:
  • Rename — give the group a meaningful name (e.g., “US Audience” or “Budget $50”). Group names can be referenced in dynamic naming templates.
  • Clone — duplicate this group’s settings into a new group.
  • Clone Bulk — duplicate the group multiple times at once.
  • Delete — remove the group.
Where groups are available:
LevelSectionGroup name in UIWhat varies between groups
CampaignBudgetBudget GroupDaily budget amount, bid strategy
Ad SetBudget & ScheduleBudget GroupPer-ad-set daily/lifetime budget, schedule
Ad SetAudience ControlsAudience GroupLocations (include/exclude), age, gender, languages, custom audiences
Ad SetPlacementsPlacement GroupAdvantage+ vs manual placements, platform/position selections
AdIdentityIdentity GroupFacebook Page, Instagram Account
AdAd CreativeCreative GroupMedia (images/videos), primary text, headlines, descriptions
How permutations are calculated. Groups at the same level multiply with each other. If you create three budget groups and three audience groups at the ad set level, the system generates 3 × 3 = 9 ad set variations. Add two placement groups and you get 3 × 3 × 2 = 18 ad set variations. The Variation Preview panel on the right updates in real time as you add groups. Always check this counter before proceeding.
Permutations can grow quickly. Three groups in three different sections produces 27 variations. Make sure the total in the Variation Preview is intentional before moving forward.

Using Campaign Restructuring

Campaign Restructuring lets you take the variations you have built and distribute them across separate campaigns and ad sets exactly the way your testing strategy requires. Unlike older versions of the launcher where restructuring was a late step, restructuring is now defined at the very beginning of the campaign creation flow, immediately after selecting an ad account and naming your campaign. This means you can plan your final structure upfront — before you even configure audiences or upload creatives — which prevents surprises at the end and makes the whole process faster. Restructuring is split into two independent sections: one at the campaign level and one at the ad set level. Both sections have a Preview button that shows the complete campaign tree — with naming templates applied — based on your current settings and any groups you have already defined.

Structure Your Campaigns

The Structure your campaigns section sits at the top of the Create Campaign step (Step 1). It controls how your total set of ad sets and ads gets distributed across campaigns.
Structure your campaigns — campaign-level restructuring UI
There are two options, each independently toggleable. You can enable one, the other, or both simultaneously. Option 1 — Generate campaigns based on Ad Set groups This option lets you specify which ad set groups each generate a separate campaign. For example, if you have defined Audience groups and Placement groups at the ad set level, you can tell the system: “Give each unique combination of audience and placement its own campaign.” Selecting a group here moves that dimension of variation from the ad set level up to the campaign level. The result: each campaign contains ad sets that share the same audience/placement combination, and different campaigns are used to isolate different targeting setups. Multiple groups can be combined. The number of campaigns created equals the number of unique combinations across all selected groups. For example:
  • 5 Audience groups × 3 Placement groups = 15 campaigns, each containing ad sets for one specific audience + placement pair
  • Any other groups you defined but did not include here (e.g., Budget groups) remain as ad set-level variation inside each campaign
This option did not exist in the previous version of the launcher. Previously, you could only separate campaigns by the number of ad sets — you had no way to say “I want a separate campaign for each audience I’m testing.”
Use group-based campaign separation when your testing strategy is audience-first or placement-first. It gives you clean, isolated campaign budgets per targeting dimension without having to manually create each campaign.
Option 2 — Generate campaigns based on the number of Ad Sets per campaign This is the same option that existed in the previous version, now surfaced earlier in the flow. Toggle it on and set a number — for example, 1. The system will create as many campaigns as needed to give each ad set its own campaign. Set it to 2 and each campaign gets two ad sets, and so on. Example: you have generated 20 ad set variations total. Setting this to “1 Ad Set per campaign” creates 20 campaigns, each with 1 ad set. Setting it to “2 Ad Sets per campaign” creates 10 campaigns, each with 2 ad sets. Combining both options If both options are enabled at the same time, their results are multiplied together. Example: you have 5 Audience groups and 3 Placement groups selected in Option 1, generating 15 base campaigns. You also have 20 total ad sets and have enabled Option 2 with “1 Ad Set per campaign”. The final campaign count becomes 15 × 20 = 300 campaigns. The Preview button at the bottom of this section shows the full resulting structure — including naming templates — so you can verify the outcome before you’ve finished building the campaign.

Structure Your Ad Sets

The Structure your ad sets section works at the ad level — controlling how your ads get distributed across ad sets.
Structure your ad sets — ad set-level restructuring UI
It has the same two-option layout as the campaign-level section, and also has a Preview button. Option 1 — Generate ad sets based on Ad groups This option lets you specify which ad-level groups each generate a separate ad set. For example:
  • Select Identity group → each Facebook Page / Instagram Account combination gets its own ad set
  • Select Creative group → each creative group (images, videos, copy variations) gets its own ad set
  • Select both → each combination of identity and creative gets its own ad set
This is particularly useful for:
  • Testing images vs. videos in separate ad sets — create one Creative group with images and one with videos, select it here, and each gets its own ad set
  • Running ads under different Pages in separate ad sets — identity isolation per ad set without manual duplication
  • Testing different copy groups on separate ad sets — group ads by copy variation and isolate each group
This option did not exist previously. In the old version, groups were only used at the ad level to generate ad variations — there was no way to say “I want a separate ad set for each creative group.” Now you can. Option 2 — Generate ad sets based on the number of Ads per ad set Toggle this on and set the number of ads per ad set. The system generates the necessary number of ad sets to accommodate all your ads at that count. Example: you have uploaded 30 images (30 ads). Setting this to “5 Ads per Ad Set” creates 6 ad sets, each containing 5 ads. Setting it to “1 Ad per Ad Set” creates 30 ad sets. How ad set restructuring affects campaign restructuring The total number of ad sets generated by the ad set-level restructuring feeds directly into the campaign-level restructuring calculation. If the ad set structure produces 30 ad sets and you have “1 Ad Set per campaign” enabled at the campaign level, you will end up with 30 campaigns — regardless of how many you started with. Always use the Preview button after configuring both sections to see the final campaign count and structure.

Restructuring Examples

Example 1 — Isolate each creative in its own campaign (full budget isolation) Goal: 20 image ads, one campaign per creative, each with its own budget. Setup:
  • Ad set level → Option 2 → 1 Ad per Ad Set → generates 20 ad sets
  • Campaign level → Option 2 → 1 Ad Set per campaign → generates 20 campaigns
Result: 20 campaigns, each with 1 ad set and 1 ad. Every creative has a completely isolated budget.
Example 2 — Test audiences in separate campaigns, creatives in separate ad sets Goal: 3 audiences each tested in their own campaign; within each campaign, each creative gets its own ad set. Setup:
  • Ad Set level → Audience groups (3 groups) → selected in Campaign level Option 1 → 3 campaigns
  • Creative group (5 creatives) → selected in Ad Set level Option 1 → 5 ad sets per campaign
Result: 3 campaigns × 5 ad sets = 15 ad sets total. Each campaign targets one audience; within each campaign, each creative has its own ad set.
Example 3 — Test pages in separate ad sets, audiences in separate campaigns Goal: Run ads under 2 different Facebook Pages; test 4 different audiences, each in a separate campaign. Setup:
  • Ad level → Identity group (2 groups, one per Page) → selected in Ad Set level Option 1 → 2 ad sets per campaign
  • Ad Set level → Audience group (4 groups) → selected in Campaign level Option 1 → 4 campaigns
Result: 4 campaigns × 2 ad sets = 8 ad sets total. Each campaign targets one audience; within each campaign, there is one ad set per Facebook Page identity.

Reviewing the Preview

Both the campaign-level and ad-set-level restructuring sections include a Preview button. Clicking it generates a complete, expandable campaign tree showing:
  • Every campaign that will be created, with its name (using your naming template)
  • Every ad set inside each campaign, with its name
  • Every ad inside each ad set
The preview updates dynamically as you add groups and change restructuring settings throughout the campaign creation process. Use it frequently — especially before moving to the Review Variations step — to catch misconfigurations early.

Reviewing Variations (Step 2)

Once you complete the Create Campaign step (Step 1), clicking Review Variations takes you to a full read-only summary of the structure you are about to launch.
Review Variations step — information cards and campaign tree
The Review Variations step is now purely a review screen. Restructuring is no longer done here — it was moved to Step 1 in the latest version of the launcher. What you see in Step 2: At the top, a row of summary cards shows:
  • Number of Campaigns
  • Number of Ad Sets
  • Total Daily Budget (for ad set-level budgets)
  • Number of Ad Set Variations
  • Number of Audiences
  • Number of Ads
  • Number of Headlines
  • Number of Descriptions
  • Number of Ad Variations
Below the summary cards is the full campaign tree — Campaign → Ad Set → Ad — with each item showing its final name (naming templates applied). Every item in the tree has a toggle switch you can use to enable or disable that specific variation. Disabling a campaign disables everything inside it; disabling an individual ad set or ad removes just that item from the launch. This is where you make any final adjustments — for example, removing a specific ad from one ad set, or disabling a campaign variation you no longer want — without going back and re-configuring the whole structure.

Using Duplication

The third way to generate variations is by manually duplicating items in the left panel tree. Click the three-dot menu (⋯) on any campaign, ad set, or ad and select Duplicate (to copy with all settings) or Create New (to start a fresh one). Duplication creates an exact copy of the selected item and everything inside it. You can then click on the copy and modify its settings — different creatives, different destination URLs, different structure. This is the most manual approach, but it gives you full control over exactly what goes inside each campaign, ad set, or ad.

Groups vs. Restructuring vs. Duplication — When to Use Which

MethodBest forControl level
GroupsTesting combinations of variables (budgets × audiences × placements) — you want all permutations generated automaticallyYou control the variables; the system generates all combinations
RestructuringDeciding how ad sets and ads are distributed across campaigns — audience isolation, creative isolation, budget isolationYou control the distribution rule; the system does the splitting
DuplicationWhen you need specific creatives in specific ad sets, or different destination URLs per ad — full manual controlYou control everything; no automation
In practice, most workflows use a combination: Groups define what varies, Restructuring decides how variations are distributed across campaigns and ad sets, and Duplication handles the parts that need manual precision.

Next Steps