Google Ads Integration
Connect Google Ads (and YouTube) to PromotiAI using a Google Cloud OAuth 2.0 client. Once connected, you can manage campaigns and view cross-platform performance alongside your social campaigns.
Step 1 — Create a Google Cloud project and enable the API
- Open console.cloud.google.com, create or select a project
- Go to APIs & Services → Library, search "Google Ads API" and click Enable
Step 2 — Configure the OAuth consent screen (required before creating credentials)
- Go to APIs & Services → OAuth consent screen
- Select External user type, fill in app name, support email, developer contact email
- Under Authorized domains, add your production domain (e.g.
promotiai.com) - On the Scopes step, click Add or Remove Scopes and add
.../auth/adwords,.../auth/userinfo.email,.../auth/userinfo.profile
✅ Shortcut — add yourself as a Test User: on the "Test users" step, add your own Google email. Test users get full access to every scope, including Google Ads, with zero Google verification — up to 100 test users, enough for a whole team. Publishing/verification is only needed for external users outside your test list; skip it unless you actually need that. Test users will see an "unverified app" warning during login — click Advanced → Go to app to proceed, that warning is expected and harmless.
Step 3 — Create OAuth 2.0 credentials
- Go to APIs & Services → Credentials
- Click + Create Credentials → OAuth 2.0 Client ID
- Application type: Web application
- Under Authorized redirect URIs, add the callback URL shown in PromotiAI's setup modal (e.g.
https://promotiai.com/api/integrations/google/callback) - Click Create and copy the Client ID and Client Secret
Step 4 — Connect in PromotiAI
- Go to Settings → Integrations
- Click the Google Ads card
- Choose Quick Setup or Step-by-Step Guide
- Paste your Client ID and Client Secret, then click Connect
- Optionally paste a Developer Token (Google Ads manager account → Tools & Settings → Setup → API Center) — connecting still works without it, but campaign launch/pause and metrics sync stay unavailable until it's added
- Sign in with the Google account that has access to your Ads account and authorize PromotiAI
- Select the Google Ads manager or individual accounts to sync
What You Can Do
- View Google Ads campaigns alongside social campaigns in one dashboard
- Track cross-platform performance (impressions, clicks, conversions, ROAS)
- Manage budgets and pause/resume campaigns from PromotiAI
- Apply AI-generated optimization suggestions to your Google campaigns
Requirements
- A Google Ads account with at least one active campaign
- Admin or Standard access level on the account
- Google Ads API enabled in your Cloud project