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

# Integrations

> Connect your ad platforms and analytics tools to Adstudio.

Adstudio brings all your marketing data together in one place. Connect your ad platforms and analytics tools to get started.

## How It Works

1. **Authorize** - Click Connect and sign in with your platform account
2. **Select Account** - Choose which account to connect from your available accounts
3. **Grace Period** - You have 3 days to confirm your selection
4. **Start Using** - Your data syncs automatically every 45 minutes

<Warning>
  **One Account Per Platform Per Workspace**

  Each workspace can connect one account per platform. Once the 3-day grace period ends, your account selection is locked. To connect a different account, you'll need to create a new workspace.
</Warning>

## Connect Your Platforms

Navigate to **Settings → Integrations** in Adstudio to connect your accounts.

<Tabs>
  <Tab title="Google Ads">
    ### Requirements

    * Google account with Admin or Standard access to your Google Ads account

    ### Steps

    <Steps>
      <Step title="Click Connect">
        Find **Google Ads** in the integrations list and click **Connect**.
      </Step>

      <Step title="Sign in to Google">
        A popup opens for Google authentication. Select the Google account that has access to your Google Ads account.
      </Step>

      <Step title="Grant Permissions">
        Review and approve the permissions Adstudio needs:

        * View and manage your Google Ads accounts
        * Access account performance data
      </Step>

      <Step title="Select Your Account">
        Choose which Google Ads account to connect. If you have multiple accounts (MCC structure), select the specific account you want to use.

        <Note>
          Remember: You can only connect one Google Ads account per workspace. Choose carefully - this selection locks after 3 days.
        </Note>
      </Step>

      <Step title="Done">
        Your Google Ads data will begin syncing immediately. Initial sync may take a few minutes for large accounts.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Meta Ads">
    ### Requirements

    * Facebook account linked to your Meta Business account
    * Advertiser or Admin role on the ad account

    ### Steps

    <Steps>
      <Step title="Click Connect">
        Find **Meta Ads** in the integrations list and click **Connect**.
      </Step>

      <Step title="Log into Facebook">
        A popup opens for Facebook authentication. Log in with the Facebook account that has access to your Meta Ads.
      </Step>

      <Step title="Grant Permissions">
        Authorize these permissions:

        * **ads\_management**: Create and manage ads
        * **ads\_read**: View campaign performance
        * **business\_management**: Access Business Manager
      </Step>

      <Step title="Select Your Account">
        Choose which ad account to connect from your Business Manager.

        <Note>
          Remember: You can only connect one Meta Ads account per workspace. Choose carefully - this selection locks after 3 days.
        </Note>
      </Step>

      <Step title="Done">
        Your Meta Ads data will begin syncing immediately.
      </Step>
    </Steps>
  </Tab>

  <Tab title="TikTok Ads">
    ### Requirements

    * TikTok for Business account with advertiser access

    ### Steps

    <Steps>
      <Step title="Click Connect">
        Find **TikTok Ads** in the integrations list and click **Connect**.
      </Step>

      <Step title="Log into TikTok">
        A popup opens for TikTok authentication. Log in with your TikTok for Business account.
      </Step>

      <Step title="Grant Permissions">
        Authorize Adstudio to access your TikTok Ads data.
      </Step>

      <Step title="Select Your Account">
        Choose which TikTok ad account to connect.

        <Note>
          Remember: You can only connect one TikTok Ads account per workspace. Choose carefully - this selection locks after 3 days.
        </Note>
      </Step>

      <Step title="Done">
        Your TikTok Ads data will begin syncing.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Google Analytics">
    ### Requirements

    * Google account with Editor or Administrator access to your GA4 property

    ### Steps

    <Steps>
      <Step title="Click Connect">
        Find **Google Analytics 4** in the integrations list and click **Connect**.
      </Step>

      <Step title="Sign in to Google">
        Authenticate with your Google account that has GA4 access.
      </Step>

      <Step title="Grant Permissions">
        Authorize Adstudio to view your Google Analytics data.
      </Step>

      <Step title="Select Your Property">
        Choose which GA4 property to connect.

        <Note>
          Remember: You can only connect one GA4 property per workspace. Choose carefully - this selection locks after 3 days.
        </Note>
      </Step>

      <Step title="Done">
        Your analytics data will begin syncing.
      </Step>
    </Steps>

    <Info>
      Adstudio only supports **Google Analytics 4**. Universal Analytics is not supported.
    </Info>
  </Tab>

  <Tab title="Search Console">
    ### Requirements

    * Google account with Owner or Full user access to your Search Console property
    * Your website must be verified in Search Console

    ### Steps

    <Steps>
      <Step title="Click Connect">
        Find **Search Console** in the integrations list and click **Connect**.
      </Step>

      <Step title="Sign in to Google">
        Authenticate with your Google account that has Search Console access.
      </Step>

      <Step title="Select Your Property">
        Choose which verified property (website) to connect.

        <Note>
          Remember: You can only connect one Search Console property per workspace. Choose carefully - this selection locks after 3 days.
        </Note>
      </Step>

      <Step title="Done">
        Your SEO data will begin syncing.
      </Step>
    </Steps>

    <Info>
      Search Console data updates daily (not every 45 minutes) because Google only refreshes this data once per day.
    </Info>
  </Tab>
</Tabs>

## About the Grace Period

When you select an account, you have a **3-day grace period** to make sure it's the right one.

During this period:

* Your data syncs normally
* You can disconnect and choose a different account if needed
* You don't need to take any action if you're happy with your selection

After the grace period:

* Your account selection is locked to this workspace
* To connect a different account, create a new workspace

<Tip>
  **Why this limitation?**

  The one-account-per-workspace model keeps your data clean and organized. Each workspace represents a distinct business or project with its own set of connected accounts.
</Tip>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Connection popup doesn't open">
    * Check if popup blockers are enabled
    * Try a different browser (Chrome recommended)
    * Clear your browser cache and cookies
  </Accordion>

  <Accordion title="Access Denied error">
    * Verify you have the required access level for the platform
    * Ask an admin to grant you appropriate permissions
  </Accordion>

  <Accordion title="Account not appearing in selection">
    * You only see accounts you have direct access to
    * Check your permissions in the platform's native interface
  </Accordion>

  <Accordion title="Sync stuck or taking too long">
    * Large accounts may take 10-15 minutes for initial sync
    * If stuck for over 30 minutes, try disconnecting and reconnecting
  </Accordion>
</AccordionGroup>

## Need Help?

If you're having trouble connecting your accounts, [contact our support team](https://useadstudio.com/contact).