Before you connect
The following are required:- A Singular account with API access.
- A Singular API key, generated from the Singular dashboard under Developer Tools → API Keys. Singular’s Reporting API Reference documentation provides additional context.
- A report-type decision for each data source, since the report type is set per data source at creation.
Connect Singular
1
Open the Singular data source
On the Data Sources page, search for Singular and select it.
2
Enter the API key
Paste the API Key retrieved from the Singular dashboard into the API Key field.
3
Choose the report type and options
Enter a Name to identify the data source, then choose the Report Type — All, SKAN, or Normal. Optionally, refine the pull under Configuration: filters (Campaign Filter, App Filter, Country Filter, Custom Filter), metric selectors (Cohort Metrics, SKAN Events, Conversion Metrics), and extra breakdown options. Apply a filter only when the same filter is in use in the Singular UI.
4
Submit
Click Submit to complete the connection. Initial data availability can take up to one business day.
What gets imported
Reports arrive at daily granularity in each ad network’s local currency. After connection, the previous 60 days are backfilled; afterward, the most recent 30 days are refreshed daily. SKAdNetwork installs and conversion values follow Apple’s postback timer, so the most recent days settle as later postbacks land. For the full metric list and SKAN and unified report details, see the Singular data reference.Troubleshooting
The API key is rejected
The API key is rejected
Singular validates the key against its cohort metrics endpoint, and a non-200 response causes the key to be treated as invalid. Regenerate the key under Developer Tools → API Keys in Singular and reconnect.
Validation error: at least one metric or SKAN event must be selected
Validation error: at least one metric or SKAN event must be selected
SKAN report types require at least one standard SKAN metric or SKAN event. Re-open the data source form and add a selection from either picker.
Validation error: at least one metric, cohort, or conversion metric must be selected
Validation error: at least one metric, cohort, or conversion metric must be selected
Unified report types require at least one standard metric, cohort metric, or conversion metric. Add a selection from at least one of the three pickers.
SKAN and unified data are needed together
SKAN and unified data are needed together
A single data source supports one report type. Create a second Singular data source in the other report type to pull both alongside each other.
Related
Singular data reference
Metrics, breakdowns, report types, and limits for Singular.
Singular FAQs
Common questions and expected behaviors for the Singular data source.
How to connect AppsFlyer
Connect another mobile measurement partner with similar coverage.
How to connect Adjust
Connect the Adjust MMP data source.
