Google Ads

Google Ads connections give you access to your company’s campaign and advertisement data.

Source Setup

We use OAuth to authenticate with Google Ads. When creating a connection, you will be redirected to your Google Ads account to authorize Etleap to extract data. Before setting up a new connection, please perform the following steps to verify that you have the required information.

Log in to your Google Ads account.
Navigate to the top right corner and locate your 10-digit Customer ID.
Copy the Customer ID. When copying it over to Etleap at the connection setup screen, please remove the hyphens.
If you have a manager Customer ID, you’ll be able to extract data from all the other IDs associated with it.

Note

Prefer using an API? Go here and select Google Ads under the Body header to start creating a connection via API.

What Data is Available?

Note

Update-Mode Deletes Support

Deletes are not applicable for this connector as pipelines handle reporting rather than entity data.

Google Ads connections provide reports and entities to start building pipelines with. Reports contain selectable fields, metrics, segments, and attributed resources. Entities return all the available fields, without metrics and additional segmentation options.

You can create Google Ads pipelines with the following reports:

Entity	Pipeline Mode
Report: Ad Group	Update
Report: Ad Group Ad	Update
Report: Ad Group Ad Asset Combination View	Update
Report: Ad Group Ad Asset View	Update
Report: Ad Group Asset	Update
Report: Ad Group Audience View	Update
Report: Ad Schedule View	Update
Report: Age Range View	Update
Report: Asset Field Type View	Update
Report: Asset Group Product Group View	Update
Report: Bidding Strategy	Update
Report: Campaign	Update
Report: Campaign Asset	Update
Report: Campaign Audience View	Update
Report: Campaign Budget	Update
Report: Campaign Group	Update
Report: Click View	Update
Report: Conversion Action	Update
Report: Customer	Update
Report: Customer Asset	Update
Report: Detail Placement View	Update
Report: Display Keyword View	Update
Report: Distance View	Update
Report: Dynamic Search Ads Search Term View	Update
Report: Expanded Landing Page View	Update
Report: Extension Feed Item	Update
Report: Feed Item	Update
Report: Feed Placeholder View	Update
Report: Gender View	Update
Report: Geographic View	Update
Report: Group Placement View	Update
Report: Hotel Group View	Update
Report: Hotel Performance View	Update
Report: Hotel Reconciliation	Update
Report: Income Range View	Update
Report: Keyword View	Update
Report: Landing Page View	Update
Report: Location View	Update
Report: Managed Placement View	Update
Report: Paid Organic Search Term View	Update
Report: Parental Status View	Update
Report: Product Group View	Update
Report: Search Term View	Update
Report: Shopping Performance View	Update
Report: Smart Campaign Search Term View	Update
Report: Topic View	Update
Report: User Location View	Update
Report: Video	Update
Report: Webpage View	Update

You can create Google Ads pipelines with the following entites:

Entity	Pipeline Mode
ACCESSIBLE BIDDING STRATEGY	Replace
ACCOUNT BUDGET	Replace
ACCOUNT BUDGET PROPOSAL	Replace
ACCOUNT LINK	Replace
AD GROUP AD LABEL	Replace
AD GROUP BID MODIFIER	Replace
AD GROUP CRITERION	Replace
AD GROUP CRITERION CUSTOMIZER	Replace
AD GROUP CRITERION LABEL	Replace
AD GROUP CRITERION SIMULATION	Replace
AD GROUP CUSTOMIZER	Replace
AD GROUP EXTENSION SETTING	Replace
AD GROUP FEED	Replace
AD GROUP LABEL	Replace
AD GROUP SIMULATION	Replace
AD PARAMETER	Replace
ASSET	Update
ASSET GROUP	Replace
ASSET GROUP ASSET	Replace
ASSET GROUP LISTING GROUP FILTER	Replace
ASSET SET	Replace
ASSET SET ASSET	Replace
BATCH JOB	Replace
BIDDING DATA EXCLUSION	Replace
BIDDING SEASONALITY ADJUSTMENT	Replace
BIDDING STRATEGY SIMULATION	Replace
BILLING SETUP	Replace
CALL VIEW	Replace
CAMPAIGN ASSET SET	Replace
CAMPAIGN BID MODIFIER	Replace
CAMPAIGN CONVERSION GOAL	Replace
CAMPAIGN CRITERION SIMULATION	Replace
CAMPAIGN CUSTOMIZER	Replace
CAMPAIGN DRAFT	Replace
CAMPAIGN EXPERIMENT	Replace
CAMPAIGN EXTENSION SETTING	Replace
CAMPAIGN FEED	Replace
CAMPAIGN LABEL	Replace
CAMPAIGN SHARED SET	Replace
CAMPAIGN SIMULATION	Replace
CARRIER CONSTANT	Replace
COMBINED AUDIENCE	Replace
CONVERSION CUSTOM VARIABLE	Replace
CONVERSION GOAL CAMPAIGN CONFIG	Replace
CONVERSION VALUE RULE	Replace
CONVERSION VALUE RULE SET	Replace
CURRENCY CONSTANT	Replace
CUSTOMER ASSET	Replace
CUSTOMER CLIENT	Replace
CUSTOMER CLIENT LINK	Replace
CUSTOMER CONVERSION GOAL	Replace
CUSTOMER CUSTOMIZER	Replace
CUSTOMER EXTENSION SETTING	Replace
CUSTOMER FEED	Replace
CUSTOMER LABEL	Replace
CUSTOMER MANAGER LINK	Replace
CUSTOMER NEGATIVE CRITERION	Replace
CUSTOMER USER ACCESS	Replace
CUSTOMER USER ACCESS INVITATION	Replace
CUSTOMIZER ATTRIBUTE	Replace
CUSTOM AUDIENCE	Replace
CUSTOM CONVERSION GOAL	Replace
CUSTOM INTEREST	Replace
DETAILED DEMOGRAPHIC	Replace
DOMAIN CATEGORY	Replace
FEED	Update
FEED ITEM SET	Replace
FEED ITEM SET LINK	Replace
FEED MAPPING	Replace
GEO TARGET CONSTANT	Replace
KEYWORD PLAN	Replace
KEYWORD PLAN AD GROUP	Replace
KEYWORD PLAN AD GROUP KEYWORD	Replace
KEYWORD PLAN CAMPAIGN	Replace
KEYWORD PLAN CAMPAIGN KEYWORD	Replace
LABEL	Replace
LANGUAGE CONSTANT	Replace
LIFE EVENT	Replace
MEDIA FILE	Replace
MOBILE APP CATEGORY CONSTANT	Replace
MOBILE DEVICE CONSTANT	Replace
OFFLINE USER DATA JOB	Replace
OPERATING SYSTEM VERSION CONSTANT	Replace
PRODUCT BIDDING CATEGORY CONSTANT	Replace
RECOMMENDATION	Replace
REMARKETING ACTION	Replace
SHARED CRITERION	Replace
SHARED SET	Update
SMART CAMPAIGN SETTING	Replace
TOPIC CONSTANT	Replace
USER INTEREST	Replace
USER LIST	Replace

Key Considerations

The Report: Click View resource only returns data from a single day and only stores data from the last 90 days.
Google Ads can refresh your data from the last 30 days, which means that in delta-mode we always fetch data from 30 days ago.
During the initial catch-up, Etleap starts extracting data from your Google Ads account from the early 2000s. This is to make sure the pipeline extracts all the data available in your account. The initial extractions might be empty, as most Google Ads accounts do not have data populated from that time period. Once the pipeline reaches a time period with data in your Google Ads account, it will successfully start to extract it.