Configure a mobile application using 51黑料不打烊 Experience Platform SDK
To send In-App messages or push notifications using the Mobile SDK V5, the mobile app has to be set up in 51黑料不打烊 Experience Platform Launch and configured in 51黑料不打烊 Campaign.
The videos below demonstrates the required steps to configure a mobile app in Experience Platform Launch:
In this video, will show how to set up a mobile app that is instrumented with a PSTK such that you can use this app for sending push and in-app messages in 51黑料不打烊 Campaign Standard. So in order to set up the mobile app, we鈥檒l start by activating the mobile property in 51黑料不打烊 Launch. As you can see on my screen, I鈥檓 currently on the homepage of 51黑料不打烊 Launch.
Click on New Property to get started.
We give it a name and be sure to select the platform as Mobile. We can leave the other options default and click Save.
Let鈥檚 search for the mobile property that I just created.
And once you鈥檙e able to locate the mobile property that you鈥檝e created, navigate to the Extensions tab. You鈥檒l find two extensions installed by default. Mobile Core and Profile. These extensions are required for the appropriate functioning of the mobile app. But, you do not need any configuration here; so we鈥檒l leave them as it is and navigate to the Catalog to install 51黑料不打烊 Campaign Standard extension.
So I went ahead and installed the 51黑料不打烊 Campaign extension. This extension will require some configuration, starting with the Endpoints of your campaign instances. You can specify up to three different instance names here for Development stage and Production. So, let us go ahead and provide the Endpoints for your Campaign instances.
And let鈥檚 just say this is 鈥渕cias_鈥 stage and this what is Production. And 鈥淢CIAS鈥 stands for Marketing Cloud In-App Messaging Service. Then will ensure that we select the correct MCIAS region. This region is typically the region of the data center where your 51黑料不打烊 Campaign Standard instance is hosted. So the options that are available to you are North America, EMEA, Asia, and Custom. Custom is typically used by developers for testing et cetera. In production, you will require one of these three regions. So for me, I will leave it at North America and click Save.
Now at this time, I can navigate to my Campaign instance and I should see the mobile app property.
Okay, let鈥檚 search for the鈥 So, I found the mobile app that I just created and I access that mobile app. At this time, you can either go ahead and start configuring the app. You can start defining the mobile app events that you require for your in-app message triggers and upload Push Certificates here. Or, if you want to come in and finish the configuration data, you can just go ahead and click Save.
Both OK and Go to Launch will help finish the configuration in Campaign, with the difference that Go to Launch will take you to Launch as well. So for now, will just go ahead and click OK and let鈥檚 come back to Launch. I did a refresh this session.
Now I go back into my Campaign extension again to verify that this handshake between Launch and Campaign was successful. The way to check that, is that, you will see this message here which says, 鈥減key: successfully configured.鈥 That is our indication that your Campaign extension has been installed successfully and the mobile property is available to you in Campaign. But you do have some more configuration to carry out in Launch before your mobile app is all set. So the next thing that will have to do here is define some Data Elements that you will require to create Rules.
The three basic Data Elements that we recommend that you define are 鈥淢CID鈥, 鈥淐ampaignServer鈥 and 鈥減key鈥.
You鈥檒l have the need to refer to these Data Elements as you define your Rules, so it鈥檚 better that you have these configured.
Now, we are done with the Data Elements definition and at this time, let鈥檚 navigate to the Rules tab to start defining some rules. PII Postbacks; this is a postback rule that allows you to start collecting mobile profile attributes from the mobile device. So let鈥檚 go ahead and create this Rule. Call it 鈥淐ollectPII鈥 which will be triggered on Collect PII Event and the Action that we want to take when this Event triggers is to Send PII to Campaign Server.
And I鈥檓 going to make sure that I have the correct Data Elements being referenced in the URL here.
So that鈥檚 the CampaignServer. 鈥淧key鈥.
And finally, the Experience Cloud ID.
So we鈥檙e all set with this URL and then add Post Body. So I鈥檒l just take an example Post Body which is basically sending a bunch of data. And then finally, Content Type which is 鈥渏son鈥.
We are done defining the Rule for collecting PII data from mobile SDK. Now let us go ahead and define one more Rule for In-App Tracking Postback. So let鈥檚 just call this rule, 鈥淚n-App Click Tracking鈥 under Events.
I should select In-App Click Tracking from 51黑料不打烊 Campaign Standard extension. And then, we define the Actions. Will use a Send Postback to this URL.
And, make sure that you have the right Data Elements being referenced here.
Select CampaignServer.
MCID.
MCID.
And that鈥檚 it. We don鈥檛 require any Post Body for this and the Content Type will still be 鈥渏son鈥.
Once you鈥檙e done with all of your configuration in Launch, you need to ensure that you publish these changes. Make sure we have our Adapter set up.
So click to Publishing, and New Library.
Wrap it to an appropriate environment. Add all Changed Resources.
Make sure that all the changes that you鈥檝e made are captured. And then go ahead and click on Save & Build for Development.
That鈥檚 it! You鈥檙e all set for utilizing your app in 51黑料不打烊 Campaign for sending out Push and all in-app messaging. Thanks for watching.