Looker Studio

Connect your Trakkr brand visibility data directly to Looker Studio (formerly Google Data Studio) to create powerful dashboards and reports. This community connector allows you to visualize your brand’s presence across AI models and prompts in real-time.

This feature requires an API key to get set up, which is only available on the Scale plan.

Overview

The Trakkr Looker Studio Connector provides access to:

Brand Scores: Time-series data showing visibility and presence metrics
Brand List: Complete list of brands accessible with your API key
Breakdown Options: Filter data by AI model, prompt, or both
Historical Data: Up to 90 days of historical brand performance

Prerequisites

Before setting up the connector, you’ll need:

To sign up for a Trakkr account.
Trakkr API Key: A valid API key starting with sk_live_
Brand ID: 32-character hexadecimal brand identifier
Looker Studio Account: Access to Google Looker Studio
View Trakkr’s Terms of Service and Privacy Policy.

Setup Instructions

Get Your API Credentials

Find your API Key:
- Log into your Trakkr API section
- Copy your key (starts with sk_live_)
Get your Brand ID:
- Use the /get-brands API endpoint to list all accessible brands
- Or find it in your Trakkr API dashboard
- Brand IDs are 32-character hexadecimal strings

Add the Connector to Looker Studio

Open this link to add Trakkr as a custom data source
Fill in the configuration parameters:

Parameter	Description	Example
API Key	Your Trakkr API key	`sk_live_1234567890abcdef...`
Brand ID	32-character brand identifier	`0000000000000x000000000000000000`
Data Type	Choose data to fetch	`Brand Scores (Time Series)` or `Brand List`
Breakdown Options	Optional filtering	`By Model`, `By Prompt`, or both
Date Range	Days to look back (max 90)	`30`

And then click “Connect”.

Data Types

Brand Scores (Time Series)

Returns daily visibility and presence metrics for your brand. Available Fields:

Date - Report date (YYYYMMDD format)
Brand ID - Your brand identifier
Brand Name - Human-readable brand name
Visibility Score - Brand visibility metric (0-100)
Presence Score - Brand presence percentage (0-100%)

Breakdown Options:

By Model: Adds AI model-specific metrics
By Prompt: Adds prompt-specific metrics
Both: Combines model and prompt breakdowns

Brand List

Returns all brands accessible with your API key. Available Fields:

Brand ID - Brand identifier
Brand Name - Human-readable brand name

Configuration Examples

Basic Brand Scores Dashboard

{
  "apiKey": "sk_live_your_api_key_here",
  "brandId": "0000000000000x000000000000000000",
  "dataType": "scores",
  "breakdown": [],
  "dateRange": "30"
}

Model Breakdown Analysis

{
  "apiKey": "sk_live_your_api_key_here",
  "brandId": "0000000000000x000000000000000000",
  "dataType": "scores",
  "breakdown": ["model"],
  "dateRange": "90"
}

Full Breakdown (Model + Prompt)

{
  "apiKey": "sk_live_your_api_key_here",
  "brandId": "0000000000000x000000000000000000",
  "dataType": "scores",
  "breakdown": ["model", "prompt"],
  "dateRange": "7"
}

Data Field Reference

Core Metrics

Field	Type	Description	Range
`visibility`	Number	Brand visibility score	0-100
`presence`	Percent	Brand presence percentage	0-100%

Model Breakdown Fields

Field	Type	Description
`model`	String	AI model name (e.g., “OpenAI”, “Anthropic”)
`model_visibility`	Number	Model-specific visibility score
`model_presence`	Percent	Model-specific presence percentage

Prompt Breakdown Fields

Field	Type	Description
`prompt_id`	String	Unique prompt identifier
`prompt_text`	String	Actual prompt text
`prompt_visibility`	Number	Prompt-specific visibility score
`prompt_presence`	Percent	Prompt-specific presence percentage

Combined Breakdown Fields

Field	Type	Description
`model`	String	AI model name
`prompt_text`	String	Prompt text
`model_prompt_rank`	Number	Average rank in responses (null if not mentioned)

Troubleshooting

Common Issues

“API Key is required”

Ensure your API key is correctly copied
Check that the key starts with sk_live_
Verify the key is active in your Trakkr dashboard

“Brand ID is required”

Use the /get-brands endpoint to find your brand ID
Ensure the brand ID is exactly 32 characters
Verify you have access to the specified brand

“Date range cannot exceed 90 days”

Reduce the date range to 90 days or less
Consider using multiple data sources for longer periods

“API error” responses

Check your API key permissions
Verify the brand ID is correct
Ensure your account has active data for the date range

Data Quality Issues

Missing Data Points

Some dates may not have data if no reports were generated
Check your Trakkr dashboard for data availability
Verify the date range contains active data

Inconsistent Scores

Scores may vary between models and prompts
Use breakdowns to understand the differences
Consider the context of each prompt type

Frequently Asked Questions

Why is my visibility/presence over 100?

This typically occurs when you’ve selected a breakdown option but the data is being aggregated. When you break down by model or prompt, the connector may aggregate scores across multiple data points, which can result in values exceeding 100. To get accurate individual scores:

Use specific breakdowns (model OR prompt, not both)
Check that you’re not accidentally aggregating across multiple dimensions
Verify your date range isn’t too broad

Why don't I have visibility/presence score with model prompt breakdown?

The model-prompt breakdown doesn’t include visibility and presence scores because these are aggregate metrics that don’t make sense at the individual query level. For each specific model-prompt combination:

Presence would always be either 100% (if mentioned) or 0% (if not mentioned)
Visibility is an aggregate metric across multiple queries

Instead, the model-prompt breakdown provides the model_prompt_rank field, which shows your brand’s average position in responses for that specific combination.

Where do I find my brand ID?

You can find your brand ID in several ways:

Using the API directly:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.trakkr.ai/get-brands

In your Trakkr dashboard:
- Navigate to the API section of your Trakkr dashboard
- Your brand IDs will be listed there
From the API documentation:
- Visit trakkr.ai/api
- Use the /get-brands endpoint to list all accessible brands

Brand IDs are 32-character hexadecimal strings that uniquely identify each brand in the Trakkr system.

How often does the data refresh?

The connector fetches data in real-time, but Trakkr implements caching on the back-end. This means that your data may be up to 180 minutes old. Trakkr implements caching to ensure that your dashboards load as quickly as possible.

Can I use multiple brands in one dashboard?

Currently, the connector is designed to work with one brand per data source. To create a multi-brand dashboard:

Create separate data sources for each brand
Use the same connector configuration but with different brand IDs
Combine the data sources in your Looker Studio report

What's the difference between visibility and presence scores?

Visibility Score: Measures how often your brand is mentioned across AI responses (0-100 scale)
Presence Score: Measures the quality and context of those mentions (0-100% scale)

A high visibility score means your brand is frequently mentioned, while a high presence score indicates those mentions are in positive or relevant contexts.

Support

If you encounter issues with the Looker Studio connector:

Check the FAQs above for common solutions
Review your configuration for typos or incorrect values
Contact Support: mack@trakkr.ai

Getting Started

Using Trakkr

Advanced Features

Overview

Prerequisites

Setup Instructions

Get Your API Credentials

Add the Connector to Looker Studio

Data Types

Brand Scores (Time Series)

Brand List

Configuration Examples

Basic Brand Scores Dashboard

Model Breakdown Analysis

Full Breakdown (Model + Prompt)

Data Field Reference

Core Metrics

Model Breakdown Fields

Prompt Breakdown Fields

Combined Breakdown Fields

Troubleshooting

Common Issues

Data Quality Issues

Frequently Asked Questions

Support

Getting Started

Using Trakkr

Advanced Features

​Overview

​Prerequisites

​Setup Instructions

​Get Your API Credentials

​Add the Connector to Looker Studio

​Data Types

​Brand Scores (Time Series)

​Brand List

​Configuration Examples

​Basic Brand Scores Dashboard

​Model Breakdown Analysis

​Full Breakdown (Model + Prompt)

​Data Field Reference

​Core Metrics

​Model Breakdown Fields

​Prompt Breakdown Fields

​Combined Breakdown Fields

​Troubleshooting

​Common Issues

​Data Quality Issues

​Frequently Asked Questions

​Support

Overview

Prerequisites

Setup Instructions

Get Your API Credentials

Add the Connector to Looker Studio

Data Types

Brand Scores (Time Series)

Brand List

Configuration Examples

Basic Brand Scores Dashboard

Model Breakdown Analysis

Full Breakdown (Model + Prompt)

Data Field Reference

Core Metrics

Model Breakdown Fields

Prompt Breakdown Fields

Combined Breakdown Fields

Troubleshooting

Common Issues

Data Quality Issues

Frequently Asked Questions

Support