Integrating with Singular Analytics FAQ (Partners)

Singular’s marketing intelligence platform gives advertisers a unified view of all their marketing data in one place in order to empower them to make better decisions. This article helps you learn how to become an integrated partner of Singular’s marketing analytics platform.

Be sure to read Integrating with Singular: A Guide for Partners first to learn about Singular and the different integration options.

See also: Integrating with Singular Attribution.

If you are a Singular customer, see the Data Connectors FAQ instead to learn how to use Singular's existing analytics integrations in your account. See Partner Configuration for information about Singular's attribution tracking integrations.


What is Singular analytics?

Singular’s marketing intelligence platform gives advertisers a unified view of all their marketing data in one place in order to empower them to make better decisions.

What Singular does:

  1. Automatically pulls marketing performance data from all of the advertiser’s ad networks, agencies, and other sources into one database
  2. Combines this data with attribution stats pulled from Singular’s native attribution solution or a third-party attribution tracker used by the advertiser
  3. Presents the combined data in dashboards and reports that provide customized performance and ROI insights. The data is presented in a high level of granularity, with breakdowns by app, campaign, targeted country, publisher app, creative, and more).

In order to pull data from all the sources as described above, Singular is integrated with over 1000 companies, including ad networks, agencies, self-attributing networks, BI services, and more. You can browse the full list of partners to get an idea of who we work with.

We keep developing new integrations to meet the needs of our customers - but we need you to help us do it.

What is a Singular analytics integration?

We create analytics integrations (also known as data connectors) when we have a mutual customer that uses you as an ad network, ad agency, or similar service.

The integration is designed to pull the customer’s aggregated marketing campaign data from you every day in order to present up-to-date data in our analytics reports.

The way we build the connector is highly flexible and depends on the way you present data to your customers. We can pull data from your API if you have one, read it from your dashboard, automatically parse an email report, or even ingest a report file from Google Drive or Amazon S3. 


  • While we support file-based integrations (email, S3, etc.), we don't support them for all our customers (only enterprise-level customers). We encourage you to help us build an API-based integration if possible.
  • The integration should be generic - even if it is originally constructed by request of one particular customer, it should be able to serve multiple customers in the future. Please see the integration specifications here.
  • Once an integration is set up (e.g., the customer enables the integration in their Singular account and enters their credentials), the integration provides daily data updates automatically, with no further action needed from the user.
What data fields does the integration pull?

Remember that Singular’s goal is to combine campaign data and attribution data in order to give the customer a unified, high-granularity report.

For that purpose, we need to get the most detailed breakdown of data we can, both in our analytics integration and our attribution integration.

When you provide reporting data, include at least the date, campaign, and cost fields - these are mandatory. Singular also supports creative, publisher, and platform breakdowns, and additional metrics such as impressions, clicks, and installs.

How often does the integration pull data?

Singular pulls data daily, and we pull data for the last 7 days.

How does Singular access the data?

Singular uses a number of different methods to integrate with partners:

  • API Integrations: Singular can pull data from your reporting API. Note that the API key we use for the integration should be different per customer! We need to be able to pull each customer’s data separately in order to differentiate the data on our end.
  • Dashboard-Based Integrations:  If you have a reporting dashboard, we can pull the customer’s data from it.
  • File-Based Integrations (Email, Google Drive, S3):  Singular can ingest data from email reports as well as files shared on Google Drive or S3, if this is how you provide your reports to customers.
How do I become an integrated partner?

1. Gather the necessary information

This depends on the type of integration you want to have with Singular.

Integration Type Required Information
API Integration A link to your API documentation that includes the endpoints, supported fields, authentication method, etc.
File-Based Integration (Email, Google Drive, S3) We need the email or file to be in a particular structure. To begin,  prepare a sample report in line with our report template.

  • The mandatory fields are Date (by day), App name, Campaign Name, Platform or Store ID, and the desired metrics.
  • We also recommend filling in as much information as possible to increase granularity.
  • If you will not be including data for a certain field, remove that column from the file entirely instead of leaving it blank.
  • In the Platform column we support the following values: iOS, Android, iPhone, iPad, Web, and Desktop.

2. Fill out the form

Fill out the form to become a Singular partner!

Once your application is approved, you will receive an email notification informing you to log back into the Integration Center to submit your technical specifications for our team to review.

3. Next steps

After you submit your specifications, we will review them and contact you to let you know if we have any questions or if we have all the information we need.

Then we will create the integration. When we’re done, we’ll let you know, and we will activate the new integration for the customer.

We will also add the integration to the list of Singular integrations available to customers. Future Singular customers who are also users of your service will also be able to use the integration.

Requirements on your side:

  • If you will be sharing the report by email with us, send the first report to:

  • If you will be sharing the report through Google Drive:
    • Share the report with
    • We pull data from one file per customer only, meaning that the same spreadsheet should be updated with new data every time.
    • We support data in multiple sheets.
  • If you will be using S3: provide us with the following:
    • Access to a s3 bucket that contains a folder for each customer's files.
      • AWS access_key and secret_key
    • Relevant customer bucket names