Search documentation...

K

Singular

Enrich your analytics in Singular with event data from your warehouse.

Overview

This integration lets you send server-to-server events to Singular without writing a custom pipeline. Whether you're calculating cross-device attribution, analyzing ROI, or using Singular for fraud prevention, including event data helps you have a more complete analytics view.

Supported syncing

TypeDescriptionSupported Sync Modes
EventsHightouch supports syncing in-app events to SingularInsert only

Getting started

Start by creating an instance of Singular destination in Hightouch. Upon creating your instance, you must enter a Singular API key for authentication.

Authenticating with an API key

To get your API key, navigate to Developer Tools > API Keys and copy your API key into Hightouch.

Syncing data

Events

Any records added to your source are treated as new events and are sent to Singular when your sync runs.

Platform,Package Name, and OS Version fields are the minimum required fields to make the API call to Singular. For a richer analytics, we recommend that you provide all relevant fields in your use case.

The supported platforms are iOS and Android, case sensitive. If the platform is Android, andi field is also required.

If you don't map the ip field, it will be defaulted with one from Hightouch's servers.

You can use custom mappings to attach custom data relevant to your application.

Custom mappings are included as the e parameter of the API request payload.

For more information about required fields, refer to Singular's documentation.

Troubleshooting

Common errors

If you receive errors, ensure that your including all of Singular's required fields: Platform, Package Name, OS Version and andi if your Platform is Android.

Use the Hightouch debugger

Hightouch provides full visibility into the Singular API calls made during each of your sync runs. We recommend reading our article on debugging tips and tricks.

Set up sync alerts

Hightouch can alert you of any sync issues via Slack, PagerDuty, SMS, and/or email. For details, please visit our article on alerting.

    Need help?

    Our team is relentlessly focused on your success. We're ready to jump on a call to help unblock you.

    • Connection issues with your data warehouse?
    • Confusing API responses from destination systems?
    • Unsupported destination objects or modes?
    • Help with complex SQL queries?

    Feature Requests?

    If you see something that's missing from our app, let us know and we'll work with you to build it!

    We want to hear your suggestions for new sources, destinations, and other features that would help you activate your data.

On this page

OverviewSupported syncingGetting startedAuthenticating with an API keySyncing dataEventsTroubleshootingCommon errorsUse the Hightouch debuggerSet up sync alerts

Was this page helpful?