エージェント型基準

エージェント型基準は、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つ目のルールステップがあります。

• キャンペーン
• canvas

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

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

評価を実行する

• キャンペーン
• canvas

評価結果を確認する

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

評価ログを確認する

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

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

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

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

評価ごとの使用量

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

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

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

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

制限事項

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

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

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

ベストプラクティス

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