Adrails Docs

Get started

Sign in with Google, set up your workspace, connect an ad account and finish the Get started checklist.

Sign in

Open Sign in and choose Continue with Google. A new Adrails account is created with Google only. Once your account exists, you can also sign in with a one-time code sent to your email address. Adrails has no passwords.

If someone invited you to their workspace, open the link they shared. It asks you to sign in with the email address the invitation was sent to. See Workspaces and members.

Set up your workspace

The first time you sign in, Adrails creates a workspace and opens its setup. The first two steps can be left with Back or Skip setup. At the account step, I'll connect later opens Home with the connection choices still available.

What best describes this workspace? Ecommerce brand, SaaS company, Mobile app, Agency or Other. Your answer decides which integrations and setup steps come first.

What should Adrails help you do first? Pick the goal closest to yours.

Connect your first ad account. Choose Connect Meta or Connect Google Ads. Adrails reads campaigns, ads, spend and reported results from the accounts you select. Nothing changes without your action or an automation you turn on. I'll connect later keeps the agent usable, but account performance needs a connection.

Setup asks for no plan and no card. Every workspace starts on Preview: the real workspace with 3 ads and 10 free credits to try Adrails. Preview reads and reviews your ad accounts and prepares changes, so you see each change exactly before paying. Adrails asks you to choose a plan the first time you apply one, and brings you back to it after checkout. See Plans and billing.

When setup ends, Adrails opens Home. Connecting an account starts a data sync; it does not publish ads or change budgets.

Only the workspace owner is taken through setup. People who join an existing workspace go straight to Home.

Connect Meta

  1. Open Ad accounts in the sidebar and choose Add account.
  2. Choose Connect Meta. Meta asks you to choose a business portfolio, then the ad accounts, Pages and datasets Adrails may use. An ad account outside any portfolio must first be added to one in Meta Business Settings.
  3. Back in Adrails, the ad accounts you chose are listed. Use the switch in the In use column to start or stop using each one.

Adrails asks Meta for these permissions: ads_read, ads_management, pages_show_list, pages_read_engagement and business_management. An ad must name the Page it runs from, so the Page permissions are needed to create ads. See Meta Ads for what is read and how to disconnect.

Google Ads

New workspaces can connect Google Ads from Ad accounts, beside Meta.

Finish the Get started checklist

The sidebar shows a Get started checklist. Every displayed step counts toward its progress:

StepDone when
Connect your ad accountThe workspace has an ad account in use.
Get your first answerYou have received a completed, non-empty agent answer in this workspace.
Invite your teamThe workspace has another member or an active pending invitation.
Connect your integrationsThe workspace has an active business integration.

A teammate's answer does not complete your personal first-answer step. Starting a conversation or sending a request is not enough. An answer is a setup milestone, not proof that all requested data was available.

The team step appears whenever your role can manage members, even before connecting an account. It opens the invitation dialog. The counter shows four steps when this step is available, or three otherwise.

The integrations step puts first the source the business you described in setup has: Shopify for e-commerce, Stripe for SaaS, RevenueCat for a mobile app. Connect a store, a revenue source or another business integration when the question needs it. Shopify, Stripe, RevenueCat and Triple Whale add sales, payment or subscription evidence. PostHog, Klaviyo and Google Drive add other business context. Ad performance can be reviewed before adding these sources; the agent must identify missing evidence rather than treating it as zero.

Review one account first

  1. Home shows stored progress while the first account sync runs.
  2. Once data arrives, choose What's happening in my account? or the question drawn from your synced figures, under the message box.
  3. Check or edit the prepared request, then send it.

The shortcut retains your account selection and asks for the last seven completed days, dates, data freshness and supported next steps. It does not send a request or change an ad on its own. Sending the request usually costs 1 credit. An incomplete reporting period should be described as missing coverage, not zero spend.

Watch for

  • Connecting or disconnecting ad accounts and integrations requires the corresponding role permission.
  • The Review performance shortcut appears when an account is connected and the message box is empty.
  • Inviting your team, connecting a store and publishing an ad are not requirements for using Home. Once an account is connected and the first answer received, the checklist leaves Home and Priorities take its place. The optional steps stay in the sidebar until every step is done, then the checklist leaves the sidebar too.

On this page