Google Ads Campaign Reports

This document explains the Google Ads Campaign Reports node, which retrieves campaign performance data from Google Ads.

Node Inputs

Required Fields

Customer ID:
Your Google Ads customer ID (without hyphens).
Example: "1234567890"

Start Date:
The beginning of the date range for the report.
Example: "2024-10-01"

End Date:
The end of the date range for the report.
Example: "2024-10-19"

Optional Fields

Campaign IDs:
Specific campaign IDs to include in the report. If empty, all campaigns are included.
Example: ["12345678", "87654321"]

Metrics:
Specific metrics to include in the report.
Available options:

• impressions: Ad impressions
• clicks: Click count
• cost_micros: Cost in micros
• conversions: Conversion count
• conversions_value: Total conversion value
• ctr: Click-through rate
• average_cpc: Average cost per click
• average_cpm: Average cost per thousand impressions
  Default: All metrics

Report Level:
The level of detail for the report.
Available options:

• campaign: Campaign-level metrics
• ad_group: Ad group-level metrics
• keyword: Keyword-level metrics
  Default: campaign

Node Output

Campaign Performance:
Detailed performance metrics for your Google Ads campaigns.

Example Output:

{
  "customer_id": "1234567890",
  "date_range": {
    "start": "2024-10-01",
    "end": "2024-10-19"
  },
  "campaigns": [
    {
      "campaign_id": "12345678",
      "campaign_name": "Brand Campaign",
      "impressions": 125000,
      "clicks": 3450,
      "cost": 1250.50,
      "conversions": 67,
      "conversions_value": 6700.00,
      "ctr": 2.76,
      "average_cpc": 0.36,
      "average_cpm": 10.00,
      "conversion_rate": 1.94
    }
  ],
  "totals": {
    "impressions": 125000,
    "clicks": 3450,
    "cost": 1250.50,
    "conversions": 67
  }
}

Node Functionality

The Google Ads Campaign Reports node:

• Retrieves comprehensive campaign performance data from Google Ads.
• Supports filtering by campaign, date range, and metrics.
• Provides insights at campaign, ad group, or keyword level.
• Calculates key performance indicators (CTR, CPC, conversion rate).
• Enables automated reporting and performance tracking.