Singular Destination

Singular is a Marketing Intelligence Platform that transforms marketing data into accurate, granular and actionable insights to drive growth. By unifying marketing campaign data with attribution data, marketers can measure ROI from every touchpoint across multiple channels for a single source of truth.

This destination is maintained by Singular. For any issues with the destination, please reach out to Singular Support.

NOTE: Singular is currently in beta, which means that they are still actively developing the product. This doc was last updated on April 15th, 2019. If you are interested in joining their beta program or have any feedback to help improve the Singular Destination and its documentation, please let their team know!

Getting Started

The first step is to make sure Singular supports the source type and connection mode you’ve chosen to implement. You can learn more about what dictates the connection modes we support here.

📱 Device-based
☁️ Cloud-based
  1. From your Segment UI’s Destinations page click on “Add Destination”.
  2. Search for “Singular” within the Destinations Catalog and confirm the Source you’d like to connect to.
  3. Add your Singular “API KEY”, found in your Singular Dashboard under ‘Settings’ > ‘SDK Keys’, to the Segment Settings UI.

What’s supported

  1. Install Attribution
  2. Apple Search Ads Attribution
  3. Custom Event Tracking
  4. Revenue tracking

Install Attribution

Will work out-of-the-box once the integration is live as this is based on app opens and will be sent automatically by the integration.

Apple Search Ads Attribution

Will work out-of-the-box once the integration is live as the ASA attribution data will be sent automatically by the integration.

Tracking Custom Events

If you haven’t had a chance to review our spec, please take a look to understand what the Track method does. An example call (in Android) would look like:


Those calls will be sent to Singular and processed as custom post-install events and will be available in reporting & user-level exports.

Revenue Tracking

Any event with the revenue property will be tracked as a revenue event, you can optionally pass the currency (as an iso3 code). The default currency is USD.

For example in Android you would do:

Analytics.with(context).track("Purchased Item", new Properties().putRevenue(1.99));

If you have any questions, or see anywhere we can improve our documentation, please let us know!