コンテンツにスキップ

テストメッセージを送信する

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

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

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

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

テストユーザーを整理するには、コンテンツテストグループを作成すると便利です。コンテンツテストグループは、キャンペーンからテストメッセージを受信するユーザーのグループです。このテストグループをキャンペーンのテスト受信者にあるコンテンツテストグループを追加フィールドに追加すると、個々のテストユーザーを作成したり追加したりせずにテストを開始できます。

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

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

Bannerメッセージを作成したら、Bannerのプレビューやテストメッセージの送信ができます。

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

テストメッセージは最大5分間、デバイスで確認できます。

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

テストチェックリスト

  • Bannerキャンペーンはプレースメントに割り当てられていますか?
  • 画像やメディアは、ターゲットとするデバイスの種類や画面サイズで想定どおりに表示され、動作しますか?
  • リンクやボタンは、ユーザーを適切な遷移先に誘導しますか?
  • 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. 未加工データをクリックします。
  4. セッションのidを見つけます。以下は抜粋の例です。

     [
       {
         "session_id": "D1B051E6-469B-47E2-B830-5A728D1D4AC5",
         "data": {
           "ids": [
             "NDg2MTY5MmUtNmZjZS00MjE1LWJkMDUtMzI1NGZiOWU5MDU3"
           ]
         },
         "name": "cci",
         "time": 1636106490.155
       }
     ]
    
  1. 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です。

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

キャンペーンページでcampaign_idを検索している画面

そこからメッセージの設定と内容を確認し、ユーザーが特定のContent Cardを表示できない理由を調べて特定できます。

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

  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メッセージを作成したら、テストメッセージを携帯電話に送信して、実際の表示をリアルタイムで確認できます。受信者は、テスト送信時に選択した購読グループに属し、有効な電話番号を持ち、地理的許可で少なくとも1つの国が選択されている必要があります。

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

SMSメッセージのテスト

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

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

WhatsAppメッセージのテスト。

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

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

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

メッセージでパーソナライゼーションを使用している場合は、キャンペーンを正しくプレビューし、ユーザーデータがコンテンツに正しく入力されていることを確認するために、追加の手順が必要です。作成画面、Inbox Vision、キャンバスでのプレビューの制限については、パーソナライゼーションのプレビューを参照してください。

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

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

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

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

ユーザーを選択する

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

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

カスタムユーザー

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

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

「編集」ボタンがある「ユーザーとしてプレビュー」タブ。

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

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

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

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

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

プロパティを含むテストメッセージの作成

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

テストメッセージの配信

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

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

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

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

テストメッセージの例

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

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

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

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

方法3: Liquidを使用する

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

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

制限事項

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

  • テストメッセージから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を通じてカスタムイベントを記録する必要があります。これにより、ユーザーは対象となるアプリ内メッセージをデバイスで直接受信できます。ユーザーがセッション中にそのイベントを実行すると、アプリ内メッセージを受信します。

New Stuff!