コンテンツにスキップ

エージェント型基準

エージェント型基準は、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 %} フォールバックのない条件分岐をチェックします。評価中にコネクテッドコンテンツの呼び出しは行われません。

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

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

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

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

ステップ1: 基準のタイプを選択する

基準を作成するには、エージェント > エージェント型基準に移動します。エージェント型基準を作成を選択し、キャンペーン基準の下でBrazeテンプレートから作成または最初から作成を選択します。

ステップ2: 詳細を設定する

次に、基準の詳細を設定します。

  1. チームが目的を理解しやすいように、名前と説明を入力します。
  2. (オプション) 基準をフィルタリングするためのタグを追加します。
  3. (オプション) チームを割り当てて、この基準を適用するキャンペーンの範囲を指定します。

Brazeでカート放棄キャンペーンのルールとルールセットを定義するキャンペーン基準「Abandoned Cart キャンペーン Standards」。

ステップ3: キャンペーンルールを設定する

キャンペーンルールステップで、この基準の一部として適用するルールを定義します。1つの基準につき最大15個のルールセットを追加でき、1つのルールセットにつき最大20個のルールを追加できます。

Brazeテンプレートから開始した場合は、事前構築済みの各カテゴリーのルールセットがすでに追加されています。それぞれを確認し、チームに合わないルールを編集または削除してください。

ルールを作成するには、次のいずれかを選択します。

  • ファイルから生成: 既存のチェックリストやポリシーを含むPDF、TXT、Markdown、またはCSVファイルをアップロードします。BrazeはBraze Autoモデルを使用して、その内容をエージェント型基準で評価できるルールとルールセットに変換します。
  • ルールセットを追加: ルールを最初から作成します。

ルールセットを追加を選択すると、次のカテゴリーが表示されます。

  • キャンペーン設定: 命名規則、タグ、コンバージョントラッキングを検証します。
  • オーディエンスとターゲティング: セグメント、除外条件、オーディエンスサイズをチェックします。
  • コンテンツとコピー: テキストの品質、文字数制限、メッセージの完全性に関する要件を定義します。
  • リンクとトラッキング: URL、CTA、ディープリンク、UTMパラメーターを検証します。
  • パーソナライゼーションとダイナミックなコンテンツ: Liquidロジックとフォールバック値のチェックを定義します。
  • コンプライアンスと配信到達性: 法的義務と送信時の安全対策に関する要件を定義します。
  • カスタムルール: カスタムルールセットを作成を選択して、事前設定されたどのカテゴリーにも当てはまらない独自の要件を定義します。

「オーディエンスとターゲティング」カテゴリーに設定された4つのルール。

ステップ4: 基準をテストする

Brazeのキャンペーンで基準を使用する前に、評価プレビューペインを使用してエージェント型評価をシミュレートします。

  1. テストケースとして使用する既存のキャンペーンをドロップダウンメニューから選択します。
  2. すべてのルールセットをテストするか、特定のルールセットをテストするかを選択します。
  3. レスポンスをシミュレートを選択します。

次に、結果を確認します。評価はキャンペーンに対して実行され、結果が次のカテゴリーで表示されます。

  • 合格: これらのルールは正常に満たされています。たとえば、命名規則が想定されるパターンに一致していることを評価で確認できます。
  • 警告: 対応が必要な場合がある重大ではない問題です。たとえば、Webhookキャンペーンに対してメールのルールセットをテストしている場合、エージェント型評価によって差出人名が該当しないという警告が表示されることがあります。
  • 不合格: 開始前に修正すべき重大な問題です。例としては、過去の日付にスケジュールされている場合や、必須の組織タグが欠落している場合などがあります。

ステップ1: 基準のタイプを選択する

基準を作成するには、エージェント > エージェント型基準に移動します。エージェント型基準を作成を選択し、キャンバス基準の下でBrazeテンプレートから作成または最初から作成を選択します。

ステップ2: 詳細を設定する

次に、基準の詳細を設定します。

  1. チームが目的を理解しやすいように、名前と説明を入力します。
  2. (オプション) 基準をフィルタリングするためのタグを追加します。
  3. (オプション) チームを割り当てて、この基準を適用するキャンバスの範囲を指定します。

Brazeでカート放棄キャンバスをレビューするためのルールとルールセットを定義するキャンバス基準。

ステップ3: キャンバス構成ルールを設定する

キャンバス構成ステップで、キャンバス全体に対して1回評価されるルールを定義します。両方のルールステップを合わせて1つの基準につき最大15個のルールセットを追加でき、1つのルールセットにつき最大20個のルールを追加できます。

Brazeテンプレートから開始した場合は、両方のルールステップに事前構築済みのルールセットが含まれています。このステップには、キャンバス設定、キャンバス構造、オーディエンスとターゲティングのルールセットが含まれます。キャンバスステップステップには、メッセージステップとオーディエンスパスのルールセットが含まれます。それぞれを確認し、チームに当てはまらないルールを編集または削除してください。

ルールを作成するには、次のいずれかを選択します。

  • ファイルから生成: 既存のチェックリストやポリシーを含むPDF、TXT、Markdown、またはCSVファイルをアップロードします。BrazeはBraze Autoモデルを使用して、その内容をエージェント型基準で評価できるルールとルールセットに変換します。
  • ルールセットを追加: ルールを最初から作成します。

ルールセットを追加を選択すると、次のカテゴリーが表示されます。

  • キャンバス設定: 命名規則、タグ、コンバージョンイベント、エントリスケジュール、再エントリ設定を検証します。
  • キャンバス構造: フローの接続性、分岐、遅延、終了条件を検証します。
  • オーディエンスとターゲティング: セグメント、除外条件、エントリ制限、オーディエンスサイズをチェックします。
  • カスタムルール: カスタムルールセットを作成を選択して、事前設定されたどのカテゴリーにも当てはまらない独自の要件を定義します。

「キャンバス設定」カテゴリーに設定された4つのルール。

ステップ4: キャンバスステップのルールを設定する

キャンバスステップステップで、ジャーニー内の個々のステップに対して評価されるルールを定義します。これらのルールセットは、キャンバス内で一致するすべてのステップに対して実行されます。たとえば、メッセージステップのルールセットは各メッセージステップで実行され、オーディエンスパスのルールセットは各オーディエンスパスステップで実行されます。

ルールセットを追加を選択してステップタイプを選ぶと、次のカテゴリーが表示されます。

  • メッセージおよびContent Optimizerステップ
    • コンテンツとコピー: テキストの品質、文字数制限、メッセージの完全性に関する要件を定義します。
    • リンクとトラッキング: URL、CTA、ディープリンク、UTMパラメーターを検証します。
    • パーソナライゼーションとダイナミックなコンテンツ: Liquidロジックとフォールバック値のチェックを定義します。
    • コンプライアンスと配信到達性: 法的義務と送信時の安全対策に関する要件を定義します。
  • オーディエンスパス
    • パスと優先度: パスのラベル、狭い条件から広い条件への順序付け、意図的な優先度を検証します。

どちらのステップタイプでも、カスタムルールを作成することもできます。

ステップ5: 基準をテストする

Brazeのキャンバスで基準を使用する前に、評価プレビューペインを使用してエージェント型評価をシミュレートします。

  1. テストケースとして使用する既存のキャンバスをドロップダウンメニューから選択します。
  2. すべてのルールセットをテストするか、特定のルールセットをテストするかを選択します。
  3. レスポンスをシミュレートを選択します。

次に、結果を確認します。評価はキャンバスに対して実行され、結果が次のカテゴリーで表示されます。

  • 合格: これらのルールは正常に満たされています。たとえば、命名規則が想定されるパターンに一致していることを評価で確認できます。
  • 警告: 対応が必要な場合がある重大ではない問題です。たとえば、プッシュ通知のメッセージステップのみを含むキャンバスに対してメールのルールセットをテストしている場合、エージェント型評価によって差出人名が該当しないという警告が表示されることがあります。
  • 不合格: 開始前に修正すべき重大な問題です。例としては、エントリスケジュールが過去の日付になっている場合、必須の組織タグが欠落している場合、終了条件が設定されていない場合などがあります。

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

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

評価を実行する

自動評価を実行するには、キャンペーン作成ワークフローのレビュー概要ステップに移動します。

  1. エージェント型基準セクションに移動し、ドロップダウンメニューから1つ以上の基準を選択します。複数の基準を選択すると、すべての基準が同時に評価されます。Freeティアでは、基準ごとに個別の実行としてカウントされます(プランティアを参照)。
  2. 評価を実行を選択します。

最初の評価を実行した後にキャンペーンを変更した場合は、評価を再実行を選択して結果を更新します。

自動評価を実行するには、キャンバス作成ワークフローの概要ステップに移動します。

  1. エージェント型基準セクションに移動し、ドロップダウンメニューから1つ以上の基準を選択します。複数の基準を選択すると、すべての基準が同時に評価されます。Freeティアでは、基準ごとに個別の実行としてカウントされます(プランティアを参照)。
  2. 評価する対象を選択します。
    • 設定のみ: キャンバス設定ステップのキャンバス全体のルールセットを評価します。
    • ステップのみ: キャンバスステップステップのステップごとのルールセットを評価します。
    • 評価を実行: 設定とステップの両方を評価します。
  3. 評価を実行を選択します。

最初の評価を実行した後にキャンバスを変更した場合は、評価を再実行を選択して結果を更新します。

キャンバス全体ではなく、特定のステップだけを評価することもできます。ステップの編集中にキャンバスビルダーからステップ単位の実行を開始するか、概要ステップでステップに移動を選択してから、対象のステップに対して評価を再実行を選択します。すべての結果は概要ステップに表示されます。

評価結果を確認する

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

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

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

  • ルール: チェック対象の具体的な基準(「スペルと文法のチェック」など)。
  • 理由: チェックが不合格になった理由の説明。たとえば、オーストラリア英語のスペル「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エラーを返すリンクなどの壊れたリンクを検出したり、リンク先がメッセージの内容と一致しているかを確認したりすることはできません。
  • ユーザーやセグメントの検索は不可: エージェント型基準では、個々のユーザープロファイルを検索したり、特定のユーザーがセグメントに含まれているかを確認したりすることはできません。評価できるのは、キャンペーンまたはキャンバス自体のターゲティング設定のみです。
  • キャンバスステップの対象範囲: ステップのルールセットは、メッセージ、Content Optimizer、オーディエンスパスの各ステップでのみ実行されます。その他のステップタイプは評価できません。
  • 画像の上限: エージェント型基準では、キャンペーンごと、またはキャンバスのメッセージステップごとに、最大32個の固有の画像の内容を確認できます。複数のバリアントで使用されている画像は1つとしてカウントされます。これにはContent Blocksやメールフッターで追加された画像も含まれ、フッター画像は最後にカウントされます。合計サイズの上限もあるため、大きな画像を多数含むキャンペーンまたはキャンバスでは、チェックされる画像の数が少なくなる場合があります。URLがLiquidで構築されている画像はチェックされません。画像の見た目に関するルールは、この上限内の画像にのみ適用されます。
  • 非常に大きなメッセージ: 多数の大きなバリアントを含む多変量メールなど、キャンペーンまたはキャンバスのコンテンツ量がエージェント型基準で一度に評価できる量を超える場合、評価前にコンテンツが短縮されます。その場合、結果に警告が表示され、ルールが不完全なコンテンツに対してチェックされている可能性があります。

ベストプラクティス

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