This guide contains all permissions and requirements for connecting your Adthena data to Supermetrics.
You can connect to data sources from the Data sources page on the Supermetrics Hub. On the Hub, you can also share an 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.
Required permissions
To connect to Adthena, you need an API key and your Account ID.
API key: Contact Adthena support at support@adthena.com to request an API key. Note that you need a unique API key for each Adthena account or location.
Account ID: Your account ID can be found in the URL of your Adthena dashboard:
https://application.adthena.com/brand-activator/{account_id}.
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.
AI Overview Daily: Track how often AI overviews appear for your search terms over time, including appearance counts and frequency by device.
AI Overview Search Terms: Analyze AI overview performance at the search term level, including ad position data for your account and competitors above, below, and inside AI overviews.
AEO Performance: Monitor your brand's performance in AI engine results (ChatGPT, Perplexity), including citation frequency, average position, and performance score by domain.
Market Trends: Track competitor share of clicks, impressions, spend, and average CPC across ad types (text ads, organic, Shopping/PLA) over time.
Connection instructions
When connecting to Adthena, you need to provide your API key and account ID and select the account to use when prompted.
Select the Adthena data source on the Supermetrics Hub or in the data destination.
Enter your API key and Account ID.
Give your connection a name to identify it if you have multiple accounts.
If prompted, choose to make this connection shared or private.
Click Start.
In your data destination, select the account and query type to use.
See detailed instructions on how to connect to a data source from the Supermetrics Hub.
You can also connect to Adthena from these destinations:
Data Studio: How to connect data sources to Data Studio
The Supermetrics API: How to use the Query Manager
Data warehouse and cloud storage (Hub): How to create a transfer
BigQuery (marketplace): How to create a BigQuery (marketplace) transfer
Troubleshooting
If you see an error message saying Feature not enabled for this account, your Adthena account doesn’t have access to the requested data. This means that, for example, a specific ad type (text ads, organic, or Shopping/PLA) may not be included in your subscription. Contact Adthena support for more information.