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

# How to connect

> How to connect the TikTok GMV Max data source to Adriel: authorize with TikTok, select an ad account, and choose which TikTok Shop stores to include.

TikTok GMV Max is TikTok Shop's automated advertising product for driving gross merchandise value (GMV) across live shopping, short-form product ads, and shoppable creatives. Connecting it brings GMV Max campaign performance — spend, GMV, orders, and ROAS — into Adriel dashboards, organized by ad account and TikTok Shop store.

## Before you connect

The following are required:

* A TikTok account with access to the TikTok ad account that runs GMV Max campaigns.
* At least one TikTok Shop store that is available for GMV Max on that ad account. Only GMV-Max-available stores can be connected.

## Connect TikTok GMV Max

<Steps>
  <Step title="Authorize with TikTok">
    On the **Data Sources** page, search for **TikTok GMV Max** and select it. Sign in to TikTok in the pop-up using an account with access to the target ad account, then approve the requested read permissions to complete authorization.
  </Step>

  <Step title="Select the account">
    On the data source settings, choose one **Account** from the dropdown list.
  </Step>

  <Step title="Choose which stores to include">
    Decide whether to use **all GMV stores** or a specific set. To include every available store, keep the all-stores option. To limit the connection to specific stores, choose **Select Stores**, then pick the stores from the dropdown that appears.
  </Step>

  <Step title="Submit">
    Click **Submit** to complete the connection. The initial sync runs in the background, and GMV Max data appears once the first sync finishes.
  </Step>
</Steps>

## What gets imported

The connector imports GMV Max campaign performance across four collection levels — Campaign, Product, Creative, and Livestream — including spend, GMV, orders, ROAS, live-viewership metrics, and creative delivery metrics, grouped by ad account, store, and campaign.

For the complete list of metrics, breakdowns, collection-level rules, and limits, see the [TikTok GMV Max data reference](/data-sources/o-z/tiktok-gmv-max/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="A newly linked TikTok Shop store is not appearing">
    When the all-stores option is used, the store list is refreshed on every sync, so a newly linked store appears after the next sync. When **Select Stores** was chosen at setup, the store set is fixed — reconnect the data source and add the new store to include it.
  </Accordion>

  <Accordion title="No stores are available to select">
    Only stores that are available for GMV Max on the connected ad account can be included. If the ad account has no GMV-Max-available stores, none will be listed. Confirm the store is enabled for GMV Max on TikTok, then reconnect.
  </Accordion>

  <Accordion title="Data stopped updating after a token expired">
    This connection does not reconnect automatically when its TikTok token expires. Reconnect the data source and sign in again with the same TikTok account to resume syncing.
  </Accordion>

  <Accordion title="Numbers do not match a TikTok Ads data source">
    TikTok GMV Max and TikTok Ads use different TikTok reporting products, so their figures may not reconcile. Compare GMV Max data against GMV Max, and general ad performance against TikTok Ads.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="TikTok GMV Max data reference" href="/data-sources/o-z/tiktok-gmv-max/data-reference">
    Metrics, breakdowns, collection levels, and limits for TikTok GMV Max.
  </Card>

  <Card title="TikTok GMV Max FAQs" href="/data-sources/o-z/tiktok-gmv-max/faqs">
    Common questions and expected behaviors for the TikTok GMV Max data source.
  </Card>

  <Card title="How to connect TikTok Ads" href="/data-sources/o-z/tiktok/how-to-connect">
    Connect general TikTok ad-account and campaign performance.
  </Card>

  <Card title="How to connect TikTok Organic" href="/data-sources/o-z/tiktok-organic/how-to-connect">
    Connect owned TikTok account analytics.
  </Card>
</CardGroup>