--- title: "Adtraction connection guide" slug: "adtraction-connection-guide" description: "Connect your Adtraction data to Supermetrics with our guide on permissions, API keys, and query types for seamless data integration." updated: 2026-05-11T09:54:48Z published: 2026-05-11T09:54:48Z --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt > Use this file to discover all available pages before exploring further. # Adtraction connection guide This guide contains all permissions and requirements for connecting your Adtraction data to Supermetrics. You can connect to data sources from the [Data sources page on the Supermetrics Hub](https://hub.supermetrics.com/token-management). On the Hub, you can also [share an authentication link](https://docs.supermetrics.com/v1/docs/how-to-connect-to-data-sources-from-supermetrics-hub#share-authentication-link) to connect to a data source you don't have direct access to. After you connect to the data source on the Hub, you can use the data source connection in [all available destinations](/docs/adtraction-connection-guide#connection-instructions). ## Required permissions To connect Supermetrics to Adtraction, you need an [Adtraction API token](https://adtraction.com/blog/get-started-with-the-adtraction-api). These are also referred to as API keys. To generate this token: 1. [Log in to Adtraction](https://adtraction.com/login). 2. Navigate to **Account** → **Settings**. 3. Select **API** from the navigation menu. 4. Copy the API token. Remember to keep it safe. ## Query types Query types define what sort of metrics and dimensions are available. You need to select one of the following query types when pulling data. ****Reference list: Adtraction query types**** - Advertiser: Channels - Advertiser: Clicks - Advertiser: Transactions - Advertiser: Statistics - Advertiser: Statistics by ad - Advertiser: Statistics by channel - Advertiser: Statistics by day - Advertiser: Statistics by segment - Affiliate: Markets - Affiliate: Channels - Affiliate: Currencies - Affiliate: Applications - Affiliate: Clicks - Affiliate: Transactions - Affiliate: Latest transactions - Affiliate: Statistics - Affiliate: Statistics by ads - Affiliate: Statistics by channel - Affiliate: Statistics by day - Affiliate: Statistics by EPI - Affiliate: Statistics by program If you're logged with an API token belonging to an advertiser account, you can only use the report types intended for advertiser users. The same applies to affiliate accounts. ## Connection instructions When connecting to Adtraction, you need to insert your API key (API token) and select the query details when prompted. 1. Select the Adtraction data source [on the Supermetrics Hub](https://hub.supermetrics.com/token-management) or in the data destination. 2. Enter your API key. 3. Give your login a name. The name can be anything — its purpose is for you to recognize the login later in case you have multiple logins. 4. If prompted, choose to make this connection [shared or private](https://docs.supermetrics.com/docs/about-shared-and-private-connections). 5. Click **Start**. 6. In your data destination, select the query type and other options depending on the selected query type. See detailed instructions on [how to connect to a data source from the Supermetrics Hub](https://docs.supermetrics.com/docs/how-to-connect-to-data-sources-from-supermetrics-hub). You can also connect to Adtraction from these destinations: - Google Sheets: [How to connect to a Supermetrics data source in Google Sheets](https://docs.supermetrics.com/docs/how-to-connect-to-a-supermetrics-data-source-in-google-sheets) - Data Studio: [How to connect data sources to Data Studio](/v1/docs/how-to-connect-data-sources-to-data-studio) - Excel: [How to connect data sources to Excel with Supermetrics](https://docs.supermetrics.com/docs/how-to-connect-data-sources-to-excel-with-supermetrics) - Power BI: [How to create your first Supermetrics query for Power BI](https://docs.supermetrics.com/docs/how-to-create-your-first-supermetrics-query-for-power-bi) - The Supermetrics API: [How to use the Query Manager](https://docs.supermetrics.com/docs/how-to-use-the-query-manager) - Data warehouse and cloud storage (Hub): [How to create a transfer](https://docs.supermetrics.com/docs/how-to-create-a-transfer) - BigQuery (marketplace): [How to create a BigQuery (marketplace) transfer](https://docs.supermetrics.com/v1/docs/how-to-create-a-bigquery-marketplace-transfer) ## More resources - [Adtraction: Query setup guide](/v1/docs/adtraction-report-building-guide) - [How to reauthenticate a data source in Google Sheets, Looker Studio, Excel, or Power BI](/v1/docs/how-to-reauthenticate-a-data-source-connection-in-google-sheets-looker-studio-excel-power-bi-and-supermetrics-hub) - [How to reauthenticate a data source in data warehouse, API, or cloud storage platform](/v1/docs/how-to-reauthenticate-a-data-source-connection-in-data-warehouse-destinations-or-the-supermetrics-api) - [How to manage data source connections on the Supermetrics Hub](/v1/docs/how-to-manage-data-source-connections-on-supermetrics-hub)