> ## Documentation Index
> Fetch the complete documentation index at: https://www.integrate.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ETL: Google Ads Source

> Configure the Google Ads source component to read advertising report data from your Google Ads account in Integrate.io ETL data pipelines.

## Connection Setup

## To create a Google Ads connection in Integrate.io ETL

<Steps>
  <Step>
    Click the **Connections** icon (lightning bolt) on the top left menu.
  </Step>

  <Step>
    To create a connection, click **New** connection.

    <Frame>
      <img src="https://mintcdn.com/integrateio/XpeHmuMzUiEmfOEz/images/connectivity-and-security/image-152.webp?fit=max&auto=format&n=XpeHmuMzUiEmfOEz&q=85&s=fc5b660a8e109ef5f88cf630df59b580" alt="Connections page with New connection button" width="1200" height="829" data-path="images/connectivity-and-security/image-152.webp" />
    </Frame>
  </Step>

  <Step>
    Choose Google Ads.

    <Frame>
      <img src="https://mintcdn.com/integrateio/XpeHmuMzUiEmfOEz/images/connectivity-and-security/image-153.webp?fit=max&auto=format&n=XpeHmuMzUiEmfOEz&q=85&s=da99b12c23ea1ac432719e2acb15eb0e" alt="Selecting Google Ads from the connection type list" width="1200" height="829" data-path="images/connectivity-and-security/image-153.webp" />
    </Frame>
  </Step>

  <Step>
    Click **Authenticate**.

    <Frame>
      <img src="https://mintcdn.com/integrateio/XpeHmuMzUiEmfOEz/images/connectivity-and-security/image-154.webp?fit=max&auto=format&n=XpeHmuMzUiEmfOEz&q=85&s=edab677e6b22c34e59ef350165e232e5" alt="Google Ads connection dialog with Authenticate button" width="1200" height="829" data-path="images/connectivity-and-security/image-154.webp" />
    </Frame>
  </Step>

  <Step>
    In the Google account window, choose an existing Google account or click **Add account** to create a new Google account.
  </Step>

  <Step>
    In the next Google window click **Accept** to authorize Integrate.io ETL access.
  </Step>

  <Step>
    In the new Google Ads connection window, name the connection and click **Create connection.**

    <Frame>
      <img src="https://mintcdn.com/integrateio/XpeHmuMzUiEmfOEz/images/connectivity-and-security/image-155.webp?fit=max&auto=format&n=XpeHmuMzUiEmfOEz&q=85&s=24672ff21b6aaa241f9de38b800ab7d8" alt="Naming the Google Ads connection" width="1200" height="829" data-path="images/connectivity-and-security/image-155.webp" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/integrateio/XpeHmuMzUiEmfOEz/images/connectivity-and-security/image-156.webp?fit=max&auto=format&n=XpeHmuMzUiEmfOEz&q=85&s=b52902ddb63f074ae0c8e6b93a9942b0" alt="Google Ads connection created successfully" width="1200" height="829" data-path="images/connectivity-and-security/image-156.webp" />
    </Frame>
  </Step>
</Steps>

## To modify a Google Ads connection in Integrate.io ETL

<Steps>
  <Step>
    Click the Connections icon (lightning bolt) on the top left menu.
  </Step>

  <Step>
    Click a connection to open and modify it. Make any necessary changes, then click Reconnect, and Save changes. To exit the Google Ads connection window without changes, click Back to connections (grey tab on the left side) on the Google Ads connection window.
  </Step>

  <Step>
    To delete a Google Ads connection, click on the three vertical dots on the far right of the connection listing and select the Delete connection option.

    <Frame>
      <img src="https://mintcdn.com/integrateio/XpeHmuMzUiEmfOEz/images/connectivity-and-security/image-157.webp?fit=max&auto=format&n=XpeHmuMzUiEmfOEz&q=85&s=fcf4bc70db64c999c57881718cb8e10e" alt="Delete connection option for Google Ads" width="1200" height="829" data-path="images/connectivity-and-security/image-157.webp" />
    </Frame>
  </Step>
</Steps>

***

<Note>
  **Note:**

  Ad blockers may block html and javascript elements that mention Ads. We recommend that you disable your ad blocker or make an exception for Integrate.io ETL.
</Note>

<Frame>
  <img src="https://mintcdn.com/integrateio/OwEKdS5aIKsEcmhX/images/creating-packages/using-components-google-ads-source/image-1.png?fit=max&auto=format&n=OwEKdS5aIKsEcmhX&q=85&s=dc2be2965f2cf563ae736c9df2d7ef83" alt="Google Ads source component in the pipeline designer" width="1200" height="828" data-path="images/creating-packages/using-components-google-ads-source/image-1.png" />
</Frame>

## Connection

Select an existing Google Ads connection or create a new one.

## Source Properties

<Frame>
  <img src="https://mintcdn.com/integrateio/OwEKdS5aIKsEcmhX/images/creating-packages/using-components-google-ads-source/image-2.png?fit=max&auto=format&n=OwEKdS5aIKsEcmhX&q=85&s=588aff02e9d1aa83b1dfd55196fe6683" alt="Google Ads source properties with API version, report type, and date range" width="1200" height="828" data-path="images/creating-packages/using-components-google-ads-source/image-2.png" />
</Frame>

* **API Version** - Integrate.io ETL will use the selected Ads API version when running the job. Google releases a new API version every few months and [sunsets older versions of the API](https://developers.google.com/google-ads/api/docs/sunset-dates?hl=en). You should check and update the API versions periodically.
* **Report type** - Select a report type from the dropdown list of reports. See [this article](https://developers.google.com/google-ads/api/docs/migration/mapping?hl=en) to map reports to Google AdWords UI. **Note: For structure reports, select "All time" in date range. We are using report types from the old version of Google Adwords.**
* **Date range** - Select a date range from the dropdown list of ranges. If you select `custom date range...`, you will be prompted to enter From date and To date. Click on either inputs and select the dates from the calendar. You can also use variables as values for the custom date range in the format `yyyyMMdd`.
* **customer ids** - Leave empty to read data for all Ads customer account ids accessible to the connection or use a comma separated list of Ads customer account ids. The account ids appear in the top right corner of your Ads page or are managed by Ads Manager (MCC). If you provide an MCC account's customer id, the report will be executed for all the Ads accounts it has access to. Customer ids appear in the format nnn-nnn-nnnn (e.g. 123-456-7890)

## Source Schema

<Frame>
  <img src="https://mintcdn.com/integrateio/OwEKdS5aIKsEcmhX/images/creating-packages/using-components-google-ads-source/image-3.png?fit=max&auto=format&n=OwEKdS5aIKsEcmhX&q=85&s=15a7d9f3e545a497590ddf9a2d91430f" alt="Google Ads source schema with field selection" width="1200" height="828" data-path="images/creating-packages/using-components-google-ads-source/image-3.png" />
</Frame>

After defining the Ads report, select the fields to use in the source.

<Note>
  **Note:**

  Some fields are not compatible with other fields in the same report. Refer [here](https://developers.google.com/google-ads/api/docs/migration/mapping?hl=en) for more information. Please contact us if there are missing fields on the Ads source components
</Note>

## Related

<CardGroup cols={2}>
  <Card title="Google Ads Destination" icon="arrow-right" href="/etl/using-components-google-ads-destination" horizontal />
</CardGroup>