Getting Started
Pull your first ad report in under 5 minutes. No coding required.
Install AdsBull from Google Workspace Marketplace
- 1.Open any Google Sheet.
- 2.Go to Extensions → Add-ons → Get add-ons.
- 3.Search for "AdsBull" and click Install.
- 4.Grant the requested permissions (required to connect ad accounts).
- 5.After install, go to Extensions → AdsBull → Open Sidebar.
Connect your ad accounts
- 1.In the AdsBull sidebar, click the platform you want to connect (Meta, TikTok, Google Ads, or Shopify).
- 2.Click Authenticate — you'll be redirected to that platform's login page.
- 3.Log in and approve AdsBull's access. You'll be returned to your Sheet.
- 4.Repeat for each platform you want to pull data from.
- 5.Your connected accounts will appear in the sidebar.
Configure your report
- 1.Select your ad account from the dropdown.
- 2.Choose your date range (preset or custom).
- 3.Pick your fields — metrics, dimensions, and breakdowns.
- 4.Choose your update mode: Replace (clean each pull), Append (add new rows), or Update-or-add.
- 5.Optionally, set a schedule for automatic pulls.
Pull your data
- 1.Click "Fetch Data" in the sidebar.
- 2.AdsBull pulls data from the platform API and writes it to your sheet.
- 3.Your data lands in a clean table starting from cell A1 (or your configured start cell).
- 4.Column headers are auto-populated on the first pull.
Common questions
Where does my data land in the Sheet?
By default, AdsBull writes data starting from cell A1 of the active sheet. The first row is always column headers. In Append mode, new rows are added below existing data.
What's the difference between Replace and Append mode?
Replace clears the sheet on each pull and writes fresh data — good for snapshots. Append adds new rows below existing data — good for building a rolling history. Update-or-add matches by date and updates existing rows.
Can I pull data for multiple date ranges?
Yes. Each pull uses the date range you configure at the time of pulling. To build historical data, use Append mode and pull for different date ranges over time.
What permissions does AdsBull need?
AdsBull needs permission to read your ad data (via OAuth from each platform) and to write to your Google Sheets. It never stores your ad data on our servers.