Integrate Appsflyer SDK

Appsflyer is a multi-purpose app analytics plugin. It offers features such as page view analytics, uninstall detection, and universal link support. iOS devices using this feature must use version 13.0 or higher.

The current provided version is 6.3.1.

To integrate the Appsflyer SDK with the Mobile SDK:

  1. Follow Appsflyer’s documentation to configure your dashboard.
  2. Add the package to your conanfile.py conditionally following the pattern established in that file. This will look something like:

conanfile.py

1
2

if 'appsflyer' in stdout:
  self.build_requires("appsflyer/6.3.1-16@mx/stable")
  1. In client/default/config/configuration.yaml, set has_appsflyer_plugin: true.
  2. Run ./setup and ./generate.
  3. Contact MX to send your Appsflyer configuration template files. Save those files under the institutions/<your_institution_name>/plug-ins/appsflyer folder.
  4. In plug-ins/appsflyer/appsflyer_config.h, set the following configuration strings for Android or iOS.
    • For Android, set ANDROID_DEV_KEY, which is declared as constexpr const char*, as constexpr auto = "[key]".
    • For iOS, set the NSString* _Nonnull keys IOS_DEV_KEY and IOS_APP_ID, which Appsflyer provides.
  5. If you’re using universal links, set UNIVERSAL_LINK_HANDLER_ID and INVITE_SHORT_LINK_CODE (also as constexpr auto). Set UNIVERSAL_LINK_HANDLER_ID to "appsflyer". INVITE_SHORT_LINK_CODE is the template short code for a universal link created in the Appsflyer dashboard.
  6. If you followed the previous step, also configure the following object for universal links in internal_configs.json.
    • The "host" field is the onelink host used, and the "path" is the path root for universal links. An invite universal link would appear as https://sub.onelink.me/n5Fa/[INVITE_SHORT_LINK_CODE]. Set the "handler" field to "appsflyer". The "fallback" field is the fallback scheme set up in the Appsflyer dashboard for universal links.

institutions/<your_institution_name>/config/internal_configs.json

1
2
3
4
5
6
7
8
9
10

"universal_links": {
  "links": [
    {
      "host": "sub.onelink.me",
      "path": "n5Fa",
      "handler": "appsflyer",
      "fallback": "afscheme"
    }
  ]
}
  1. If building for iOS, open plug-ins/appsflyer/config.yaml and set ns_user_tracking_usage_description to customize the custom text for permission to track dialog in iOS.

Integrate LivePerson SDK

LivePerson is a chat service used by businesses to connect their users to company chat agents. It integrates into iOS and Android mobile applications.

To integrate the LivePerson SDK with the Mobile SDK:

  1. Contact MX to set up the logic needed to fetch your chat verification token.
  2. Add the package to your conanfile.py conditionally following the pattern established in that file. This will look something like:

conanfile.py

1
2

if 'liveperson' in stdout:
    self.requires("liveperson-iOS/6.10.0.849-1@mx/stable")
  1. In client/default/config/configuration.yaml, set has_liveperson_plugin: true.
  2. Run ./setup and ./generate.

Now, contact MX to send your LivePerson configuration template files. Save those files under the institutions/<your_institution_name>/plug-ins/liveperson folder.

Integrate Zelle SDK

Zelle is a service for sending money to friends and family that integrates into many banking applications. Zelle integrates with the Mobile SDK’s payments UX as an additional payment option. You don’t have control over its theme or appearance. This guide shows you how to integrate Zelle payments into the Mobile SDK for Android and iOS.

Mobile SDK supports Zelle SDK versions 1.4.x and higher for both Android and iOS.

To integrate the Zelle SDK with the Mobile SDK:

  1. Contact MX to configure the use of Zelle for your implementation. This includes providing MX with an endpoint so we can receive the following:
  • base URL
  • Institution ID
  • SSO token
  1. Add the package to your conanfile.py conditionally following the pattern established in that file. This will look something like:

conanfile.py

1
2

if 'zelle' in stdout:
  self.requires("zelle-iOS/1.4.0-4@mx/stable")
  1. In client/default/config/configuration.yaml, set has_zelle_plugin: true.
  2. Run ./setup and ./generate.