Singular offers special versions of the Singular SDK for apps directed at underage users. These versions of the SDK support Singular attribution while complying with the restrictions placed by the Apple App Store and Google Play Store on apps for Kids/Families.
Integrating the Singular Kids Apps SDK, instead of the regular SDK for your platform, is a good way to ensure your app does not collect device identifiers that are considered personally identifiable information and forbidden by the Apple App Store and Google Play Store for use in children's apps.
Singular offers Kids Apps SDKs for iOS, Android, Unity, Flutter, React Native, and Cordova.
FAQ
Apps for children are listed in the Kids/Family Category in the App Store and have special restrictions placed on them to protect the security and privacy of children online.
Regarding MMPs such as Singular, the guidelines say:
"In limited cases, third-party analytics may be permitted provided that the services do not collect or transmit the IDFA or any identifiable information about children (such as name, date of birth, email address), their location, or their devices." (App Store Review Guidelines)
In terms of using Singular in your app, this means that Singular can't collect the IDFA from the device.
According to the Google Play Policy Center, apps that target children must comply with the Google Play Families Policy. Regarding data collection, the policy says:
You must not transmit Android advertising identifier (AAID), SIM Serial, Build Serial, BSSID, MAC, SSID, IMEI, and/or IMSI from children or users of unknown age.
In terms of using Singular in your app, this means that Singular can't collect the GAID (AAID) from the device.
The Kids Apps SDK enables your app to pass the Kids Apps review required by the Apple App Store and the Google Play Store.
For iOS apps: If you use the Kids Apps SDK, you can be assured that Singular will not collect the IDFA from the end-user's device.
For Android apps: The Kids Apps SDK will not collect the GAID (AAID) from the end-user's device.
Notes
- Self-attributed networks (SANs) such as Google and Facebook require the IDFA/GAID in order to process requests from Singular or any other MMP. If your app uses the Kids Apps SDK, you will not get SAN attribution for that app based on IDFA/GAID (SKAN and Referrer-based measurement would still be available).
- In apps distributed outside of the Google Play Store, Singular supports identifiers such as OAID (On Huawei devices) and AMID (on Amazon devices). Check with your legal team to make sure that your app is compliant with any applicable privacy regulations.
Self-attributed networks (SANs) such as Google and Facebook require the GAID/IDFA in order to process attribution requests from Singular or any other MMP. If your app uses the Kids Apps SDK, you will not get SAN attribution for that app based on the device ID.
The Android SDK uses the InstallReferrer decryption method. The iOS SDK uses SKAdNetwork.
To integrate the Singular Kids SDK follow the instructions below based on the chosen Framework:
For iOS:
If you installed the Singular SDK using CocoaPods.
- Update your pod file to reference Singular-Kids-SDK:
Then run pod updatepod 'Singular-Kids-SDK'
If you installed the Singular SDK using Swift Package Manager.
- In Xcode, go to File > Package Dependencies and enter the Singular SDK GitHub repository for the Kids SDK:
Then follow the remaining steps under the Installing the SDK Using the Swift Package Manager.https://github.com/singular-labs/Singular-Kids-SDK
If you installed the Singular SDK using the static library:
- Download the Singular iOS Kids SDK Version 12.6.0
- Follow the iOS SDK implementation guide starting with "Using the Singular Static Library".
- DO NOT add the "AdSupport.framework" library.
For Android:
If you installed the Singular SDK using Gradle.
- Update your app/build.gradle file to reference singular_kids_sdk:
Then sync gradle.dependencies { ... com.singular.sdk:singular_kids_sdk:12.6.0 ... }
If you installed the Singular SDK using the static library:
- Download the Singular Android Kids SDK Version 12.6.0
- Add the Singular-v*.aar into the libs folder in your Android project's libs directory. If it doesn't exist, create a directory called libs in your project folder (usually at <project>/app/libs). See "Downloading the SDK Manually" and follow the Android SDK implementation guide.
- Do NOT include the permission to access the Google Advertising ID (com.google.android.gms.permission.AD_ID) in your manifest file.
For Unity:
- Follow the Unity SDK implementation guide and import the Kids App SDK where instructed.
For Flutter:
- Update the dependency in your pubspec.yaml file to reference the Singular Kids SDK.
Then follow the rest of the Flutter SDK implementation guide.dependencies: singular_flutter_kids_sdk: ^1.5.1
For React Native:
Note: If you already installed the standard Singular React Native SDK, you will want to remove it with the following command:
npm uninstall singular-react-native
- Open the terminal in the root directory of your project.
- Download the Singular React Native Kids SDK package to your project with the following command:
Then follow the rest of the React Native SDK implementation guide.npm i singular-react-native-kids-sdk
For Cordova:
Note: If you already installed the standard Singular Cordova SDK, you will want to remove it with the following command:
cordova plugin remove singular_cordova_sdk
- Open the terminal in the root directory of your project.
- Download the Singular Cordova Kids SDK package to your project with the following command:
Then follow the rest of the Cordova SDK implementation guide.cordova plugin add singular_cordova_kids_sdk
The USA's COPPA (Children’s Online Privacy Protection Act) and the European Union's GDPR Kids (General Data Protection Regulation for Kids) each have specific requirements for preserving children's privacy and security online. These may differ from the standards used by Apple and Google in their app stores. Using the Kids Apps SDKs doesn't necessarily ensure compliance with COPPA/GDPR, and it's possible to use Singular's general SDKs and still comply with COPPA/GDPR.
If you are looking to build a COPPA/GDPR-compliant app, you can reach out to your Singular Customer Success Manager or Singular Support for guidelines.