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

# Looker Studio connector

> Build custom dashboards and client reports from Koalr's daily visibility metrics, with no Koalr login inside Looker Studio.

The Koalr connector is a Looker Studio community connector. It authenticates with a connector key and reads the same stored daily rollup the Multi-Site Dashboard uses.

## Dataset

One row per site per day.

| Field                  | Type             | Description                                                                           |
| ---------------------- | ---------------- | ------------------------------------------------------------------------------------- |
| Date                   | date             | The day the run completed                                                             |
| Site                   | dimension        | Site name                                                                             |
| Domain                 | dimension        | Site domain                                                                           |
| Prompt Visibility Rate | metric, %        | The headline visibility metric                                                        |
| Share of Voice         | metric, %        | The brand's share of all brand mentions                                               |
| Sentiment Score        | metric, 0 to 100 | How positively AI describes the brand                                                 |
| First Mention Rate     | metric, %        | How often the brand is named first. Legacy field kept for compatibility; may be empty |
| AI Visibility Score    | metric           | The same value as Prompt Visibility Rate, kept for existing reports                   |

A date range is required and drives the query.

## Setup

<Steps>
  <Step title="Create a connector key">
    In Koalr, an organisation owner opens **Integrations, Looker Studio**, creates a key and copies it. It is shown once.
  </Step>

  <Step title="Open the connector">
    From the same card, **Open in Looker Studio**. Looker Studio asks for credentials: paste the key.
  </Step>

  <Step title="Configure">
    Pick one site or **All sites**, then create the data source.
  </Step>

  <Step title="Build">
    Add charts. The date range control on your report drives the API query, so a scorecard, a time series and a per-site table all come from the same source.
  </Step>
</Steps>

## Sharing with clients

Looker Studio reports are shared through Looker Studio's own sharing. The viewer never needs a Koalr account. The data refreshes on Looker Studio's schedule from stored runs, so it costs nothing against your plan.

## Revoking

Revoke the key in Koalr under **Connector keys**. Looker Studio prompts for new credentials on the next refresh.

## Numbers match the app

The connector reads the same stored rollup the Multi-Site Dashboard uses, so a figure in Looker always equals the figure in Koalr for the same site and day.