Databases
Marketing Analytics

How to load data from Google Ads to DuckDB

Learn how to use Airbyte to synchronize your Google Ads data into DuckDB within minutes.

TL;DR

This can be done by building a data pipeline manually, usually a Python script (you can leverage a tool as Apache Airflow for this). This process can take more than a full week of development. Or it can be done in minutes on Airbyte in three easy steps:

  1. set up Google Ads as a source connector (using Auth, or usually an API key)
  2. set up DuckDB as a destination connector
  3. define which data you want to transfer and how frequently

You can choose to self-host the pipeline using Airbyte Open Source or have it managed for you with Airbyte Cloud.

This tutorial’s purpose is to show you how.

What is Google Ads

The Google Ads API is the modern programmatic interface to Google Ads and the next generation of the AdWords API and it is a paid online advertising platform offered by Google. Google Ads is a paid search channel. Google Ads is a key digital marketing tool for any business which is looking to get meaningful ad copy in front of its target audience. Google AdWords is a well known marketplace where companies pay to have their website ranked at the top of a search results page, based on keywords.

What is DuckDB

DuckDB is an in-process SQL OLAP database management system. It has strong support for SQL. DuckDB is borrowing the SQLite shell implementation. Each database is a single file on disk. It’s analogous to “ SQLite for analytical (OLAP) workloads” (direct comparison on the SQLite vs DuckDB paper here), whereas SQLite is for OLTP ones. But it can handle vast amounts of data locally. It’s the smaller, lighter version of Apache Druid and other OLAP technologies.

Integrate Google Ads with DuckDB in minutes

Try for free now

Prerequisites

  1. A Google Ads account to transfer your customer data automatically from.
  2. A DuckDB account.
  3. An active Airbyte Cloud account, or you can also choose to use Airbyte Open Source locally. You can follow the instructions to set up Airbyte on your system using docker-compose.

Airbyte is an open-source data integration platform that consolidates and streamlines the process of extracting and loading data from multiple data sources to data warehouses. It offers pre-built connectors, including Google Ads and DuckDB, for seamless data migration.

When using Airbyte to move data from Google Ads to DuckDB, it extracts data from Google Ads using the source connector, converts it into a format DuckDB can ingest using the provided schema, and then loads it into DuckDB via the destination connector. This allows businesses to leverage their Google Ads data for advanced analytics and insights within DuckDB, simplifying the ETL process and saving significant time and resources.

Step 1: Set up Google Ads as a source connector

1. Go to the Airbyte dashboard and click on "Sources" on the left-hand side of the screen.

2. Click on the "New Source" button and select "Google Ads" from the list of available connectors.

3. Enter a name for your connector and click on "Next".

4. Enter your Google Ads credentials, including your client ID, client secret, refresh token, and developer token.

5. Click on "Test Connection" to ensure that your credentials are correct and that Airbyte can connect to your Google Ads account.

6. Once the connection is successful, select the accounts that you want to sync with Airbyte.

7. Choose the sync mode that you want to use, either "Full Refresh" or "Incremental".

8. Set the frequency of your sync and click on "Create Source" to save your settings.

9. Your Google Ads source connector is now set up and ready to use. You can view your data in the Airbyte dashboard and start syncing it with your destination.

Step 2: Set up DuckDB as a destination connector

1. Open the Airbyte platform and navigate to the "Destinations" tab on the left-hand side of the screen.
2. Click on the "Add Destination" button located in the top right corner of the screen.
3. Scroll down the list of available destinations until you find "DuckDB" and click on it.
4. Fill in the required information for your DuckDB database, including the host, port, database name, username, and password.
5. Test the connection to ensure that the information you provided is correct and that Airbyte can successfully connect to your DuckDB database.
6. If the connection is successful, click on the "Save" button to save your DuckDB destination connector.
7. You can now use this connector to transfer data from your source connectors to your DuckDB database. Simply select the DuckDB destination connector when setting up your data integration pipelines in Airbyte.

Step 3: Set up a connection to sync your Google Ads data to DuckDB

Once you've successfully connected Google Ads as a data source and DuckDB as a destination in Airbyte, you can set up a data pipeline between them with the following steps:

  1. Create a new connection: On the Airbyte dashboard, navigate to the 'Connections' tab and click the '+ New Connection' button.
  2. Choose your source: Select Google Ads from the dropdown list of your configured sources.
  3. Select your destination: Choose DuckDB from the dropdown list of your configured destinations.
  4. Configure your sync: Define the frequency of your data syncs based on your business needs. Airbyte allows both manual and automatic scheduling for your data refreshes.
  5. Select the data to sync: Choose the specific Google Ads objects you want to import data from towards DuckDB. You can sync all data or select specific tables and fields.
  6. Select the sync mode for your streams: Choose between full refreshes or incremental syncs (with deduplication if you want), and this for all streams or at the stream level. Incremental is only available for streams that have a primary cursor.
  7. Test your connection: Click the 'Test Connection' button to make sure that your setup works. If the connection test is successful, save your configuration.
  8. Start the sync: If the test passes, click 'Set Up Connection'. Airbyte will start moving data from Google Ads to DuckDB according to your settings.

Remember, Airbyte keeps your data in sync at the frequency you determine, ensuring your DuckDB data warehouse is always up-to-date with your Google Ads data.

Use Cases to transfer your Google Ads data to DuckDB

Integrating data from Google Ads to DuckDB provides several benefits. Here are a few use cases:

  1. Advanced Analytics: DuckDB’s powerful data processing capabilities enable you to perform complex queries and data analysis on your Google Ads data, extracting insights that wouldn't be possible within Google Ads alone.
  2. Data Consolidation: If you're using multiple other sources along with Google Ads, syncing to DuckDB allows you to centralize your data for a holistic view of your operations, and to set up a change data capture process so you never have any discrepancies in your data again.
  3. Historical Data Analysis: Google Ads has limits on historical data. Syncing data to DuckDB allows for long-term data retention and analysis of historical trends over time.
  4. Data Security and Compliance: DuckDB provides robust data security features. Syncing Google Ads data to DuckDB ensures your data is secured and allows for advanced data governance and compliance management.
  5. Scalability: DuckDB can handle large volumes of data without affecting performance, providing an ideal solution for growing businesses with expanding Google Ads data.
  6. Data Science and Machine Learning: By having Google Ads data in DuckDB, you can apply machine learning models to your data for predictive analytics, customer segmentation, and more.
  7. Reporting and Visualization: While Google Ads provides reporting tools, data visualization tools like Tableau, PowerBI, Looker (Google Data Studio) can connect to DuckDB, providing more advanced business intelligence options. If you have a Google Ads table that needs to be converted to a DuckDB table, Airbyte can do that automatically.

Wrapping Up

To summarize, this tutorial has shown you how to:

  1. Configure a Google Ads account as an Airbyte data source connector.
  2. Configure DuckDB as a data destination connector.
  3. Create an Airbyte data pipeline that will automatically be moving data directly from Google Ads to DuckDB after you set a schedule

With Airbyte, creating data pipelines take minutes, and the data integration possibilities are endless. Airbyte supports the largest catalog of API tools, databases, and files, among other sources. Airbyte's connectors are open-source, so you can add any custom objects to the connector, or even build a new connector from scratch without any local dev environment or any data engineer within 10 minutes with the no-code connector builder.

We look forward to seeing you make use of it! We invite you to join the conversation on our community Slack Channel, or sign up for our newsletter. You should also check out other Airbyte tutorials, and Airbyte’s content hub!

What should you do next?

Hope you enjoyed the reading. Here are the 3 ways we can help you in your data journey:

flag icon
Easily address your data movement needs with Airbyte Cloud
Take the first step towards extensible data movement infrastructure that will give a ton of time back to your data team. 
Get started with Airbyte for free
high five icon
Talk to a data infrastructure expert
Get a free consultation with an Airbyte expert to significantly improve your data movement infrastructure. 
Talk to sales
stars sparkling
Improve your data infrastructure knowledge
Subscribe to our monthly newsletter and get the community’s new enlightening content along with Airbyte’s progress in their mission to solve data integration once and for all.
Subscribe to newsletter

Connectors Used

What should you do next?

Hope you enjoyed the reading. Here are the 3 ways we can help you in your data journey:

flag icon
Easily address your data movement needs with Airbyte Cloud
Take the first step towards extensible data movement infrastructure that will give a ton of time back to your data team. 
Get started with Airbyte for free
high five icon
Talk to a data infrastructure expert
Get a free consultation with an Airbyte expert to significantly improve your data movement infrastructure. 
Talk to sales
stars sparkling
Improve your data infrastructure knowledge
Subscribe to our monthly newsletter and get the community’s new enlightening content along with Airbyte’s progress in their mission to solve data integration once and for all.
Subscribe to newsletter

Connectors Used

Frequently Asked Questions

What data can you extract from Google Ads?

Google Ads API provides access to a wide range of data related to advertising campaigns, including:  

- Campaigns: Information about the campaigns, such as name, status, budget, and targeting settings.

- Ad groups: Details about the ad groups, including name, status, and targeting criteria.

- Ads: Information about the ads, such as type, format, and performance metrics.

- Keywords: Data related to the keywords used in the campaigns, including search volume, competition, and performance metrics.

- Bidding: Details about the bidding strategies used in the campaigns, such as manual bidding or automated bidding.

- Conversions: Information about the conversions generated by the campaigns, including conversion rate, cost per conversion, and conversion tracking settings.

- Audience: Data related to the audience targeting used in the campaigns, such as demographics, interests, and behaviors.

- Location: Information about the geographic targeting used in the campaigns, including location targeting settings and performance metrics.  

Overall, the Google Ads API provides a comprehensive set of data that can be used to optimize advertising campaigns and improve their performance.

What data can you transfer to DuckDB?

You can transfer a wide variety of data to DuckDB. This usually includes structured, semi-structured, and unstructured data like transaction records, log files, JSON data, CSV files, and more, allowing robust, scalable data integration and analysis.

What are top ETL tools to transfer data from Google Ads to DuckDB?

The most prominent ETL tools to transfer data from Google Ads to DuckDB include:

  • Airbyte
  • Fivetran
  • Stitch
  • Matillion
  • Talend Data Integration

These tools help in extracting data from Google Ads and various sources (APIs, databases, and more), transforming it efficiently, and loading it into DuckDB and other databases, data warehouses and data lakes, enhancing data management capabilities.