> ## Documentation Index
> Fetch the complete documentation index at: https://help.mentionpilot.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Looker Studio Connector

> Import your MentionPilot AI visibility data into Google Looker Studio and build custom dashboards and reports.

## What is the MentionPilot Looker Studio connector?

The MentionPilot Looker Studio community connector lets you import your AI search visibility data directly into [Google Looker Studio](https://lookerstudio.google.com/). You can then create custom dashboards and reports using your brand performance data from AI search engines like ChatGPT, Perplexity, and Gemini.

<Note>
  Looker Studio is Google's free data visualization tool that helps you turn your data into informative, easy-to-read, and shareable dashboards and reports.
</Note>

### How this helps

* **Real-time data access** — Connect directly to your MentionPilot project for up-to-date visibility metrics.
* **Custom visualizations** — Create charts, graphs, and tables that match your reporting needs.
* **Team collaboration** — Share dashboards with stakeholders and team members.

***

## How to set up the connector

### What you need

Before you begin, ensure you have:

* A MentionPilot account with access to at least one project
* A Google account with access to Looker Studio

***

### Step 1: Access the connector

1. Use [this link](https://datastudio.google.com/datasources/create?connectorId=AKfycbxsJnXvf6x50ubEkAVXee9qbP--znoJvfm9N5JCMp0YkMxUyJUGRAc-QWg_HHAj2ZEQ\&authuser=0) to access the MentionPilot connector in Looker Studio (make sure you're signed in with your Google account).
2. Enter your basic info and complete account setup.

<Warning>
  If you can't find the MentionPilot connector in the gallery or encounter other issues, contact us at [support@mentionpilot.raiseaticket.com](mailto:support@mentionpilot.raiseaticket.com).
</Warning>

***

### Step 2: Authorize the connection

1. Click **AUTHORIZE** to begin the OAuth2 authentication process.
2. You'll be redirected to Google's authorization page.
3. Sign in with your Google account if prompted.
4. You'll see a "Google hasn't verified this app" warning. This is normal for community connectors. Click **Advanced → Go to MentionPilot (unsafe)**.
5. Grant the necessary permissions to the connector.
6. You'll be redirected back to Looker Studio once authorization is complete. Another **AUTHORIZE** button will appear below "MentionPilot requires authorization to connect to data."
7. Click **AUTHORIZE** again.
8. You will see a MentionPilot Looker Authenticator pop-up. Click **Continue with Google** and sign in or select your Google account.
9. Once prompted, close the window and return to the Looker Studio page.

***

### Step 3: Configure your data source

After authorization, you'll see the connector configuration screen:

1. Choose which **MentionPilot Project** to connect.
2. If you want to create reports that can switch between multiple MentionPilot projects, select the option to use **Projects as a parameter** in reports.

***

### Step 4: Connect and validate

1. Click **CONNECT** to establish the connection.
2. The connector will validate your configuration and fetch sample data.
3. You'll see the available fields that can be used in your reports.

***

## Available data fields

### Dimensions

| Field          | Type | Description                                                          |
| -------------- | ---- | -------------------------------------------------------------------- |
| Brand          | Text | All the brands that you have added in MentionPilot                   |
| Source: Domain | Text | The website domains that AI models used while answering your prompts |
| Date           | Date | Date for all the metrics                                             |

### Metrics

| Field      | Type   | Description                                                |
| ---------- | ------ | ---------------------------------------------------------- |
| Visibility | Number | Visibility score for brands on the specific date           |
| Citations  | Number | Citation count for the source domain on the specified date |
| Chats      | Number | Number of chats on the specified date                      |

***

## Creating your first report

### Step 1: Create a new report

1. After configuring your data source, click **CREATE REPORT**.
2. Looker Studio will open the report editor with your MentionPilot data source connected.

### Step 2: Add visualizations

Looker Studio offers a wide range of charts and tables to fit your needs. See [Types of Charts in Looker Studio](https://cloud.google.com/looker/docs/studio/types-of-charts-in-looker-studio) for all available options.

Recommended starting points:

* **Time series chart** — Track your Visibility score over time.
* **Bar chart** — Compare brand visibility across AI models.
* **Table** — Show a detailed breakdown of citations by source domain.

### Step 3: Apply filters and controls

Add interactive controls to make your reports dynamic:

* **Date range control** — Let viewers adjust the time window.
* **Brand filter** — Drill into a specific brand's performance.
* **Source domain filter** — Focus on citations from a particular domain.

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authorization Failed">
    * Ensure you're using the correct Google account.
    * Clear your browser cache and try again.
    * Check that your account has access to the MentionPilot project.
  </Accordion>

  <Accordion title="No Data Available">
    * Verify you've selected the correct MentionPilot project.
    * Check that your date range includes data (data appears after 24–48 hours).
    * Ensure your filters aren't too restrictive.
  </Accordion>

  <Accordion title="Connection Timeout">
    * Try reducing the date range.
    * Remove unnecessary filters.
    * Contact support if the issue persists.
  </Accordion>

  <Accordion title="Invalid Project">
    * Double-check your project selection in the MentionPilot dashboard.
    * Ensure you have access permissions to the project.
    * Contact your account administrator if needed.
  </Accordion>
</AccordionGroup>

### Getting help

If you encounter issues not covered above, contact support:

* **Email**: [support@mentionpilot.raiseaticket.com](mailto:support@mentionpilot.raiseaticket.com) — include a description of the issue and screenshots if applicable.
