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.

​

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:

1. Trakkr API Key: A valid API key starting with sk_live_
2. Brand ID: 32-character hexadecimal brand identifier
3. Looker Studio Account: Access to Google Looker Studio

​

Setup Instructions

​

Get Your API Credentials

1. Find your API Key:
   • Log into your Trakkr API section
   • Copy your key (starts with sk_live_)
2. 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

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

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

​

Model Breakdown Fields

​

Prompt Breakdown Fields

​

Combined Breakdown Fields

​

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

​

Support

If you encounter issues with the Looker Studio connector:

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