Including STAT Experiences to Google Sheets Utilizing App Scripts


The creator’s views are totally his or her personal (excluding the unlikely occasion of hypnosis) and should not all the time replicate the views of Moz.

The workforce at MacMillan Search has generated a whole lot of worth by combining automated STAT studies with Google Sheets. From including rating particulars to different device’s outputs, to giving the content material groups up-to-date “Folks Additionally Ask” studies, the top consequence has confirmed to be an incredible time-saver in our week-to-week search engine marketing workflows by decreasing guide work and offering commonplace outputs that simply combine with any spreadsheet.

Why did we create this script?

STAT’s wealth of key phrase rankings particulars could be very helpful for enterprise SEOs to know each the macro and micro particulars of their rankings. Google Sheets is without doubt one of the commonest cloud-based spreadsheets platforms, and is straightforward to share between groups and organizations. That’s why SEOs use each of those instruments repeatedly when analyzing key phrase knowledge.

Regardless of this, documentation on learn how to combine STAT into Google Sheets is proscribed. To handle this hole, we created our personal script!

It’s confirmed helpful for a number of causes:

  1. Not everybody likes CSVs: We leverage the STAT studies to offer purchasers with route. Having to obtain a CSV and open it each week isn’t for everybody. With this script, you’ll be able to set a weekly ticket with a hyperlink to the spreadsheet, and evaluate the output repeatedly.

  2. It saved us time: search engine marketing is a marathon, not a dash. After we establish a chance, there may be ongoing work that may have us reviewing studies repeatedly. The weekly ticket strategy to evaluate a spreadsheet shaves a while off of every process, and over the course of the engagement, this saved time provides up.

  3. Cleaner output: Utilizing Vlookups, Uniques, and so on., you’ll be able to create a abstract web page of this info, highlighting what purchasers and/or readers care about. You too can combine this info with different knowledge sources.

  4. Create automation with out utilizing an API: Automation, when finished appropriately, saves time. Utilizing this script with triggers opens the door to automation.

Find out how to implement this script

1) Create a report in STAT

The STAT information base has a nice useful resource on studies. The one factor we’d get particular on is the naming of the report and the recipient electronic mail.


What you identify your report just isn’t as vital as maintaining it clear and concise. This makes scaling to different tasks with related studies cleaner and simpler. Additionally, you will use this report identify as one of many variables within the scripts.

We additionally counsel putting the corporate or undertaking identify on the finish of the report identify in parentheses (e.g. “(MacMillan Search)”). This makes it simpler to search out the report in your electronic mail.

Recipient electronic mail

It’s vital to make use of a Gmail-enabled electronic mail for the account the place you’ll be constructing the sheet. This manner, Google has a better time getting the app script to extract the CSV from the e-mail.


For our purchasers, weekly knowledge is probably the most helpful — sufficient element to identify traits, however not a lot that it turns into simply noise to be ignored. For studies with restricted fluctuations (e.g. Folks Additionally Ask), month-to-month may be passable.


Choose “Run this report instantly” to substantiate that your report works, proper after creating the script. This manner, you’re able to set your triggers and let the information move.

The remainder of the settings are particular to what particulars you need out of your report.

2) Create a Google Sheet and add the script

Create a brand new sheet in Google Drive underneath the account related along with your report’s recipient electronic mail. Then you definitely’re prepared so as to add the script:

1. Below the menu “Instruments”, choose “<> Script editor”

2. Paste the script under into the “Script editor”.

3. A couple of issues will have to be edited to work along with your knowledge:

  • var COMPANY_NAME up to date to the corporate or undertaking identify you used whereas creating the STAT Report

  • var REPORT_NAME up to date to the identify of your report minus the corporate identify and parentheses

  • var SHEET_NAME up to date to the identify of the sheet within the spreadsheet

4. Verify the Script works by saving it, refreshing the sheet, and when the menu “Handbook Replace” hundreds, choose “Import Key phrases”.

5. The primary time you run this you’ll get an “Authorization Required” pop-up:

Choose “Proceed”, comply with the steps, and choose “Import Key phrases” underneath the menu once more.

Your spreadsheet ought to now be populated with all the particulars out of your CSV.

3) Automate the inhabitants with triggers

Setting this sheet as much as mechanically replace because the report comes out could be very simple utilizing Apps Script “Triggers”. To arrange the triggers:

1. Return into the “Script Editor”

2. Choose the “alarm” icon “Triggers”

    3. Choose “Add Set off”

    4. Choose the perform “importKws”

    5. Choose occasion supply “Time-driven”

    6. Choose kind of time-based set off “Week Timer” for weekly studies, “Month Timer” for month-to-month studies, and so on.

    7. In our time zone, our studies normally come out late Sunday, so we decide early Monday morning:

    8. Click on “Save”

      The result’s a spreadsheet that repeatedly updates, populated by an emailed STAT report.

      We’ve discovered many makes use of for this script — anyplace we reference rank. And, since a undertaking may take time to get carried out, we will present present rating info with out leveraging the API.

      We’re curious to find out how you leverage it as properly. In case you discover the script helpful, attain out to us on LinkedIn and tell us what you’re utilizing it for.


Please enter your comment!
Please enter your name here