よくある質問

これらは、Brazeのバナーに関するよくある質問への回答です。より一般的な情報については、バナーについてを参照してください。

バナーの更新はいつユーザーに表示されますか？

バナーは、リフレッシュメソッドを呼び出すたびに最新のデータで更新されます。バナーキャンペーンを再送信したり更新したりする必要はありません。

1回のセッションでリクエストできるプレースメントの数はいくつですか？

1回のリフレッシュリクエストで、最大10個のプレースメントをリクエストできます。リクエストごとに、Brazeはそのユーザーが対象となる最も優先度の高いバナーを返します。追加のリクエストはエラーを返します。

詳細については、プレースメントリクエストを参照してください。

同時にアクティブにできるバナーキャンペーンの数はいくつですか？

各ワークスペースでは、最大200件のアクティブなバナーキャンペーンをサポートできます。この上限に達した場合、新しいキャンペーンを作成する前に、既存のキャンペーンをアーカイブまたは無効化する必要があります。

同じプレースメントを共有するキャンペーンでは、どのバナーが最初に表示されますか？

ユーザーが同じプレースメントを共有する複数のバナーキャンペーンの対象となった場合、優先度が最も高いバナーが表示されます。詳細については、バナーの優先度を参照してください。

既存のContent Cardsフィードでバナーを使用できますか？

バナーはContent Cardsとは異なるため、バナーとContent Cardsを同じフィードで使用することはできません。既存のContent Cardsフィードをバナーに置き換えるには、アプリまたはWebサイトにプレースメントを作成する必要があります。

バナーとアプリ内メッセージの違いは何ですか？

バナーとアプリ内メッセージはどちらもアプリやWebサイト内でユーザーにリーチしますが、配信モデルが異なります。バナーを既存のアプリ内メッセージ設定と比較する場合、トリガー、更新タイミング、テストに違いがあり、単純な置き換えではないことを理解してください。

トピック	バナー	アプリ内メッセージ
メッセージの表示場所	アプリやサイトで定義したプレースメントにインラインで表示	SDKが管理するフルスクリーン、モーダル、またはスライドアップのオーバーレイ
コンテンツの更新タイミング	アプリやサイトがバナーの更新を呼び出したとき（例：セッション開始時やセッション中）	テンプレート化されたメッセージは、ペイロードがデバイスにキャッシュされた後、アプリ内メッセージがトリガーされたとき（例：カスタムイベントやセッション開始時）にLiquidを評価します
アクションベースのトリガー	アクションベース配信なし。代わりにセグメント、優先度、更新タイミングを使用します	アクションベースおよびAPIトリガー配信をサポート
テスト	ユーザーをプレビューし、アプリやサイトでプレースメントの更新が期待どおりのバナーを表示するか確認します	トリガーベースの表示に対してテスト送信またはアプリ内プレビューフローを使用します
レポート	バナーの閲覧数とクリック数はバナー分析に従います	アプリ内インプレッションとクリック数はアプリ内メッセージ分析に従います

バナーに動画を含めることはできますか？

標準のバナービルダーは、画像、テキスト、ボタンをサポートしています。バナーに動画を含めるには、ビルダーでカスタムコードブロックを使用するか、HTMLエディターでバナー全体を構築し、HTML内に直接動画プレーヤーを埋め込みます。

ユーザーのアクションに基づいてバナーをトリガーできますか？

バナーはアクションベース配信をサポートしていませんが、セグメンテーションと優先度を使用して、過去のアクションに基づいてユーザーをターゲットにすることができます。

例えば、purchaseイベントを完了したユーザーにのみ特別なバナーを表示するには：

1. ターゲティング： キャンペーンで、カスタムイベントpurchaseを少なくとも1回実行したユーザーのセグメントをターゲットにします。
2. 優先度： すべてのユーザー向けの一般的なバナーと、同じプレースメントをターゲットにする購入者向けの特定のバナーがある場合、特定のバナーの優先度をHighに、一般的なバナーをMediumまたはLowに設定します。

ユーザーが新しいセッションを開始するか、アクションの実行後にバナーを更新すると、Brazeはそのユーザーの適格性を評価します。「Purchase」セグメントに一致する場合、高優先度のバナーが表示されます。

ユーザーはバナーを閉じることができますか？

はい。ユーザーがバナーを手動で閉じることを許可できます。ビルダーおよびHTMLエディターでの閉じる動作の設定方法については、閉じる動作を設定するを参照してください。

ユーザーがバナーを手動で閉じることができるのは、閉じる動作が有効になっている場合のみです。閉じる動作が有効になっていない場合は、ユーザーセグメントの適格性を管理することでバナーの表示を制御できます。ユーザーがバナーキャンペーンのターゲティング条件を満たさなくなった場合、次のセッションではそのバナーは表示されなくなります。

ユーザーがバナーを閉じると、デフォルトではそのキャンペーンの対象外となります。閉じたユーザーに再度バナーを表示するには、キャンペーンの配信コントロールステップで再適格性を設定してください。キャンバスのバナーステップでは、再適格性の制御にキャンバスの再エントリ設定が使用されます。

例えば、ユーザーが購入するまでプロモーションバナーを表示する場合、purchase_completedなどのイベントを記録することで、そのユーザーをターゲットセグメントから除外し、以降のセッションでバナーを効果的に非表示にすることができます。

コントロールグループユーザーはCurrentsとデータ共有でどのように記録されますか？

バナーのコントロールグループは、Content Cardsやアプリ内メッセージとは異なる動作をします。コントロールユーザーはUSERS_CAMPAIGNS_ENROLLINCONTROL_SHARED（またはCurrentsのusers.campaigns.EnrollInControlイベント）には記録されません。代わりに、コントロールの露出は、アプリがインプレッションを記録した後にUSERS_MESSAGES_BANNER_IMPRESSION_SHARED（Currentsのusers.messages.banner.Impression）に記録されます。これには、インテグレーションがコントロールバナーに対してinsertBannerを呼び出し、コンテナを非表示にした場合も含まれます。

エクスポートデータでコントロールユーザーを識別するには、message_variation_name（Control Group）またはコントロールバリアントのmessage_variation_api_idでフィルターしてください。

詳細については、Content Cards、アプリ内メッセージ、バナーのコントロールグループユーザーはCurrentsでどのように記録されますか？およびUSERS_MESSAGES_BANNER_IMPRESSION_SHAREDを参照してください。

Banners キャンペーンの分析データをBraze APIを使用してエクスポートできますか？

はい。/campaigns/data_series エンドポイントを使用して、バナーキャンペーンの表示数、クリック数、コンバージョン数に関するデータを取得できます。

ユーザーはいつセグメンテーションされますか？

ユーザーはセッション開始時にセグメンテーションされます。キャンペーンのターゲットセグメントがカスタム属性、カスタムイベント、またはその他のターゲティング属性に依存している場合、それらはセッション開始時にユーザーに存在している必要があります。

バナーのレイテンシーを最小限に抑えるにはどうすればよいですか？

バナーのメッセージがシンプルであるほど、レンダリングが速くなります。ユースケースで想定されるレイテンシーに対してバナーキャンペーンをテストすることをお勧めします。例えば、catalog_itemsのようなLiquid属性を必ずテストしてください。

Connected Content（早期アクセス中）を使用する場合、各呼び出しは1回のリフレッシュにおけるすべてのプレースメント全体で約2秒の共有レンダリングバジェットに対してカウントされることに注意してください。バジェットを超過するか呼び出しがタイムアウトした場合、Connected Contentの結果はnullとして扱われ、バナーはリトライしません。レイテンシーを最小限に抑えるには：

• エンドポイントを高速に保ち、可能な限りレスポンスをキャッシュしてください。
• 同時にレンダリングされるプレースメント間でのユニークなConnected Content URLの数を制限してください。
• あるConnected Contentのレスポンスが次のURLを決定するような、呼び出しの連鎖を避けてください。
• Liquidのガードステートメントまたはdefaultフィルターを使用して、nullの結果を処理し、空のバナーを防いでください。

すべてのLiquidタグはサポートされていますか？

いいえ。ただし、バナーメッセージではほとんどのLiquidタグがサポートされています。例外として、:rerenderタグを使用して再レンダリングされるcatalog_itemsはサポートされていません。

クリックイベントをキャプチャできますか？

はい。クリックイベントのキャプチャ方法は、バナーのレンダリング方法によって異なります。

• ビルダー — 標準コンポーネント: バナーが標準エディターコンポーネント（画像、ボタン、テキスト）を使用している場合、SDKの挿入メソッドを使用すると、クリックは自動的にトラッキングされます。
• ビルダー — カスタムコードブロック: カスタムコードエディターブロック内の要素のクリックをトラッキングする場合は、カスタムHTML内からbrazeBridge.logClick()を呼び出す必要があります。これは、SDKメソッドを使用してバナーを挿入およびレンダリングする場合にも適用されます。
• HTMLエディター: クリックトラッキングは自動ではありません。トラッキングしたいクリック可能な要素ごとにbrazeBridge.logClick()を呼び出す必要があります。完全なリファレンスについては、バナーのカスタムコードとJavaScriptブリッジを参照してください。
• カスタムUI（ヘッドレス）: バナーHTMLをレンダリングする代わりに、バナーのカスタムプロパティを使用して完全にカスタムのUIを構築している場合は、アプリケーションコードからバナーオブジェクトのlogClick()を呼び出してください。

詳細については、クリックのロギングを参照してください。