This document outlines the functionality and characteristics of the Google Ads Campaign Reader node, which enables automated extraction of campaign data from Google Ads accounts.

Node Overview

The Google Ads Campaign Reader node retrieves comprehensive campaign-level data from your Google Ads accounts, providing you with performance metrics and configuration details that can be used in your automation workflows.

This node is particularly valuable for marketing teams that need to monitor campaign performance, generate reports, or trigger automations based on advertising metrics.

Node Inputs

Required Fields

  • Account: Select which Google Ads account to pull data from
    • Select from a dropdown of connected accounts

Optional Fields

  • Managed Account: Select a specific client account to access

    • Available for all Google Ads accounts
    • Allows you to specify which account to pull data from when you have multiple accounts or sub-accounts
  • Show More Options: Expand to access additional configuration settings

    • Credentials to use: Specify which set of Google Ads API credentials to use
      • Useful when managing multiple Google Ads accounts with different API access

Node Output

The Google Ads Campaign Reader provides rich campaign data through multiple outputs:

OutputTypeDescription
Bidding StrategyListThe automated or manual bidding approach used for each campaign
IDListUnique campaign identifiers
ClicksListNumber of clicks received by each campaign
CostListTotal spend for each campaign
ImpressionsListNumber of times ads were shown
NameListCampaign names
StatusListCurrent campaign status (Active, Paused, Removed, etc.)
TypeListCampaign type (Search, Display, Video, Shopping, etc.)

All outputs are provided as lists, with each item corresponding to a specific campaign in your account.

Node Functionality

The Google Ads Campaign Reader connects to the Google Ads API to extract real-time campaign data for analysis and automation.

Key Features

  • Comprehensive Campaign Data: Access to all essential campaign metrics
  • MCC Support: Ability to work with Manager accounts and their child accounts
  • Multiple Authentication Options: Support for various credential configurations
  • Loop Mode: Process campaigns individually when loop mode is enabled

Common Use Cases

1. Performance Monitoring and Alerts

Purpose: Automatically detect campaigns that are spending more than allocated budgets and send alerts.

2. AI-Powered Campaign Analysis

Purpose: Generate weekly performance insights and recommendations for optimization.

3. Cross-Platform Reporting

Purpose: Create consolidated cross-platform advertising reports.

4. Campaign Optimization Recommendations

Purpose: Use AI to analyze campaign performance and generate actionable recommendations.

Loop Mode Application

When Loop Mode is enabled, the node processes each ad account individually, allowing for account-specific operations:

Google Ads Campaign Reader (Loop Mode) → Ask AI → Gmail Sender

This setup could generate individual performance reports for each ad account and email them to respective account managers.

Important Considerations

Example Workflow: Weekly Campaign Performance Report

This workflow automatically generates a weekly performance report for all active campaigns:

  1. Google Ads Campaign Reader: Retrieves all campaign data from your account

  2. Combine Text: Templates each campaign’s data with proper formatting (in Loop Mode)

    Template: Campaign: {Name}\nClicks: {Clicks}\nCost: {Cost}\nImpressions: {Impressions}\nStatus: {Status}\n

  3. Join List Items: Merges all formatted campaign data into a single report with newline separators

  4. Ask AI: Analyzes the consolidated data and generates a comprehensive report with insights and recommendations

  5. Gmail Sender: Emails the formatted report with actionable insights to stakeholders

How To Set Up

  1. Connect your Google Ads Account: First, add your Google Ads credentials in the Credentials page
  2. Add the Node: Drag the Google Ads Campaign Reader onto your canvas
  3. Select Account: Choose your Google Ads account from the dropdown
  4. Connect Outputs: Link the campaign data outputs to subsequent nodes in your workflow

Getting Help

If you encounter any issues or have questions about using the Google Ads Campaign Reader node, visit forum.gumloop.com for community support.