Starting May 13, 2025 Supermetrics will begin the rollout to a new version of the StackAdapt data source connector, which will run on the newer GraphQL API. This includes some new functionality, as well as requiring a new specific API key for this version.
This article outlines what you need to do to keep your queries running. The important steps are requesting a new API key from StackAdapt and switching to the new API key on the Supermetrics Hub.
Request new GraphQL API key
As part of this change, you will be required to request a GraphQL (GQL) API key from your StackAdapt account manager, to be used to connect when the new version is enabled for you.
Please request the key as soon as possible so you are ready for the switch, as the old REST system keys will not function after you have been switched over.
Important
You will receive an email from Supermetrics that will tell you which date and time your team(s) will be switched over to the new version of the StackAdapt connector.
Do not use your GraphQL API key until after that time! Switching too soon will cause disruptions to your queries or data transfers.
Switch your API key
After the date and time specified in your email for us about the switch, you may start to see errors like the following:
The following StackAdapt account is no longer available: XXXX
That is your cue to switch to your GraphQL API key so your existing queries can keep working under the new version.
Follow these instructions to switch the API key:
- Log in to the Supermetrics Hub.
- Select your team.
- Go to Data sources and look for your StackAdapt connection.
- Click + Add new connection.
- Setup your new GraphQL API key connection:
- Account name: Give a meaningful account name to tell it apart from the old key.
- API key: Insert your GraphQL/GQL API key.
- Click Start and finish the login process.
- You should now see the new API key in the Data sources list alongside your old one.
- Use the Replace connection option on the old REST API key to update it to your new GraphQL API key.
- If you have multiple StackAdapt connections with several REST API keys, repeat the steps to add each GraphQL API key and replace the old keys with them with the Replace connection functionality.
And that’s it! Your existing queries should now use the new API key and be refreshable under the new version.
Special note for Looker Studio users
After you update your StackAdapt API key, refresh the field list in the StackAdapt data source to access the new version’s configuration and new fields.
New fields
We have added more fields, previously unavailable under the the older API:
- Frequency
- Average time on site
- Cookie conversions
- IP conversions
- eCPCL
- rCPA
- rCPC
- rCPCL
- rCPE
- rCPM
- ROAS
- Secondary conversions (this replaces the old “View-through conversions” metric)
- Third-party CPC cost
- Third-party CPM cost
- Audio started
- Audio completed
- Audio completion rate
We’re here for you
If you have any questions or concerns about this change, contact our support team.