Search our Knowledge Base
Search

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.
 
Google Ads Connection Tool
 

Generate Daily Google Ads Data Script

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

Google Ads Daily Updates        
  • 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

Integrate Historical Google Ads data

  • 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. 

Google Ads Tools Scripts

Add Script
Click the +Add script button 

add script

Authorize
Click the AUTHORIZE link in the yellow bar 

Authorize script

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

select Google account

Click the Allow button

allow access



Add Script

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

add Google Ads 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. 

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

    choose account

  • Click the Allow button

    Authorize script


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)             
Google Ads Scripts

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).
             
scripts today

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. 

Script action options



Google Ads Metrics


Ads performance data directly from the Google Ads API* can be viewed in the Google Ads Campaigns report, Insight GraphsSingle 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