Overview
The node "Google Ads Advanced" provides integration with the Google Ads API, specifically allowing users to retrieve multiple campaigns in bulk. This is useful for marketers and advertisers who want to programmatically access campaign data such as status, date ranges, and other statistics from their Google Ads accounts.
Common scenarios include:
- Fetching all campaigns or filtering by status (enabled, paused, removed) for reporting.
- Retrieving campaign performance data over specific time periods like last 7 days or last month.
- Automating campaign audits or synchronizing campaign data with other marketing tools.
Example: A user wants to get all active campaigns from a client account for the last 30 days to analyze recent ad spend and performance trends.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating with Google Ads API; options are OAuth2 (recommended) or Service Account. |
| Manager Customer ID | The customer ID of the manager account overseeing the client accounts (required). |
| Client Customer ID | The customer ID of the client account whose campaigns are being fetched (required). |
| Additional Options | Collection of optional filters and settings: |
| - Date Range | Filter campaigns' statistics by period. Options: All Time, Today, Yesterday, Last 7 Days, Last Business Week, This Month, Last Month, Last 14 Days, Last 30 Days. Default is All Time. |
| - Show Campaigns by Status | Filter campaigns by their status. Options: All, Enabled, Paused, Removed. Default is All. |
| Divide field names expressed with micros by 1,000,000 to get the actual value | Notice explaining that some numeric fields are returned in micros and need conversion. |
Output
The node outputs JSON data representing the list of campaigns retrieved from the Google Ads API. Each campaign object typically includes details such as campaign ID, name, status, and performance metrics filtered by the selected date range and status.
If any fields are expressed in micros (millionths), the user should divide those values by 1,000,000 to get the actual amounts (e.g., monetary values).
No binary data output is indicated.
Dependencies
- Requires valid authentication credentials for Google Ads API, either via OAuth2 or a Service Account.
- Needs configuration of developer token and appropriate permissions on the Google Ads accounts.
- Network access to
https://googleads.googleapis.comendpoint.
Troubleshooting
- Authentication errors: Ensure correct OAuth2 tokens or service account credentials are provided and have sufficient scopes/permissions.
- Invalid Customer IDs: Verify that both Manager and Client Customer IDs are accurate and accessible by the authenticated user.
- Empty results: Check if filters like date range or campaign status are too restrictive.
- API quota limits: Google Ads API enforces quotas; hitting these may cause errors or throttling.
- Micros unit confusion: Remember to convert micros fields by dividing by 1,000,000 to interpret values correctly.