iOS SDK integration guide for marketers

At a glance: Integrate AppsFlyer SDK into iOS apps to measure installs, in-app events, media sources, and more.

ioios2.png

1. Overview

The SDK provides app installation and event recording functionality. You can record installs, updates, sessions, and in-app events. In-app events include, for example, in-app purchases or leveling up in a game. Recording these events can help you evaluate ROI and user quality. 

The SDK integration requires that the marketer and the developer work together. This guide describes the decisions and actions that the marketer must perform during the integration and links to the relevant developer documentation.

This article describes the SDK integration process for V6+. Additional documentation includes the following:

1.1 SDK compatibility

The AppsFlyer iOS SDK is compatible with the following platforms:

  • iOS 9+ (iPhone, iPod, iPad)
  • tvOS 9+ (Apple TV)
  • Complies with Apple IPv6 DNS64/NAT64 networks

The SDK supports multiple attribution methods. The attribution methods that are used depend on the following:

  • The iOS version installed on the user's device
  • The iOS SDK version installed in the app
Attribution methods supported iOS version iOS SDK support Notes
Probabilistic modeling

8 – 14.4

 

5.0.0+  

14.5+

6.0.3+ Probabilistic modeling is limited to the context of owned media, cross-promotion, and consented web-to-app flows.
ID matching

8 - 13 5.0.0+ Users can opt out using Limit Ad Tracking (LAT).
14.5+ 6.0.3+

App Tracking Transparency (ATT) is enforced. For more information, see configure the iOS SDK to support ATT.

SKAdNetwork

11.3 - 13

6.0.3+

SKAdNetwork Solution is limited to install attribution in accordance with the SKAdNetwork specification, meaning there is no conversion value.

14+

 

  • SKAdNetwork Solution is always available at the iOS and SDK levels irrespective of the ATT setting.
  • The marketer enables in the AppsFlyer dashboard.

Starting from SDK V6.0.8, Apple App Clips attribution is available. You can also read our blog post about Apple App Clips. 

1.2 SDK integration

The SDK integration includes the following:

Tab Tasks After completion

SDK Integration 
[Mandatory]

  1. Retrieve the AppsFlyer dev key and send the link to the developer.
  2. Send the developer instructions for installing the SDK in your app and integrating the SDK
  3. Review the App Tracking Transparency (ATT) guidelines and send the developer instructions for ATT implementation. Decide on the wording for the ATT consent dialog box, and provide the text to your developer.
  4. Configure SKAdNetwork measurement in the AppsFlyer platform.  
  5. Work with the developer to test the SDK integration.

Basic attribution reporting can begin for your app. You can start to view real-time LTV user-acquisition (UA) performance in the dashboard.

Core APIs 
[Recommended]

  • View in-app events and revenue on your dashboard and understand actions performed by users after conversion.
  • Use deep linking to direct new users to personalized content, or run retargeting campaigns and serve existing users customized content.

Additional APIs

Work with your developer to implement optional APIs such as: 

Measure uninstalls, referrals, user engagements with push notifications, and manage user privacy scenarios.

The SDK reference documentation for developers is here.

Was this article helpful?

Comments

11 comments
  • Hi everyone!

    We want to update you that a new AppsFlyer iOS SDK has been released - version 4.10.3.

    This version supports iOS 13 updates, specifically push token retrieval for Uninstall Measurement.
    The new version also includes bugs fixes and improvements.

    We recommend that you update your app to use version 4.10.3.

    Thank you!

    0
    Comment actions Permalink
  • Hi everyone!

    We want to update you that a new AppsFlyer iOS SDK has been released - version 5.0.0.

    The new version introduces changes to method names and SDK functionality.

    We recommend that you update your app to use version 5.0.0. If you update to version 5.0.0, pay attention to changes in method names and conversion data format.

    For more information, see the following link:
    https://support.appsflyer.com/hc/en-us/articles/360003090618

    0
    Comment actions Permalink
  • Hi everyone!

    We want to update you that a new AppsFlyer iOS SDK has been released - version 5.1.0.

    The new version improves Objective-C - Swift interoperability.

    When our SDK guarantees that a certain value is not null, we return non-optional value. Otherwise, we return an optional so you need to unwrap it manually. If you migrated from older versions of the SDK and used to have unwrapping “?” character in any code that references the SDK, you will get compile-time error now unless you remove “?” as the returned type is no longer optional.

    We recommend that you update your app to use version 5.1.0. If you update to this version, make sure you adapt your code accordingly.

    For more information on optional and unwrapping in swift, see the following link:
    https://docs.swift.org/swift-book/LanguageGuide/OptionalChaining.html

    0
    Comment actions Permalink
  • Hi there!

    AppsFlyer iOS SDK version 5.2.0 has been released.
    Why should you update to it?

    Besides maintenance and bug fixes the new version introduces the following features :
    * Allow setting advanced deferred deep linking for Facebook users
    * Allow generating branded links when using User Invite feature
    * Extended security, logging, and debugging capabilities

    If you use these features or haven't updated the SDK in a while, we recommend doing so.

    0
    Comment actions Permalink
  • Hi everyone!

    AppsFlyer iOS SDK version 5.3.0 has been released! This version includes general bugs fixes and improvements, plus the following additional features:
    * Direct deep linking attribution data can be accessed at any time
    * Additional parameters are available for cross-promotion impressions
    * Main apps and app extensions get the same AppsFlyer ID, so in-app events are grouped similarly

    If you need these features or haven't updated the SDK in a while, we recommend doing so.

    Thanks!

    0
    Comment actions Permalink
  • Hi everyone!

    AppsFlyer iOS SDK version 5.4.1 has been released! This version includes general bug fixes and improvements, plus the following additional features:
    * setSharingFilter API that allows advertisers to control sharing data with integrated partners/networks.
    * onAppOpenAttribution method - aligned the response of iOS Universal Links with the rest of the use cases.

    If you need these features or haven't updated the SDK in a while, this is a great time to do so :)

    0
    Comment actions Permalink
  • Hi everyone! If you implement SKAdNetwork measurement you must adopt SDK V6.2.3 as prior versions contain a bug the impacts the setting of SKAdNetwork conversion value.

    0
    Comment actions Permalink
  • Hi everyone!

    We've released SDK V6.2.4, which fixes a bug related to SKAdNetwork in Revenue mode and in-app events.
    If you implement SKAdNetwork measurement and use Revenue mode, you need to upgrade your SDK to V6.2.4.

    For more details, see the iOS SDK release notes:
    https://support.appsflyer.com/hc/en-us/articles/115001224823

    Thank you!

    0
    Comment actions Permalink
  • Hi everyone!

    We've released iOS SDK V6.2.6.
    For more details, see the release notes:
    https://support.appsflyer.com/hc/en-us/articles/115001224823

    0
    Comment actions Permalink
  • Hi everyone!

    We've released iOS SDK V6.3.0!
    The highlight for this release is Apple Silicon (M1 chipset) support.

    For more details, see the release notes:
    https://support.appsflyer.com/hc/en-us/articles/115001224823

    0
    Comment actions Permalink
  • Hi everyone!

    Recently we’ve released two iOS SDK updates: V6.3.1 and V6.3.2.
    For more details, see the release notes:
    https://support.appsflyer.com/hc/en-us/articles/115001224823

    0
    Comment actions Permalink

Please sign in to leave a comment.