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

キャンペーンを設定する際は、開始前にメッセージをテストすることをおすすめします。このリファレンス記事では、APIリクエスト、ペイロード、配信到達性ログを検査するためのテストユーザーセグメントの作成方法について説明します。

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

API またはカスタムイベントによるキャンペーンのトリガーをテストする唯一の方法は、キャンペーンを公開することです。新しいキャンペーンを展開する際には、トリガーの配信到達性をテストするときにテストユーザーセグメントをキャンペーンに追加することを強くお勧めします。これにより、キャンペーンが誤って送信された場合でも、内部ユーザーにのみ届くというセーフティネットが確保されます。

1. テストユーザーをインポートする
   テストユーザーは、CSV、または Postman を使用した 1 回限りのバッチリクエストで Braze にインポートできます。これらのユーザーをインポートする際は、テストグループのセグメントの作成に使用できるカスタム属性 (internal_test_user: true など) をプロファイルに設定することをお勧めします。
   
   
2. テストユーザーを Braze が認識するテストユーザーとして追加する
   ダッシュボードでテストユーザーを Braze が認識するテストユーザーとしてマークすると、各ユーザーの詳細ログにアクセスできるようになり、API リクエストとそのペイロードの確認や、配信到達性ログの表示が可能になります。これらのログは、エンドユーザーへのキャンペーン配信で問題が発生したかどうかを判断するのに役立ちます。
   
   
3. セグメントを作成する
   テストユーザーセグメントを作成するには、internal_test_user カスタム属性が true に設定されているユーザーのセグメントを作成します。このセグメントは、キャンペーンの公開時に削除できます。

ステップ 2: 送信のテスト

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

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

Braze のログを使用して、トリガー、送信、イベントに関する問題のトラブルシューティングを行います。

• イベントユーザーログには、API トリガーリクエストの未加工のペイロード、キャンペーンをトリガーしたカスタムイベント、および関連するトリガーまたはイベントのプロパティが表示されます。
• Messaging Observabilityでは、特定のメッセージが送信されなかった可能性がある理由を確認できます。

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

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