Integrating with Singular Analytics (FAQ for Partners)

Follow
Avatar
Liz Lauer-Lopez
Updated

Singular's marketing analytics platform gives advertisers a unified view of all their marketing data in one place to empower them to make better decisions. This article helps you learn how to become an integrated partner of Singular's marketing analytics platform sending us advertising cost for mutual advertiser campaigns.

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 analytics platform gives advertisers a unified view of all their marketing data in one place to empower them to make better decisions.

What Singular does:

  1. Automatically pulls marketing cost 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).

To pull data from all the sources 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 cost integration?

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

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

The way we build the data 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, automatically parse an email report, or even ingest a report file from Google Drive or Amazon S3. 

Note:

  • 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. See the integration specifications.
  • Once an integration is set up (e.g., the customer enables the integration in their Singular account by adding the Data Connector with the required credentials for your integration), 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 cost data and attribution data to give the customer a unified, high-granularity report.

For that purpose, we need to get the most detailed breakdown of cost data, to match the granularity of data you support in your attribution integration. 

When you provide reporting data, include at least the date, brand/app name (this will align with what the customer has input into their Singular Advertiser Account under "Apps"), campaign, and cost fields - these are mandatory. Singular also supports sub-campaign, 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. When an advertiser first adds a Data Connector to ingest cost campaign data from your integration, Singular will attempt to pull data for the last 3 months.

How does Singular access the data?

Singular uses several 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 pull each customer's data separately to differentiate the data on our end.
    • If you are an agency running campaigns for an advertiser from your network partner account, we cannot use an existing API integration. Contact our support team so we can initiate a file-based integration with you to ensure we are only receiving advertising cost data for the mutual customer.
  • 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.

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 do not include 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.

*For non-mobile campaigns, we do not expect to receive a "platform" breakdown of cost data, but having this information in the campaign name will allow advertisers to understand the platform on which their ad/creative was targeted and on which mobile platform (iOS or Android) the audience converted. See more instructions for non-mobile partner sources.

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:

    <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 bucket: 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
      • Ensure the bucket name starts with “singular-sharing-data-”
    • Relevant customer bucket names
    • Note: if you want to use IAM permissions, we support this and you will work with our integration team to ensure we can access your bucket using the permissions you have set.