Adrails Docs

Meta Ads

Connect your Meta ad accounts, what Adrails reads and writes with the access you grant, and how to remove it.

Meta Ads is where Adrails reads your spend and results, and where it publishes new campaigns, pauses, budget changes and split tests.

Connect

Adrails connects Meta through a business portfolio, with Meta's login for businesses. An admin of the portfolio picks in Meta's window what Adrails gets, and Adrails reaches nothing else.

  1. Open Ad accounts and choose Add account, then Meta.
  2. Sign in with a Facebook profile that is an admin of the business portfolio.
  3. Choose the business portfolio, then the ad accounts, Pages and datasets Adrails may use, or Select all.
  4. Back in Adrails, the ad accounts you chose are listed and start syncing.

An ad account outside any business portfolio cannot be chosen: add it to a portfolio first, in Meta Business Settings under Accounts, Ad accounts. A Page outside the portfolio is added there too, under Accounts, Pages; Meta stops with an error if one is ticked in its window.

Meta handles sign-in, so Adrails never receives your password. Nothing is published or changed during setup.

You can connect several business portfolios, each its own connection. Connections are never a billing unit.

A Facebook profile connected before

A workspace connected through a personal Facebook profile keeps working as it is. Reconnect and Refresh access on it open the business login, and a strip at the top of Adrails invites an owner or admin to switch. Once a business portfolio grants the same ad accounts, they move to it with their history, automations, drafts and choices, and the profile, left with no ad account, is removed from the workspace. Nothing is deleted at Meta.

What Adrails asks for

PermissionWhy
ads_readRead ad accounts, campaigns, ad sets, ads and their results.
ads_managementApply what you approve: create, pause, resume, change budgets.
pages_show_list, pages_read_engagementAn ad must name the Page it runs from. Without these, Adrails cannot see your Pages or create an ad.
business_managementRead the business portfolios your accounts belong to. A Meta split test needs one.

What it is used for

  • Campaigns, Creatives, Analysis and Home read the synced figures, as Ads Manager shows them by default: each ad set's own attribution setting, and archived and deleted ads kept with their status. See How the figures are counted.
  • Each account's spending limit, what it spent against it, its balance and its payment method. A finding opens when an account has used 90% of its limit or reached it, or when a payment failed, and the Account billing and health automation can tell you. See Automations.
  • The agent reads the same data and proposes changes, applied only after approval. A card that restarts an ad set's learning, gives an ad that has run a new post without its likes and comments, or sends an ad back to Meta's review says so before you apply it. See What a change resets.
  • Tracking can send your server's conversions, and your Shopify store's sales, to a Meta dataset through the Conversions API. Adrails starts sending a store's sales by itself where nothing else sends them; you can turn it off in the tracking settings.

Audiences

Retargeting audiences are built in Adrails, as in Ads Manager's Create audience, and used in an ad set's Custom audiences and Excluded custom audiences. In the Campaigns editor, open an ad set's audience, then Create audience next to Custom audiences; Manage lists the account's audiences. The agent creates the same ones in the chat, and MCP clients through meta_audience_create, each after your approval. An audience spends nothing until an ad set uses it.

AudienceWho is in itDays kept, at most
WebsiteAll visitors, visitors of pages whose address contains a word, or people who sent a pixel event180
Video viewersPeople who watched 3 seconds, a ThruPlay, or 25, 50, 75 or 95 percent of a campaign's ads' videos, or of videos you choose. Meta takes only videos on a Page: a video only uploaded to the ad account is refused, while a launched ad's video always has its Page copy365
Instagram accountEveryone who engaged, visited the profile, engaged with a post or ad, sent a message or saved730
Facebook PageThe same, and people who clicked a call-to-action button730
Lead formPeople who opened a form, opened it but did not submit, or submitted it90
Instant ExperiencePeople who opened it, or clicked a link in it730
People who sent a messageMessages to the Page, or to the Instagram account: one per audience730
Customer listYour Shopify store's customers, or a CSV file
LookalikeThe people most like another audience, in one or several countries

Customer lists. From the store, choose the customers who accept marketing or every customer: Adrails reads them from Shopify, normalizes each email, phone, name and address by Meta's rules, hashes them with SHA-256 and sends only the hashes. Ticked, Add the store's new and changed customers every day keeps the list current, and takes out a customer who stopped accepting marketing; its switch stays on the audience in Manage. From a file, the columns are read by their first row (Email, Phone, First name, Last name, City, State, Zip, Country), and the file is hashed in your browser: only the hashes reach Adrails and Meta. Either way Adrails keeps counts, never your customers or their hashes. Ticking the value option sends each customer's total spent, for a value-based lookalike. When Shopify withholds the phone and the address from Adrails, the list goes with emails and names, and Manage says so.

A customer list needs Meta's Custom Audience Terms accepted on the ad account. When they are not, the dialog says so and links to Meta's page that accepts them, and creates nothing until they are.

Lookalikes. Start from any custom audience but a lookalike, choose one or several countries and a size up to 10 percent. Number of audiences splits it as Ads Manager does: up to 3 percent in 3 audiences makes 0-1%, 1-2% and 2-3%. A lookalike of a value-based customer list is value-based. Meta needs at least 100 people in the source audience.

Manage lists each audience with its kind, Meta's size estimate, how long it keeps people, its state and when it was made, and what Adrails sent to a customer list. Delete asks on the row first: a deleted audience cannot come back, and ad sets that used it stop reaching it.

Figures beyond Ads Manager's defaults

The defaults stay as Ads Manager shows them. Ask for more, or add the columns, and Adrails reads these from Meta too:

  • One attribution window. Purchases, results and revenue in 1-day, 7-day or 28-day click, 1-day view or 1-day engaged view, instead of each ad set's own setting, or split by click and by view beside Ads Manager's figure. Choose it with Attribution in Analysis, or name it in a question, such as 7-day click only or without views. Every figure read in a window says so.
  • Inside an ad. For an ad with several primary texts, headlines, images or videos, each one's spend, CTR, purchases, CPA and ROAS, from Meta's asset breakdown. Meta credits each asset approximately, so the rows of one kind may not add up to the ad's total.
  • Delivery cuts. A period by region, DMA, frequency, catalog product or customer segment, beside age, gender, country, placement, device and hour. Frequency gives reach alone. Customer segments, new against existing customers, come from Advantage+ sales campaigns, and the answer says when the account defines no existing customers. A catalog product is tied to the store's product.
  • Clicks and plays. Outbound clicks with their CTR and cost, unique clicks and unique link clicks, 2-second continuous and 30-second plays, plays at 25%, 50%, 75% and 95%, ThruPlays, Instant Experience view time, and what a lifetime budget has left.
  • Custom conversions your ad sets optimise for, with their rule, event, default value, datasets and last event. One with no event for a week is said to be silent.

Where to find them: the Campaigns column picker, an ad's page, the Creatives columns, the agent's answers and the ad file. See A Meta ad's page.

What Meta does not give

  • 7-day and 28-day view. Meta has returned no data for them since January 12, 2026, so Adrails never offers them.
  • Purchases by region, DMA or product. Meta gives no purchases with these cuts. By region, the store's net sales by shipping region sit beside the ad figures when a Shopify store sells for the account, matched by name within the store's countries.
  • Unique purchasers. Meta has not reported them since October 30, 2024.
  • Ad recall. Meta returns no estimated ad recall lift on any ad, so it is not shown.
  • A video mark Meta leaves out, such as 2-second plays on a short-run ad, is shown as missing, never as zero.

Stop using an account, or remove a profile

  • To stop using one ad account, switch it off in In use. It leaves every other screen but stays on Ad accounts, where you can switch it back on.
  • To leave an ad account out of what Adrails takes, untick it in Choose assets on its Meta connection, or stop sharing it with Adrails in Meta Business Settings, under Integrations, Connected apps, then use Refresh access. It leaves every screen and stops syncing. Its history is deleted after 30 days unless you tick it again: its snapshots, its daily and hourly figures, what the rules found on it and the creatives synced from it. The changes Adrails made on it, and what was billed, stay in the record.
  • To remove a Facebook profile, use the delete button on its connection and confirm Remove profile. Its ad accounts leave every screen and stop syncing, and the stored access token is erased. Their history is deleted after 30 days in the same way, unless you connect the profile again.

You can also revoke Adrails' access from your Facebook settings at any time.

Watch for

  • If a change is refused for a missing permission, reconnect Meta from Ad accounts so it asks again for ads_management.
  • Reading, exporting and hiding the comments under your ads needs Meta permissions Meta has not approved for Adrails yet. It is not available yet: read them in Meta Business Suite.
  • Removing a profile cannot be undone from Adrails: connect it again to read its accounts.

On this page