The SDK provides two ways for users to retrieve their global feed: the getGlobalFeed method and the getCustomPostRanking method. By providing these two distinct ways to retrieve the global feed, the SDK enables users to customize their content experience to better reflect their interests and preferences. This can help to foster a more dynamic and engaging community experience, promoting greater engagement and participation among users.
We provide a simple way to query posts on Global Feed using the getGlobalFeed method. When using this method, posts will be returned in chronological order by default, allowing users to quickly and easily view the most recent content.
Version 6
Beta (v0.0.1)
Query custom post ranking is a smarter global feed that supports the score-sorting mechanism. The score-sorting mechanism ensures that the posts are presented in order of relevance, with the most engaging and relevant content at the top of the feed. Refer toCustom Post Ranking for more information about this feature. You can use getCustomRankingGlobalFeed to retrieve posts from this functionality.
You can retrieve your global feed by calling the queryAllPosts method. This method accepts the following parameters:
The method will return a LiveCollection instance of post model.
The queryAllPosts method will throw an error if parameters passed are incorrect.
Version 6
Beta (v0.0.1)
Supported ✅ (Please wait while we prepare a real example!)
Let your users showcase their unique personality right in their timelines
Amity Social Cloud SDK provides a powerful Feed feature that allows users to stay informed, communicate, and express themselves through ranked posts. The Feed feature is comprised of a collection of posts, with three distinct types of feeds available to users: User Feed, Community Feed, and Global Feed.
User Feed: provides a collection of posts that are curated for a user's timeline. This feed is tailored to the individual user, providing relevant post that they generated.
Community Feed: on the other hand, is a collection of posts generated by members of a particular community. This feed allows users to stay connected and engaged with other members of their community, fostering a sense of belonging and shared experience.
Global Feed: aggregates both User and Community feeds, providing a comprehensive view of all relevant content in the user's network. This feed ensures that users can stay up-to-date with all the latest content and conversations in their network, promoting engagement and participation in the community.
By providing these three distinct types of feeds, the SDK enables users to customize their content experience, ensuring that they receive relevant and engaging content that reflects their interests and preferences. This feature can help to foster a vibrant and dynamic community, promoting engagement, communication, and collaboration among users.
Feed management methods are all contained in AmityFeedRepository class. For querying posts from User Feed and Community Feed, please refer to - Query Post.
Supported ✅ (Please wait while we prepare a real example!)
In our previous implementation of our global feed, we rank posts in chronological order. This means that newer posts will rank higher than older ones, thus, the former will show up higher in the feed. While this is not a bad algorithm, other factors should also be considered to determine the posts’ ranking in the global feed.
With our new custom post ranking algorithm, we are using a smarter ranking in our global feed that supports a score-sorting mechanism. We focus on what we consider as “meaningful interactions”. This means that, aside from the post’s submission time, we also factor in user engagements, i.e., posts with more comments and reactions will have a higher ranking. In addition, we factor in the updates and edits done to the post.
The post will be ranked according to these factors:
Engagement rate Posts with more comments and reactions will show up higher than posts with less
Time of posting Newer posts will show up higher than older posts. Time decay is applied where the score will decrease as the post gets older.
Updates Post updates and edits on a post will give the post a score boost. Updates may also include new comments and reactions.
Posts will be ranked using mathematical formulas with the following properties in the post model as variables:
commentsCount - number of comments to the post
reactionsCount - number of reactions to the post
createdAt - date/time the post was created
updatedAt - date/time the post was updated
editedAt - date/time the post was edited
High engagement rate has a big impact on the ranking. A comment will score twice as much as a reaction. A post’s score will decrease as time goes by. However, updating or editing the post bumps up the score.
The score of each post is calculated for every query. This means that when users want to go to the next page, the score will be recalculated.
If you want to configure the ranking logic to include more factors such as post type, post creator, etc., you may contact Amity Social Cloud Support to review the ranking logic and apply it to the code accordingly.
In our next implementation phase, we will add ranking configurations in ASC Console so users can update ranking logic without the need to call support.
Please note however that our custom post ranking implementation has some limitations currently such as:
While your newly created posts will be immediately available in your User Feed, due to the nature of the ranking algorithm, there may be a momentary delay before it appears on the Global Feed.
Updating the ranking formula can't be done via ASC console. Please contact Amity Social Cloud Support for the formula validation and applying your ranking logic to the network.
You can only see up to 20 posts from each user or community that you are following in the global feed.
Old post data will not be migrated, thus, only the posts that are posted using version 5.10 will show in the global feed.
For more information on how to implement custom post ranking in your global feed, see our documentation here.
We also provide UI Kit guides for custom post ranking for iOS and Android.