メインコンテンツへスキップ
データタグは、OneSignalでカスタムプロパティを保存し、ユーザーの行動を追跡できるキーと値のペアです。強力なセグメンテーションとパーソナライゼーションを可能にします。
タグの使用目的:
  • subscription_tiernameなどのユーザー特性を保存
  • purchasesclickslevelsなどの行動を追跡
  • メッセージとJourneysのためにユーザーをセグメント化
  • メッセージコンテンツをパーソナライズ

データタグの値のフォーマット規則

すべてのタグ値は文字列である必要があります。数値、タイムスタンプ、ブール値のような値も保存できます—文字列化するだけです!
値のタイプフォーマット例注意事項
文字列ラベル"free", "VIP"ユーザータイプ、特権、ステータス用
数値"42", "3.14"数値フィルター(より大きいより小さい)を有効にします
タイムスタンプ"1685400000"Unixタイムスタンプ(秒単位)。時間演算子と一緒に使用します
ブール値"true" / "false", "1" / "0"ペイロードサイズを削減するには"1"/"0"を使用します
サポートされていません: 配列、オブジェクト、ネストされた値、またはJSONブロブ。複雑なデータを保存する必要がある場合は、カスタムイベントを使用してください。

制限されたキーワード

以下のキーワードは制限されており、メッセージのパーソナライゼーションに内部的に使用されるため、タグキーとして使用しないでください: messagenotificationsubscriptionusertemplateapporgdynamic_contentdata_feedjourneycustom_data 詳細については、メッセージパーソナライゼーションを参照してください。

タグ vs カスタムイベント

Tags and Custom Events are both ways to add data to your users. However, there are some key differences:
FeatureTagsCustom Events
Data usageSegmentation and personalizationTrigger Journeys without a Segment, Wait Until steps, personalization directly within Journeys
Data retentionLifetime30+ days (lifetime storage is available)
Data formatKey-value strings or numbersJSON
Data sourceOneSignal SDK, API, or integrations (limited)OneSignal SDK, API, or integrations
Data accessSegmentation and message personalizationJourneys and Journey-message-template personalization, Segmentation (Coming soon)
The key distinction between Tags and Custom Events is in their depth and use cases. Tags are properties of a user, such as Name, Account Status, or Location. Events are thing that the user has done, such as Purchasing an Item, Completing a Level, or Inviting a Friend. Both tags and events can be used for segmentation and personalization. In practice, you will likely use both:
  • 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"一般的なオーディエンスセグメンテーションに便利

タグの追加、更新、削除方法

ユースケースと技術的なセットアップに応じて、以下のいずれかの方法でタグを管理できます。


FAQ

ユーザーごとに設定できるタグの数は?

プランによって異なります。プランの制限を確認するか、営業に問い合わせてクォータを増やしてください。

プランの制限を超えるとタグはどうなりますか?

OneSignalアプリ内で利用可能なタグの数に制限はありません。制限は、一度に各個別ユーザーに設定できるタグの数に適用されます。 制限に達しているか超えているユーザーのタグを追加または更新できません。最初にタグを削除してから、新しいタグを追加する2番目のリクエストを送信する必要があります。 既に設定されているタグは維持されます。 例: プランの制限 = ユーザーあたり20タグ。
  • ユーザーが19タグを持っている場合:
    • ✅ 1つの新しいタグを追加 = 成功
    • ❌ 2つ以上の新しいタグを追加 = 失敗
  • ユーザーが20タグを持っている場合:
    • ❌ 新しいタグを追加 = 失敗
    • ✅ 既存のタグを1つ以上更新 = 成功

タグの使用状況はどこで確認できますか?

タグの使用量を減らすにはどうすればよいですか?

  • 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
We’re happy to help!