Singular
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.
Collect advertising identifiers
For both iOS and Android you must manually provide advertising identifier by calling
Apphud.setAdvertisingIdentifier(idfa)
on iOS andApphud.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:
Singular.setCustomUserId(Apphud.userID())
Singular.setCustomUserId(Apphud.userID())
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
- 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.
Updated 6 months ago