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

# Add the Detrics Connector

> Step-by-step guide to adding Detrics as a data source in Looker Studio

<Info>**Last updated:** March 21, 2026</Info>

This guide walks through every step of adding a Detrics connector to Looker Studio, from finding the connector to seeing your data in a live report.

## Two ways to add the connector

You can add Detrics to Looker Studio in two ways:

1. **From the Detrics website** (recommended for first-time users)
2. **From within Looker Studio** (if you already have a report open)

***

## Option 1: From the Detrics website

<Steps>
  <Step title="Visit the Detrics connector gallery">
    Go to [detrics.io/looker-studio/integrations](https://www.detrics.io/looker-studio/integrations?utm_source=detrics-support\&utm_medium=looker-add-connector) and browse the available connectors.

    You will see connectors for Meta Ads, Google Ads, TikTok Ads, LinkedIn Ads, Google Analytics 4, Shopify, and more.
  </Step>

  <Step title="Click your desired connector">
    Click on the platform you want to connect. For example, click **Meta Ads** to add Facebook/Instagram advertising data.

    This will redirect you to Looker Studio's connector authorization page.
  </Step>

  <Step title="Authorize your Detrics account">
    You will see two authorization steps:

    1. Click the **Authorize** button on the left side to sign in with your Google account
    2. Click the **Authorize** button on the right side to connect your ad platform

    <Frame caption="The Detrics authorization buttons in Looker Studio">
      <img src="https://mintcdn.com/detrics-4688583d/zhuWz3v2lbFVKC5_/images/looker-studio/looker-user-authorize-button.png?fit=max&auto=format&n=zhuWz3v2lbFVKC5_&q=85&s=f880d8d28ed244324f11ddf2219e83a2" alt="Authorize Detrics access button on the left side" width="604" height="372" data-path="images/looker-studio/looker-user-authorize-button.png" />
    </Frame>

    <Frame caption="Platform authorization on the right side">
      <img src="https://mintcdn.com/detrics-4688583d/zhuWz3v2lbFVKC5_/images/looker-studio/looker-meta-authorize-button.png?fit=max&auto=format&n=zhuWz3v2lbFVKC5_&q=85&s=ea64c862ba6d71a656ed88d3203ac678" alt="Authorize Meta connection button on the right side" width="783" height="261" data-path="images/looker-studio/looker-meta-authorize-button.png" />
    </Frame>
  </Step>

  <Step title="Select your ad account">
    Choose the specific account you want to pull data from. For Meta Ads, you will see a dropdown listing all your ad accounts.

    <Frame caption="Account selection dropdown">
      <img src="https://mintcdn.com/detrics-4688583d/zhuWz3v2lbFVKC5_/images/looker-studio/looker-meta-select-accounts.png?fit=max&auto=format&n=zhuWz3v2lbFVKC5_&q=85&s=ca75898b403c232ac2acadaf0a8ad599" alt="Dropdown showing available Meta ad accounts to connect" width="623" height="272" data-path="images/looker-studio/looker-meta-select-accounts.png" />
    </Frame>
  </Step>

  <Step title="Choose a template (optional)">
    Some connectors offer pre-built templates with common charts and layouts already configured. Keep the checkbox checked to start with a template, or uncheck it to start from a blank report.

    <Frame caption="Template opt-in checkbox">
      <img src="https://mintcdn.com/detrics-4688583d/zhuWz3v2lbFVKC5_/images/looker-studio/opt-in-template-looker.png?fit=max&auto=format&n=zhuWz3v2lbFVKC5_&q=85&s=6bb405cb3e3b320fc1d04f9cb2f28225" alt="Checkbox to opt in to a pre-built Looker Studio template" width="1916" height="860" data-path="images/looker-studio/opt-in-template-looker.png" />
    </Frame>

    <Tip>
      Templates are a great starting point. You can always customize or remove any element after the report is created.
    </Tip>
  </Step>

  <Step title="Connect the data source">
    Click the **Connect** button in the top-right corner of the screen to finalize the connection.

    <Frame caption="Connect button to establish the data source connection">
      <img src="https://mintcdn.com/detrics-4688583d/zhuWz3v2lbFVKC5_/images/looker-studio/connect-button.png?fit=max&auto=format&n=zhuWz3v2lbFVKC5_&q=85&s=6e80260ae2386eb2fd720bf2b9d806dd" alt="Connect button in the top-right corner" width="1916" height="860" data-path="images/looker-studio/connect-button.png" />
    </Frame>
  </Step>

  <Step title="Review and format fields">
    Before creating the report, you can review the available fields. A common adjustment is changing the "Ad Image" field type from **Text** to **Image URL** so your report can display ad creative previews.

    <Frame caption="Field configuration screen showing dimensions and their types">
      <img src="https://mintcdn.com/detrics-4688583d/zhuWz3v2lbFVKC5_/images/looker-studio/dimension-view-looker.png?fit=max&auto=format&n=zhuWz3v2lbFVKC5_&q=85&s=05c5220e0503b787a7b61f9571b918d0" alt="Dimension view showing field names and data types that can be adjusted" width="1918" height="841" data-path="images/looker-studio/dimension-view-looker.png" />
    </Frame>
  </Step>

  <Step title="Create the report">
    Click **Create Report** (or **Add to Report** if adding to an existing report). Your data source is now connected and ready to use.

    <Frame caption="Create Report button">
      <img src="https://mintcdn.com/detrics-4688583d/zhuWz3v2lbFVKC5_/images/looker-studio/create-report-button.png?fit=max&auto=format&n=zhuWz3v2lbFVKC5_&q=85&s=d2b8b95dca353bd454642d92b4c1c1d6" alt="Create Report button in the top-right corner" width="1918" height="841" data-path="images/looker-studio/create-report-button.png" />
    </Frame>
  </Step>
</Steps>

***

## Option 2: From within Looker Studio

If you already have a report open in edit mode, you can add Detrics as an additional data source.

<Steps>
  <Step title="Click 'Add Data' in the toolbar or panel">
    In edit mode, click **Add data** in the toolbar at the top of the screen, or click the **Add Data** link at the bottom of the Data panel on the right side.

    <Frame caption="Add Data button at the bottom of the Data panel">
      <img src="https://mintcdn.com/detrics-4688583d/OWWVo-QQI-tOiwlY/images/tutorials/looker/ac-add-data.png?fit=max&auto=format&n=OWWVo-QQI-tOiwlY&q=85&s=5910715f2ac801d3dbecc43255f0bd03" alt="Add Data button highlighted at the bottom-right of the Data panel" width="1280" height="720" data-path="images/tutorials/looker/ac-add-data.png" />
    </Frame>
  </Step>

  <Step title="Search for Detrics">
    In the connector search dialog, type **Detrics**. You will see all available Detrics connectors listed. Select the one matching your platform.
  </Step>

  <Step title="Authorize and select account">
    Follow the same authorization flow as Option 1 above (Steps 3-4). You will authorize your Google account, then your platform account, and select the specific ad account.
  </Step>

  <Step title="Confirm the connection">
    Once connected, you will see the data source appear in the Data panel on the right, showing the platform name (e.g., "Meta Ads") and all available field categories.

    <Frame caption="Data panel showing the connected Meta Ads data source with field categories">
      <img src="https://mintcdn.com/detrics-4688583d/OWWVo-QQI-tOiwlY/images/tutorials/looker/ac-meta-ads-source.png?fit=max&auto=format&n=OWWVo-QQI-tOiwlY&q=85&s=080653e4db38f3cc44e88b27907c423f" alt="Data panel showing Meta Ads as the connected data source with field categories listed below" width="1280" height="720" data-path="images/tutorials/looker/ac-meta-ads-source.png" />
    </Frame>
  </Step>
</Steps>

***

## What you see after connecting

Once your connector is set up and you have added charts, your report will display live data from your ad platform. Here is an example report with two data tables pulling campaign performance data from Meta Ads:

## Switching accounts on an existing connector

If you need to change which ad account a connector uses:

1. Go to **Resource > Manage added data sources**
2. Find the Detrics connector and click **Edit**
3. Change the account selection
4. Click **Reconnect** in the top-right corner

## Available connectors

Detrics currently supports the following platforms as Looker Studio connectors:

* **Meta (Facebook) Ads**
* **Google Ads**
* **TikTok Ads**
* **LinkedIn Ads**
* **X (Twitter) Ads**
* **Bing (Microsoft) Ads**
* **Google Display & Video 360**
* **Google Analytics 4**
* **Instagram Insights**
* **Shopify**

For the full list with field details, see [Supported Data Sources](/data-destination/looker-studio/supported-data-sources).

## Troubleshooting connection issues

<AccordionGroup>
  <Accordion title="I don't see Detrics in the connector list">
    Make sure you are searching for **Detrics** (not "Dataplug"). If it still does not appear, try using the [direct link from the Detrics website](https://www.detrics.io/looker-studio/integrations?utm_source=detrics-support\&utm_medium=looker-add-connector-troubleshooting) instead.
  </Accordion>

  <Accordion title="Authorization fails or loops">
    Clear your browser cookies for `lookerstudio.google.com` and try again. Make sure you are using the same Google account that has your Detrics workspace. If the issue persists, try in an incognito window.
  </Accordion>

  <Accordion title="I don't see any ad accounts in the dropdown">
    Verify that your platform connection is active in your [Detrics workspace](https://app.detrics.io). If the connection has expired, re-authorize it in the Detrics web app first, then retry in Looker Studio.
  </Accordion>

  <Accordion title="Data is not loading after connecting">
    Check the [6-minute timeout guide](/data-destination/looker-studio/6-minutes-limit). Looker Studio has a strict execution time limit. Try reducing your date range or the number of fields in your query.
  </Accordion>
</AccordionGroup>

<Warning>
  Each Looker Studio connector instance is tied to a single ad account. To pull data from multiple accounts, add the connector once per account using **Add data**.
</Warning>

## Next steps

<CardGroup cols={2}>
  <Card title="Looker Studio Quickstart" icon="play" href="/looker-studio/quickstart">
    Full walkthrough of building your first report
  </Card>

  <Card title="Work Faster in Looker Studio" icon="rocket" href="/data-destination/looker-studio/how-to-work-faster">
    Tips to speed up your dashboard workflow
  </Card>

  <Card title="6-Minute Limit" icon="clock" href="/data-destination/looker-studio/6-minutes-limit">
    Understand Looker Studio's query timeout and how to work around it
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/data-destination/looker-studio/troubleshooting">
    Solutions for common issues
  </Card>
</CardGroup>

<Tip>
  **Need help?** Reach out to [support@detrics.io](mailto:support@detrics.io) for assistance with connection issues or missing platforms.
</Tip>
