テストメッセージを送信する
メッセージングキャンペーンをユーザーに送信する前に、推奨されるベストプラクティスとして、正しく表示され、意図した通りに動作することを確認するためにテストを行うことをお勧めします。Brazeダッシュボードのツールを使用して、選択したデバイスやチームメンバーにテストメッセージを作成して送信できます。

テスト後はキャンペーンの下書きを保存して、キャンペーンが削除されないようにしてください。メッセージを下書きとして保存せずにテストメッセージを送信することもできます。
ステップ 1: テストユーザーを特定する
メッセージングキャンペーンをテストする前に、テストユーザーを特定しておくことが重要です。テストユーザーには、既存のユーザー ID やメールアドレスのほか、メッセージングキャンペーンのテスト専用に使用する新しいユーザーも指定できます。
オプション: コンテンツテストグループを作成する
テストユーザーを整理するには、コンテンツテストグループを作成すると便利です。コンテンツテストグループは、キャンペーンからテストメッセージを受信するユーザーのグループです。このテストグループをキャンペーンのテスト受信者にあるコンテンツテストグループを追加フィールドに追加すると、個々のテストユーザーを作成したり追加したりせずにテストを開始できます。
ステップ 2: チャネル別のテストメッセージを送信する
テストメッセージの送信手順については、各チャネルの以下のセクションを参照してください。

コンテンツテストグループまたは個別ユーザーにテストを送信するには、送信前にテストデバイスでプッシュが有効になっており、テストユーザーに有効なプッシュトークンが登録されている必要があります。iOSユーザーの場合、テストのContent Cardを表示するには、Brazeから送信されたプッシュ通知をタップする必要があります。この動作はテストのContent Cardsにのみ適用されます。
テストのContent Cardsはプッシュ通知を通じて配信されます。カードはプッシュペイロードにパッケージ化され、プッシュを受信すると、SDKがカードを抽出してローカルにキャッシュします。
このプロセスは通常のカード配信システムを経由しないため、Content Cardをテストする場合でもプッシュを有効にする必要があります。
テストのContent Cardsは、送信から約5分後に有効期限が切れます。
Content Cardを作成したら、テストのContent Cardをアプリに送信して、実際の表示をリアルタイムで確認できます。
- Content Cardの下書きを作成します。
- テストタブを選択し、このテストメッセージを受信するコンテンツテストグループまたは個別ユーザーを少なくとも1つ選択します。
- テストを送信を選択して、Content Cardをアプリに送信します。

プレビュー
カードの作成中に、プレビュータブでカードをプレビューできます。これにより、最終的なメッセージがユーザーにどのように見えるかをイメージしやすくなります。

コンポーザーのプレビュータブでのメッセージの表示は、ユーザーのデバイスでの実際の表示と完全に一致しない場合があります。メディア、コピー、パーソナライゼーション、カスタム属性が正しく生成されることを確認するため、常にデバイスにテストメッセージを送信することをお勧めします。
テストチェックリスト
- テストユーザーは有効なプッシュトークンでプッシュにオプトインしていますか?
- 画像やメディアは想定どおりに表示され、動作しますか?
- Liquidは想定どおりに機能しますか?Liquidが情報を返さない場合に備えて、デフォルトの属性値を設定していますか?
- コピーは明確かつ簡潔で、正確ですか?
- リンクは、ユーザーを適切な遷移先に誘導しますか?
- テストユーザーは有効なプッシュトークンでプッシュにオプトインしていますか?
画像が壊れている場合のトラブルシューティング
Content Cardの画像がレンダリングされない、または壊れて表示される場合は、次の点を確認してください。
- URLが正しく、URLエンコードされていることを確認する: URL内の特殊文字(スペースやクエリパラメーターなど)は、適切にエンコードする必要があります。エンコードされていないと、画像のリクエストが失敗します。
- コンテンツセキュリティポリシーを確認する: 組織にコンテンツセキュリティポリシー(CSP)や社内のITセキュリティルールがある場合、そのポリシーによって画像のドメインがブロックされる可能性があります。画像URLのドメインがCSPで許可されていることを確認してください。
- HTTPSを使用する: ブラウザーやアプリで混在コンテンツとしてブロックされないよう、画像URLには
http://ではなくhttps://を使用してください。 - ブラウザーでURLを直接開く: ブラウザーで画像が読み込まれない場合、問題はBrazeではなく、画像URLまたはホスティングにあります。
デバッグ
Content Cardsの送信後、開発者コンソールのイベントユーザーログから問題を分析またはデバッグできます。
よくあるユースケースとして、ユーザーが特定のContent Cardを表示できない理由のデバッグがあります。これを行うには、イベントユーザーログで、セッション開始時(インプレッション前)にSDKに配信されたContent Cardsを確認し、それらを特定のキャンペーンまでさかのぼって追跡します。
- 設定 > イベントユーザーログに移動します。
- テストユーザーのSDKリクエストを見つけて展開します。
- 未加工データをクリックします。
-
セッションの
idを見つけます。以下は抜粋の例です。[ { "session_id": "D1B051E6-469B-47E2-B830-5A728D1D4AC5", "data": { "ids": [ "NDg2MTY5MmUtNmZjZS00MjE1LWJkMDUtMzI1NGZiOWU5MDU3" ] }, "name": "cci", "time": 1636106490.155 } ]
-
Base64 Decode and Encodeなどのデコードツールを使用して
idをBase64形式からデコードし、関連付けられたcampaign_idを見つけます。この例では、次のような結果になります。4861692e-6fce-4215-bd05-3254fb9e9057_$_cc=c3b25740-f113-c047-4b1d-d296f280af4f&mv=6185005b9d9bee79387cce45&pi=cmp
ここで、
4861692e-6fce-4215-bd05-3254fb9e9057がcampaign_idです。 -
キャンペーンページに移動し、
campaign_idを検索します。

そこからメッセージの設定と内容を確認し、ユーザーが特定のContent Cardを表示できない理由を調べて特定できます。
- メールメッセージの下書きを作成します。
- プレビューとテストを選択します。
- テスト送信タブを選択し、個別ユーザーを追加フィールドにメールアドレスまたはユーザー IDを追加します。
- テストを送信を選択して、下書きしたメールを受信トレイに送信します。

メールにユーザー設定センターのリンクが含まれている場合、テスト送信では有効なリンクが生成されず、設定を保存することもできません。ユーザー設定センターをテストするには、代わりにテストユーザーまたは小規模な社内セグメントに対してメッセージを配信してください。詳細については、ユーザー設定センターのテストを参照してください。
メールキャンペーンに大きな画像が含まれていて、Outlookで想定どおりに表示されない場合は、CSSやHTMLで拡大縮小するだけでなく、画像編集ツールやリサイズツールを使用して画像の実際のファイルサイズを小さくすることを検討してください。
- LINEメッセージを作成します。
- テストタブを選択し、このテストメッセージを受信するコンテンツテストグループまたは個別ユーザーを少なくとも1つ選択します。
- テストを送信を選択して、メッセージを送信します。

モバイルプッシュ
- モバイルプッシュの下書きを作成します。
- テストタブを選択し、個別ユーザーを追加フィールドにメールアドレスまたはユーザー IDを追加します。
- テストを送信を選択して、下書きしたメッセージをデバイスに送信します。

選択したユーザーの中に一致するプッシュトークンを持つユーザーがいないというエラーが表示された場合、テストユーザーは選択したプラットフォームの有効なプッシュトークンを持っていません。ユーザーはアプリでセッションを開始し、そのデバイスでプッシュを有効にしている必要があります。詳細については、プッシュの有効化とプッシュの購読を参照してください。
Web プッシュ
- Web プッシュを作成します。
- テストタブを選択します。
- 自分にテストを送信を選択します。
- テストを送信を選択して、Web プッシュをWebブラウザーに送信します。

Brazeダッシュボードからのプッシュメッセージをすでに許可している場合、メッセージは画面の隅に表示されます。許可していない場合は、プロンプトが表示されたら許可を選択すると、メッセージが表示されます。
選択したユーザーの中にWeb プッシュ用の一致するプッシュトークンを持つユーザーがいないというエラーが表示された場合は、テストユーザーに選択したプラットフォームの有効なプッシュトークンが登録されていることを確認してください。プッシュトークンを取得するには、ユーザーがデバイスでアプリのプッシュ通知を受信できるよう設定されている必要があります。詳細については、プッシュの有効化とプッシュの購読を参照してください。
SMS、MMS、またはRCSメッセージを作成したら、テストメッセージを携帯電話に送信して、実際の表示をリアルタイムで確認できます。受信者は、テスト送信時に選択した購読グループに属し、有効な電話番号を持ち、地理的許可で少なくとも1つの国が選択されている必要があります。
- SMS、MMS、またはRCSメッセージの下書きを作成します。
- テストタブを選択し、このテストメッセージを受信するコンテンツテストグループまたは個別ユーザーを少なくとも1つ選択します。
- テストを送信を選択して、テストメッセージを送信します。

Webhookを作成したら、テスト送信を行ってWebhookのレスポンスを確認できます。テストタブを選択し、テストを送信を選択して、指定したWebhook URLにテスト送信します。また、個別ユーザーを選択して、特定のユーザーとしてレスポンスをプレビューすることもできます。
- WhatsAppメッセージを作成します。
- テストタブを選択し、このテストメッセージを受信するコンテンツテストグループまたは個別ユーザーを少なくとも1つ選択します。
- このメッセージに使用している購読グループに関連付けられた電話番号にWhatsAppメッセージを送信して、会話ウィンドウを開始します。関連付けられた電話番号は、テストタブのアラートに記載されています。
- テストを送信を選択して、メッセージを送信します。

パーソナライズされたキャンペーンをテストする
ユーザーデータを入力するキャンペーンや、カスタムイベントプロパティを使用するキャンペーンをテストする場合は、追加の手順や別の手順が必要です。
ユーザー属性でパーソナライズされたキャンペーンのテスト
メッセージでパーソナライゼーションを使用している場合は、キャンペーンを正しくプレビューし、ユーザーデータがコンテンツに正しく入力されていることを確認するために、追加の手順が必要です。作成画面、Inbox Vision、キャンバスでのプレビューの制限については、パーソナライゼーションのプレビューを参照してください。
テストメッセージを送信する際は、既存のユーザーを選択するオプションか、カスタムユーザーとしてプレビューするオプションのいずれかを選択してください。

既存のユーザーを選択する
既存のユーザーを選択する場合は、検索フィールドに特定のユーザー ID またはメールアドレスを入力します。次に、ダッシュボードのプレビューを使用して、そのユーザーにメッセージがどのように表示されるかを確認し、そのユーザーに表示される内容を反映したテストメッセージを自分のデバイスに送信します。

カスタムユーザーを選択する
カスタムユーザーとしてプレビューする場合は、ユーザーの名やカスタム属性など、パーソナライゼーションに使用できるさまざまなフィールドにテキストを入力します。この場合も、自分のメールアドレスを入力して、テストを自分のデバイスに送信できます。

既存のユーザーをカスタマイズする
ランダムなユーザーまたは既存のユーザーの個々のフィールドを編集して、メッセージ内のダイナミックなコンテンツをテストできます。編集を選択すると、選択したユーザーを変更可能なカスタムユーザーに変換できます。

カスタムイベントプロパティでパーソナライズされたキャンペーンのテスト
カスタムイベントプロパティでパーソナライズされたキャンペーンのテストは、ここで説明している他の種類のキャンペーンのテストとは少し異なります。
方法1: キャンペーンを手動でトリガーする
カスタムイベントプロパティを使用してパーソナライズされたキャンペーンを確実にテストする方法として、キャンペーンを自分でトリガーできます。
- イベントプロパティを含むコピーを作成します。

- アクションベースの配信を使用して、イベント発生時にキャンペーンを配信します。

iOS のプッシュキャンペーンをテストする場合、iOS は現在開いているアプリのプッシュ通知を配信しないため、アプリを終了する時間を確保できるよう遅延を1分に設定する必要があります。その他の種類のキャンペーンは、すぐに配信するように設定できます。

- テストフィルターを使用するか自分のメールアドレスをターゲットにして、テスト時と同様にユーザーをターゲットに設定し、キャンペーンの作成を完了します。

- アプリに移動し、カスタムイベントを完了します。
キャンペーンがトリガーされ、イベントプロパティでカスタマイズされたメッセージが表示されます。

方法2: 自分にテストメッセージを送信する
または、カスタムユーザー ID を保存している場合は、カスタマイズされたテストメッセージを自分に送信してキャンペーンをテストすることもできます。
- キャンペーンのコピーを作成します。
- テストタブを選択し、カスタマイズされたユーザーを選択します。
- ページの下部でカスタムイベントプロパティを追加し、上部のボックスにユーザー ID またはメールアドレスを追加します。
- テストを送信を選択すると、プロパティでパーソナライズされたメッセージを受信できます。

方法3: Liquidを使用する
Liquidで値を手動で入力して、カスタムイベントプロパティをテストできます。
- メッセージエディターで、カスタムイベントプロパティの値を入力します。
- ユーザーとしてプレビュータブを選択し、正しいメッセージが表示されることを確認します。
制限事項
テストメッセージは、実際のユーザーに送信されるキャンペーンやキャンバスと同じように動作しない場合があります。このような場合は、限られたテストユーザーを対象にキャンペーンまたはキャンバスを開始して、動作を検証することを検討してください。
- テストメッセージからBrazeのユーザー設定センターを表示すると、設定を保存ボタンが無効になります。また、ユーザー設定センターのLiquidタグが有効なリンクに解決されない場合があります。これは想定された動作です。エンドツーエンドでテストするには、ユーザー設定センターのテストを参照してください。
- アプリ内メッセージとContent Cardsをテストするには、対象ユーザーが対象デバイスのプッシュトークンを持っている必要があります。
- メール内の購読解除リンクをテストする場合、
{{${set_user_to_unsubscribed_url}}}が完全な URL としてレンダリングされるのは、受信者のメールアドレスに、ワークスペース内で external ID を持つユーザープロファイルが関連付けられている場合のみです。ユーザープロファイルまたは external ID がない場合、このタグは<a href="#">Unsubscribe</a>としてレンダリングされます。テストユーザーのメールアドレスに、該当するワークスペース内の既存のプロファイルがあることを確認してください。 - テストメッセージ機能で送信されたメールには、
List-Unsubscribeヘッダーは含まれません。 - シードグループのユーザーに送信されたメールでは、ユーザープロファイルの受信済みキャンペーンリストは更新されず、ダッシュボード分析の送信数も増加しません。
トラブルシューティング
アプリ内メッセージ
アプリ内メッセージキャンペーンがプッシュキャンペーンによってトリガーされない場合は、アプリ内キャンペーンのセグメンテーションを確認し、ユーザーがプッシュメッセージを受信する前にターゲットオーディエンスの条件を満たしていることを確認してください。
Android と iOS でのテスト送信では、プッシュ許可をリクエストのクリック時動作を使用するアプリ内メッセージが、一部のデバイスで表示されない場合があります。回避策は次のとおりです。
- Android: デバイスが Android 13 と Android SDK バージョン 21.0.0 を使用している必要があります。また、アプリ内メッセージを表示するデバイスに、すでにシステムレベルのプロンプトが表示されていることも原因として考えられます。今後表示しないを選択している可能性があるため、再度テストする前にアプリを再インストールして通知の許可をリセットする必要がある場合があります。
- iOS: 開発者チームがアプリのプッシュ通知の実装を確認し、プッシュ許可をリクエストするコードを手動で削除することをお勧めします。詳細については、プッシュプライマーのアプリ内メッセージを参照してください。
アクションベースのアプリ内メッセージキャンペーンを配信するには、REST API ではなく Braze SDKを通じてカスタムイベントを記録する必要があります。これにより、ユーザーは対象となるアプリ内メッセージをデバイスで直接受信できます。ユーザーがセッション中にそのイベントを実行すると、アプリ内メッセージを受信します。





