APIトリガーおよびアクションベースのキャンペーン

キャンペーンを設定する際は、起動前にメッセージをテストすることが常にベストプラクティスです。このリファレンス記事では、APIリクエストやペイロードの検査、配信ログの確認を可能にするテストユーザーセグメントの作成方法について説明します。

ステップ 1: テストユーザーセグメントを作成する

APIまたはカスタムイベントによるキャンペーンのトリガーをテストする唯一の方法は、キャンペーンを本番環境にプッシュすることです。新しいキャンペーンを展開する際は、配信のトリガーをテストするときにキャンペーンにテストユーザーセグメントを追加することを強くお勧めします。これにより安全策が確保され、キャンペーンが誤って送信された場合でも、内部ユーザーにのみ送信されます。

1. テストユーザーをインポートする
   テストユーザーは、CSVまたはPostmanを使用した単発のバッチリクエストでBrazeにインポートできます。これらのユーザーをインポートする際は、テストグループセグメントの構築に使用できるカスタム属性（internal_test_user: true など）をプロファイルに設定することをお勧めします。
   
   
2. テストユーザーをBraze認定テストユーザーとして追加する
   ダッシュボードでテストユーザーをBraze認定テストユーザーとしてマークすると、各ユーザーの詳細なログにアクセスでき、APIリクエストやそのペイロードの検査、および配信ログの確認が可能になります。これらのログは、エンドユーザーへのキャンペーン配信に問題がなかったかどうかを判断するのに役立ちます。
   
   
3. セグメントを作成する
   テストユーザーセグメントを作成するには、internal_test_user カスタム属性が true に設定されたユーザーのセグメントを作成します。このセグメントは、キャンペーンが本番環境に移行した際に削除できます。

ステップ 2: テスト送信を行う

次に、Brazeダッシュボードからテスト送信を行うか、Inbox Vision（メールのみ）を使用して、キャンペーンがまだ下書きモードの間にレイアウトがどのように表示されるかを確認できます。その後、キャンペーンをテストユーザーセグメントに送信して、期待どおりに動作しているかを確認します。キャンペーンがAPIトリガーであるかアクションベースであるかに関わらず、Postmanを使用してBraze APIに単発のリクエストを送信し、キャンペーンをトリガーしてください。

ステップ 3: Brazeのログを使用して受信結果を検査する

Brazeのログを使用して、トリガー、送信、およびイベントの問題をトラブルシューティングします。

• イベントユーザーログでは、APIトリガーリクエストの生のペイロード、キャンペーンをトリガーするカスタムイベント、および関連するトリガーやイベントプロパティを確認できます。
• メッセージアクティビティログでは、エラーが記録され、特定のメッセージが配信されなかった理由を把握するのに役立ちます。

ステップ 4: テストセグメントを削除してキャンペーンを展開する

メッセージが正しくトリガーおよびレンダリングされ、クリックされたすべてのリンクが登録されたことを確認したら、セグメントを削除してキャンペーンを更新できます。テストユーザーの少数のインプレッションが含まれないようにキャンペーンを最初からやり直したい場合は、キャンペーンを複製し、テストユーザーセグメントなしで再開できます。