Preparing and sending an In-App message

Last update: December 8, 2023

CREATED FOR:

  • User

Three types of In-App message are available in Adobe Campaign:

  • Target users based on their Campaign profile (inAppProfile): This message type enables you to target Adobe Campaign profiles (CRM profiles) who have subscribed to your mobile application. This message type can be personalized with all available profile attributes in Adobe Campaign but requires a secure handshake between Mobile SDK and Campaign’s In-App messaging service to ensure that messages with personal and sensitive information are used by authorized users only.

    To download this message type on users’ devices, Mobile SDK has to send linkage fields used to connect a mobile profile to a CRM profile in Adobe Campaign. For more information on SDK APIs required to support In-App, refer to this page.

  • Target all users of a Mobile app (inAppBroadcast): This message type enables you to send messages to all users (current or future) of your mobile application even if they don’t have an existing profile in Adobe Campaign. Personalization is thus not possible when customizing the messages as the user profile may not even exist in Adobe Campaign.

  • Target users based on their Mobile profile (inApp): This message type enables you to target all known or anonymous users of a mobile app that have a mobile profile in Adobe Campaign. This messages type can be personalized using only non-personal and non-sensitive attributes and does not require secure handshake between Mobile SDK and Adobe Campaign’s In-App messaging service.

    For more information on how to handle personal and sensitive data, refer to Handling mobile profile fields with personal and sensitive data.

Preparing your In-App message

CAUTION
In-App personalization relies on a linkage field which is typically a CRM ID and/or Mobile App Login ID. You are solely responsible for securing this linkage field when used in connection with Adobe Campaign. If you fail to keep your linkage field(s) secure, your personalized message may be vulnerable. Adobe will not be liable for damages arising out of unauthorized access or use of any profile data if you fail to follow secure linkage field composition, management, and protection practices.

The steps for creating a standalone In-App message with Adobe Campaign are:

  1. From Adobe Campaign home page, click the In-App messaging card.

    You can also create an In-App from the Marketing activities tab, by clicking the Create button.

    Note that an In-App message can also be created from a campaign or from the Adobe Campaign home page or in a workflow.

  2. Select In-App message.

  3. Select an appropriate template based on your audience targeting needs.

    By default, you can select one of the following three out-of-the-box templates:

    • Target users based on their Campaign CRM profile (inAppProfile)
    • Target all users of a Mobile app (inAppBroadcast)
    • Target users based on their Mobile profile (inApp)

  4. Enter the In-App message properties and select your mobile app in the Associate a Mobile App to a delivery field.

    If you don’t see any applications in the drop-down list, make sure that your mobile applications are in a Configured state. Applications in a Ready to be configured state will not appear in the list. For more information on mobile application configuration, refer to this page.

  5. Select the audience you want to target for you In-App message. Your audience is prefiltered depending on the mobile application associated to this delivery.

    Note that this step is not needed with the Broadcast an In-App message (inAppBroadcast) since it targets all users of a mobile application.

  6. In the Triggers tab, drag and drop the event that will trigger your message. By choosing a trigger, you choose an action done by users which will cause the In-App message to be displayed.

    Four categories of events are available:

    • Mobile Application events: Custom events implemented in your mobile application.

      For more on events creations, refer to this page.

    • Life Cycle events: Out-of-the-box life cycle events supported by Adobe Mobile SDK.

      For more on life cycle events, refer to this page.

    • Analytics Events: The following three categories are supported depending on what is instrumented in your mobile app: Adobe Analytics, Context data or View state.

      Please note that these events are only available if you have an Adobe Analytics license.

    • Places: The following three categories leverage real-time location data to deliver contextually relevant mobile experiences: Places context data, Places custom metadata or Places event type.

      For more information on Adobe Places, refer to the Places documentation.

  7. If you use an Analytics Events, Adobe Analytics and View state events will be automatically populated based on the report suites configured in the Analytics extension in the Data Collection UI whereas Context data events have to be manually added.

    Please note that these events are only available if you have an Adobe Analytics license.

  8. If you use a Places trigger, Places context data, Places custom metadata or Places event type will be automatically populated based on all the Libraries and their Points of Interest created in Adobe Places.

    Please note that this trigger will be applied on the device only for the Points of Interest from the Libraries selected in the Places extension in the Data Collection UI. For more information on the Places extension and how to install it, refer to this documentation.

  9. In the Frequency & duration tab, choose the frequency for your trigger, the start and end date, day of the week and time of the day when your In-App message will be active.

  10. Edit the content of your message and define the advanced options. See Customizing an In-App message.

  11. Click Create.

Your In-App message is now ready to be sent to your targeted audience.

Related topics: