Open navigation

Adtraction: Authentication guide

This guide will walk you through how to authenticate or reauthenticate Adtraction with Google Sheets, Data Studio, and Excel.

Before you begin

Create an API token

To connect Supermetrics to Adtraction, you need an Adtraction API token. These are also referred to as API keys.

To generate this token:

  1. Log into Adtraction.
  2. Navigate to AccountSettings.
  3. Select API from the navigation menu.
  4. Copy the API token. 
Review query types

Supermetrics supports 2 Adtraction query types:

  • Advertiser 
  • Affiliate accounts

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.

For Excel users

If your team uses Supermetrics for Excel, you’ll see different options for managing and sharing data source connections in that destination. Learn more.


Google Sheets Data Studio  Excel Data integrations
Before you can authenticate the data source in Google Sheets, you need to install the Supermetrics add-on.
  1. Open a new Google Sheets file. 
  2. Navigate to ExtensionsSupermetricsLaunch to open the Supermetrics sidebar.
  3. Click Create query.
  4. Under Data source, select Adtraction.
  5. Enter your Account name and API key.
  6. Click Start.
  7. Navigate to Report configuration.
  8. Under Select query type, select the query type.
  9. Under Approval status, select the approval status type. 

When you're ready, learn how to create your first Supermetrics query with Adtraction.


  • If you encounter an authentication error such as “authentication failed”, “you need to reauthenticate” or similar, see this guide
  • If you encounter a permission error such as “user permission denied” or similar, follow this guide.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.