Advice and answers from the Advanced Web Ranking Team
Search for articles
>
>
How to Report on AI Search Visibility: The AWR AI Search Connector for Data Studio
Connect AWR AI Search to Data Studio (formerly Looker Studio) and report ChatGPT, Gemini, AI Mode and AI Overviews visibility from a five-page template.
Bring your ChatGPT, Gemini, Google AI Mode and AI Overviews visibility from AWR into Data Studio, and start from a ready-made five-page report template.
TL;DR
The AWR AI Search connector sends the data of an AI Search project in Advanced Web Ranking (AWR) to Data Studio, formerly Looker Studio: brand performance, prompts, citations and web mentions, with the same numbers as AWR. It's available on Agency and Enterprise plans and all yearly subscriptions. Four steps get you to a filled report:
Copy your API token in AWR, under Settings > Integrations & Exports > Google Data Studio.
Open the AI Search connector from the same card, authorize it and paste your token.
Choose a project and, if you like, narrow it by model, location, persona, topic, prompt type, intent or tag.
Create a report from the template, then shape it for your audience.
Your client's monthly report already covers rankings, traffic and conversions. Then comes the question you hear more often every month: "How do we show up in ChatGPT?"
Until now, that answer lived in the AI Search reports in AWR, while the rest of the story lived in Data Studio. The AWR AI Search connector brings the two together. It sends the brand performance, prompts, citations and web mentions of an AI Search project to Data Studio, with the same numbers you see in AWR.
What this article covers
Before You Start
You need three things:
An AWR account with API access. The connector is available on Agency and Enterprise plans and all yearly subscriptions. New to AWR? See the plans.
A project tracked in AWR AI Search, with at least one AI engine: ChatGPT, Gemini, Google AI Mode or Google AI Overviews. New to the module? Meet AI Search explains it and its five reports.
A Google account to sign in to Data Studio.
Already using the AWR rankings connector? Keep it. The two connectors work side by side in the same report, and one API token serves both.
1. Copy Your AWR API Token
The connector signs in to AWR with your API token, so that's the first thing to grab.
In AWR, open Settings > Integrations & Exports.
Find the Google Data Studio card.
Under Copy your API token, click Copy API token
1.

The Google Data Studio card in AWR: Copy API token (1) and Open AI Search connector (2)
Treat the token like a password. Anyone who has it can read your AWR data, so paste it only into the connector.
2. Connect a Project in Data Studio
Each data source reads one AI Search project. Here's how to create one:
On the same Google Data Studio card, click Open AI Search connector
2. You can also open Data Studio, choose Create > Data source and search for AWR AI Search.Click Authorize
1and allow the connector to connect to an external service. That's how it reaches AWR.
Authorize the connector the first time you use it
Paste your API token into the Key field
1and click Submit2. Data Studio keeps it for your Google account, so you enter it once, however many projects you connect.
Paste the API token you copied from AWR into the Key field
Choose a Project
1and click Next2. Leave Use report template for new reports ticked3.
Choose the AI Search project this data source reads
Optionally, narrow the data with the seven settings
1. They work like the filters in the AI Search reports:SETTING
WHAT IT NARROWS
Model
The AI engines: ChatGPT, Gemini, Google AI Mode, Google AI Overviews
Location
The locations your prompts are tracked in
Persona
The personas your prompts are asked as
Topic
The topics your prompts are grouped in
Prompt type
The types AWR assigns to your prompts
Intent
The search intent behind your prompts
Tag
Your own prompt tags
Leave a setting empty, or pick its "All" option (All models, All locations and so on), to include every value, including ones you add later. Ticking every name instead freezes today's list.
To let report editors change a setting later, tick its Allow ... to be modified in reports box
2. The project is the exception: a data source always reads the project it was connected to, so nobody can point your report at another project.Keep Use report template for new reports ticked
3and click Connect4.
The seven settings (1), the boxes that open them to report editors (2), the template box (3) and Connect (4)
Check the list of fields and click Create Report
1.
The fields of the AWR AI Search data source, and Create Report (1)
3. Start From the Report Template
You don't have to build anything from scratch. Use report template for new reports is ticked by default on the connector page. Leave it ticked, and Create Report opens a copy of the AWR template filled with your project's data.
The template has one page per AI Search report: Overview, Prompts, Answers, Citations and Web Mentions. Every page has a date range control, set to the last 30 days, and seven filters: Model, Location, Persona, Topic, Prompt type, Intent and Tag. The Citations and Web Mentions pages add Relationship and Nature.
Each page shows the same figures as the matching report in AWR, for the same dates and filters. Add your logo, remove what your audience doesn't need, and change the charts as you like. The copy is yours.
What You'll Find on Each Page of the Template
Each page mirrors the AWR report of the same name. The numbers below match the callouts in the screenshots.
Overview

The Overview page of the AWR AI Search report template
Filters - narrow every page by model, location, persona, topic, prompt type, intent or tag.
Date range - sets the period for every page.
KPI cards - your brand's Visibility score, Share of voice, Average position, Sentiment and Citation share for the period.
Metric trend - one metric of your brand day by day, whichever you pick. By default it shows Visibility score. To follow another metric, hover the chart, click its Optional metrics icon and pick Share of voice, Average position, Sentiment or Citation share. Report viewers can switch it too. To change the metric everyone sees first, edit the report, select the chart and pick another metric in the Setup panel.
Dimension control - ranks the brands you track by Visibility score in the table below it. Switch it to Model to rank the AI engines instead.
Prompts

The Prompts page: prompt type and intent, and every prompt with its metrics
Prompt Type - how your prompts split between types, such as Organic and Brand Specific.
Intent - how they split by search intent, such as Informational and Commercial.
Prompts - every prompt with its topic and type, its Visibility score, Share of voice, Average position, Sentiment and Citation share, and the number of personas and locations it's asked for.
Mentions - the brands named in the answers to each prompt.
Answers

The Answers page: how positively AI answers speak about your brand
Sentiment Score trend - how positively AI answers speak about your brand, day by day.
Sentiment score - the score for the whole period.
Sentiment by Prompt Type - the score for each prompt type, so you can see whether answers to brand questions read differently from organic ones.
Citations

The Citations page: the sources AI engines rely on
Relationship and Nature - two extra filters. Relationship picks your own sites (Owned), your competitors' sites (Competitor) or everyone else's (Third-party). Nature picks the kind of site, such as Earned Media, Social or Review Platform.
Top Cited Domains - the domains AI engines cite most, by number of citations.
Domain Ranking - every cited domain with its citations share and total citations.
Citations by Relationship - how citations split between your sites, your competitors' sites and third-party sites.
Citations by nature - the same split by kind of site.
Citations - every cited domain with its domain type, citations share, cite position and the number of prompts that cite it. Mentions you shows how many of its cited pages name your brand, such as "3 of 4".
Web Mentions

The Web Mentions page: the brands named on the pages AI engines cite
Relationship and Nature - the same two filters as on the Citations page.
Web mentions by brand - how often the pages AI engines cite mention each brand you track.
Brand ranking - each brand's share of all mentions, and its total.
Pages by domain type and brand - which kinds of sites mention which brands. The darker the cell, the more pages.
Sources - the cited sites, with their domain type, citations share and cite position, how many competitors their pages name and how many of their pages mention you.
Five Ways to Use AI Search Data in Data Studio
The template is a starting point. These are the reports teams build most often once the data is in Data Studio.
1. Add AI visibility to the client report you already send
Copy the Overview's KPI cards onto a page of your existing report, next to your rankings from the AWR rankings connector, Google Analytics or Search Console. Each chart reads its own data source, so one report can tell the whole story: where the client ranks, what traffic that brings, and how often AI engines recommend them.
Then let Data Studio's scheduled delivery email the report every month, so the numbers reach your client without a manual export.
2. Compare AI engines side by side
Your brand rarely performs the same everywhere. On the Overview page, switch the Dimension control above the ranking table from Brand to Model to rank the AI engines by your visibility score. In one glance, you see where you're strong, in ChatGPT for example, and where you trail, such as Google AI Mode.
Pick a single engine in the Model filter to see every page through that engine only.
3. See where competitors win
The brand ranking on the Overview page lists every competitor you track by visibility score, next to your own brand. On the Prompts page, the Mentions column shows which brands each answer names. Sort the table by visibility score and look for the prompts where your competitors appear and you don't. Those are the conversations to win next.
4. Find the sites AI engines cite
The Citations page shows which domains AI engines use as sources, and how often. Filter Relationship to Third-party, and the table becomes a shortlist for PR and outreach: sites the engines already trust. The Mentions you column shows how many of their cited pages name your brand.
For a full walkthrough of what to do with those pages, see AI Found Your Content but Didn't Cite It? Here's How to Spot and Address Citation Gaps.
5. Build one report per market, persona or product line
Need a report for your German market, or for one product line? Connect a data source with the Location or Topic setting narrowed to it. Every chart on that data source then shows that slice only, so a regional manager sees exactly their market.
To cover several projects in one report, connect one data source per project and add each one to the report.
Good to Know Before You Build Your Own Charts
How charts behave
Not every field goes with every other. The connector offers the same breakdowns as the AI Search reports in AWR. A chart that asks for one AWR doesn't calculate, such as Visibility score by Topic, shows "AWR AI Search can't build this chart" and names the fields. The quickest way to a working chart is to copy one from the template and change it.
Missing a combination you need? Contact our support team and we'll do our best to add it as fast as possible.
The numbers come as AWR computes them. Shares and averages can't simply be added up again, so every metric uses the Auto aggregation. Leave it that way.
Every chart reads a date range, from the report's date range control or Data Studio's default range.
A filter on a field a chart doesn't have leaves that chart alone. A Relationship filter, for example, doesn't change the Overview charts. A Brand filter keeps the chosen brands in the brand tables, and the charts about your own brand show no data when the filter leaves your brand out.
Filters use "Equal to" or "In" conditions.
A chart can show up to 100,000 rows. For more, narrow the date range or add a filter.
Sharing reports with clients
A data source reads AWR with the token of the person who connected it. Anyone who can view a report built on it sees that project's data, so:
Share reports as view-only. Viewers can't change the project or the settings.
Keep edit rights on the data source to yourself. Create it from Data Studio's home page (Create > Data source), not with Add data inside a report. A data source added inside a report can be edited by anyone who can edit that report.
Troubleshooting
When something goes wrong, the connector says so in the chart. Here's what each message means and what to do:
MESSAGE | WHAT DO TO |
|---|---|
This API token is not valid. | Copy the token again from Settings > Integrations & Exports in AWR, then revoke the connector's access and reconnect (see the FAQ below). |
Connect your AWR API token: open this data source and sign in again. | Open the data source and paste your token when Data Studio asks for it. |
The AWR AI Search connector is available on Agency and Enterprise plans and all yearly subscriptions. | Your plan doesn't include API access. Change your plan, or ask your account owner. |
This project isn't available to this API token. | The token's account can't access this project. Reconnect with the token of an account that can. |
This project isn't tracked in AWR AI Search. | Set the project up in AWR AI Search first. |
AWR AI Search can't build this chart: ... | The rest of the message names the fields that don't go together. Copy a chart from the template and change it, or contact our support team to ask for the combination. |
This filter type isn't supported by the AWR AI Search connector. | Change the filter to an "Equal to" or "In" condition. |
This chart needs more than 100,000 rows. | Narrow the date range or add a filter. |
AWR AI Search rejected the connection. Reconnect this data source. | Open the data source, click Edit connection, then Reconnect. |
AWR AI Search is busy right now. | Wait a minute, then refresh the report. |
AWR AI Search is temporarily unavailable. | Try again later. If it keeps happening, contact our support team. |
Privacy and Data Use
The connector only reads. It never changes anything in AWR.
It reads only the AI Search data of the projects your token can access, and only for the charts you open.
Your token stays with your Google account. The connector stores it for your Google account only, never in a data source or a report, and deletes it when you revoke the connector's access.
The connector keeps no report data. It caches only the list of fields and a short-lived access pass, for a few minutes.
Read our Privacy Policy and Terms of Service for the details.
Do you have any questions about the AI Search connector? Don't hesitate to get in touch with our support team.
Frequently Asked Questions
Does the AI Search connector replace the rankings connector?
Which AWR plans include the AI Search connector?
Can I combine several AI Search projects in one Data Studio report?
Which AI engines does the AI Search connector include?
Can I show a metric other than Visibility score in the trend chart?
How do I switch to a different API token?
Why can't I change a metric's aggregation in the AI Search connector?
Track this on your own keywords
Rankings, AI answers and Search Console data in one project. 7-day free trial, no credit card required.
stay in the loop
