コンテンツにスキップ

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:テストセグメントを削除してキャンペーンをロールアウトする

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

New Stuff!