メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt

Use this file to discover all available pages before exploring further.

テストユーザーは、メッセージ配信のテスト用に指定するユーザーです。テストユーザーには専用のセグメントフィルターがあり、メッセージコンポーザー、Journeyオーディエンス、およびWebhookテストから直接ターゲットにできます。 テストフラグはユーザーレベルのプロパティです。ユーザーをテストユーザーとしてマークすると、同じテスト名の下でそのユーザーのすべてのサブスクリプションに自動的に適用されます。ユーザープロフィールから、ユーザーを手動で作成するときに、いずれかのサブスクリプションから、またはAPIを通じてユーザーをテストユーザーとしてマークできます。
Options menu on a subscription record with Add as test user highlighted

ユーザーをテストユーザーとしてマークする

ユーザープロフィールから

すでにユーザーを特定しており、特定のサブスクリプションを探さずにテストユーザーとしてマークしたい場合はこのフローを使用します。
  1. オーディエンス > ユーザーに移動し、ユーザーのプロフィールを開きます。
  2. アクション > テストユーザーとして追加を選択します。
  3. テストユーザー名を入力します。このユーザーに関連付けられたすべてのサブスクリプションが同じ名前でテストサブスクリプションとして追加されます。

ユーザーを手動で作成するとき

ダッシュボードの新規ユーザーフォームから単一のユーザーを追加する際に、テストユーザーとして追加にチェックを入れて名前を入力します。このユーザー用に作成されたすべてのサブスクリプションは、その名前でテストサブスクリプションとしてマークされます。

サブスクリプションから

デバイスのサブスクリプションIDがわかっている場合や、アクティビティでデバイスを探したい場合はこのフローを使用します。サブスクリプションをテストサブスクリプションとしてマークすると、基となるユーザーがテストユーザーとしてマークされ、そのユーザーの他のすべてのサブスクリプションに伝播します。
  1. オーディエンス > サブスクリプションに移動し、テストしたいデバイスのサブスクリプションを見つけます
  2. サブスクリプションの横にあるオプション > テストサブスクリプションに追加を選択します。
  3. テストユーザー名を入力します。

APIを通じて

REST APIでユーザーを作成または更新する際に test_user_name プロパティを設定します:
curl -X POST https://api.onesignal.com/apps/YOUR_APP_ID/users \
  -H "Content-Type: application/json" \
  -d '{
    "properties": {
      "test_user_name": "QA Device - Jane"
    }
  }'
テストユーザーラベルを削除するには、test_user_nameを空の文字列("")に設定してください。 完全なAPIリファレンスについては、ユーザーの作成およびユーザーの更新を参照してください。

テストユーザーへの送信

ユーザーがテストユーザーとしてマークされると、以下の場所から送信できます:
  • メッセージコンポーザー: テストとプレビューアクションを使用します。
  • Journeyテストユーザーセグメントフィルターを使用して、エントリールールをテストユーザーのみに絞り込みます。Journey設定を参照してください。
  • Webhookテスト: JourneyのWebhookは、本番環境に公開する前にテストユーザーに対して検証できます。Journey Webhookを参照してください。

よくある質問

テストユーザーを削除するにはどうすればよいですか?

ダッシュボードから:
  • ユーザープロフィールから: ユーザーを開き、オプション > テストユーザーから削除を選択します。
  • サブスクリプションリストから: オーディエンス > サブスクリプションに移動し、そのユーザーに属するサブスクリプションを見つけて、オプション > テストサブスクリプションから削除を選択します。
どちらのアクションも、ユーザーとそのすべてのサブスクリプションからテストフラグをクリアします。ユーザーとサブスクリプションはアプリに残りますが、テストユーザーとしてのマークは解除されます。 APIを通じてユーザーの test_user_name"" に設定してフラグをクリアすることもできます。

テストユーザーとテストサブスクリプションの違いは何ですか?

もはや意味のある違いはありません。テストステータスはユーザーに保存されるため、1つのサブスクリプションをテストサブスクリプションとしてマークすると、基となるユーザーがテストユーザーとしてマークされ、そのユーザーの他のすべてのサブスクリプションにもフラグが適用されます。サブスクリプションリストの「テストサブスクリプションに追加」エントリーポイントは利便性のために保持されています。

テストユーザーに登録解除済みと表示されているサブスクリプションがあります。再登録するにはどうすればよいですか?

最も簡単な方法は、ユーザープロフィール > サブスクリプションタブから手動で再登録することです。
User profile Subscriptions tab with the manual re-subscribe option
ユーザーの同意なしに再登録することは、メッセージングコンプライアンスルールに違反し、スパム報告、キャリアフィルタリング、またはアカウント停止につながる可能性があります。

テストユーザーフィルターで同じ人物が複数回表示されるのはなぜですか?

アプリを再インストールするたびに新しいサブスクリプションが作成されます。新しいサブスクリプションが外部IDを通じて既存のユーザーにリンクされていない場合、別のユーザーとして表示されます。インストール後に同じ外部IDで OneSignal.login を呼び出すことで、1人のすべてのサブスクリプションを1つのユーザーに紐付けることができます。

APIからテストユーザーに送信できますか?

はい。通知の作成 APIで include_subscription_ids を使用し、テストデバイスのサブスクリプションIDを渡してください。

関連ページ

ユーザー

OneSignalのユーザーモデル、エイリアス、ユーザーとサブスクリプションの関係。

サブスクリプション

サブスクリプションを管理し、テスト用の特定のデバイスを見つけます。

セグメンテーション

テストユーザーセグメントを含め、送信範囲を限定するセグメントを作成します。

メッセージ作成API

特定のサブスクリプションIDに通知をプログラムで送信します。