Preparing and sending an In-App message
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.
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 .
Handling mobile profile fields with personal and sensitive data
In Adobe Campaign, mobile profile attributes data sent from mobile device are stored in
Subscriptions to an application (appSubscriptionRcp)resource which allows you to define the data that you want to collect from your applications' subscribers.
This resource needs to be extended to collect data you intend to send from the mobile device to Adobe Campaign. To do so, refer to this page for the detailed steps.
To enable personalization of your In-App messages more securely, mobile profile fields from this resource need to be configured accordingly. In your
Subscriptions to an application (appSubscriptionRcp), when creating your new mobile profiles fields, check
Personal and Sensitiveto make them unavailable during In-App messages personalization.
If you have an existing implementation with custom resource extension on this table, we advise you to label the fields appropriately before leveraging them for personalization of In-App messages.
Subscriptions to an applicationcustom resource is configured and published, you can start preparing your In-App delivery using the
Target users based on their Mobile profile (inApp)template. Only non-personal and non-sensitive fields will be available from
Subscriptions to an application (appSubscriptionRcp)resource for personalization.
If you require personalization with
Personal and Sensitivefields, we recommend using the
Target users based on their Campaign profile (inAppProfile)template which has additional security mechanism to ensure that your users' PII data remains secure.
Preparing your In-App message
The steps for creating a standalone In-App message with Adobe Campaign are:
- From Adobe Campaign home page, click theIn-App messagingcard.You can also create an In-App from theMarketing activitiestab, by clicking theCreatebutton.Note that an In-App message can also be created from a campaign or from the Adobe Campaign home page or in a workflow.
- SelectIn-App message.
- 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)
- Enter the In-App message properties and select your mobile app in theAssociate a Mobile App to a deliveryfield.
- 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 theBroadcast an In-App message (inAppBroadcast)since it targets all users of a mobile application.
- In theTriggerstab, 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 .
- If you use anAnalytics Events, Adobe Analytics and View state events will be automatically populated based on the report suites configured in the Analytics extension in Adobe Experience Platform Launch whereas Context data events have to be manually added.Please note that these events are only available if you have an Adobe Analytics license.
- If you use aPlacestrigger, 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 Experience Platform Launch. For more information on the Places extension and how to install it, refer to this documentation .
- In theFrequency & durationtab, 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.
- Edit the content of your message and define the advanced options. See Customizing an In-App message .
Your In-App message is now ready to be sent to your targeted audience.
Sending your In-App message
Once you have finished preparing your delivery and the approval steps have been carried out, you can send your message.
- ClickPrepareto compute the target and generate the messages.
- Once the preparation has finished successfully, theDeploymentwindow presents the following KPIs:TargetandTo deliver.You can check the Deployment window by clicking the button for potential exclusions or errors in your delivery.
- ClickConfirmto start sending your In-App message.
- Check the status of your delivery through the message dashboard and logs. For more on this, refer to this section .DeliveredandSentKPIs counts are based on what is successfully sent out from Campaign to Message delivery service. Please note that these KPIs are not an indication of the count of mobile devices that received or downloaded the message successfully from Message delivery service.