Question 1

What is Chiliad?

Accepted Answer

Chiliad is a SaaS platform for managing Google Ads scripts. It lets you write, deploy, and monitor automation scripts across multiple Google Ads accounts — all from a single dashboard. Whether you're a freelancer managing a handful of accounts or an agency with hundreds, Chiliad replaces the manual process of copying scripts into each account.

Question 2

How do I get started?

Accepted Answer

1. Sign up and create your workspace. 2. Connect Google Ads — go to Settings and click "Connect Google Ads" to authorize via OAuth. 3. Add accounts — navigate to Accounts and select which Google Ads accounts to manage. 4. Create or install a script — write your own in Scripts > New Script, or browse the Marketplace for ready-made automations. 5. Deploy — assign the script to accounts and paste the generated loader into Google Ads.

Question 3

How do I connect my Google Ads account?

Accepted Answer

Go to Settings and click the "Connect Google Ads" button. You'll be redirected to Google to authorize access. Once connected, navigate to Accounts and click "Add Accounts" to select which accounts to manage. If you have an MCC (Manager) account, all child accounts will be available.

Question 4

What is a Workspace?

Accepted Answer

A Workspace is your team's shared environment in Chiliad. All accounts, scripts, and team members belong to a workspace. If you're a solo user, you have one workspace. Agencies can have multiple team members in the same workspace sharing access to all resources.

Question 5

What is the Dashboard?

Accepted Answer

The Dashboard is the first page you see after logging in. It shows an overview of your workspace: total accounts, active scripts, recent executions, and performance trends. Use it to quickly check if everything is running smoothly across your accounts.

Question 6

How do I add Google Ads accounts?

Accepted Answer

Navigate to Accounts and click "Add Accounts". Chiliad will fetch all accounts accessible through your Google Ads credentials, including those under MCC (Manager) accounts. Select the accounts you want to manage and click "Add Selected".

Question 7

What is an MCC (Manager) account?

Accepted Answer

An MCC (My Client Center) is a Google Ads Manager account that can manage multiple client accounts. When you connect an MCC, Chiliad automatically discovers all child accounts in the hierarchy. The MCC account page shows aggregated performance data across all child accounts with currency conversion.

Question 8

How do I sync performance data?

Accepted Answer

Open any account page and click the Refresh button in the tabs row. This fetches the latest performance data and campaign information from Google Ads. Data is cached for 1 hour — you can force a refresh at any time. The date range picker lets you view different time periods.

Question 9

What is OCID and why do I need it?

Accepted Answer

OCID is an identifier Google uses in their Ads interface URLs. Setting it enables the "Open in Google Ads" button on account pages, giving you direct deep links to Campaigns, Scripts, Settings, and other pages in Google Ads. You can find your OCID in the URL bar when viewing an account in Google Ads (look for ?ocid=...).

Question 10

Why don't I see campaign data?

Accepted Answer

Campaign data is fetched when you click Refresh on the account page. Only enabled campaigns are shown. If you just added the account, click Refresh to trigger the initial sync. The sync fetches campaigns and 30 days of performance data.

Question 11

How do I create a new script?

Accepted Answer

Go to Scripts and click "New Script". Give it a name, select a category, and write your code in the editor. The code should contain a function main() {} as the entry point. Click Save when done. You can also install scripts from the Marketplace.

Question 12

Can I create scripts from Claude (AI)?

Accepted Answer

Yes — Chiliad has a Claude connector. Connect your workspace to Claude once, then ask it to write, deploy, configure, and debug Google Ads scripts directly in Chiliad — no copy-pasting. See the Claude Connector section for setup steps and the full list of what it can do.

Question 13

What is the code editor?

Accepted Answer

The built-in code editor provides a full IDE-like experience with: - Syntax highlighting for JavaScript - Real-time error checking — red underlines appear on syntax errors - Google Ads autocomplete — type a dot after known globals (like AdsApp., Logger., SpreadsheetApp.) to see available methods - Keyboard shortcuts — Cmd+S (Mac) or Ctrl+S (Windows) to save - Bracket matching and auto-closing

Question 14

What are script variables?

Accepted Answer

Script variables are configurable values that appear at the top of the generated loader script. They let users customize a script's behavior without modifying the code itself — for example, email addresses, bid thresholds, or spreadsheet URLs. Define variables in the script's Settings, and they'll be editable per-account.

Question 15

How does version history work?

Accepted Answer

Every time you save a script, a new version is created automatically. Go to the Versions tab to see all previous versions with timestamps. You can view the code of any version and delete versions you no longer need. This gives you a safety net if you need to revert changes.

Question 16

Why can't I save my code?

Accepted Answer

The editor blocks saving when there are syntax errors in your code. Check for: - Missing closing brackets }, ), or ] - Incomplete variable declarations (e.g. var x = without a value) - Invalid JavaScript syntax Fix the highlighted errors and try saving again.

Question 17

What is the Claude connector?

Accepted Answer

The Claude connector lets you build and manage your Google Ads scripts by chatting with Claude (Anthropic's AI assistant). Connect your workspace once, then ask Claude in plain language to write a script, deploy it, configure it per account, run a quick query, or debug a failing run — and it happens directly in Chiliad, with hosted loaders, execution analytics, and version history. No copy-pasting code. Available on all plans; your plan's script and loader limits apply.

Question 18

How do I connect Chiliad to Claude?

Accepted Answer

1. Copy your connector URL — in Chiliad, open Settings → Claude and copy the connector URL (it looks like https://app.chiliad.io/api/mcp). 2. Open Claude's connector settings — in claude.ai (web) or the Claude Desktop app, go to Settings → Connectors. 3. Add a custom connector — click "Add custom connector" and paste the connector URL. 4. Sign in and approve — click Connect, sign in with your Chiliad account, and approve access on the consent screen. 5. Start chatting — ask Claude something like "Write a budget pacing script and push it to Chiliad," then follow the loader and setup steps it hands back.

Question 19

Which Claude apps can I use?

Accepted Answer

The connector works anywhere Claude supports custom connectors: - claude.ai (web) — Settings → Connectors → Add custom connector - Claude Desktop — the same Connectors settings - Claude Code (terminal) — run claude mcp add --transport http chiliad <your-connector-url>, then /mcp to authenticate claude.ai and Claude Desktop give the smoothest experience.

Question 20

What can Claude do once connected?

Accepted Answer

- Create & update scripts — write a script in the chat and push it to your workspace, then get the loader to paste into Google Ads - Configure variables — declare a script's settings (thresholds, emails, dates) and override them per account - Manage accounts — list your connected Google Ads accounts and assign scripts to them - Query with GAQL — run read-only GAQL against an account to inspect real data before configuring a script - Monitor & debug — read execution results and error messages, then fix the code and re-push - Marketplace — search and install ready-made scripts - Archive & restore — soft-delete scripts you no longer need and restore them later

Question 21

Is it secure? What can Claude access?

Accepted Answer

Connections use your Chiliad login via OAuth — no API keys. Claude works within the single workspace you approve, subject to your role and the same account-access limits you already have. It can create, edit, and configure scripts, read analytics, run read-only GAQL, and install marketplace scripts — it cannot change billing or team settings. You can review or revoke the connection anytime from Claude's Connectors settings.

Question 22

Do my plan limits apply through Claude?

Accepted Answer

Yes — the connector respects your plan exactly like the dashboard does: script-count limits, loader access, and analytics retention all apply. On the Free plan you can push and edit scripts and read analytics, but loader generation (deploying to Google Ads) requires a paid plan. Claude tells you and links to upgrade when a limit is hit.

Question 23

How does script deployment work?

Accepted Answer

Chiliad uses a two-file system: 1. Loader script — a small script you paste into Google Ads. It fetches your actual code from Chiliad's servers and runs it. 2. Library script — your full code, hosted on Chiliad. Updated instantly when you save — no need to touch Google Ads. This means you deploy once (paste the loader) and all future code changes are picked up automatically.

Question 24

How do I deploy a script to Google Ads?

Accepted Answer

1. Open your script and go to the Script tab. 2. Copy the Loader Script code shown below your main code. 3. In Google Ads, go to Tools > Bulk Actions > Scripts (or use the deep link if OCID is set). 4. Create a new script, paste the loader code, and authorize it. 5. Run the script once to verify it works, then set a schedule.

Question 25

What is the setup() function?

Accepted Answer

The setup() function in the loader pre-authorizes Google service classes that your script uses. Since the main code is loaded via eval(), Google Ads can't detect which services it needs during the authorization step. Uncomment the services your script uses (e.g. DriveApp, SpreadsheetApp, MailApp) in setup() so Google grants the necessary permissions.

Question 26

Do I need to update Google Ads when I change my code?

Accepted Answer

No. The loader script in Google Ads always fetches the latest version of your code from Chiliad. Just save your changes in Chiliad and they'll be picked up on the next scheduled run. The only time you need to touch Google Ads is during the initial deployment or if you add new Google services (update setup()).

Question 27

What about MCC (Manager) scripts?

Accepted Answer

The loader automatically detects MCC accounts. If AdsManagerApp is available, it uses executeInParallel() to run your script across all child accounts. For single accounts, it runs directly. No code changes needed — the same loader works for both.

Question 28

What is the Marketplace?

Accepted Answer

The Marketplace is a library of ready-made Google Ads scripts that you can install with one click. Each script is tested and documented. Browse by category — bidding, reporting, monitoring, cleanup, and more.

Question 29

How do I install a Marketplace script?

Accepted Answer

1. Go to Marketplace and browse or search for a script. 2. Click on a script to see its description, features, and configuration options. 3. Click Install to add it to your Scripts library. 4. Configure any variables (like email addresses or thresholds) in the script's Settings. 5. Assign it to accounts and deploy the loader to Google Ads.

Question 30

Can I customize Marketplace scripts?

Accepted Answer

Yes. Once installed, a Marketplace script becomes your own copy. You can edit the code, change variables, and modify it however you like. Your changes won't be overwritten by updates to the original Marketplace listing.

Question 31

What is GAQL Lab?

Accepted Answer

GAQL Lab lets you run GAQL (Google Ads Query Language) queries directly against your Google Ads accounts from chiliad. It's a powerful tool for exploring account data, debugging scripts, and pulling quick reports — without writing a full script or using the Google Ads API directly.

Question 32

What is GAQL?

Accepted Answer

GAQL is Google's query language for the Google Ads API. It uses SQL-like syntax: SELECT fields FROM resource WHERE conditions ORDER BY field LIMIT n For example: SELECT campaign.name, metrics.clicks FROM campaign WHERE campaign.status = 'ENABLED' AND segments.date DURING LAST_7_DAYS Resources include campaign, ad_group, keyword_view, search_term_view, and many more.

Question 33

How do I use the Editor?

Accepted Answer

1. Select a Google Ads account from the dropdown. 2. Write your GAQL query in the editor — or click an Example button to start with a template. 3. Press Run Query (or Cmd+Enter) to execute. 4. Results appear in a table below with formatting for metrics (cost in micros is auto-converted). The editor includes real-time validation that catches syntax errors, unknown fields, and common mistakes before you run the query.

Question 34

What is the Query Builder?

Accepted Answer

The Builder tab provides a visual form for constructing GAQL queries without writing syntax manually. Select a resource, check the fields you want, add WHERE filters, set ORDER BY and LIMIT — the builder generates the GAQL for you. Click Use in Editor to transfer the generated query to the editor.

Question 35

How does autocomplete work?

Accepted Answer

As you type in the editor, Chiliad suggests fields, resources, and values based on your cursor position: - After SELECT — available attributes, metrics, and segments for the resource - After FROM — common Google Ads resources - In WHERE — filterable fields and date presets (for DURING) - In ORDER BY — sortable fields from your SELECT clause Press Ctrl+Space to trigger suggestions manually. Use arrow keys to navigate and Tab or Enter to accept.

Question 36

Can I export query results?

Accepted Answer

Yes. After running a query: - CSV — click the CSV button to download results as a CSV file - AdsApp.search() — click to copy a ready-made Google Ads Scripts snippet that runs the same query in Google Ads - Copy CSV — copies results to clipboard in CSV format Query history is saved automatically so you can re-run previous queries.

Question 37

How do I see script execution logs?

Accepted Answer

Open a script and go to the Executions tab. You'll see KPI cards (total runs, success rate, errors) and a table of individual executions with timestamps, status, account, and any error messages. Use the date range picker to filter by time period.

Question 38

What do the execution statuses mean?

Accepted Answer

- Completed — the script ran successfully - Error — the script threw an exception (check the message for details) - Timed out — the script exceeded Google Ads' 30-minute execution limit Error messages include the line number and description to help you debug.

Question 39

How does execution analytics work?

Accepted Answer

Each time a script runs in Google Ads, the loader reports the result (success or error) back to Chiliad. This data powers the Executions tab and KPI cards. Analytics are automatic — no additional setup needed beyond deploying the loader.

Question 40

A script is failing — how do I debug it?

Accepted Answer

1. Check the Executions tab for error messages and line numbers. 2. Look at the error message — common issues include: API quota limits, missing permissions (update setup()), invalid selectors, or data format errors. 3. Test changes by running the script manually in Google Ads (Scripts > Run). 4. Use Logger.log() in your code for debugging — output appears in Google Ads' script logs.

Question 41

How do I invite team members?

Accepted Answer

Go to the Team page and click "Invite Member". Enter their email address and select a role. They'll receive an invitation email to join your workspace. All team members share access to accounts and scripts within the workspace.

Question 42

What roles are available?

Accepted Answer

- Owner — full access, can manage billing and delete the workspace - Admin — can manage team members, accounts, and scripts - Member — can view and edit scripts and accounts but can't manage team settings

Question 43

How do I switch between workspaces?

Accepted Answer

If you belong to multiple workspaces, a workspace selector appears in the sidebar header. Click on it and select the workspace you want to switch to. Each workspace has its own accounts, scripts, and team members.

Question 44

How do I update my profile?

Accepted Answer

Go to Settings > Profile to update your display name, company, timezone, and password. Your email address is shown for reference but cannot be changed. You can also delete your account from this section.

Question 45

How do I manage my Google Ads connection?

Accepted Answer

In Settings > Google Ads, you can see your connection status, connected accounts, and sync details. You can disconnect and reconnect if you need to change the Google account or refresh permissions. Reconnecting won't affect your existing accounts or scripts.

Question 46

How do I configure notifications?

Accepted Answer

Go to Settings > Notifications to control how Chiliad alerts you: - Email notifications — toggle alerts for script completions, errors, performance alerts, and weekly digests - In-app notifications — toggle alerts for script executions, account alerts, and team activity - Quiet hours — set a time window when notifications are silenced - Digest frequency — choose how often to receive summary emails - Slack integration — admins can add a Slack webhook URL to send alerts to a channel - Authorized emails — whitelist email addresses that receive script execution reports

Question 47

How does billing work?

Accepted Answer

Go to Settings > Billing to view your current subscription plan, billing period, and team member count. You can upgrade, downgrade, or cancel your subscription from this page. Available plans include Free, Pro, and Agency tiers.

Help Center

Guides

Articles

Getting started with chiliad

Connecting Google Ads accounts

Scripts and deployment

Using the marketplace

Claude connector

Monitoring and alerts

GAQL Lab

Team, access and billing

Frequently asked questions

Getting Started

What is Chiliad?

How do I get started?

How do I connect my Google Ads account?

What is a Workspace?

What is the Dashboard?

Google Ads Accounts

How do I add Google Ads accounts?

What is an MCC (Manager) account?

How do I sync performance data?

What is OCID and why do I need it?

Why don't I see campaign data?

Scripts

How do I create a new script?

Can I create scripts from Claude (AI)?

What is the code editor?

What are script variables?

How does version history work?

Why can't I save my code?

Claude Connector

What is the Claude connector?

How do I connect Chiliad to Claude?

Which Claude apps can I use?

What can Claude do once connected?

Is it secure? What can Claude access?

Do my plan limits apply through Claude?

Script Deployment

How does script deployment work?

How do I deploy a script to Google Ads?

What is the setup() function?

Do I need to update Google Ads when I change my code?

What about MCC (Manager) scripts?

Marketplace

What is the Marketplace?

How do I install a Marketplace script?

Can I customize Marketplace scripts?

GAQL Lab

What is GAQL Lab?

What is GAQL?

How do I use the Editor?

What is the Query Builder?

How does autocomplete work?

Can I export query results?

Execution Monitoring

How do I see script execution logs?

What do the execution statuses mean?

How does execution analytics work?

A script is failing — how do I debug it?

Team & Workspace

How do I invite team members?

What roles are available?

How do I switch between workspaces?

Settings & Account

How do I update my profile?

How do I manage my Google Ads connection?

How do I configure notifications?

How does billing work?

Have a question or feedback?

Help Center

Guides

Articles

Getting started with chiliad

Connecting Google Ads accounts

Scripts and deployment

Using the marketplace

Claude connector

Monitoring and alerts

GAQL Lab