Manage Ad Accounts & Profiles

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.

Once your Google Ads integration is connected, you can manage the individual ad accounts and authentication profiles associated with it from Integrations → Google Ads.

---

​

Ad Accounts

Click on the Google Ads integration to see the full list of ad accounts pulled from your connected Google account or Manager Account (MCC).

​

Enable and Disable Accounts

Each ad account has an ON/OFF toggle. Disabling an account stops TheOptimizer from syncing data and running automation rules for that account. All historical data is retained — you can re-enable it at any time and data will resume syncing. You can also disable multiple accounts at once using the bulk actions menu.

---

​

Archive Ad Accounts

Archiving is a stronger form of removal than disabling. When an ad account is archived it is completely hidden from the system — it no longer appears in dropdown selectors, filters, or the Campaign Creator, and TheOptimizer stops all processing for it: no data sync, no automation rules, no campaign or resource visibility. Use archiving when you want to permanently retire an ad account from your workflow without losing the ability to restore it later if needed. Archive a single account Hover over any ad account row in the list. Below the account name, two inline actions appear: Edit and Archive. Click Archive to archive that account immediately. Archive multiple accounts at once Select the checkboxes next to two or more ad accounts. A bulk action bar appears at the bottom of the screen showing options including Manage Tags, Manage Linked Trackers, Change Profile, and Archive. Click Archive to archive all selected accounts in one operation. View and unarchive archived accounts Archived accounts are hidden from the default view. To find them:

1. Click Filters at the top of the ad accounts list.
2. Select Archived from the filter menu.
3. Choose Archived (to see only archived accounts) or All (to see both active and archived).
4. Click Apply Filters.

Once the archived accounts are visible, select one or more using their checkboxes, then click Unarchive in the bottom action bar. The account is immediately restored — it reappears in all selectors and filters, and TheOptimizer resumes data syncing and rule execution for it.

---

​

Assign Ad Accounts to a Profile

Each ad account uses one profile — the Google login TheOptimizer uses to access it. Ad account-to-profile assignments are managed from the Profiles panel: click Manage Ad Accounts on any profile card to open an assignment dialog where you can add or remove accounts from that profile. The dialog shows two sections: accounts that the selected profile has access to but which are currently assigned to a different profile (available to reassign), and accounts already using this profile. Select the accounts you want to add and click Save. You can also reassign a single ad account directly from the ad accounts table — hover the row and click Edit to change its assigned profile without opening the profiles panel.

---

​

Add Tags

Ad accounts can be tagged with any labels you define — by client, brand, vertical, team, or any other convention. Tags appear as filters throughout TheOptimizer, making it easy to work with specific subsets of accounts. Some tags (timezone, currency) are applied automatically by TheOptimizer when the account is first synced. To add a tag: click on the ad account → Tags → Add Tag.

---

​

Customise Tracker Connections Per Account

By default, tracker connections are configured at the integration level and apply to all ad accounts. But you can override this at the individual account level:

• Link a different tracker — use a different tracking platform for this specific account.
• Pause the tracker connection — stop pulling tracker data for this account without affecting others.
• Change the tracking template — use a different template (macro mapping) for this account.

Access these settings from Linked Trackers on the individual ad account page.

---

​

Profiles

Profiles are the Google logins (OAuth tokens) that TheOptimizer uses to access your Google Ads accounts. After connecting Google Ads via OAuth, each authenticated login becomes a profile.

​

Add New Profiles

Go to Integrations → Google Ads → Profiles and click Add Profile. Complete the OAuth flow with the additional Google login. Reasons to add multiple profiles:

• Team access — each team member manages their own set of accounts under their own login.
• Backup access — if a primary profile is restricted or token becomes invalid, a backup profile can take over the affected accounts immediately.
• Multiple Manager Accounts (MCCs) — different MCCs often have different admin logins.

​

Sync New Ad Accounts

When you add a new ad account to a Google Ads Manager Account you’ve already connected, it won’t appear automatically. To pull in the new account:

1. Go to Integrations → Google Ads → Profiles.
2. Find the profile that has access to the new account.
3. Click Sync (or Refresh Accounts).

This triggers a re-sync for that profile and pulls in any new accounts without requiring a full re-authorisation.

​

Re-authenticate a Profile

Google OAuth tokens expire or become invalid when you:

• Change your Google account password
• The ad network detects suspicious activity on your account
• Security settings change (e.g., two-factor authentication changes)
• The token is manually revoked from Google’s security settings

When a token expires, TheOptimizer can no longer sync data or run automation for the accounts under that profile. To re-authenticate:

1. Go to Integrations → Google Ads → Profiles.
2. Find the profile showing an error or “Re-authentication required” warning.
3. Click Re-authenticate and complete the OAuth flow again.

Re-authenticating refreshes the token without losing any account history, automation settings, or tags.