Lesson 2 - Create a mobile in-app campaign
In this lesson, you create and trigger mobile in-app messages.
Learning Objectives
- Understand how in-app messages are triggered.
- Know how to create a mobile in-app campaign.
- Trigger an in-app message.
Exercise 2.1 - Log in to Journey Optimizer
-
Login using the following details:
Username: L820+<your seat number>@adobeeventlab.com
Password: Adobe2024!
You can find the details for your login on your lab machine desktop. Use the Adobe ID and the Password.
-
You can skip the next two screens:
Exercise 2.2 Create a mobile in-app campaign
In this exercise, you create an in-app messaging campaign, which is triggered, when you open the app.
-
In Journey Optimizer, in the left navigation, select Campaigns.
-
Click Create Campaign.
-
On the Create Campaign page, in the Action section, select the In-app message check box.
-
From the Send to dropdown, select Mobile.
-
From the App surface dropdown, select Frecopa Mobile App.
-
Click Create.
Exercise 2.3 Configure your campaign
2.3.1 Properties section
Give your campaign a name. Make sure to start the name with your seat number, so you can easily find your campaign again.
For example if your seat number is 99: 99 - Welcome Campaign.
2.3.2 Set up your custom trigger rule
-
Scroll down to the Triggers section, then click Edit triggers.
-
In the rule builder, click on Application Launch and from the dropdown select Sent data to Platform.
-
Add a condition by clicking Add condition.
-
From the Select a trait drop down, select XDM event type.
-
In the following text field, add a
<custom string value>that you can remember. -
To save the value, click Add
<custom string value>.This custom string value is used later to fire you message.
note tip TIP Adding your seat number to the custom string value makes it unique and easier for you to remember. For example: 99exerciseTrigger
-
Click Done in the top right.
2.3.3 Edit the content of the in-app message
In the Action section, click Edit Content.
The In-App message editor displays, where you configure the in-app message content.
2.3.3.1 Layout
Select which layout should be applied to your message.
For example, click Modal to make your in-app message a modal layout.
2.3.3.2 Authoring your message and publishing your campaign
-
In the media section, paste in the following URL:
https://t3.ftcdn.net/jpg/02/79/42/52/240_F_279425217_Hr9VBkknMr4fTpuZbxZXfcYdC7jSvGl2.jpg
When you click out of the value field, your image should appear.
-
In the following Content section, add in your own custom text that you want to be displayed in your message for the Header and Body.
-
Additional Options:
-
Buttons:
-
In this section of the editor, you can customize the text for your CTA button by editing the Button Text field.
-
The Interact event field is used to define the value that is passed to the SDK when the CTA is pressed by the user.
-
The Target field is used to define where you would like the CTA to take the user. This includes URLs and Deeplinks. For example, you can add this deeplink to a product page such as
dxdemo://exoticVibes. -
You can add additional buttons by pressing + Add button.
-
When a second button is added to your message, you now have the option to change the button layout with the drop-down box.
-
-
Advanced formatting
Enabling this toggle will give additional customization options in the editor.
- Media Size
- Font
- Pt size
- Font color
- Alignment
-
Settings Tab
By shifting over to this tab and in the Preview section, you can change the App Preview.
-
The Layout section gives you option to use an image as the background or a solid color.
-
The Message section provides custom interactions that can be enabled for your message:
- Custom Gestures
- UI Takeover
- Custom UI takeover
- Custom size
- Custom position
- Custom animation
- Message round corner
-
-
-
When you are done authoring your content and are satisfied with you message click the Review to activate button.
note success SUCCESS You have now completed authoring your mobile In-app message. You should now be on the Campaign Review to activate page.
Here you will be able to see a complete summary of your message. Please take note of the custom value that you used as you trigger rule. This value will be used to fire your In-app message. The value that used can be found on in the highlight area of the summary page. note note NOTE The current trigger for the in-app message is the default Application launch event happens, which means that the in-app message is triggered when the app launches. You can see this in the Schedule section. -
If you are done reviewing your Campaign, press the Activate button to publish the Campaign.
Exercise 2.4 Trigger the mobile in-app message
To refresh the payload and download your newly published Campaign:
-
On your mobile device, completely close out the Fréscopa app.
-
Reopen the Fréscopa app.
-
Now navigate to the Exercise tab on the app.
-
In the text field, type in your custom trigger value that you defined in you Campaign. Then press Submit.
{align="center" width="250" modal="regular"}
- In the Event name field on your mobile app, make sure that you type in your trigger rule value exactly how you had it in the Campaign.
- Make sure capitalization is correct and that you do not have a leading or ending space.
- You can look up your trigger rule value that you used if you go back to your Campaign review page by clicking back into your campaign on the Campaign Dashboard.
You just authored and published your first Journey Optimizer In-app message!
Bonus Exercise: Duplicate Campaign and Preview on device
The Duplicate campaign and Preview on device features are out-of-the-box functionality that allows you to duplicate your Campaigns and test and review your In-app messages directly on your device before activating it. In this exercise you will learn how to use this feature and preview the message you created in exercise 3.1.
-
Open the campaign you just created, by clicking on the name of the campaign in the Campaigns dashboard page to open the campaign. This will take you back to the Review campaign page.
-
Press the Duplicate button. This will open a new prompt to name your new campaign that is being duplicated. Add in a new name that you easily remember or used the default name where _copy is added by default.
-
Once you hit the duplicate button, your duplicate campaign will be created, and you will be taken back to the Campaigns Dashboard.
-
Once your campaign is duplicated, open your new campaign.
-
You can access the Preview on device feature on the Campaign review page or on the Campaign author step.
-
Next, click the start button from the connect to device screen.
-
Enter the base url which has been configured to launch the Fréscopa app:
dxdemo://
-
Follow the instructions on the screen:
- Scan the QR code with your mobile device, and the Fréscopa app opens with a screen that allows you to enter a pin displayed.
- Enter the pin shown in AJO on the Assurance screen on your device and click the Connect button which appears at the bottom right once you have entered the pin.
{align="center" width="250" modal="regular"}
-
This pop-up appears on your computer screen
-
Click the Done button. This will close the dialog box and your phone is now connected to Preview on device.
Additional resources
How to videos:
Product documentation: