Search documentation...

K
ChangelogBook a demoSign up

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.

To ensure syncs send each event, your event model must use a truly unique primary key. See the events syncs documentation for more information.

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.

Tips and 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.

Live debugger

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

Sync alerts

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

Ready to get started?

Jump right in or a book a demo. Your first destination is always free.

Book a demoSign upBook a demo

Need help?

Our team is relentlessly focused on your success. Don't hesitate to reach out!

Feature requests?

We'd love to hear your suggestions for integrations and other features.

Last updated: Jan 4, 2023

On this page

OverviewSupported syncingGetting startedAuthenticating with an API keySyncing dataEventsTips and troubleshootingCommon errorsLive debuggerSync alerts

Was this page helpful?