Integrating with Singular Analytics FAQ (Partners)

Learn how to become an integrated partner of Singular’s marketing analytics platform. Make 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 once 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. 

Note:

  • 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.
  • 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, please 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. Please 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. See our Reporting API Guidelines.
Dashboard-Based Integration Dashboard URL and the customer’s credentials
File-Based Integration (Email, Google Drive, S3) We need the email or file to be in a particular structure. To begin, please prepare a sample report in line with our report template.

Important:
  • 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, please 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!

3. Next steps

After you submit the form, we will review it 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, please send the first report to <MUTUAL CLIENT NAME>-noreply@singular.net
  • If you will be sharing the report through Google Drive:
    • Share the report with reports@singular.net
    • 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: Please upload the reports to a dedicated S3 bucket and provide us with the following information:
    • AWS access_key and secret_key
    • Relevant bucket names
Was this article helpful?
0 out of 0 found this helpful