Historical Ranking Data Integration

Historical Ranking Data Integration

Historical Ranking Data Integration Overview

The following steps will show you how to integrate a historical rank data into seoClarity so your domain’s data can be loaded into the platform. Historical ranking data integration may incur an additional cost depending on the contract agreement.

Background & Requirements

The most important requirement for integrating historical ranking data into seoClarity is to ensure the format provides all required data noted below. The file name should contain the domain and date for which the report belongs to. Reports should be specific to just one domain. 


Required Dimensions & Metrics

  • Date: The date of collection for the ranking data.
  • Keyword: The keyword that was rank tracked.
  • Search Engine: The search engine for the ranking data and can be Google, Bing, Yahoo, Yandex, or Baidu.
  • Location: The specific location that the ranking data belongs to. This is typically a country, though it could be a more specific location.  
  • Device: This is the device type used for the search engine specified and is either Desktop or Mobile. 
  • Rank: This is the position where the ranking URL was found for the keyword.
  • Ranking URL: The URL found ranking for the keyword in the search results.


Optional Dimensions & Metrics

  • Keyword Tags: The keyword tag groups for the keyword can be included where available. 
  • Search Volume: The search volume for the keyword from Google Keyword Planner.


Historical Ranking Data Integration Example 

The screenshot below is a 3 line sample file of a historical ranking file. It includes both the required metrics and some of the optional metrics.


Delivery Method

Ranking data can be delivered in a variety of ways, with e-mail and sFTP being the most commonly utilized options. The sFTP method is preferred and those profile specific credentials can be attained via the Integrations tab on the Settings page.

 



    • Related Articles

    • Standard API Data

      Standard API Overview seoClarity's API provides you programmatic access to a wealth of data, statistics and information collected by the seoClarity platform. The API is designed to be extremely simple to use and flexible to accommodate a wide range ...

    • Google Search Console Integration

      Google Search Console Integration Overview The objective of this integration is to authenticate a Google Search Console account within seoClarity. This integration takes the place of the previous Google Webmaster Tools integration. Background & ...

    • Adobe Analytics Integration

      Overview For Adobe Analytics integration, this article outlines the steps needed to run through in order to grant seoClarity access to your account. Adobe eVars (Conversion Variables) are not needed for the Partner Exchange integration. In the Adobe ...

    • Google Analytics Historical Data Retrieval via Flat File

      Overview The standard Google Analytics integration will retrieve daily historical data for the last 13 months prior to the date of authentication. The integration requires that the Google Analytics view that is integrated does not contain a ...

    • My Site Analytics has no data. What should I do?

      If you have a profile selected in your Site Analytics but see no data, it likely means you need to re-authenticate your Google Analytics 4 (GA4) integration with Site Analytics. Steps to Re-authenticate: For Admins: If you have an seoClarity Admin ...