Google Ads

1. Overview

Google Ads is an online advertising platform developed by Google, where advertisers bid to display brief advertisements, service offerings, product listings, or videos to web users. The Google Ads API allows developers to build applications that interact directly with the Google Ads platform, enabling programmatic management of campaigns, ad groups, ads, and more.

With the GoInsight Google Ads node, you can seamlessly integrate your advertising data into your automated workflows. This allows you to retrieve comprehensive performance metrics and campaign details directly from your Google Ads account, including:

• Fetching Campaign Data: Retrieve detailed information for one or more campaigns, including their status, budget, and performance metrics like clicks, impressions, and cost.

2. Prerequisites

Before using this node, you need to have a valid Google Ads account. You may also need administrative or appropriate permissions within your Google Ads account to generate the necessary API credentials.

3. Credentials

For a detailed guide on how to obtain and configure credentials, please refer to our official documentation: Credentials Configuration Guide.

4. Supported Operations

Summary

This node allows you to perform operations related to your advertising campaigns. The table below summarizes the available actions.

Operation Details

Get Campaigns

Retrieves information for one or more Google Ads campaigns. Supports fetching specific campaigns by IDs or all campaigns in the account. Returns detailed campaign metrics including status, budget, clicks, and impressions.

Input Parameters:

• CustomerId: Google Ads customer ID (10-digit number without hyphens, e.g., 1234567890)

Options:

• CampaignIds: Comma-separated campaign IDs to retrieve (empty to get all campaigns)
• LoginCustomerId: Login customer ID (10-digit number without hyphens). Required when accessing customer accounts through an MCC (Manager) account. Should be the MCC account ID.
• DateRange: Date range for metrics data. Valid options: ALL_TIME (no metrics), LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH.
• ShowCampaignsStatus: Filter campaigns by status. Valid options: ALL, ENABLED, PAUSED, ALL_INCLUDING_REMOVED, REMOVED.

Output:

• Campaigns (object-array): Array of campaign information. Each element is a campaign object containing campaign details (CampaignId, CampaignName, Status, ChannelType, BudgetMicros, Clicks, Impressions, CostMicros).
• TotalCount (number): Total number of campaigns returned in the response.
• StatusCode (number): Operation status code: 200 (success), -1 (parameter validation error), 500 (internal error), or HTTP status code for API errors.
• ErrorMessage (string): Error description if the operation fails, empty string on success.

5. Example Usage

This section will guide you through creating a simple workflow to fetch all active campaigns from your Google Ads account for the last 30 days.

The workflow will consist of three nodes: Start -> Google Ads: Get Campaigns -> Answer.

Step-by-Step Guide

1. Add the Google Ads Node:
   • In your workflow canvas, click the + button to add a new node.
   • Select the "Tool" tab in the pop-up panel.
   • Find and select "Google Ads" from the list of tools.
   • From the list of supported operations, click on "Get Campaigns" to add the node to your canvas.
2. Configure the Node:
   • Click on the newly added "Get Campaigns" node to open its configuration panel on the right.
   • Credentials: In the "Credentials" field, click the dropdown menu and select your pre-configured Google Ads credential.
   • Parameters: Fill in the input parameters as follows:
   • CustomerId: Enter your 10-digit Google Ads customer ID without any hyphens (e.g., 1234567890). This is the ID of the account you want to query.
   • CampaignIds: Leave this field empty to retrieve all campaigns in the specified account.
   • LoginCustomerId: If you are accessing the customer account through a Manager (MCC) account, enter your MCC account ID here. Otherwise, you can leave this blank.
   • DateRange: Select LAST_30_DAYS from the dropdown to get performance metrics from the last 30 days.
   • ShowCampaignsStatus: Select ENABLED to filter the results and only retrieve campaigns that are currently active.
3. Run and Validate:
   • Once all required parameters are correctly filled, any error indicators on the workflow canvas should disappear.
   • Click the "Run" button in the top-right corner of the canvas to execute the workflow.
   • After a successful run, you can click the log icon in the top-right corner to view the detailed input and output of the node, verifying that the campaign data was retrieved successfully.

Final Workflow

After completing these steps, your workflow is fully configured. When you run it, the node will connect to your Google Ads account and return a list of all your active campaigns along with their performance data from the last 30 days.

6. FAQs

Q: Why am I getting an authentication error (401/403)?

A: This usually indicates an issue with your credentials or permissions. Please check the following:

• Correct Credentials: Ensure that the API key, client ID, client secret, and refresh token are correctly configured in GoInsight.
• API Enabled: Verify that the Google Ads API is enabled in your Google Cloud Platform project.
• Account Access: Make sure the user account associated with the credentials has at least read-only access to the Google Ads account you are trying to query.

Q: What is the difference between CustomerId and LoginCustomerId?

A: CustomerId is the ID of the specific Google Ads account you want to retrieve data from. LoginCustomerId is only used when you are accessing that customer account through a Manager (MCC) account. In that case, LoginCustomerId should be the ID of your Manager account, and CustomerId should be the ID of the client account.

Q: The cost and budget values in the output are very large numbers. Why?

A: The Google Ads API returns all monetary values in "micros," which is one-millionth of the base currency unit (e.g., micro-dollars or micro-euros). To get the actual currency value, you need to divide the returned number by 1,000,000.

7. Official Documentation

For more detailed information about the API's capabilities and parameters, please refer to the Google Ads Official API Documentation.