If you need help using the Data Studio Connector, you're in the right place. Here's what we'll cover:

1

Does my subscription give me access to the Data Studio Connector?

To use the connector, your plan must contain the Data Studio feature. You can check if this is the case by looking for your Data Studio API key: if you have access to the Data Studio connector, you'll be able to find your key using the steps described just below.

If you have any doubts or if your plan does not contain the Data Studio feature, click on the blue button at the bottom right of your screen and ask to speak with the sales team (from the suggested answers).

2

Where can I find my Data Studio access key?

Note that the access key for Data Studio is different from the OnCrawl API key. Having the API feature does not imply access to Data Studio.

  • In OnCrawl, click on your username in the top right corner to open the dropdown user menu.
  • Click on Account.
  • On the account page, click on Tokens in the left-hand sidebar.

You can find your Data Studio access key on this page:

You'll need this key to access the connector in Data Studio.

You can also find the Data Studio access key in the crawl settings when you activate the export of all future crawls with a given crawl profile.

If you're stuck on the next steps, here's some help on getting the connector set up.

3

How can I select the OnCrawl data to send to Data Studio?

There are two ways to get crawl data from OnCrawl via the Data Studio connector:

  • Send new analyses to Data Studio as they're created:
    - From the project home page, click Set up a new crawl.
    - Scroll down to the Analysis section.
    - Expand the Export to settings.
    - Tick the Enable export to Data Studio checkbox.

    Once the crawl has been launched and completed, the data will be available via the connector.

This will automatically connect all future analyses with this crawl profile to Data Studio.

  • Send completed analyses to Data Studio after they've finished:
    - From the project home page, scroll down to the list of crawl reports (at the bottom of the screen).
    - Choose the crawl you want to be available in Data Studio and click on the three buttons on the right side of the screen. This opens a menu.
    - Click on Export to Data Studio. The screen will update automatically and you will see that the export is in progress.

    If your crawl is archived, you won't see this option; you'll need to unarchive it first.

The time it takes to export data from OnCrawl to Data Studio depends on the number of URLs that have been crawled.

Note: Please wait until the export has finished to view the data in Data Studio. If no exports have been completed yet, you'll see an error when you try to add a chart in Data Studio. This error will be resolved automatically when the export finishes.

If you're stuck on the next steps, here's some help on getting the connector set up.

4

What data is available?

The OnCrawl data source includes:

A list of fields is available at http://developer.oncrawl.com/#Fields

5

How does the connector's quota work?

Also from the Account window (Summary tab), you have access to new information to track your Data Studio quota. The operation is the same as for your quota of URLs :

  • It works on a monthly basis.
  • The quota is updated every month, on the anniversary date of your subscription.

Look for the line: Monthly Data Studio query usage. You have up to 1TB per month.

For example, if you see 1.82 GB of 1 TB, it means that you have consumed 1.82 GB out of your monthly total of 1 TB.

If you run out before the end of the month and need more quota immediately, please contact us.

6

Are there any tips and tricks?

Counting URLs

The best way to get the number of URLs in a crawl is: URL count with a filter for the Crawl_ID you're interested in. Why? This method contains the least amount of calculation behind the scenes!

Sharing

If you share a report created in Data Studio, consider setting the Data Source to use Viewer Credentials. This prevents any calculations carried out by viewers from affecting your quota.

Scraping / Custom fields

If you need to change the type of a custom field (example: text to number, or number to date) after sending it to Data Studio, you should create a new field. Changing a custom field's type in OnCrawl after its data has been sent to Data Studio can prevent the field from working in Data Studio.

7

Is there a template?

Yes, there are templates!

First, we've included a template to get you started. When setting up your connector as a data source, make sure the option "Use report template for new reports" is checked (this is the default state).

When you create a report from the data source page by clicking on Create report, the template we've included will automatically be used:

Our sales and support teams can also make additional templates available to combine OnCrawl data with data from other connectors and harness the power of cross-analysis from within Data Studio.

8

How can I fix common Data Studio errors?

Q. I set up and selected the OnCrawl dataset but Data Studio says it doesn't have any data.

A. This usually occurs if you haven't exported any crawls to Data Studio, or if you haven't waited for your first export to finish. Usually this is fixed by waiting. You can check the status of the export of older crawls by checking your project home page in OnCrawl.

Q. OnCrawl says I have too many segmentations.

A. In the rare case that you see a message that you can't export a crawl because you have too many segmentations, please contact us using the blue chat button in OnCrawl. We'll help sort you out in just a few minutes.

9

Where can I get more help?

Here's some help on getting the connector set up.

Please contact us with questions or to report an issue with the OnCrawl Data Studio connector by clicking on the blue chat button at the bottom right of the screen. This button appears if you are logged in to OnCrawl.

Did this answer your question?