> ## 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.

# Connect a Platform

> Step-by-step guide to connecting your marketing platforms to Detrics

Connecting a platform takes less than a minute. The process is the same whether you are using the web app, Google Sheets sidebar, or Looker Studio.

## From the Web App

<Steps>
  <Step title="Go to Data Sources">
    Log in to [app.detrics.io](https://app.detrics.io) and click **Data Sources** in the left sidebar.

    <Frame>
      <img src="https://mintcdn.com/detrics-4688583d/OWWVo-QQI-tOiwlY/images/tutorials/data-sources-page-annotated.png?fit=max&auto=format&n=OWWVo-QQI-tOiwlY&q=85&s=a9bb8310ba978dccc92b3e0a90f0132d" alt="Data Sources page showing all connected platforms" width="1280" height="720" data-path="images/tutorials/data-sources-page-annotated.png" />
    </Frame>

    You will see all available platforms listed with their current connection counts.
  </Step>

  <Step title="Select a Platform">
    Click on the platform you want to connect (e.g., Meta Ads, Google Ads, Shopify). This opens the platform's connection page.
  </Step>

  <Step title="Authorize Access">
    Click the **Connect** button. You will be redirected to the platform's official OAuth authorization page. Sign in with the account that has access to the data you need, and grant Detrics read-only permission.

    <Tip>
      For Meta Ads, make sure you are logged into the Facebook account that has admin or analyst access to the ad accounts you want to query.
    </Tip>
  </Step>

  <Step title="Select Accounts">
    After authorizing, Detrics loads your available accounts. Select the ones you want to work with. You can always add more accounts later.
  </Step>

  <Step title="Start Querying">
    Your connection is ready. You can now use it in Google Sheets, Looker Studio, Claude, or the Data Warehouse.
  </Step>
</Steps>

## From Google Sheets

If you are working in Google Sheets, you can connect platforms directly from the Detrics sidebar.

<Steps>
  <Step title="Open the Sidebar">
    Go to **Extensions > Detrics > Launch Detrics** in your Google Sheet.
  </Step>

  <Step title="Click Connect Data Source">
    In the sidebar, click **Connect Data Source** and choose the platform you want to add.

    <Frame>
      <img src="https://mintcdn.com/detrics-4688583d/zhuWz3v2lbFVKC5_/images/connection-issues-facebook/step-4.2.png?fit=max&auto=format&n=zhuWz3v2lbFVKC5_&q=85&s=96c86a8d1d63fe040391471e101d17ef" alt="Connect Account button in the Detrics sidebar" width="369" height="591" data-path="images/connection-issues-facebook/step-4.2.png" />
    </Frame>
  </Step>

  <Step title="Choose Your Platform">
    Select the data source from the list of available platforms.

    <Frame>
      <img src="https://mintcdn.com/detrics-4688583d/zhuWz3v2lbFVKC5_/images/connection-issues-facebook/step-5.png?fit=max&auto=format&n=zhuWz3v2lbFVKC5_&q=85&s=a4eeabaceb070dcada4ff33b89ae4cfa" alt="Selecting a data source" width="339" height="800" data-path="images/connection-issues-facebook/step-5.png" />
    </Frame>
  </Step>

  <Step title="Authorize and Select Accounts">
    Complete the OAuth flow and select the accounts you want to use. The connection is now available in your workspace.
  </Step>
</Steps>

## From Looker Studio

For Looker Studio, connections are created during the connector setup process. See the [Looker Studio Quickstart](/looker-studio/quickstart) for the full walkthrough.

## Platform-Specific Notes

Some platforms have special requirements:

* **Meta Ads / Facebook**: You need admin or analyst access to the ad account. If you manage multiple Business Managers, make sure you authorize with the right Facebook account.
* **Google Ads**: Requires a Google account with access to the Google Ads MCC or individual accounts.
* **Shopify**: Uses a store-level connection. You need store owner or staff access.
* **Stripe / TiendaNube**: These use centralized tokens. One connection per account is shared across all workspaces.

<Warning>
  If a connection fails or shows an error, see [Troubleshooting Connections](/connect/troubleshooting-connections) for solutions.
</Warning>