This document contains frequently asked questions that arise when using the StackAdapt data source. You can quickly navigate to a particular FAQ by using the table of contents below.
What should I know about Domain data?
Why can't I see audio-related metrics on any data views except Devices and Geo?
How do I add a GraphQL API token for uninterrupted API service?
What if I need data from StackAdapt that TapClicks doesn’t quite support?
What fields are available for this data source?
What data can I assign to my Tap Client from this data source?
What should I know about Domain data?
The StackAdapt's API provides lifetime snapshot data for domains, meaning it does not give daily metrics for a date range. Instead, it always provides cumulative delivery metrics for each domain over the entire lifetime of a campaign.
TapClicks stores this data daily. When you select a date range in your dashboard, TapClicks displays the most recent available data. For example, if you select August 1 to August 8, the dashboard will show the Domain Delivery KPIs retrieved from StackAdapt on August 8.
If you compare this with StackAdapt’s platform, you may notice differences. For instance, if a campaign runs from January 1 to August 31, you can pull an August 1–8 report in StackAdapt that isolates just that period. However, in TapClicks, the same range will show lifetime domain delivery KPIs from January 1 to August 8.
To ensure consistency, review Domain Delivery KPIs in StackAdapt for the entire campaign duration and compare them with what is in TapClicks.
The best practice is to review your Domain Delivery KPIs in StackAdapt from the start date of your campaign until your reporting date. Then compare that information against what is in TapClicks.
Additionally, you may see some strange behavior if you use TapClicks Comparison Date Ranges in your dashboard. If you have questions, please contact your Customer Success Manager or email customercare@tapclicks.com.
Why can't I see audio-related metrics on any data views except Devices and Geo?
Audio metrics in StackAdapt are only available in the Devices and Geo data views. This is because other API calls from StackAdapt do not support audio fields.
You can still group data by Devices and Geo to create summary-level reports for audio performance. If StackAdapt allows you to report on audio metrics at a different granularity, consider submitting a feature request to the TapClicks Product Portal. Learn how to submit a request here.
What is a GraphQL token, and why do I need it to connect to StackAdapt API?
A GraphQL token is required to authenticate with the StackAdapt API.
This token:
- Verifies your identity when making API requests.
- Ensures secure access to StackAdapt’s GraphQL endpoints.
- Allows uninterrupted data retrieval from StackAdapt to TapClicks.
How do I add a GraphQL API token for uninterrupted API service?
Please go through the steps outlined in the article: How to add a GraphQL API Token.
What if I need data from StackAdapt that TapClicks doesn’t quite support?
There are a few ways to approach this situation.
1] Create a Smart Connector to bring this data into your dashboard.
- This will allow you to get to your data fast.
- This path could be used in the long term.
- Or you can use this path while waiting for an enhancement to the StackAdapt connector.
2] Submit a request to the product team to evaluate bringing this data into the Instant On connector.
- Make sure to include report extract examples so that we can review exactly the dimensions and metrics you’re looking for in your dashboard.
- If you need help with this process, feel free to reach out to your Customer Success Manager or customercare@tapclicks.com.
What fields are available for this data source?
After you connect a data source to TapClicks, you can use that data in your reports. These fields are organized into groups of similar types of data called Data Views.
For StackAdapt, you will find a list of all dimensions and fields available for use in TapClicks, organized by data view, here: StackAdapt.
What data can I assign to my Tap Client from this data source?
Level 1 - Advertiser
Level 2 - Line Item