よくある質問

これらは、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などのイベントを記録することで、そのユーザーをターゲットセグメントから除外し、以降のセッションでバナーを非表示にすることができます。

バナーキャンペーンの分析データを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()を呼び出してください。

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