Ad accounts

Open Ad accounts under Manage in the sidebar. One table shows every login you connected, with its platform and its ad accounts listed under it (status, guardrails and last sync). Add ad account at the top right lists the platforms you can connect.

What you can do on each platform

Connecting

When you connect a platform, you sign in to it and approve Roasby's access (for ChatGPT Ads, you paste an API key). Roasby keeps that access encrypted, never shows it to anyone (not on the page, not to your AI assistant) and uses it only to read your accounts and make the changes you ask for. Owners and admins can connect platforms.

Connect Google Ads

1. On Ad accounts, select Add ad account, then Connect next to Google Ads.
2. Pick your Google account and allow Roasby to manage your Google Ads campaigns. Leave that box ticked: without it, Roasby cannot read or change your accounts.
3. Pick the ad accounts to connect. You see every account your Google login reaches, including client accounts under a manager account (MCC), shown "via" the manager's name. Manager accounts themselves (they have no campaigns) and cancelled or suspended accounts are not listed.
4. Select Connect selected accounts. The page shows how many places your workspace has left. The first sync starts right away.

If the picker says some accounts may be missing (a login with very many accounts), connect the ones shown, then connect the same login again for the rest. If Google refuses to list your accounts, the picker shows Google's reason.

Accounts you leave out are not touched. To add them later, connect the same login again and tick them.

Connect Microsoft Ads

1. On Ad accounts, select Add ad account, then Connect next to Microsoft Ads.
2. Sign in with a personal Microsoft account or a work or school account, and allow Roasby to manage your Microsoft Advertising accounts.
3. Pick the ad accounts to connect. You see every active account your login can use, including accounts an agency's manager account manages for a client, shown "via" the manager account. Accounts that are not active (draft, pending, suspended or closed) and Smart campaigns accounts are not listed.
4. Select Connect selected accounts. The first sync starts right away; for a large account it can take a few minutes.

If Roasby says your login has no active Microsoft Advertising account, sign in once at ads.microsoft.com with the same login (or use the login that manages your ads), then connect again.

Connect ChatGPT Ads

Each ChatGPT Ads account has its own API key, which connects that one account.

1. In ChatGPT Ads Manager, open Settings, create an API key for the ad account and copy it.
2. On Ad accounts in Roasby, select Add ad account, then Connect next to ChatGPT Ads, paste the key and select Connect. Roasby checks the key and connects its ad account; the first sync starts right away.
3. To connect another ChatGPT Ads account, create a key in that account and connect it the same way.

Roasby never shows the key again, to anyone. ChatGPT Ads reports conversion value only when purchase tracking is set up in the ad account. Until its first attributed sale, its value and ROAS show as n/a and its spend is left out of the combined ROAS.

Connecting again

Connecting a login that is still connected, for example to add accounts, keeps the accounts you leave ticked, with their history. An account you untick is removed and its data in Roasby is permanently deleted, as when you disconnect it. Nothing changes on the ad platform. Accounts the picker doesn't list stay connected.

If an ad account is already connected through another login in the workspace, the picker says so; picking it moves it to the login you are connecting.

Reconnect needed

A connection shows Reconnect needed when Roasby's access ends, for example when:

• you remove Roasby in your Google or Microsoft account settings;
• you change your password;
• you delete the ChatGPT Ads API key;
• the person who connected the login leaves the workspace, is removed from it or deletes their account. This happens at once, and the confirmation lists the ad accounts affected.

Its ad accounts stop syncing and become read-only until you fix it, but still count toward your workspace's limit. Select Reconnect and sign in again (for ChatGPT Ads, paste a new key of the same account). An owner or admin can reconnect with their own login.

Syncing

Roasby keeps your campaigns, ad groups, ads, keywords, daily performance and search terms up to date, so the dashboard, reports and your AI assistant answer quickly.

• When you connect, Roasby brings in your accounts and at least the last 30 days of performance, or more depending on your workspace.
• After that, each ad account syncs on a schedule: once a day or more often, depending on your workspace. On paid plans, Microsoft Ads and ChatGPT Ads accounts sync every hour (Google Ads accounts every 6 to 12 hours, because Roasby shares Google's daily request limit with every customer). Each sync also refreshes the last few days, because platforms keep adding late conversions.
• On Google Ads, a scheduled sync asks Google which campaigns, budgets, settings, ad groups and assets changed since the last sync and reads only those again (ads, keywords and numbers every time). The whole account is read at least once a day.
• Changes you make in Google Ads or Google Ads Editor show after the next sync. One made in the last few minutes before a sync shows with the one after.
• Microsoft Ads and ChatGPT Ads are read whole on every sync.
• Each ad account shows when it was last synced.
• Sync now on an ad account syncs it right away and reads the whole account, its conversion goals included. Any member can use it: on Microsoft Ads and ChatGPT Ads every 5 minutes, on Google Ads as often as your workspace allows (from once a day to every 15 minutes); the button shows when it is available again. While a sync of the account is already on its way, Sync now says so instead.
• Changes made through Roasby (by you or your AI assistant) show without Sync now. A paused item, a new budget or a new bid shows as soon as the change applies. An accepted edit (ad text, a keyword, settings, bidding or goals) shows the same way. After a new campaign, ad group, keyword, ad or asset, Roasby syncs that ad account on its own about a minute and a half later, so everything the platform made shows, and reads its conversion goals again so the campaign can get campaign goals, a target CPA or a target ROAS (at most once every 5 minutes and 24 times a day per account). After negative keywords, it reads the account's negative keywords again. This doesn't use your Sync now allowance. It is skipped while Roasby's shared Google Ads capacity is busy; the scheduled sync then brings the campaign in.
• In workspaces that sync only while they are used, a workspace that nobody opens (and where no AI assistant uses Roasby) for 14 days pauses its syncs. They start again when you come back.

Syncing never changes anything in your ad accounts. Items removed on the platform stay in Roasby with their history.

Conversions

Ask your AI assistant how an ad account tracks conversions: what bidding aims for and the problems Roasby found. See Conversions.

Disconnecting

Disconnect on a connection:

• removes Roasby's access right away and asks Google to revoke it too (unless another of your workspaces still uses the same Google login);
• stops syncing its ad accounts and removes them from Roasby straight after you confirm;
• permanently deletes their campaigns, performance history, search terms, recommendations, alerts and change log. Changes already made can no longer be reverted from Roasby.

Weekly reports already sent keep their totals. A login with an account that support set read-only can't be disconnected until support lifts it.

Microsoft and ChatGPT Ads don't let apps revoke their own access. To end it there too:

• Microsoft Ads: remove Roasby at account.microsoft.com (Privacy → Apps and services) for a personal account, or ask your organization's admin for a work account.
• ChatGPT Ads: delete the key in ChatGPT Ads Manager → Settings.

Nothing changes in your ad accounts themselves. Connecting the same login later starts fresh: Roasby syncs the accounts again, as far back as your workspace's history allows. Deleting a workspace disconnects its connections the same way, and so does deleting your Roasby account for your personal workspace and for workspaces deleted with it. Logins you connected in other workspaces need reconnecting by someone else, and their data stays.

Limits on ad accounts and members

Each workspace has a set number of active ad accounts and members. When you reach a limit, connecting another ad account or inviting another person is refused with a short message; nothing is replaced or removed.

If a workspace has more ad accounts than it allows (for example after its limit changes), nothing is disconnected or deleted. The oldest ones stay active and the others become read-only: over the limit: they keep their data, stop syncing and cannot be changed, though you can still revert earlier changes. Owners and admins choose which accounts stay active with Make active, picking an active account to swap with.

Some workspaces have a monthly allowance of ad changes (for example 20 per calendar month). Reverts and changes the platform refused don't count. The owner gets an email at 80% and at 100%. Reports, previews and reverts always keep working.

Read-only set by support

Roasby support can make an ad account read-only, for example during a payment dispute or at your request. It shows Read-only: set by support: it keeps syncing and its reports keep working, but every change, reverts included, is refused until support allows changes again. Write to [email protected] to find out more.

Guardrails and the change log

Each ad account shows its guardrails: the max daily budget per campaign, the max bid, the max change per step for budgets and bids, and, optionally, a max target CPA and a min target ROAS for bidding targets. Owners and admins edit them with Guardrails. Every budget and bid change, by a person or an AI assistant, must stay within the guardrails. See the safety model.

Right after you connect

Roasby opens the money caps of each account new to the workspace in turn (accounts you reconnect keep theirs): its max daily budget and max bid, in the account's currency.

• The max change per step for budgets and bids is filled in from your workspace's safety defaults.
• Save them, or choose Set later to move on to the next account.
• A new account has no max daily budget until you set one, and your AI assistant cannot create campaigns in it until then: choose Set it to create campaigns on the account, or use the link your assistant gives you.

More on each account

• If a sync fails, the account shows why under Last synced.
• Campaigns on an account opens its campaigns.
• Change log opens the changes made to it (see Change log).

Who can do what

Ask your AI assistant

Your assistant works with ad accounts through these tools:

• list_ad_accounts: the workspace's ad accounts with platform, name, account ID, currency, time zone, status (including needs_reconnect and locked_by_support), last sync and guardrails.
• list_conversion_actions (with primary_only or include_removed): how each account tracks conversions (see Conversions).
• list_ad_changes: the change log.
• run_ad_account_sync: syncs an account.
• preview_activate_ad_account and activate_ad_account: for owners and admins, swaps which accounts are active, after you confirm.

Try "Which ad accounts are in my Roasby workspace?", "Is conversion tracking working in my Google Ads account?" or "Sync my Microsoft Ads account now."

Connecting, disconnecting and setting guardrails happen only in Roasby, never through your assistant. Never paste an API key into a chat.

Limitations

• Connecting, disconnecting and setting guardrails happen only in Roasby on the web, never through your AI assistant.
• Roasby works from a synced copy of each ad account: numbers are as fresh as its last sync. Roasby's own changes show without it (a new campaign through a sync a few minutes later); for fresh numbers, or changes made in the ad platform itself, use Sync now.
• Disconnecting permanently deletes the account's data in Roasby, and changes made before can no longer be reverted from Roasby.
• Microsoft Ads and ChatGPT Ads don't let Roasby end its own access: remove it there as described under Disconnecting.
• Conversion tracking is read only, every few hours (and with Sync now): Roasby never creates or changes conversion actions, goals or Google Analytics 4 key events, and doesn't read ChatGPT Ads conversion tracking. Google Ads gives no tag status, so Roasby judges recording by the last conversion (when Google Ads received it, or for Google Analytics 4 imports its day; none in 7 days is No recent conversions). See Conversions.
• A read-only account (reconnect needed, over the limit or set by support) can't be changed through your assistant; your assistant tells you what to do and where.

See every limit by platform on Limitations.