Attentive’s mobile SDKs

Our mobile SDKs enable use of our patented two-tap mobile technology to grow your list with sign-up units inside your Android or iOS apps. In addition to converting app users to subscribers via sign-up units, our SDKs help identify subscribers who use your app and also allow you to track when users view products, add items to their carts, and make purchases. You can even track custom in-app events.

Prerequisites

  • Your brand has an Android and/or iOS mobile app
  • Your team has answered the questions in the Mobile SDKs article
  • Your brand doesn’t use Tapcart or other mobile app builders that prohibit importing other vendor SDKs.

Implement mobile SDK

  1. Download the SDK and follow the README instructions:

    • Android
    • iOS (only supported for iOS 14 or higher)

    Notes:

    • If your app is built in React Native, Xamarin, or another app development platform, you or your development team must add a way to call the Attentive SDK and then call the platform itself.
    • If the Attentive tag is already installed, your Attentive domain name can be found in the tag. In the following example, YOURDOMAIN is the domain name: <script src="//cdn.attn.tv/YOURDOMAIN/dtag.js"></script>
    • If you don’t know your Attentive domain, reach out to your Attentive CSM or our White Glove team (whiteglove@attentivemobile.com).
  2. If you’re implementing in-app sign-ups, we recommend completing the following test cases.

    Note: If you’re not in the US, you must use a VPN with a US-based IP address to test.

    • The Attentive sign-up unit appears in your app.

      • Ensure it’s the app-specific sign-up unit, not a web sign-up unit.
      • Use debug mode to search for WHITELIST and verify that it shows the mobile-apps/index.html rule.
    • Tapping X closes the sign-up unit.
    • The in-app sign-up unit respects the unit’s display rules.
    • Our patented two-tap flow works as expected (i.e., signing up in your app opens the device’s messaging app with a pre-filled message).
    • The sign-up unit doesn’t appear when the user is already subscribed.

    If you run into issues with any of these test cases, please coordinate with your Attentive contact, since some issues may be the result of a configuration in the Attentive UI.

  3. If you’re implementing event and identity tracking, coordinate with your Attentive contact to ensure events are being sent to the Attentive platform and those events are tied to subscriber users. We recommend testing the following scenarios:

    • Ensure that the following events are being received by Attentive:

      • Product views
      • Add to carts
      • Purchases
    • Ensure that all the events above are being linked to subscribers when the identity function is called.
    • Ensure that when unknown users make a purchase and provide an email address and/or phone number that they’re identified and the purchase is tracked to them.
    • Ensure that users that were deep-linked into the app from an SMS message have their events tracked to their subscriber record.
  4. Package update and ship.