Notifications Testing Guide¶
GetSocial supports 6 types of Social Push Notifications which allows to increase the user engagement of your app. Each notification type can be separately enabled for the app users from the GetSocial Dashboard. Social Notifications are localized to all supported languages.
Prerequisite¶
- Finished Getting Started guide for Android, iOS or Unity.
- Finished setting up push notifications for Android, iOS or Unity.
Testing Scenarios¶
To test Social Notifications you’ll need:
- Two mobile test devices. To test on Android you can use an emulator, but make sure that Google Apps are installed. To test on iOS you have to use physical device.
- Access to the GetSocial Dashboard.
TIP 1: Use Dashboard instead of the second device
To test Social Notifications generated from Activity Feeds you can perform steps for the second test device from the GetSocial Dashboard. In this case, the author of the push notifications will be the application.
TIP 2: Use Notification Center UI
Use Notification Center UI to verify notifications instead of push notifications. In this case, you can skip setting up push notifications.
Test Social Push Notifications¶
Notification type | GetSocial feature | Notification text (could be updated via template) |
---|---|---|
activity_like |
Activity Feed | User2 liked your activity |
activity_mention |
Activity Feed | User2 mentioned you in an activity |
comment |
Activity Feed | User2 commented on your activity |
comment_like |
Activity Feed | User2 liked your comment |
comment_mention |
Activity Feed | User2 mentioned you in a comment |
comment_reply |
Activity Feed | User2 replied to your comment |
friends_add |
Social Graph | User2 is now your friend |
invite_accept |
Smart Invites & Social Graph | User2 accepted your invite |
related_comment |
Activity Feed | User2 also commented on User3’s activity |
Notification Templates¶
Starting from SDK 6.22, you can customize GetSocial notification templates and create your own ones. Customization includes the ability to update notification text and title, add custom placeholders and emojis, and localize changes to one of 24 languages that we support.
To create a template for notifications:
-
Login to the GetSocial Dashboard.
-
Go to the “Notifications” section → “Templates” tab.
-
Press “New Template” button.
-
Define template content and save it.
To learn more about custom templates on SDK side check our documentation for Android, iOS and Unity.
Anonymous notifications¶
For users who didn’t set their name yet we send a generic notification text without user name. For example, A friend accepted your invite will be sent for invite_accept
notification type, because it’s sent right after the first app launch by invited user and the user didn’t setup their name yet.
GetSocial notification types that support anonymous fallbacks: activity_mention
, comment
, comment_mention
, invite_accept
.
You can add anonymous placeholder to your custom templates via |
separator, for example placeholder [SENDER_DISPLAY_NAME|Someone]
will use sender display name if it’s set and Someone
if it’s not set.
Likes¶
The notification is received when someone likes user’s activity or comment in the Activity Feed.
Testing scenario:
-
User1 posts an activity/comment.
-
User2 puts a like under the activity/comment.
-
User1 receives a notification with text “User2 Liked your activity” or “User2 Liked your comment”. Clicking on the notification will take user to activity feed post/comment details screen.
Comment¶
The notification is received when someone puts a comment under the user’s activity in the Activity Feed.
Testing scenario:
-
User1 posts an activity.
-
User2 posts a comment under the activity.
-
User1 receives a notification with text “User2 commented on your activity”. Clicking on the notification will take user to activity feed post details screen.
Related comment¶
The notification is received when someone also left a comment under the activity which was earlier commented by the user.
Testing scenario:
-
User1 posts a comment under User3’s activity.
-
User2 also posts a comment under the same activity.
-
User1 receives a notification with text “User2 also commented on User3’s activity.”. Clicking on the notification will take user to activity feed post details screen.
Mentions¶
GetSocial supports 3 types of the mentions notifications: Activity mention
, Comment mention
and Comment reply
.
Activity mention¶
The notification is received when someone mention the current user in a post.
Testing scenario:
- User2 posts an activity with ‘@User1’ mention.
- User1 receives a notification with text “User2 mentioned you in an activity.”. Clicking on the notification will take user to activity feed post details screen.
Comment mention¶
The notification is received when someone mention the current user in a comment.
Testing scenario:
- User2 posts a comment with ‘@User1’ mention (doesn’t matter where the mention is placed).
- User1 receives a notification with text “User2 mentioned you in a comment.”. Clicking on the notification will take user to activity feed comment details screen.
Comment reply¶
The notification is received when someone replied to the user’s comment and the mention is placed at the beginning of the reply.
Testing scenario:
- User1 posts a comment under User3’s activity.
- User2 posts a comment under the same activity with ‘@User1’ mention at the beginning of the reply.
- User1 receives a notification with text “User2 replied to your comment.”. Clicking on the notification will take user to activity feed comment details screen.
Friend added¶
The notification is received when someone added the user to their friends list. It’s a part of the GetSocial Social Graph.
Testing scenario:
- User1 is authenticating to the app with Facebook.
- User2 is also authenticating to the app with Facebook.
- User1 and User2 automatically become friends inside of the app, because they are friends in Facebook.
- User1 receives a notification with text “User2 is now your friend.”.
Invite accepted¶
The notification is received when a user installed the app from a Smart Invite. It’s a part of the GetSocial Social Graph.
Testing scenario:
- User1 sends a Smart Invite to User2.
- User2 installs the app after click on the link and oppens it.
- User1 receives a notification with text “User2 accepted your invite.”.