Skip to content

テストメッセージの送信

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

ステップ 1: テストユーザーを特定する

メッセージングキャンペーンをテストする前に、テストユーザーを特定することが重要です。これらのユーザーは、既存のユーザーIDやメールアドレスでも、メッセージングキャンペーンのテスト専用に使用される新しいユーザーでもかまいません。

オプション：コンテンツテストグループを作成する

テストユーザーを整理する便利な方法として、コンテンツテストグループを作成する方法があります。これは、キャンペーンからテストメッセージを受信するユーザーのグループを含みます。このテストグループをキャンペーンのテスト受信者の下にあるコンテンツテストグループを追加フィールドに追加すれば、個々のテストユーザーを作成・追加することなくテストを開始できます。

ステップ 2: チャネル固有のテストメッセージを送信する

テストメッセージの送信手順については、該当するチャネルの以下のセクションを参照してください。

バナーメッセージを作成した後、バナーをプレビューするか、テストメッセージを送信できます。

  1. バナーメッセージの下書きを作成します。
  2. プレビューを選択して、バナーをプレビューするか、テストメッセージを送信します。
  3. テストメッセージを送信するには、コンテンツテストグループまたは1人以上の個別ユーザーをテスト受信者として追加し、テスト送信を選択します。

テストメッセージはデバイス上で最大5分間表示されます。

バナーコンポーザーのプレビュータブ。

テストチェックリスト

  • バナーキャンペーンはプレースメントに割り当てられていますか？
  • 画像やメディアは、ターゲットとするデバイスの種類や画面サイズで期待通りに表示・動作しますか？
  • リンクやボタンは、ユーザーを正しい場所に誘導していますか？
  • Liquidは期待通りに機能していますか？Liquidが情報を返さない場合に備えて、デフォルトの属性値を設定していますか？
  • コピーは明確で、簡潔で、正確ですか？

テスト用Content Cardsはプッシュ通知を通じて配信されます。カードはプッシュペイロードにパッケージされ、プッシュを受信するとSDKがそれを抽出し、ローカルにキャッシュします。

このプロセスは通常のカード配信システムをバイパスするため、Content Cardのテストであってもプッシュを有効にする必要があります。

テスト用Content Cardsは、送信後約5分で有効期限が切れます。

Content Cardを作成した後、テスト用Content Cardをアプリに送信して、リアルタイムでどのように表示されるかを確認できます。

  1. Content Cardの下書きを作成します。
  2. テストタブを選択し、このテストメッセージを受信するコンテンツテストグループまたは個別ユーザーを少なくとも1つ選択します。
  3. テスト送信を選択して、Content Cardをアプリに送信します。

テスト用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（インプレッション前）を確認し、特定のキャンペーンまでたどることができます。

  1. 設定 > イベントユーザーログに移動します。
  2. テストユーザーのSDKリクエストを見つけて展開します。
  3. Raw Dataをクリックします。

  4. セッションのidを見つけます。以下は抜粋の例です。

    1
2
3
4
5
6
7
8
9
10
11
12

     [
   {
     "session_id": "D1B051E6-469B-47E2-B830-5A728D1D4AC5",
     "data": {
       "ids": [
         "NDg2MTY5MmUtNmZjZS00MjE1LWJkMDUtMzI1NGZiOWU5MDU3"
       ]
     },
     "name": "cci",
     "time": 1636106490.155
   }
 ]

  1. Base64 Decode and Encodeなどのデコードツールを使用して、idをBase64形式からデコードし、関連するcampaign_idを見つけます。この例では、以下の結果になります。

    1

     4861692e-6fce-4215-bd05-3254fb9e9057_$_cc=c3b25740-f113-c047-4b1d-d296f280af4f&mv=6185005b9d9bee79387cce45&pi=cmp

    ここで4861692e-6fce-4215-bd05-3254fb9e9057がcampaign_idです。

  2. キャンペーンページに移動し、campaign_idを検索します。

キャンペーンページでcampaign_idを検索する画面

ここから、メッセージの設定とコンテンツを確認し、ユーザーが特定のContent Cardを表示できない理由を特定できます。

  1. メールメッセージの下書きを作成します。
  2. プレビューとテストを選択します。
  3. テスト送信タブを選択し、個別ユーザーを追加フィールドにメールアドレスまたはユーザーIDを追加します。
  4. テスト送信を選択して、下書きしたメールを受信トレイに送信します。

テストメール

メールにユーザー設定センターのリンクが含まれている場合、テスト送信では有効なリンクが生成されず、設定を保存することもできません。ユーザー設定センターをテストするには、テストユーザーまたは小規模な内部セグメントにメッセージを配信してください。詳細については、ユーザー設定センターのテストを参照してください。

メールキャンペーンに大きな画像が含まれており、Outlookで期待通りに表示されない場合は、CSSやHTMLでのスケーリングだけでなく、画像編集ツールやリサイズツールを使用して画像の実際のファイルサイズを縮小することを検討してください。

アプリ内とテストデバイスでプッシュ通知が設定されている場合、テスト用アプリ内メッセージをアプリに送信して、リアルタイムでどのように表示されるかを確認できます。

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

テストプッシュメッセージがデバイス画面の上部に表示されます。

テスト用アプリ内メッセージ

プッシュメッセージを直接クリックして開くと、アプリに遷移し、アプリ内メッセージのテストを表示できます。このアプリ内メッセージのテスト機能は、ユーザーがテストプッシュ通知をクリックすることでアプリ内メッセージがトリガーされる仕組みに依存しています。そのため、テストプッシュ通知が正常に配信されるには、ユーザーが該当するアプリでプッシュ通知の受信資格を持っている必要があります。

プレビュー

プレビュータブで、作成中のアプリ内メッセージをプレビューできます。これにより、ユーザーの視点から最終的なメッセージがどのように見えるかを確認できます。ランダムなユーザー、特定のユーザー、またはカスタマイズされたユーザーとしてメッセージをプレビューできます。また、モバイルデバイスまたはタブレット向けのメッセージもプレビューできます。

アプリ内メッセージ作成時の作成タブで、メッセージがどのように見えるかのプレビューを表示しています。ユーザーが選択されていないため、本文セクションに追加されたLiquidはそのまま表示されています。

Brazeには3世代のアプリ内メッセージがあります。サポートする世代に基づいて、メッセージを送信するデバイスを細かく調整できます。

アプリ内メッセージのプレビュー時に世代を切り替える画面。

テストチェックリスト

  • 画像やメディアは期待通りに表示・動作しますか？
  • Liquidは期待通りに機能していますか？Liquidが情報を返さない場合に備えて、デフォルトの属性値を設定していますか？
  • コピーは明確で、簡潔で、正確ですか？
  • ボタンはユーザーを正しい場所に誘導していますか？

アクセシビリティスキャナー

アクセシビリティのベストプラクティスをサポートするため、Brazeは従来のHTMLエディターを使用して作成されたアプリ内メッセージのコンテンツをアクセシビリティ基準に照らして自動的にスキャンします。このスキャナーは、Web Content Accessibility Guidelines（WCAG）基準を満たしていない可能性のあるコンテンツを特定するのに役立ちます。WCAGは、障害を持つ人々がWebコンテンツをより利用しやすくするために、World Wide Web Consortium（W3C）が策定した国際的に認知された技術基準です。

アクセシビリティスキャン結果

仕組み

スキャナーはカスタムHTMLメッセージに対して自動的に実行され、HTMLメッセージ全体をWCAG 2.1 AAルールセットに照らして評価します。フラグが立てられた各問題について、以下が表示されます。

  • 関連する特定のHTML要素
  • アクセシビリティの問題の説明
  • 追加のコンテキストまたは修正ガイダンスへのリンク

自動アクセシビリティテストについて

自動アクセシビリティテストは、WCAG Level AA 標準に基づくalt テキストの欠落や低色コントラストなどの一般的な問題をキャッチするのに役立ちます。これは、より包括的なメッセージを構築するための強力な出発点です。

しかし、オートメーションはすべてを捕まえることはできない。いくつかの問題は、フォーカス順序が意味を持つかどうか、リンクやボタンが明確にラベル付けされているかどうか、または指示に従うことが容易かどうか、人間の目のようなものを必要とする。これらのチェックは、最終的な評決ではなく、診断ツールとして考えてください。フラグが設定された問題を手動で確認し、何かが「要レビュー」とマークされている場合は最善の判断を使用することをお勧めします。

追加のサポートのために、Braze でのアクセシビリティは、以下を含む、すべてのユーザーのコンテンツをより使いやすくするための実用的なヒントを共有します。

自動テストと思慮深い手動レビューを組み合わせると、より多くの問題が見つかり、すべてのユーザーのより良い体験ができるようになります。

  1. LINEメッセージを作成します。
  2. テストタブを選択し、このテストメッセージを受信するコンテンツテストグループまたは個別ユーザーを少なくとも1つ選択します。
  3. テスト送信を選択してメッセージを送信します。

テスト用LINEメッセージ。

モバイルプッシュ

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

テストプッシュ

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

Webプッシュ

  1. Webプッシュを作成します。
  2. テストタブを選択します。
  3. 自分にテスト送信を選択します。
  4. テスト送信を選択して、WebプッシュをWebブラウザーに送信します。

テスト用Webプッシュ

Brazeダッシュボードからのプッシュメッセージをすでに許可している場合、メッセージは画面の隅に表示されます。そうでない場合は、プロンプトが表示されたら許可を選択すると、メッセージが表示されます。

選択されたユーザーにWebプッシュ用の一致するプッシュトークンがないというエラーが表示された場合、テストユーザーに選択されたプラットフォーム用の有効なプッシュトークンが登録されていることを確認してください。プッシュトークンを受信するには、ユーザーがデバイス上のアプリでプッシュ通知を受信するように設定されている必要があります。詳細については、プッシュの有効化とプッシュ購読を参照してください。

SMS、MMS、またはRCSメッセージを作成した後、テストメッセージを携帯電話に送信して、リアルタイムでどのように表示されるかを確認できます。受信者は、テスト送信時に選択したSMS購読グループに属し、有効な電話番号を持ち、地域別の権限で少なくとも1つの国が選択されている必要があります。詳細については、SMS FAQを参照してください。

  1. SMS、MMS、またはRCSメッセージの下書きを作成します。
  2. テストタブを選択し、このテストメッセージを受信するコンテンツテストグループまたは個別ユーザーを少なくとも1つ選択します。
  3. テスト送信を選択して、テストメッセージを送信します。

テスト用Content Card

Webhookを作成した後、テスト送信を行ってWebhookのレスポンスを確認できます。テストタブを選択し、テスト送信を選択して、指定されたWebhook URLにテスト送信を行います。また、個別ユーザーを選択して、特定のユーザーとしてレスポンスをプレビューすることもできます。

  1. WhatsAppメッセージを作成します。
  2. テストタブを選択し、このテストメッセージを受信するコンテンツテストグループまたは個別ユーザーを少なくとも1つ選択します。
  3. このメッセージに使用している購読グループに関連付けられた電話番号にWhatsAppメッセージを送信して、会話ウィンドウを開始します。関連する電話番号は、テストタブのアラートに表示されています。
  4. テスト送信を選択してメッセージを送信します。

テスト用WhatsAppメッセージ。

パーソナライズされたキャンペーンのテスト

ユーザーデータを使用するキャンペーンや、カスタムイベントプロパティを使用するキャンペーンをテストする場合は、追加の手順や異なる手順が必要です。

ユーザー属性でパーソナライズされたキャンペーンのテスト

メッセージにパーソナライゼーションを使用している場合、キャンペーンを適切にプレビューし、ユーザーデータがコンテンツに正しく反映されていることを確認するために、追加の手順が必要です。

テストメッセージを送信する際は、既存のユーザーを選択するか、カスタムユーザーとしてプレビューするオプションのいずれかを選択してください。

パーソナライズされたメッセージのテスト

既存のユーザーを選択する

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

ユーザーを選択する

カスタムユーザーを選択する

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

カスタムユーザー

既存のユーザーをカスタマイズする

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

「ユーザーとしてプレビュー」タブと「Edit」ボタン

カスタムイベントプロパティでパーソナライズされたキャンペーンのテスト

カスタムイベントプロパティでパーソナライズされたキャンペーンのテストは、上記で説明した他の種類のキャンペーンのテストとは少し異なります。

方法1: キャンペーンを手動でトリガーする

カスタムイベントプロパティを使用してパーソナライズされたキャンペーンをテストするための確実な方法として、自分でキャンペーンをトリガーできます。

  1. イベントプロパティを含むコピーを作成します。

プロパティを使用したテストメッセージの作成

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

テストメッセージの配信

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

テストメッセージのターゲティング

  1. アプリに移動して、カスタムイベントを実行します。

キャンペーンがトリガーされ、イベントプロパティでカスタマイズされたメッセージが表示されます。

テストメッセージの例

方法2: 自分にテストメッセージを送信する

また、カスタムユーザーIDを保存している場合は、カスタマイズされたテストメッセージを自分に送信してキャンペーンをテストすることもできます。

  1. キャンペーンのコピーを作成します。
  2. Testタブを選択し、Customized Userを選択します。
  3. ページの下部にカスタムイベントプロパティを追加し、上部のボックスにユーザーIDまたはメールアドレスを追加します。
  4. Send Testを選択して、プロパティでパーソナライズされたメッセージを受信します。

カスタマイズされたユーザーを使用したテスト

方法3: Liquidを使用する

Liquidを使用して値を手動で入力することで、カスタムイベントプロパティをテストできます。

  1. メッセージエディターで、カスタムイベントプロパティの値を入力します。
  2. Preview as a Userタブを選択して、正しいメッセージが表示されることを確認します。

制限事項

テストメッセージが、実際のユーザーに送信されるキャンペーンやキャンバスと異なる動作をするケースがいくつかあります。このような場合は、限定されたテストユーザーに対してキャンペーンやキャンバスを配信し、動作を検証することを検討してください。

  • テストメッセージからBrazeのユーザー設定センターを表示すると、設定を保存ボタンが無効になります。ユーザー設定センターのLiquidタグも、有効なリンクに解決されない場合があります。これは想定される動作です。エンドツーエンドのテストについては、ユーザー設定センターのテストを参照してください。
  • アプリ内メッセージやContent Cardsのテストでは、対象ユーザーがターゲットデバイスのプッシュトークンを持っている必要があります。
  • メールの購読解除リンクをテストする場合は、テストユーザーのメールアドレスが該当するワークスペースに登録されていることを確認してください。
  • List-Unsubscribeヘッダーは、テストメッセージ機能で送信されるメールには含まれません。
  • シードグループユーザーに送信されたメールは、ユーザープロファイルのキャンペーン受信リストを更新せず、ダッシュボードの分析における送信数も増加しません。

トラブルシューティング

アプリ内メッセージ

アプリ内メッセージキャンペーンがプッシュキャンペーンによってトリガーされない場合は、アプリ内キャンペーンのセグメンテーションを確認し、ユーザーがプッシュメッセージを受信する前にターゲットオーディエンスの条件を満たしていることを確認してください。

AndroidおよびiOSでのテスト送信では、プッシュ許可をリクエストのクリック時動作を使用するアプリ内メッセージが、一部のデバイスで表示されない場合があります。回避策として以下を確認してください。

  • Android: デバイスはAndroid 13以上で、Android SDKバージョン21.0.0以上である必要があります。もう1つの原因として、アプリ内メッセージが表示されるデバイスにすでにシステムレベルのプロンプトが表示されている可能性があります。今後表示しないを選択した可能性があるため、再テスト前にアプリを再インストールして通知権限をリセットする必要がある場合があります。
  • iOS: 開発者チームがアプリのプッシュ通知の実装を確認し、プッシュ許可をリクエストするコードを手動で削除することをお勧めします。詳細については、プッシュプライマーアプリ内メッセージを参照してください。

アクションベースのアプリ内メッセージキャンペーンを配信するには、REST APIではなくBraze SDKを通じてカスタムイベントをログに記録する必要があります。これにより、ユーザーは対象となるアプリ内メッセージをデバイスに直接受信できます。ユーザーがセッション中にイベントを実行すると、アプリ内メッセージを受信します。
New Stuff!