エージェント型基準

エージェント型基準は、Brazeのキャンペーンやキャンバスにエンタープライズポリシーやガードレールを適用するためのルールとルールセットです。基準を設定する際は、Operatorがルールの下書き作成を支援します。キャンペーンやキャンバスを開始する前に、基準に照らしてエージェント型評価を実行し、ブランドガイドライン、組織の規約、技術要件を検証できます。Braze Agentsの概要については、Braze Agentsを参照してください。

エージェント型基準を使うと手動での監視の負担が減り、Brazeが送信するすべてのメッセージが正確で、コンプライアンスに準拠し、開始できる状態になります。

プランティア

エージェント型基準を利用できる範囲は、無料または有料のプランティアによって異なります。

機能	無料ティア	有料ティア
キャンペーン基準とキャンバス基準の構築	利用可能	利用可能
ワークスペースあたりの月間評価実行回数	25	無制限
月間使用量の上限	該当なし (実行回数の制限のみ)	高

無料ティアでは、評価プレビュー (応答をシミュレート) と、ローンチ時の評価を実行または評価を再実行が25回の実行回数にカウントされます。基準はそれぞれ個別の実行としてカウントされるため、複数の基準を選択して同時に実行すると、各基準が制限にカウントされます。たとえば、1つのキャンペーンに対して3つの基準を実行すると、3回分の実行回数を使用します。アップグレードするには、Brazeのアカウント担当者にお問い合わせください。

有料ティアでは、月間の実行回数に制限はありません。負荷の高い評価ほど、月間使用量の上限に多く加算されます。各評価が上限のどれだけを使用したかを確認するには、基準の評価ログをチェックしてください。ほとんどのワークスペースはこの上限に達しません。上限に達した場合は、カスタマーサクセスマネージャーにお問い合わせください。

仕組み

エージェント型基準には、キャンペーン基準とキャンバス基準の2種類があります。基準を作成する際は、「ルールセット」にグループ化された特定のルールを定義します。これらのルールはローンチ前に評価されます。

一般的なマーケティングニーズに対応する構築済みのルールセットから選択することも、チーム固有のカスタムルールを作成することもできます。設定が完了したら、評価プレビューペインで、ワークスペース内の既存のキャンペーンやキャンバスに対して基準をテストできます。エージェントによる評価では、検出結果をカテゴリ別にまとめた詳細なレポートが提供されます。

Content BlocksとLiquid

評価の前に、BrazeはContent Blocksをその内容に展開します。各ブロックのテキストにはブロック名のラベルが付けられます。また、エージェント型基準は、各フィールドが使用しているブロックの一覧も受け取ります。この一覧には、ネストされたブロックや展開に失敗したブロックも含まれます。そのため、ルールでブロックを名前で参照できます (例:「フッターでLegal_Disclaimerを使用している」)。

Liquidは特定のユーザーに対してレンダリングされません。エージェント型基準は記述されたとおりにLiquidを評価し、構文エラー、認識されない変数、{% else %}フォールバックのない条件分岐をチェックします。評価中にConnected Contentの呼び出しは行われません。

エージェント型基準を作成する

キャンペーン基準は、1回限りおよび定期的なキャンペーンにルールを適用します。キャンバス基準は、複数ステップのカスタマージャーニーにルールを適用します。どちらのタイプも同じ詳細設定とプレビューのワークフローを使用しますが、キャンバス基準ではステップごとのチェック用に2つ目のルールステップが追加されます。

どちらのタイプでも、エージェント型基準を作成メニューには2つの開始方法があります。

• Brazeテンプレートから作成: そのタイプの事前構築済みルールセットがすべて追加された状態で開始します。保存する前に、これらのルールセットやルールを編集または削除できます。
• 最初から作成: ルールセットがない状態で開始します。独自のルールセットを追加するか、ファイルから生成します。

• キャンペーン
• canvas

エージェント型基準を使用する

キャンペーン基準またはキャンバス基準を設定したら、最終レビューの過程でそれを使用してキャンペーンやキャンバスを評価できます。これにより、メッセージがユーザーに送信される前、またはユーザーがジャーニーにエントリする前に、メッセージングがすべての要件を満たしていることを確認できます。

評価を実行する

• キャンペーン
• canvas

評価結果を確認する

評価が完了すると、合格、不合格、警告、無視 の各カテゴリーで検出結果の概要が表示されます。

レート制限エラーにより評価が失敗した場合は、再試行 を選択します。

不合格 タブには、満たされなかったルールが一覧表示されます。各不合格項目について、基準は次の情報を提供します。

• ルール: チェック対象の具体的な基準 (「スペルと文法のチェック」など)。
• 理由: チェックが不合格になった理由の説明。たとえば、オーストラリア英語のスペル「personalised」ではなく「personalized」が使用されていることや、遅延ステップがチームの最小待機時間よりも短いことを評価が特定する場合があります。

合格 タブには、正しく守られたすべてのルールが一覧表示されます。これにより、不快な言語の検出 や 命名規則の検証 などのチェックをクリアしたことを確認できます。

警告 タブには、注意が必要な可能性のある重大ではない問題が一覧表示されます。たとえば、Webhook キャンペーンや、アプリ内メッセージステップのみを含むキャンバスに対してメールのルールセットをテストしている場合、差出人名が該当しないという警告が評価で表示されることがあります。

無視 タブには、現在の評価の実行でスキップすることを選択した問題が一覧表示されます。

前回の実行 インジケーターには、キャンペーンまたはキャンバスに対して基準が最後に評価された日時が表示されます。キャンペーンやキャンバスが停止またはアーカイブされた場合でも、最新の実行から90日間は表示されたままになります。

エージェントの判断に基づく結果

どのタブの結果でも、理由の下に エージェントの判断に基づく と表示されることがあります。このマーカーは基準全体ではなく、そのルールにのみ適用されます。これは、設定の値、タグ、リンクの有無など、直接検証可能な事実ではなく、エージェント自身の評価が結果に反映されていることを意味します。たとえば、エージェントがコピーを読むことはできても、そのコピーがよく書かれているか、スペルが正しいか、明確か、ブランドに沿っているかの判断は、判断に該当します。

キャンペーンまたはキャンバスに明記されていないことをエージェントが想定した場合、マーカーの後に、何を想定したのか、またその理由を説明する短い注記が続きます。例: エージェントの判断に基づく: キャンペーンの名前とコピーから、Homeキャンペーンであると推測されます。

ルールを具体的な事実に照らしてチェックしたい場合は、特定の設定、タグ、またはコンテンツを参照するようにルールを修正します。たとえば、「メールでオプトアウトが簡単にできる」ではなく「メールのフッターに購読解除リンクが含まれている」を使用します。

問題を解決または無視する

特定された不合格や警告のそれぞれについて、ローンチ前にどのように対処するかを決定できます。問題の横にある 解決 を選択し、次のオプションから選択します。

• 修正済みとしてマーク: 評価の提案に基づいて、キャンペーンやキャンバスの設定、ジャーニー構造、またはコピーを更新した後に選択します。
• この問題を無視: 今回の実行に限り、その問題をスキップする場合に選択します。意図的な逸脱や、評価の提案が当てはまらない可能性があるエッジケースに役立ちます。
• BrazeAI Operatorに質問: Operatorを使用して問題を修正する場合に選択します。

重大な問題がすべて解決または無視されたら、キャンペーンまたはキャンバスのローンチに進むことができます。

評価ログを確認する

基準の過去の評価を確認するには、エージェントコンソール > エージェント型基準に移動し、基準を選択してから 評価ログタブを選択します。各行が1回の評価実行を表します。詳細列を使用すると、実行を展開して個々のルール評価を確認したり、評価の詳細を開いたりできます。ログをエクスポートするには、CSVをエクスポートを選択します。

評価を実行したユーザーを確認する

実行者列には、各評価を実行した Braze ユーザーの名前が表示されます。名前が登録されていない場合は、メールアドレスが表示されます。実行内のルール評価は同じユーザーが実行したものであるため、それらの行ではこの列は空白になります。ユーザーが実行していない評価には N/A と表示されます。CSVエクスポートにも 実行者列が含まれます。

特定のユーザーが実行した評価のみを表示するには、フィルターを選択し、実行者でユーザーを選択します。選択した日付範囲内に基準を実行したユーザーが最初に表示されます。会社内のその他のユーザーも一覧に表示されますが、選択することはできません。

評価ごとの使用量

無料プランでは、上限が使用量ではなく月あたりの評価実行回数であるため、評価ログに使用量は表示されません。

有料プランでは、使用した上限列に、各実行およびルール評価がワークスペースの月間使用量上限の何パーセントを使用したかが「0.2%」のように表示されます。小数点以下2桁で表示できないほど小さい割合は「< 0.01%」と表示されます。この列を使用すると、多数のルールセットを含む基準の実行など、想定よりも多く上限を使用している評価を見つけることができます。

• キャッシュ済みは、以前の同一の評価から結果が再利用され、上限にカウントされなかったことを意味します。
• 同じパーセンテージが、詳細パネルでは 使用した上限として、CSVエクスポートでは 使用した上限 (%)として表示されます。

詳しくは、プランの種類を参照してください。

制限事項

エージェント型基準は、Brazeに保存されている状態のキャンペーンまたはキャンバスの設定とコンテンツを評価します。メッセージの送信、個々のユーザー向けのレンダリング、外部ページへのアクセスは行いません。

ルールを作成する際は以下の制限事項に留意し、これらの領域については既存の手動チェックを引き続き実施してください。

• テスト送信やユーザーごとのプレビューは不可: エージェント型基準は、テストメッセージの送信、特定のユーザーとしてのメッセージのプレビュー、多数のユーザーに対する一括プレビューのレンダリングを行えません。特定のユーザーが受け取る内容に依存するルールはサポートされていません。これらのチェックには、テスト送信とプレビューを使用してください。
• LiquidとConnected Contentはレンダリングされない: エージェント型基準は、ユーザー向けにレンダリングされた結果ではなく、記述されたままのLiquidを評価します。また、Connected Contentの呼び出しも行いません。詳しくは、Content BlocksとLiquidを参照してください。
• リンク先にはアクセスしない: エージェント型基準は、URL、ディープリンク、UTMパラメーターなど、リンクが存在し正しい形式であることをチェックできます。ただし、リンクを開くことはありません。404エラーを返すリンクなどのリンク切れを検出したり、リンク先がメッセージの内容と一致しているかを確認したりすることはできません。
• ユーザーやセグメントの検索は不可: エージェント型基準は、個々のユーザープロファイルを検索したり、特定のユーザーがセグメントに含まれているかを確認したりできません。評価できるのは、キャンペーンまたはキャンバス自体のターゲティング設定のみです。
• キャンバスステップの対象範囲: ステップのルールセットは、メッセージ、コンテンツオプティマイザー、オーディエンスパスの各ステップでのみ実行されます。その他のステップタイプは評価できません。
• 画像の上限: エージェント型基準が内容を確認できる画像は、キャンペーンごと、またはキャンバスのメッセージステップごとに、最大32枚のユニークな画像です。複数のバリアントで使用されている画像は1枚としてカウントされます。これにはContent Blocksやメールフッターによって追加された画像も含まれ、フッター画像は最後にカウントされます。合計サイズの上限もあるため、大きな画像を多数含むキャンペーンやキャンバスでは、チェックされる画像の数が少なくなる場合があります。URLがLiquidで構築されている画像はチェックされません。画像の見た目に関するルールは、この上限内の画像にのみ適用されます。
• 非常に大きなメッセージ: 多数の大きなバリアントを含む多変量メールなど、キャンペーンやキャンバスのコンテンツがエージェント型基準で一度に評価できる量を超える場合、評価前にコンテンツが短縮されます。その場合、結果に警告が表示され、ルールが不完全なコンテンツに対してチェックされている可能性があります。

ベストプラクティス

• テンプレートから始める: まずは設定、リンクとトラッキング向けの事前構築済みルールセットを使用してください。これらのルールセットは手作業で起こりやすい一般的なエラーを網羅しており、エージェント型評価に適切なコンテキストを提供します。
• 具体的に記述する: カスタムルールを作成するときは、「正しい」状態がどのようなものかを明確な例で示してください。たとえば、「命名規則を確認する」と書く代わりに、「キャンペーンまたはキャンバスの名前が現在の年で始まっている (例: 2026_)」のように記述します。
• 結果がわかっているものでテストする: 評価プレビューで、すべてのルールに合格するはずのキャンペーンまたはキャンバスと、特定のルールに不合格となるはずのものをテストしてください。これにより、ローンチ時にルールを利用する前に、ルールが正確に評価されることを確認できます。
• 頻繁に見直す: ブランドガイドラインや社内プロセスが変わったら、キャンペーン基準とキャンバス基準のルールセットを更新し、自動チェックを常に適切な状態に保ちます。