Search our Knowledge Base
Search

Google Search Console (Webmaster Tools) Integration



You can connect your campaign to your Google Webmaster Tools / Search Console profile if you'd like to provide us with access to the following data for integration into your reports:
  • Traffic: Search Queries, Links to Your Site, Internal Links
  • Optimization: HTML Improvements, Content Keywords, Structured Data

Please note that there can be a 3-5 day delay between the time Google compiles this data and releases it via their API.

Google Webmaster Tools Search Console integration
 

Authorize Connection to Google Search Console

 
Integrate Google Search Console with Rank Ranger
  • Open Account Settings > Authorized Connections
  • Click the Add Connection button to expand the option list.
  • Click the Search Console button.

Google Search Console integration

Select the Account


If more than one Google account is accessed with the computer or device you're using, then Google will ask you to choose an account.

Select Google account


Permissions

Rank Ranger requires viewing and managing sites, keywords, and messages strictly for the purpose of integrating that data into your reports.  Review the permissions that need to be granted and click the Allow button if you agree.

Authorize Search Analytics data integration

More Info

Click the "i" icon to review more information regarding the account permissions. Click the OK button to close the window.

more information about Search Console permissions

Name the Search Console Connection

Enter a Connection Name (optional) that will make it easy for users to identify the account it corresponds to and click the Update button.

Edit Connection Name
 



Connect Campaign to Google Search Console

 
Search Console integration with your rank tracking campaign enables a variety of search queries reports and tools.

From the Home screen, click the Campaign Settings (gear) icon corresponding to the campaign you want to connect to a Google Search Console account and site.

In the left menu click Webmaster Tools
  • If the screen displays with no options for selecting a Search Console, then you need to follow the Authorize Google Search Console instructions above for adding a connection to your account.

    no Search Console connection

Select a Connection Name for the campaign and click the Connect button.

Next, select the Website URL that corresponds to the campaign primary domain and click the Connect button.

select Search Console website


Repeat for each domain in your Search Console account that you want to be connected to your Rank Ranger account.


Archive Search Console Data

 
Checking  Enable RangerBot to store your monthly Search Console history in the Historical Data Storage option will cause the following Search Console data to be stored based on calendar months without filters:
  • Daily totals for Clicks, Impressions, CTR, and Position
  • Unfiltered Keyword totals for up to 5000 queries
  • Unfiltered Landing Page totals for up to 5000 pages
Data storage begins the month following this option being enabled.


Google Search Console integration


To enable this option account-wide, open the Account Settings > Default Tool Settings screen and expand the Search Console section. Next, select the Default Enabled option and click the Save button.

Search Console history


Error: Account Access Already Granted

             
 

Search Console Account Access Already Granted

If while attempting to add a new connection you receive a notice indicating that "Access to this account has already been granted", it means that the Search Console account has already been authorized for connection to Rank Ranger.  This can mean that:
  • in your Authorized Connections screen, there are multiple Search Console connections and one of them is for the account you're trying to connect
  • a different Rank Ranger account is already connected to that Search Console account (e.g., your company has/had additional Rank Ranger accounts)
  • another user has authorized access to the Search Console account and has connected it to their Rank Ranger account.

Search Console connection exists


You can resolve this by following these steps:
  • Log out of Rank Ranger
  • Log in to the Google Search Console account that you're trying to connect to Rank Ranger
  • Click this Google Authorized Access Verification link to verify whether or not that account already has been authorized for Rank Ranger
    Note: there are two types of authorizations regarding Google, Search Console, and Analytics, and they will display separately.



    • If it displays Google Search Console access to Rank Ranger, then there is a different Rank Ranger account already using it.  In this case, we may need your help in determining who else has Owner or Full access to that Search Console account, in order for us to identify which Rank Ranger account it is (e.g., perhaps another company was granted access in the past for the websites in the account).
    • If it does not display a connection to Rank Ranger, then the next step is to verify that the email address you used to log into Search Console has been assigned Owner permissions.


Error: No Sites on Search Console

             
 

After connecting a Search Console account to a Campaign (General Settings > Search Console), if you receive a notice indicating that "You have no sites on Search Console", then:
  • the campaign may be connected to an expired Webmaster Tools account, in which case you need to connect to a valid Search Console account (Account Settings > Authorized Connections)
  • the Search Console account that was connected does not contain URLs, in which case you should log into the Search Console account for the domain you are trying to connect and confirm that the correct account was set up in Account Settings.

no sites on search console


Verify Search Console User Permissions

             
 
Manage Property

Google requires that connections "must be authorized by an authenticated user who has access to that data".   If the email address that you used to log into Search Console has Owner (or possibly Full) permissions, then you will see a Manage Property button beside each website. Select the Add or remove users option.
 
verify search console permissions



Users & Property Owners

Confirm that the User email address you are logged into (when making the Rank Ranger connection) has Owner or Full Permission.

verify search console user permissions


Which Reports & Graphs Use Search Console Data?


Authorizing a Google Search Console account connection with Rank Ranger integrates referral traffic and search query data directly into the following reports and graphs that can be viewed and added to white label marketing dashboards, client dashboards, and automated PDF Reports:

Does HTTPS Migration Affect Search Console Settings?


When you migrate your site from HTTP to HTTPS you will need to change your Search Console settings to the https version because Google considers each version of the website (i.e., http://domain.com, http://www.domain.com, https://domain.com, etc.) as separate properties. After Google has completed their crawl of the HTTPS, Search Console will stop providing data for the HTTP version and so you will need to disconnect the old HTTP and connect the HTTPS in our Campaign Settings > Webmaster Tools screen for each campaign that is changed.

Update Search Console Settings
After Google completes their crawl of the HTTPS version of the website, open the campaign settings > webmaster tools screen and click the Disconnect button next to the website address.

Disconnect old search console website property


Then select the HTTPS property and click the Connect button.

Campaign Settings > Webmaster Tools


Search Console Archived Data


If you have enabled the Historical Data Storage option prior to changing to HTTPS, that archived Search Console data will remain intact and begin fresh for the new version of the site.

Search Console Data Anomalies


The data displayed in our Search Console reports comes directly via Google's API based on your Search Console integration. If you notice that data seems to be missing, there are a smaller number of items or pages in results than expected, or a significant/unexplained drop in performance, please refer to Google's Data anomalies in Search Console page for an explanation.

Available Third Party Integrations


Third Party data can be used to create individual or blended metrics Insight Graphs and Single Metric Widgets and is also available in a wide variety of reports.
Authorize these Connections for comprehensive marketing reports and graphs: See a list of the available Third Party connections in the below "Related" section.

Google Search & Ad Metrics Glossary


The below-listed metrics are only for the Google Analytics Universal Profile connection.
Wondering what some of the Google metrics in our reports and graphs mean? 

Ad Clicks Displays the number of times viewers of a banner click on an ad to view the full offer.
All Users Total of new users and returning users for a given period of time.
Assisted Conversions Google's measure of any interaction, other than the final click, that led to a consumer converting on a website.
Assisted Value The total value of the conversions assisted by the channel.
Attribution The process of assigning credit for sales and conversions to touchpoints in conversion paths.
Attribution allows marketers to quantify each channel's contribution to sales and conversions. For example, many people may purchase on your site after searching for your brand on Google.
Refer to this Google Support document for more information.
Avg. Time on Site Displays the average length of time a visitor spent on a particular page or set of pages.
Avg. Value A calculation of Event Value / Total Events.
Bounce Rate Displays the percentage of single-page visits (i.e. visits in which the person left your site from the page they entered through without going deeper inside your site).
Completions The total number of users who have completed all elements defined for a particular goal.
Conversion A completed activity, online or offline, that is important to the success of your business. Examples include a completed sign-up for your email newsletter (a Goal conversion) and a purchase (a transaction, sometimes called an Ecommerce conversion).
Refer to this Google Support document for more information.
Conversion Rate The number of conversions is divided by the number of total ad clicks that can be tracked to a conversion during the same time period.
Cost The total cost of Google AdWords campaigns, in currency units defined by the Google account user.
Channel Grouping A roll-up of traffic sources in the Acquisition reports that groups several marketing activities together. Channel groupings allow you to view and compare aggregated metrics by channel name, as well as an individual traffic source, medium, or campaign name.
Refer to this Google Support document for more information.
CPC (Cost Per Click) Cost-per-click is the average cost an advertiser paid for each click on search ad(s).
CTR (Click Through Ratio) Displays the Click-through-ratio for an ad.  This is equal to the number of clicks divided by the number of impressions the ad received.
Dimension A descriptive attribute or characteristic of an object that can be given different values.
For example, a geographic location could have dimensions called Latitude, Longitude, or City Name. Values for the City Name dimension could be New York, London, etc.
Refer to this Google Support document for more information.
Event A type of hit used to track user interactions with content. Examples of user interactions commonly tracked with Events include downloads, mobile ad clicks, gadgets, Flash elements, AJAX embedded elements, and video plays.
Refer to this Google Support document for more information.
Event Value A calculation of Total Event * Value.
Exit Rate How often do users end their session or leave the site after viewing a particular page
Goal A configuration setting that allows you to track the valuable actions, or conversions, that happens on a site or mobile app.
Goals allow you to measure how well your site or app fulfills your target objectives.
Refer to this Google Support document for more information.
Hits An interaction that results in data being sent to Analytics. Common hit types include page tracking hits, event tracking hits, and e-commerce hits.
Each time the tracking code is triggered by a user’s behavior (for example, the user loads a page on a website or a screen in a mobile app), Analytics records that activity. Each interaction is packaged into a hit and sent to Google’s servers.
Refer to this Google Support document for more information.
Impressions (Ads) The measurement of how many times an ad is shown.
Impressions (Search Console) An impression is the display of a website link in search results or an advertisement. This metric accounts for the total number of impressions recorded by Google for a website or ad campaign.
Last Interaction Conversions The ratio of assisted/last interaction conversions. This is a number that indicates whether this channel primarily results in last interaction conversions or is predominantly assisted conversions. Numbers of 1.5 and higher indicate that this channel is predominantly accounting for assisted conversions, while numbers closer to 0 indicate the channel’s contribution to conversions is predominantly as the last interaction.
Last Interaction Value The total value of the conversions completed by the listed channels.
Metric Individual elements of a dimension that can be measured as a sum or a ratio.
For example, the dimension City can be associated with a metric like Population, which would have a sum value of all the residents of the specific city.
Refer to this Google Support document for more information.
New Users New Users is based on Google's ga:newUsers metric and represents the number of sessions marked as a user's first sessions.
New Users % New Users % is based on Google's ga:percentNewSessions metric that represents the percentage of sessions by users who had never visited the site before. It does not represent the number of new users between one period and the previous. In this Google Developer document, it is described as the calculation of ga:newSessions / ga:sessions
New Visits Displays the number of new visits by people who have never been to the site before.
Organic Traffic Number of users who find your website ‘organically’ through search results, as opposed to via a paid ad, clicking a link on another site, or from a bookmark they already have saved.
Paid Traffic Number of visitors to your site who came there via Google Ads, paid search keywords and other online ad campaigns.
Pageviews An instance of a page being loaded (or reloaded) in a browser.
Pageviews is a metric defined as the total number of pages viewed.
Refer to this Google Support document for more information.
Permission The right to perform administrative and configuration tasks, to create and share assets, and to read and interact with report data.
Refer to this Google Support document for more information.
Property A sub-component of an Analytics account that determines which data is organized and stored together.
Refer to this Google Support document for more information.
Revenue Specifies the total revenue or grand total associated with the transaction (e.g. 11.99). This value may include shipping, tax costs, or other adjustments to total revenue that you want to include as part of your revenue calculations.
Roll-Up Reporting A feature of Roll-Up Properties, which aggregate data from multiple source properties into a single property.
Refer to this Google Support document for more information.
Sampling The practice of selecting a subset of data from your traffic and reporting on the trends detected in that sample set.
Refer to this Google Support document for more information.
Segment A subset of sessions or users that share common attributes.
Segments allow you to isolate and analyze groups of sessions or users for better analysis.
Refer to this Google Support document for more information.
Session The period of time a user is active on your site or app.
By default, if a user is inactive for 30 minutes or more, any future activity is attributed to a new session.
Refer to this Google Support document for more information.
Sessions with Event The number of sessions during which an Event was recorded.
Source / Medium Source: the origin of your traffic, such as a search engine (for example, google) or a domain (example.com).
Medium: the general category of the source, for example, organic search (organic), cost-per-click paid search (cpc), web referral (referral).
Refer to this Google Support document for more information.
Tags Referring to Google Tag Manager, a Tag is a snippet of JavaScript that sends information to a third party, such as Google. The Analytics tracking code is an example of a tag.
Refer to this Google Support document for more information.
Total Events A total of Events (executions of a specific action) that occurred on a website during a specified period of time.
Unique Events The number of unique events that occurred on a website during a specific period of time.
Unique Page Views The number of times a page was viewed during a specific time period.
Views The number to views a website or specific web page received during a report period.
Visits By Medium Displays the number of visits by medium through which your site was reached. For example, every referral to a website also has a medium. Possible mediums include: "organic” (unpaid search), "cpc” (cost per click, i.e. paid search), "referral” (referral), "email” (the name of a custom medium you have created), "none” (direct traffic has a medium of "none”).
Visits By Source Displays the number of visits by source that brought visitors to your website. For example, every referral to a web site has an origin, or source. Possible sources include: "google” (the name of a search engine), "facebook.com” (the name of a referring site), "spring_newsletter” (the name of one of your newsletters), and "direct” (users that typed your URL directly into their browser, or who had bookmarked your site).

We will update this periodically, but in the meantime if there are metrics you're curious about that aren't listed in this glossary, please refer to this Google support document.


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