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

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

すべてのタグ値は文字列である必要があります。数値、タイムスタンプ、ブール値のような値も保存できます—文字列化するだけです!
サポートされていません: 配列、オブジェクト、ネストされた値、または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: 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、フォローアップ、またはリマインダーをトリガーするのに最適です。

ゲームアクティビティタグ

ゲームでユーザーパフォーマンスに基づいてパーソナライズするために使用されます。

アカウントステータスタグ

アカウント階層またはステータスの変更によってユーザーをターゲットするために使用します。
個々のユーザーを識別するにはExternal IDを使用してください。この目的でタグを使用しないでください。External IDエイリアスを参照してください。

パーソナライゼーションタグ

変数置換を使用した名前ベースのメッセージカスタマイズに最適です。

ロケーションと人口統計タグ

地域または年齢によってユーザーをセグメント化します。

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

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

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つ以上更新 = 成功

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

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

  • 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!