Google Ads

Connect Dataworkz to Google Ads to sync campaign, account, and performance data into your pipelines.

Dataworkz supports two authentication methods for Google Ads: OAuth (recommended) and Service Account OAuth.

Prerequisites

OAuth

Ensure the user's Google account has access to the Google Ads property. In the appropriate Google Ads account, go to Settings > Access & Security and add the user's domain.

Service Account OAuth

1. Follow the Setup Service Account instructions to create a service account.

2. Ensure the service account has access to the Google Ads property. In the Google Ads account, go to Settings > Access & Security and add the service account's domain.

3. In Google Cloud Console, go to APIs & Services > Enabled APIs & services and enable the Google Ads API.

---

Step 1 — Create a Google Ads Connector

Navigate to Configuration (gear icon) > Integrations > SaaS Applications > Google Ads.

Google Ads — list of configured connectors

Click + Add new configuration.

Add New Google Ads — enter instance name and select OAuth option

Enter a Google Ads instance name and select an OAuth option.

OAuth

1. With OAuth selected, click Sign in with Google and complete the Google authorization flow.

2. After authorization, select a Workspace and Collection to store synced data.

3. Click Save.

Add New Google Ads — Workspace and Collection fields appear after authorization

Service Account OAuth

1. Select Service Account OAuth from the OAuth option dropdown.

2. Enter the Developer Token.

3. Enter the Client ID.

4. Enter the Client Email.

5. Select the Authenticate certificate option and Authenticate certificate type.

6. Enter the Private Key.

7. Click Authenticate. If the connection succeeds, select a Workspace and Collection.

8. Click Save.

The new connector appears in the Google Ads list. Click the connector name to open its detail view, which shows the connector Properties and a Configuration tab for managing data sync jobs.

Google Ads connector — Properties tab showing instance name, OAuth option, Workspace, and Collection

---

Step 2 — Add a Sync Configuration

Click the Configuration tab on the connector detail page, then click + Add new configuration.

Google Ads — Configuration tab listing sync jobs for this connector

Google Ads — Configuration form for defining a sync job

Fill in the following fields:

Field	Required	Description
Job name	Yes	A unique name for this sync job.
Sync mode	Yes	Choose Sync specific accounts to pull from selected accounts, or Sync specific manager accounts to pull from a manager (MCC) account hierarchy.
Account	Yes	Select one or more Google Ads accounts to sync.
Report name	Yes	The report type to sync (e.g. campaign, ad_group, keyword).
First run includes all historical data	Yes	Set to Yes to pull all available historical data on the first run. Set to No to start from the current date.
Incremental pull based on	No	Select a date field to use for incremental syncs after the first run.
Enable Recurring Job	No	Toggle on to schedule this job to run automatically on a recurring basis.

Click Add to save the configuration.