1. Check if it is an inactive data connector

By default, the Data Connectors page only shows data connectors from which data has been pulled in the last 30 days. If no data has been processed from the data connector in the last 30 days, it is considered inactive.

To show the full list of active and inactive data connectors, toggle Show Connectors without data in the last 30 days:

2. Check if a data connector is available for your account type

File-based data connectors (based on report files delivered to Singular by Email, Google Doc or s3 bucket integrations) are only available to enterprise-level customers. Encourage your media partners to help Singular build an API-based data connector.

You can't create multiple connectors to the same ad network with the same credentials.

If you don't find the existing connector in the list, try toggling Show Connectors without data in the last 30 days:

When you've integrated the Singular SDK and have started sending SDK events, a new data connector called "Singular Tracker" will be added automatically. This is so that you can track whether your Singular attribution data is pulled successfully.

This is probably because there was no data for yesterday from the media source.

The “Latest Date Queried” means that Singular pulled data from the network for that date without encountering an error. However, sometimes the data pulled from the network is simply empty. This can happen, for example, if you did not run any campaign with this media source.

If you've toggled Show Connectors without data in the last 30 days off, you may see the following error message:

This means that Singular was able to successfully query data, but the media source has no cost data to report. If the media source reports no data for 30 days, its data connector will be filtered out by the toggle.

A data connector pulls data from an ad network or another media source into Singular.

There are data connectors that pull campaign advertising cost reporting data as well as connectors for pulling ad monetization (in-app revenue) data.

  Learn more about running reports
  Learn more about ad monetization reporting

Our platform supports several types of data connectors:
1. API
2. File Based - Mail, Gdrive, S3
3. SFTP
The available connector types may vary depending on the ad network. You can identify the different types by the icons next to each connector's name.

Sometimes this is because you are pulling campaign data and ad monetization data from the same network, and this requires two separate data connectors.

Another possibility is that your organization has simply added multiple data connectors for the same ad network, each with its own login credentials.

The data connectors with “Ad Monetization” in the name signify that ad monetization (in-app revenue) data is being ingested from the monetization source. In-app revenue data from these data connectors are shown in Singular under Reports --> Ad Monetization. Data Connectors without "Ad Monetization" report campaign advertising costs in Singular reports. 

  Learn more about ad monetization reporting

Singular uses different methods to pull data, depending on the way the media source makes its data available. The data connector may be based on the media source's reporting API, reports transferred as files by Google Drive, Emails, s3 buckets or even a combination of two or more of these methods.

  Learn more about Email reports and Google Docs reports

To locate your customer ID (for both manager and individual accounts):

1. Log into your Google Ads account.
2. Click the help icon in the top right corner.
3. Find Customer ID at the bottom of the menu.

For more information about the AdWords data connector, see the AdWords (Google Ads) Data Connector FAQ.

To get the required API authentication credentials:

1. Log into your Apple Search Ads account.
2. Go to Settings > API and click Create API Certificate.
3. Select the certificate you just created and click Actions > Download Certificate. A ZIP file is downloaded to your computer containing the two credentials you need. Open the files (if you are unable to open them, change the file extension to .txt).
4. Copy the entire contents of the .key file into the "API Authentication: RSA Private key file" field (including "-----BEGIN PRIVATE KEY-----", "-----END PRIVATE KEY-----").
5. Copy the entire contents of the .pem file into the "API Authentication: Certificate .pem file" field (including "-----BEGIN CERTIFICATE-----", "-----END CERTIFICATE-----").

To get your Vungle reporting API key, see Vungle's instructions.

Additional instructions: Singular's special integration with Vungle relies on S3 reporting and needs to be configured for you by Vungle. To finish setting up the Vungle data connector, send a message to singular@vungle.com including your Vungle account email and your campaign start dates (if the campaigns have been launched already). CC your Vungle and Singular representatives. It may take up to 72 hours to configure your integration on Vungle's side.

After you add a data connector, Singular starts pulling data immediately. You will see that the connector status on the page is ● Pending. Check back later to see when the pull is done.

The next data pulls will be carried out daily at midnight your local time. You can look at the Next Update column to see when the next pull is scheduled.

The green status indicates that Singular was able to pull data for yesterday, but sometimes there is still an issue you need to fix. Check the message to see what you need to do.

This usually happens when you have removed an account from a self-attributed network (SAN) such as Facebook, but have not removed it from your account list in Singular. You can easily solve this by editing the data connector as mentioned in the message.

This data connector has been set up to receive reports by email, but Singular has not received an email report. Contact the media source to notify them.

  Learn more about Email reports and Google Docs reports

Hover over the connector and select the Edit icon. Re-input your credentials to make sure they are correct. If you are authorizing the connection using a network such as Facebook, make sure you are logged into the correct network user (and not a personal user, for example).

If you’ve set up Data Destinations to export your data from Singular, you may see the ETL Status column on the Settings > Data Connectors page. This column shows you whether data was successfully pushed to your data destinations for each data connector.

The following statuses are available:

If you have multiple data destinations set up, you can click the arrow icon to see the status for each of them.

Based on the type of data connector and data destination, your visibility may differ.

This is the last day for which Singular has pulled data successfully from this data connector. If everything is working correctly, this should be today/yesterday.

This is the date and time in which Singular last pulled data from this data connector. It’s where you can see how fresh the data that you see in Singular is.

Some examples:

Note: The “Last Updated” date always applies to the freshness of the data from the “Latest Date Queried” but does not necessarily apply to earlier dates.

Click Run Test Report to automatically run a report in Singular’s report query page for the selected data connector. This allows you to check what data Singular is pulling from this data connector.

The parameters for the test report are:

• The report covers yesterday only.
• The dimensions and metrics are all ad network data (rather than attribution tracker data).

The raw data CSV is a copy of the last data import Singular pulled from this data connector for the date you see in the "Latest Date Queried" field. Usually, this means the data for yesterday.

You can download the raw data CSV by hovering over a data connector and clicking the Raw Data CSV icon.

The data in this CSV-formatted file is "raw" in that it has not undergone currency conversions or any of Singular’s other data processing steps. However, the dimension names are mapped to Singular dimension names.

You can use the Raw Data CSV to troubleshoot some issues with your data. For example, if you see missing or unexpected data in your Singular reports for a certain ad network, the Raw Data CSV can show you if the problem already existed when the data was pulled from the ad network.

Yes. In special circumstances, you can request a Data Refresh for some of your data connectors. See How to Refresh Data for a Data Connector.