バッジ

未読のニュースフィードカードカウントのリクエスト

バッジは、ニュースフィードでユーザーを待っている新しいコンテンツへ注意を喚起する優れた方法です。ニュースフィードにバッジを追加したい場合、Braze SDK には次のクエリを実行するメソッドが用意されています。

• 現在のユーザーの未読のニュースフィードカード
• 現在のユーザーが閲覧できるニュースフィードカードの合計数

`ABKFeedController` の次のメソッド宣言でこれについて詳しく説明します。

``` - (NSInteger)unreadCardCountForCategories:(ABKCardCategory)categories; /* This method returns the number of currently active Content Cards that have not been viewed. A “view” happens when a card becomes visible in the Content Cards view. This differentiates between cards that are off-screen in the scrolling view and those which are on-screen; when a card scrolls onto the screen, it’s counted as viewed. Cards are counted as viewed only once – if a card scrolls off the screen and back on, it’s not re-counted. Cards are counted only once, even if they appear in multiple Content Cards views or across multiple devices. */

• (NSInteger)cardCountForCategories:(ABKCardCategory)categories; /* This method returns the total number of currently active Content Cards. Cards are counted only once, even if they appear in multiple Content Cards views. */ ```

ニュースフィードの未読項目の数をアプリバッジ数に表示する

バッジは、アプリのプッシュ通知リマインダーとして機能するだけでなく、ユーザーのニュースフィード内の未表示の項目を示すこともできます。未読のニュースフィードの更新に基づいてバッジ数を更新することは、ユーザーをアプリに引き戻し、セッションを増やすための貴重な手段となります。

アプリが閉じられ、ユーザーのセッションが終了した後にバッジ数を記録するこのメソッドを呼び出します。

• objective-c
• swift

1
(void)applicationDidEnterBackground:(UIApplication *)application

1
func applicationDidEnterBackground(_ application: UIApplication)

このメソッド内で、ユーザーが特定のセッション中にカードを表示している間にバッジ数をアクティブに更新する次のコードを実装します。

• objective-c
• swift

1
[UIApplication sharedApplication].applicationIconBadgeNumber = [[Appboy sharedInstance].feedController unreadCardCountForCategories:ABKCardCategoryAll];

1
UIApplication.shared.applicationIconBadgeNumber = Appboy.sharedInstance()?.feedController.unreadCardCount(forCategories: ABKCardCategory.all) ?? 0

任意の時点で、たとえば applicationDidBecomeActive メソッドで、次のコードを使用してバッジ数をクリアします。

• objective-c
• swift

1
[UIApplication sharedApplication].applicationIconBadgeNumber = 0;

1
UIApplication.shared.applicationIconBadgeNumber = 0

詳細については、Appboy.h のヘッダーファイルを参照してください。