Documentation > Getting Started > 3rd Party Integration

Google Ads

To integrate Google Ads data directly into your Rank Ranger account, an authorization script needs to be generated and added to the Google Ads account. Two options are available: Daily Ads updates and Historical Ads data import and storage in your Rank Ranger account for use in reports and graphs.

Each Rank Ranger campaign can be integrated with one Google Ads account. Google Ads campaigns can be filtered in the report and metric graph settings.

Generate Daily Google Ads Data Script

Google Ads Connection Tool
The Google Ads connection script generation tool is located in Tools > Utilities > Misc.

Select a Campaign
Select the Daily option to enable daily updates of Google Ads data to Rank Ranger
Click the Generate button
Copy the Code
Proceed to the Authorize Google Ads Integration instructions below

Generate Historical Google Ads Data Script

Get Historical Ads Data for Reporting Trends

Select a Campaign
Select the Historical option for storage of Google Ads data
Select the Date Range for the data that you want imported to Rank Ranger
Click the Generate button
Copy the Code
Proceed to the Authorize Google Ads Integration instructions below

Authorize Google Ads Integration

Google Ads Tools
Access your Google Ads account and click the TOOLS icon and then select Scripts in the BULK ACTIONS section.

Add Script
Click the +Add script button

Authorize
Click the AUTHORIZE link in the yellow bar

Select a Google Account
This must be a Google account that has administrative permissions for Google Ads

Click the Allow button

Add Script
This example is for Historical update which is a one-time script.

Name the script, we recommend using a name that is descriptive of the data to help anyone working in the Google Ads account understand what the script is for.
Paste the Rank Ranger script code into the box, overwriting their default content
Click the SAVE link
Click Scripts

Additional Steps for Daily Updates
If this script is for DAILY updates, locate the new script in the list and click the pencil icon to edit it.

Set frequency to Daily and select a time and click Save
Click AUTHORIZE
Select the Google Account
Click the Allow button

Script Status
Click the SCRIPT HISTORY tab to view the scripts that have processed (i.e., Status will be "Finished successfully" and they will display data in the Results column)

Scripts Processed Today
Select Today in the calendar to determine if your new script has processed (it usually is not ready instantly, you may need to wait an hour).

Script Action Options
If your new script isn't displayed in the Script History for today within an hour of creating it, you can click back to the Scripts screen and in the Actions column select the Run option.

Google Ads Metrics

Ads performance data directly from the Google Ads API* can be viewed in the Google Ads Campaigns report, Insight Graphs, Single Metric Widgets, which can be displayed in branded Marketing Dashboards, Client Dashboards, and scheduled PDF Reports.
* Refer to integration instructions

Metric Options

Avg CPC: The average cost per click
Avg CPM: The average cost per thousand
Avg CPV: The average cost per view
Avg Pos: Average position helps describe how your Ad Rank compares with other ads. Ad Rank determines the order in which ads appear on the page. For more information on how your Ad Rank compares with other advertisers, check the Auction insights report.
Clicks: The number of times a link was clicked
Conversions: The number of conversions for all conversion actions that you have opted into optimization.
Conversion Rate: The number of conversions divided by total clicks that can be tracked to conversions.
Cost: The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
CTR: The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
Impressions: Count of how often your ad has appeared on a search results page or website on the Google Network.
Search Absolute Top Impression Share: The impressions you've received in the absolute top location (the very first ad above the organic search results) divided by the estimated number of impressions you were eligible to receive in the top location.
Search Budget Lost Impression Share: The estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low.
Search Impression Share: The impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive.
Search Rank Lost Impression Share: The estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank.
Search Top Impression Share: The impressions you've received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location.
Views: The number of times your ads were viewed.

Learn more... about Google Ads metrics.

Get the ultimate SEO tools with the Rank Ranger Software
Learn More About Rank Ranger

Search our Knowledge Base
	Search