xpereta / appsflyer-sdk-v6-sample-app

A sample to demonstrate the init and functionality of AppsFlyer's SDK v6

Welcome to AppsFlyer SDK 6.x

‼️ The sample app is cmpatible with the IDFA limitations in iOS 14.5

iOS 14.5 blocks the collection of IDFA unless the user allows ita collection when the application starts.

AppsFlyer's SDK - starting of version 6.0.3 - supports this functionality using Apple's AppTrackingTransperancy framework.

This sample app will allow you to test this functionality and ensure that your app is running smoothly ahead of the release of iOS 14.

Compatability

• iOS version >= 10.0

• AppsFlyer SDK version 6.0.3 (current installed SDK is 6.2.2)

How do I test consent to collect of IDFA?

When the application initialises in iOS 14:

This code shows a menu that requests the user to authorise IDFA collection.

// The following block is optional for applications wishing to give users the option to collect IDFA.
// for iOS 14 and above - The user may be prompted to collect IDFA.
//                        If user opts-in, the IDFA will be collected by the SDK.
// for iOS 13 and below - The IDFA will be collected by the SDK. The user will NOT be prompted to consent.
if #available(iOS 14, *) {
  // Set a timeout for the SDK to wait for the IDFA collection before handling app launch
  // If timeout expires before the user allows to collect IDFA , the IDFA will NOT be collected.
  AppsFlyerLib.shared().waitForATTUserAuthorization(timeoutInterval: 60)
  // Show the user the Apple IDFA consent dialog (AppTrackingTransparency)
  // MUST be called here before start() in order to allow IDFA collection by the SDK
  ATTrackingManager.requestTrackingAuthorization { (status) in
                                                 }
}

Get code here

In the app you have a button 'Test IDFA collection'

If user authorised IDFA collection, its IDFA will be displayed

If user DID NOT authorise IDFA collection, a message will be displayed

Why is the demo app asking me to allow notifications?

The notifcations are used for the uninstall detection flow

How to use this demo?

1. Clone the repository
2. Make sure to open the work environment via Xcode workspace basic_app.xcworkspace
3. Get your AppsFlyer Dev Key using these instructions.
4. Create the file sdk-v6-demo/afdevkey_donotpush.plist with the following content:

<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
        <key>appsFlyerDevKey</key>
        <string>YOUR_AF_DEV_KEY_HERE</string>
        <key>appleAppID</key>
        <string>YOUR_APPLE_APP_ID_HERE</string>
</dict>
</plist>

5. Add the file into your Xcode project

The file sdk-v6-demo/sdk-v6-demo.xcodeproj/project.pbxproj will have some changes. Do not commit them!