AWS Mobile
Developer Guide

Add Messaging to Your Mobile App with Amazon Pinpoint

Overview

Engage your users more deeply by tying their app usage behavior to Push Notification, email, or SMS messaging campaigns.

When you enable the Amplify CLI Analytics category, your app is registered with Amazon Pinpoint. You can define user segments and send messages to those recipients through the Amazon Pinpoint console.

Amazon Pinpoint also enables you to gather and visualize your app's Analytics. The metrics you gather can be as simple as session start and stop data, or you can customize them to show things like how closely actual behavior matches your predicted model.

You can then algorithmically tie messaging campaigns to user behavior. For instance, send a discount mail to frequent users, or send a push notification that initiates a data sync for users that have selected a certain category in a feature of your app.

Set Up Your Backend

To set up your app to receive Push Notifications from Amazon Pinpoint, see Add Push Notifications to Your Mobile App with Amazon Pinpoint.

To set up email or SMS as part of an Amazon Pinpoint campaign perform the following steps.

To set up your app to receive Push Notifications from Amazon Pinpoint, see Add Push Notifications to Your Mobile App with Amazon Pinpoint.

  1. Complete the Get Started and Add Analytics steps before you proceed.

  2. For Email:

    1. In a terminal window, use the following command to open the project for your app by in the Amazon Pinpoint console.

      $ cd YOUR_APP_PROJECT_FOLDER $ amplify console analytics
    2. In the Amazon Pinpoint console, navigate to Settings on the left, choose the Channels tab, and then choose Email.

    3. Choose the Enable email channel check box, choose Email address, type the address that you want your messages to come from, and then choose verify.

      The email account you enter will receive an email requesting your approval for Amazon Pinpoint to use that account as the sender address for emails sent by the system. The status of Pending Verification is displayed in the console entry field until Amazon Pinpoint has processed your approval.

    4. Choose Email domain, type the domain that you want your messages to come from, and then choose verify.

      A dialog box displays the name and value of the TXT record you must add to the domain's settings. The status of Pending Verification is displayed in the entry field until the console processes your approval.

      Add a default user name to Default from address.

    5. Choose Save.

    6. For information about sending mail from Amazon Pinpoint, see Sending an Email Message.

  3. For SMS:

    1. In a terminal window, use the following command to open the project for your app by in the Amazon Pinpoint console.

      $ cd YOUR_APP_PROJECT_FOLDER $ amplify console analytics
    2. Navigate to Settings in the left-hand navigation, choose SMS, and then choose Enable SMS channel.

    3. Navigate to Direct messaging in the left-hand navigation and chose SMS.

    4. Adjust the options for Default message type, Account spend limit, and Default sender ID. For more information about these options, see Updating SMS Settings.

    5. For information about sending SMS messages from Amazon Pinpoint, see Sending an SMS Message.

Connect to Your Backend

The AWS Mobile SDK is not required to receive email or SMS messages from Amazon Pinpoint.