subscription_tierやnameなどのユーザー特性を保存purchases、clicks、levelsなどの行動を追跡- メッセージとJourneysのためにユーザーをセグメント化
- メッセージコンテンツをパーソナライズ
データタグの値のフォーマット規則
すべてのタグ値は文字列である必要があります。数値、タイムスタンプ、ブール値のような値も保存できます—文字列化するだけです!| 値のタイプ | フォーマット例 | 注意事項 |
|---|---|---|
| 文字列ラベル | "free", "VIP" | ユーザータイプ、特権、ステータス用 |
| 数値 | "42", "3.14" | 数値フィルター(より大きい、より小さい)を有効にします |
| タイムスタンプ | "1685400000" | Unixタイムスタンプ(秒単位)。時間演算子と一緒に使用します |
| ブール値 | "true" / "false", "1" / "0" | ペイロードサイズを削減するには"1"/"0"を使用します |
サポートされていません: 配列、オブジェクト、ネストされた値、またはJSONブロブ。複雑なデータを保存する必要がある場合は、カスタムイベントを使用してください。
制限されたキーワード
以下のキーワードは制限されており、メッセージのパーソナライゼーションに内部的に使用されるため、タグキーとして使用しないでください:message、notification、subscription、user、template、app、org、dynamic_content、data_feed、journey、custom_data
詳細については、メッセージパーソナライゼーションを参照してください。
タグ vs カスタムイベント
Tags and Custom Events are both ways to add data to your users. However, there are some key differences:| Feature | Tags | Custom Events |
|---|---|---|
| Data usage | Segmentation and personalization | Trigger Journeys without a Segment, Wait Until steps, personalization directly within Journeys |
| Data retention | Lifetime | 30+ days (lifetime storage is available) |
| Data format | Key-value strings or numbers | JSON |
| Data source | OneSignal SDK, API, or integrations (limited) | OneSignal SDK, API, or integrations |
| Data access | Segmentation and message personalization | Journeys and Journey-message-template personalization, Segmentation (Coming soon) |
- Tags for user properties that are static and don’t change often
- Custom Events for real-time scenarios, complex segmentation, and more sophisticated journey workflows
推奨されるタグ戦略
データタグは、メッセージまたはオーディエンスセグメンテーションで使用したい情報を表す必要があります。完全なユーザープロファイルやログを保存するためのものではありません—それにはバックエンドデータベースを使用してください。チュートリアル:
イベントベースの行動タグ
タグでユーザーアクションを追跡します。Journeys、フォローアップ、またはリマインダーをトリガーするのに最適です。| キー | 値の例 | 説明 |
|---|---|---|
cart_update | "1685400000" | ユーザーがカートに何かを追加した最後の時刻。時間演算子を使用します。 |
last_order | "1684100000" | 最後に完了した購入のタイムスタンプ |
amount_spent | "100" | 合計支出額—文字列化された数値、通貨記号なし |
social_share | "2" | ソーシャルシェアまたは紹介の数 |
tutorial_status | "step2" または "completed" | チュートリアルの進行状況—読みやすいまたは番号付きの文字列値を使用 |
ゲームアクティビティタグ
ゲームでユーザーパフォーマンスに基づいてパーソナライズするために使用されます。| キー | 値の例 | 説明 |
|---|---|---|
points | "1250" | 経験値またはゲームポイント |
level | "8" | 現在のゲームレベル |
high_score | "3000" | 達成した最高スコア |
アカウントステータスタグ
アカウント階層またはステータスの変更によってユーザーをターゲットするために使用します。| キー | 値の例 | 説明 |
|---|---|---|
user_type | "free", "premium" | サブスクリプションまたはアクセス階層 |
has_downgraded | "1" または "1685400000" | ダウングレードのブール値またはタイムスタンプ |
user_privileges | "admin", "guest" | ロールベースのセグメンテーション |
個々のユーザーを識別するにはExternal IDを使用してください。この目的でタグを使用しないでください。External IDとエイリアスを参照してください。
パーソナライゼーションタグ
変数置換を使用した名前ベースのメッセージカスタマイズに最適です。| キー | 値の例 | 説明 |
|---|---|---|
first_name | "Jon" | 名 |
last_name | "Smith" | 姓 |
user_name | "PokeCatcher22" | 表示名またはスクリーン名 |
ロケーションと人口統計タグ
地域または年齢によってユーザーをセグメント化します。| キー | 値の例 | 説明 |
|---|---|---|
region | "New York" | 都市圏、オプションでISO 3166-2を使用 |
postcode | "94105" | 郵便番号または郵便コード |
location | "Downtown LA" | カスタム文字列の場所 |
birthdate | "915148800" | Unixタイムスタンプ(秒単位)(生年月日) |
birth_year | "1998" | 4桁の生まれ年 |
age_range | "18-35" | 一般的なオーディエンスセグメンテーションに便利 |
タグの追加、更新、削除方法
ユースケースと技術的なセットアップに応じて、以下のいずれかの方法でタグを管理できます。SDKメソッド(推奨)
ユーザーがアクションを実行するときに、アプリまたはウェブサイトからリアルタイムでタグを設定します。
REST API
REST APIを使用してサーバー側でタグを追加、更新、または削除します。
Journeys
ユーザーがJourneyステップを移動するときに自動的にタグを適用します。
CSVインポート
external_idまたはsubscription_idを含むCSVをアップロードして、ユーザータグを一括更新します。ウェブカテゴリプロンプト
ユーザーに興味を自己選択するよう促し、タグとして保存します。
アプリ内メッセージ
アプリ内メッセージのクリックアクションに基づいてタグを収集または更新します。
手動入力
OneSignalダッシュボードから直接タグを編集します。
- Audience > Users > User Profile > Tagsに移動します
サードパーティ統合
一部の統合では、タグを自動的に同期できます。
- Segment、HubSpot、Mixpanelなど
FAQ
ユーザーごとに設定できるタグの数は?
プランによって異なります。プランの制限を確認するか、営業に問い合わせてクォータを増やしてください。プランの制限を超えるとタグはどうなりますか?
OneSignalアプリ内で利用可能なタグの数に制限はありません。制限は、一度に各個別ユーザーに設定できるタグの数に適用されます。 制限に達しているか超えているユーザーのタグを追加または更新できません。最初にタグを削除してから、新しいタグを追加する2番目のリクエストを送信する必要があります。 既に設定されているタグは維持されます。 例: プランの制限 = ユーザーあたり20タグ。- ユーザーが19タグを持っている場合:
- ✅ 1つの新しいタグを追加 = 成功
- ❌ 2つ以上の新しいタグを追加 = 失敗
- ユーザーが20タグを持っている場合:
- ❌ 新しいタグを追加 = 失敗
- ✅ 既存のタグを1つ以上更新 = 成功
タグの使用状況はどこで確認できますか?
- ダッシュボード:Audience > Users > Tagsカラム
- 完全なビューにはユーザーをエクスポート
タグの使用量を減らすにはどうすればよいですか?
- SDKまたはAPIを使用してタグを削除
- CSVインポートを使用して一括削除
- より少ない、より再利用可能なタグを使用(例:
status:active)
Need help?Chat with our Support team or email
support@onesignal.comPlease include:- Details of the issue you’re experiencing and steps to reproduce if available
- Your OneSignal App ID
- The External ID or Subscription ID if applicable
- The URL to the message you tested in the OneSignal Dashboard if applicable
- Any relevant logs or error messages