Google Ads

This guide will help you connect a Google Ads data grabber to the Magify analytics system. The grabber collects data on ad assets, geo performance, and other account-level metrics, enabling automated data import into your analytics pipeline.

Getting Started

1. Navigate to Configurations > Integration > UA Grabbers in the Magify interface.
2. Find Google Ads in the list and click Add Grabber to create a new data source.
3. A configuration form will open.

This will open a configuration form where you can enter the required connection parameters. Below is a description of each field, along with instructions on where to find the necessary values.

Name

The name of the grabber configuration in the Magify system. It helps you identify this data source among other integrations.

Recommended format: Google Ads Grabber [CompanyName]

Optional field – recommended to fill in for easier navigation.

Organization

Select your organization from the dropdown list.

Client ID and Client Secret

These are the two key parameters required for authorization via OAuth 2.0 — the protocol used by the grabber to access the Google Ads API on behalf of your project.

1. Go to the Google Cloud Console.

If you don't have a project in Google Cloud Console yet, follow these steps:

1. Click New project in the top right corner of the project selection window.
2. In the popup window, provide the following:

• Project name — enter any descriptive name (e.g., Your Application Name).
• Optionally, select your organization and folder, if applicable.

3. Click Create.

Choose the user type (Audience):

• External — select this if the integration will be used outside your organization. This is the default and most common option.
• Internal — only available for Google Workspace accounts within your organization.

Enter the Developer contact information:

• This email will be used by Google to send important notifications related to your project.
• Enter a valid work email (e.g., magify.application@magify.com).

Finalize the consent screen setup:

• Accept the Google API Services: User Data Policy.
• Click Create to complete the OAuth consent screen setup.

5. After clicking Create, a dialog window will appear (see screenshot above). Once done, you will be presented with your OAuth 2.0 Client ID and Client Secret.You can download these credentials in JSON format and save them for later use.For more details, refer to the Google Ads API Authentication Guide (Step 2).

Refresh token

The refresh token is a key that allows the grabber to stay authorized in the Google Ads API without requiring repeated logins.It works together with your Client ID and Client Secret to automatically refresh the access token and maintain a persistent connection.

How to get a refresh token using OAuth Playground

1. Open the OAuth 2.0 Playground
2. Click the ⚙️ (gear icon) in the top-right corner and enable: ✔ Use your own OAuth credentials
3. Set the following option: Force prompt → No. This disables extra authorization prompts during token refresh.

4. At Step 1: Select & authorize APIs, locate and expand the Google Ads API category.
5. Check the box next to: https://www.googleapis.com/auth/adwords. This grants access to Google Ads data via the API.
6. Click the Authorize APIs button.Sign in with your Google Ads account and confirm access when prompted.

7. After successful authorization, click Exchange authorization code for tokens.

8. The Playground will display both the Access Token and the Refresh Token.Copy the Refresh Token — you’ll need it when configuring the grabber in Magify.

Developer token

The Developer Token is a unique key used to identify your application when making requests to the Google Ads API. Without it, no requests from the grabber will be accepted by Google.

Where to get your Developer Token:

1. Go to your Google Ads Manager (MCC) account.
2. In the left-hand navigation menu, click Admin → then select API Center (or go directly to ads.google.com/aw/apicenter if you're already in the correct account)
3. On the page, you’ll see the Developer Token field — copy the value shown there.

Manager Customer ID

The Manager Customer ID (or MCC ID) is a unique identifier of your Google Ads Manager Account. The grabber uses this ID to operate on behalf of your account when fetching data.

Where to find your Manager Customer ID:

1. Log in to Google Ads with the account you plan to use in Magify.
2. Open the account you intend to connect.

The ID will follow the format: 123-456-7890 This is your Manager Customer ID — copy and paste it into the corresponding field in Magify.