Euromessage Android SDK Other Features
1.Transferring the members logged in Push application directly to the Euromessage member panel
Members can be registered by sending some special parameters to the Extra block. If the related EMAIL is not registered in the account, it will be registered to the account again according to the channel permissions sent in the extra block. If it is desired to transfer the members logged in Push application directly to the Euromessage member panel; The PUSH_SUBSCRIPTION_PERMISSION_ENABLED flag must be requested from the RMC Support team.
EuroMobileManager.getInstance().setPushPermit(PushPermit.ACTIVE, getApplicationContext());
"extra" : {"email" : "euromessage@euromsg.com",
"keyID" : "190708",
"emailPermit" : "Y"}2.Android Custom Parameters and Target URL
You can access the variables you defined in the RMC interface from intent.getExtra (). The parameters inside the push notification coming to the Activity, onResume () and onNewIntent ().
if (intent.getExtras() != null) {
if (EuroMobileManager.getInstance().getNotification(intent) != null) {
Log.d("Euromessage", EuroMobileManager.getInstance().getNotification(intent).getUrl());
}
if (EuroMobileManager.getInstance().getCarousels(intent) != null) {
Log.d("Euromessage Carousel", EuroMobileManager.getInstance().getCarousels(intent).get(FIRST_ITEM_CAROUSEL).getUrl());
}Data Type | Variable | Description |
|---|---|---|
String | mediaUrl | URL for images and video |
String | altUrl | Alternate URL |
String | campaignId | Campaign ID |
String | url | Campaign URL |
String | message | Message |
String | sound | Sound file |
PushType | pushType | Push Type |
Map<String, String> | params | Custom parameters |
3. Using Android Custom Sound (Using a custom notification sound)
To add Android custom sound, the developer needs to add the relevant custom music to the raw file at the app level.
Follow ->: "res / raw / my_custom_sound.mp3"
After this step, you should add this value to the Settings / Campaign Settings / Push Applications / Your Android Application / Custom Audio File section of the RMC panel without the file extension of this music.
4. Find out which item the user clicked in Carousel Push
You should add receiver to AndroidManifest.xml file as follows.
<receiver
android:name="your_broadcast_receiver_here"
android:exported="false" >
<intent-filter>
<action android:name="CarouselItemClickIntentFilter" />
</intent-filter>
</receiver>Then you can capture the url of the item clicked inside the receiver as follows.
EUROMESSAGE SDK METHODS
1.Subscribe Token
Method | Explanation |
|---|---|
subscibe(String token, Context context) | it sends Token to Euromessage services |
2.Kullanıcı Özelleştirme ile ilgili Methodlar
Method | Explanation |
|---|---|
setEmail(String email, Context context) | It assigns to E-mail to anonymous user |
setEuroUserId(String userKey, Context context) | It assigns to ID to anonymous user |
setFacebook(String facebookId, Context context) | It assigns to Facebook id to user |
setTwitterId(String twitterId, Context context) | It assigns to Twitter id to user |
setPhoneNumber(String msisdn, Context context) | It assigns to phone number to user |
setLocation(double latitute, double longitude, Context context) | It assigns to Location to user |
setAppVersion(String appVersion) | It assigns to app version to user |
setUserProperty(String key, String value, Context context) | It assigns to custom parameter to user (Please contact RMC support team) |
| Match token and user |
It is mandatory to call after making any of the above definitions.
3. SDK Customization Methods
Method | Explanation |
|---|---|
reportRead(Bundle bundle) | Informing RMC to push notification read |
setChannelName(String channelName, Context context) | Updates the channel name in the application details |
setNotificationColor(String hexColor) | Set Notification Theme color (Hex Color) |
setNotificationTransparentSmallIcon(int transparentSmallIcon, Context context) | Set Notification Transparent small icon (Drawable) |
setNotificationTransparentSmallIconDarkMode(int transparentSmallIcon, Context context) | It is for setting small icon on notification screen when device is in dark theme. (from Drawable folder) |
useNotificationLargeIcon(boolean willBeUsed) | To decide whether to use the big icon on the notification screen.(Default True) |
setNotificationLargeIcon(int largeIcon, Context context) | It is for setting the big icon on the notification screen. (from Drawable folder) |
setNotificationLargeIconDarkMode(int largeIconDarkMode, Context context) | It is for setting big icon on notification screen when device is in dark theme. (from Drawable folder) |
setPushIntent(String intentStr, Context context) | Set the activity to be opened clicking on the notification. The activity package path should set. Optional |
setNotificationPriority(RDNotificationPriority priority, Context context) | It is for setting the priority of the notifications. For heads-up notifications, the priority must be set to HIGH. |
setPushPermit(PushPermit pushPermit, Context context) | Push permissions on RMC panel are set as Active or Passive |
setEmailPermit(EmailPermit emailPermit, Context context) | Push permissions on RMC panel are set as Active or Passive |
setGsmPermit(GsmPermit gsmPermit, Context context) | Push permissions on RMC panel are set as Active or Passive |
removePushIntent(Context context) | Removes the activity to open clicking on the notification |
removeChannelName(Context context) | Removes channel name in application details |
removeIntentExtra(Context context) | Removes application extras |
removeNotificationColor(Context context) | Removes notification theme color |
removeNotificationTransparentSmallIcon(Context context) | Removes the notification icon |
removeUserProperties(Context context) | Removes extra parameters |
getCarousel(Intent intent) | Gives you the target url for carousel |
getNotification(Intent intent) | Gives you the target url for text and image |
Sample;
Reflection of Push Campaign Revenues to RMC Panel
After clicking the incoming push notification, you need to use the following method to reflect the purchase made in the Revenue field in the RMC panel.
You must enter utm parameters in the Custom Parameters field on the push screen.
Ex: utm_medium=apppush;utm_source=related;utm_campaign=campaign_name
P.S: Since utm_campaign should be different each time, you can use the ID of the push campaign you created as a variable. You can optionally use the <## CAMP_ID ##> variable for this.After clicking the push notification, a data will be returned to you as below.
Sample Data:
You should handle this data just like using deeplink and send the utm parameters as event to Visilabs when the push message is clicked. You can find sample Visilabs event codes on the bottom line.
Using Incoming Push Notifications
This method returns the list of anonymous push messages sent in the last 30 days.
The messages are ordered in terms of their timestamps e.g. most recent one is at index 0.
activity : Activity
callback : PushMessageInterface
If you want to save and get the notifications based on logged-in user, you must set the userID (email, telephone no, etc.) after the user logins in your application by using the method below:
After setting the userID like the one above, the notifications will be saved with that user ID. You can get the notifications sent to the user who is logged-in in your application by using the getPushMessagesWithID() method:
Copyright 2020 Related Digital