This guide describes how to add and configure Singular integration.

Singular is a marketing platform which allows you to get a complete view of ROI with next-gen attribution, full-funnel marketing data, and best-in-class fraud prevention.

How to Add Integration?


Collect advertising identifiers

For both iOS and Android you must manually provide advertising identifier by calling Apphud.setAdvertisingIdentifier(idfa)on iOS and Apphud.collectDeviceIdentifiers() on Android.

Please follow all steps below:

Step 1

At Apphud go to "Integrations" section and add Singular:

Step 2

Enter SDK key for production and optionally sandbox environments:

Step 3

You can enter your custom event names or disable some.


Important Note

Please, use only lower-case alpha-numeric characters (a-z and 0-9) for your in-app event names.

Step 4

Enable integration and Save changes:

Step 5

Set Custom User ID. In your app it's recommended to set customer user ID as Apphud User ID:



Do not Reject IAP without receipt

Apphud events, by default, do not contain store receipts because we validate purchases prior to event triggering. As a result, it's important not to activate the 'Reject IAP without Receipt' option on Singular's Apps page, ensuring that these pre-validated events are accepted by Singular.

Collect Device Identifiers on Android (required)

For Android SDK 1.8.0 or higher, Advertising Identifier is not collected automatically. You must manually call Apphud.collectDeviceIdentifiers() method after SDK initialization.
When targeting Android 13 and above, you must also declare AD_ID permission in the manifest file.

Request iOS IDFA Consent (highly recommended)

Starting iOS 14.5 access to IDFA requires user consent. You should request IDFA manually using AppTrackingTransparency framework and pass it to Apphud. Read more here.

View Revenue in Singular

You can view your revenue in Singular under App Reports

Testing Integration

Make sure Singular SDK is properly integrated in your app and Singular integration is configured in Apphud.

  • Open "Testing Console" in Singular and add your test device.
  • Make a purchase and you will see Apphud events there.