API トリガーキャンペーンとアクションベースのキャンペーン
キャンペーンを設定する際は、キャンペーンを開始する前に必ずメッセージをテストすることをお勧めします。この記事では、API リクエストやペイロードを検査したり、配信機能ログを表示したりできる、テストユーザーセグメントの作成について説明します。
ステップ 1: テストユーザーセグメントの作成
API またはカスタムイベントを使用したキャンペーンのトリガーをテストする唯一の方法は、キャンペーンをライブ配信することです。新しいキャンペーン展開の一環として、配信機能のトリガーをテストする際には、テストユーザーセグメントをキャンペーンに追加することを強くお勧めします。これにより、キャンペーンが誤って送信された場合でも、内部ユーザーにのみ送信されるというセーフティネットが提供されます。
- テストユーザーをインポートする
テストユーザーは、CSV 形式で Braze にインポートすることも、Postman 経由の 1 回限りのバッチリクエストでインポートすることもできます。これらのユーザーをインポートするときは、テストグループセグメントの作成に使用できるカスタム属性 (internal_test_user: true
など) をプロファイルに設定することをお勧めします。 - テストユーザーを Braze 認定テストユーザーとして追加する
ダッシュボードでテストユーザーを Braze の認定テストユーザーとしてマークすると、各ユーザーの詳細なログにアクセスして、API リクエストとそのペイロードを検査したり、配信機能ログを表示したりできます。これらのログは、エンドユーザーへのキャンペーンの配信に問題があったかどうかを判断するのに役立ちます。 - セグメントを作成する
テストユーザーセグメントを作成するには、internal_test_user
カスタム属性をtrue
に設定してユーザーのセグメントを作成します。このセグメントは、キャンペーンの開始時に削除できます。
ステップ 2: テスト送信
次に、Braze ダッシュボードからテスト送信するか、Inbox Vision (メールのみ) を使用して、キャンペーンがまだ下書きモードのときにレイアウトがどのように表示されるかを確認できます。その後、キャンペーンをテストユーザーセグメントに送信して、期待どおりに動作することを確認できます。キャンペーンが API トリガー型かアクションベースかに関わらず、Postman を使用して 1 回限りのリクエストを Braze API に送信し、キャンペーンをトリガーします。
ステップ 3: Braze のログを使って受信結果を調べる
Braze のログを使用して、トリガー、送信、イベントの問題のトラブルシューティングを行います。
- イベントユーザーログは、API-トリガーリクエストの生のペイロード、キャンペーンをトリガーするカスタムイベント、および関連するトリガーまたはイベントプロパティを表示します。
- メッセージアクティビティログは、エラーを記録し、特定のメッセージが配信されなかった理由を理解するのに役立ちます。
ステップ 4:テストセグメントを削除してキャンペーンを開始する
クリックしたすべてのリンクが登録された状態でメッセージがトリガーされ、正しく表示されるようになったら、セグメントを削除してキャンペーンを更新できます。テストユーザーのインプレッションがほとんどない状態で最初からキャンペーンを開始したい場合は、キャンペーンを複製してテストユーザーセグメントなしで再開することもできます。