Skip to content

コンテンツカードの動作のカスタマイズ

この実装ガイドでは、コンテンツカードの動作の変更、ペイロードへのキーと値のペアなどの追加、一般的なカスタマイズのレシピについて説明します。

キーと値のペア

Braze では、キーと値のペアを使用して、コンテンツカードを介して追加のデータペイロードをユーザーデバイスに送信することができます。これらは、内部指標の追跡、アプリコンテンツの更新、プロパティのカスタマイズに役立ちます。ダッシュボードを使用してキーと値のペアを追加する

キーと値のペアは、extrasとしてcardオブジェクトに格納されます 。これらは、カードと一緒にデータを送信し、アプリケーションでさらに処理するために使用します。card.extrasを呼び出して、これらの値にアクセスします。

キーと値のペアは、extrasとしてcardオブジェクトに格納されます 。これらは、カードと一緒にデータを送信し、アプリケーションでさらに処理するために使用します。card.extrasを呼び出して、これらの値にアクセスします。

キーと値のペアは、extrasとしてcardオブジェクトに格納されます 。これらは、カードと一緒にデータを送信し、アプリケーションでさらに処理するために使用します。card.extrasを呼び出して、これらの値にアクセスします。

補足コンテンツとしてのコンテンツカード

コンテンツカードを既存のフィードにシームレスにブレンドし、複数のフィードからのデータを同時に読み込むことができます。これにより、Braze コンテンツカードと既存のフィードコンテンツとの一貫性のある、調和のとれたエクスペリエンスが生まれます。

右の例は、ローカルデータと Braze コンテンツカードを使ったハイブリッドなアイテムリストを持つフィードを示しています。これによって、コンテンツカードは既存のコンテンツと区別がつかなくなります。

API トリガーのキーと値のペア

APIトリガー・キャンペーン は、カードの値がユーザーに表示するコンテンツを決定する外部要因に依存する場合に採用すると良い戦略です。たとえば、補足的なコンテンツを表示するには、Liquid を使用してキーと値のペアを設定します。なお、class_typeはセットアップ時に知っておく必要があります。

補足的なコンテンツカードのユースケースのキーと値のペア。この例では、"tile_id"、"tile_deeplink"、"tile_title " のようなカードのさまざまな側面が Liquid を使用して設定されている。

インタラクティブコンテンツとしてのコンテンツカード

画面左下に50%のプロモーションを示すインタラクティブなコンテンツカードが表示されている。クリックすると、カートにプロモーションが適用される。

コンテンツカードを活用することで、ユーザーにダイナミックでインタラクティブな体験を提供することができます。右の例では、チェックアウト時にコンテンツカードのポップアップを表示させ、ユーザーにラストミニッツプロモーションを提供しています。このようなカードをうまく配置することで、ユーザーを特定のアクションに「後押し」することができます。

このユースケースのキーと値のペアには、希望する割引額として設定されたdiscount_percentageと、coupon_code として設定されたclass_typeが含まれます。これらのキーと値のペアによって、チェックアウト画面でタイプ別のコンテンツカードをフィルタリングして表示することができます。キーと値のペアを使用して複数のフィードを管理する方法については、デフォルトのコンテンツカードフィードのカスタマイズ を参照してください。

コンテンツカードバッジ

Braze のサンプルアプリ Swifty が表示された iPhone のホーム画面には、赤いバッジで数字の7が表示されている

バッジは小さなアイコンで、ユーザーの注意を引くのに最適です。バッジを使って新しいコンテンツカードの内容をユーザーに知らせることで、ユーザーをアプリに呼び戻し、セッションを増やすことができます。

コンテンツカードの未読数をバッジで表示する

コンテンツカードの未読数をバッジとしてアプリのアイコンに表示できます。

未読カードの数は、以下を呼び出していつでもリクエストできます。

1
Braze.getInstance(context).getContentCardUnviewedCount();
1
Braze.getInstance(context).contentCardUnviewedCount

この情報を使って、未読コンテンツカードの数を示すバッジを表示することができます。詳細については、SDK リファレンスドキュメントを参照してください。

次のサンプルでは、braze.contentCards を使用して未読コンテンツカードの数をリクエストして表示しています。アプリが閉じられ、ユーザーのセッションが終了すると、このコードはカードカウントをリクエストし、viewedプロパティに基づいてカードの数をフィルタリングします。

1
func applicationDidEnterBackground(_ application: UIApplication)

このメソッド内で、ユーザがセッション中にカードを閲覧している間にバッジカウントをアクティブに更新する以下のコードを実装します。

1
2
let unreadCards = AppDelegate.braze?.contentCards.cards.filter { $0.viewed == false }
UIApplication.shared.applicationIconBadgeNumber = unreadCards?.count ?? 0
1
(void)applicationDidEnterBackground:(UIApplication *)application

このメソッド内で、ユーザがセッション中にカードを閲覧している間にバッジカウントをアクティブに更新する以下のコードを実装します。

1
2
3
4
5
6
7
NSInteger unreadCardCount = 0;
for (BRZContentCardRaw *card in AppDelegate.braze.contentCards.cards) {
  if (card.viewed == NO) {
    unreadCardCount += 1;
  }
}
[UIApplication sharedApplication].applicationIconBadgeNumber = unreadCardCount;

未読カードの数は、以下を呼び出していつでもリクエストできます。

1
braze.getCachedContentCards().getUnviewedCardCount();

この情報を使って、未読コンテンツカードの数を示すバッジを表示することができます。詳細については、SDK リファレンスドキュメントを参照してください。

「このページはどの程度役に立ちましたか?」
New Stuff!