> ## 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.

# タグ

> OneSignalデータタグを使用してユーザープロパティを保存し、イベントを追跡して、高度なセグメンテーションとパーソナライズされたメッセージングを実現します。

データタグは、OneSignalでカスタムプロパティを保存し、ユーザーの行動を追跡できるキーと値のペアです。強力なセグメンテーションとパーソナライゼーションを可能にします。

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/t82DSCUXShk?si=KH_u3zB2N5ci8GLT" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

タグの使用目的：

* `subscription_tier`や`name`などのユーザー特性を保存
* `purchases`、`clicks`、`levels`などの行動を追跡
* メッセージとJourneysのためにユーザーをセグメント化
* メッセージコンテンツをパーソナライズ

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/Z-rYqwEUU0M?si=Qjx2dMdFXwXSuZJR" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

***

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

すべてのタグ値は**文字列**である必要があります。数値、タイムスタンプ、ブール値のような値も保存できます—文字列化するだけです！

| 値のタイプ   | フォーマット例                             | 注意事項                                                |
| ------- | ----------------------------------- | --------------------------------------------------- |
| 文字列ラベル  | `"free"`, `"VIP"`                   | ユーザータイプ、特権、ステータス用                                   |
| 数値      | `"42"`, `"3.14"`                    | 数値フィルター（`より大きい`、`より小さい`）を有効にします                     |
| タイムスタンプ | `"1685400000"`                      | Unixタイムスタンプ（秒単位）。[時間演算子](./time-operators)と一緒に使用します |
| ブール値    | `"true"` / `"false"`, `"1"` / `"0"` | ペイロードサイズを削減するには`"1"`/`"0"`を使用します                    |

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/YTp-jLcajJ0?si=uSRn2cQ7Yur5MAp0" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

<Warning>
  **サポートされていません：** 配列、オブジェクト、ネストされた値、またはJSONブロブ。複雑なデータを保存する必要がある場合は、[カスタムイベント](./custom-events)を使用してください。
</Warning>

### 制限されたキーワード

以下のキーワードは制限されており、メッセージのパーソナライゼーションに内部的に使用されるため、タグキーとして使用しないでください：
`message`、`notification`、`subscription`、`user`、`template`、`app`、`org`、`dynamic_content`、`data_feed`、`journey`、`custom_data`

詳細については、[メッセージパーソナライゼーション](./message-personalization)を参照してください。

### タグ vs カスタムイベント

[Tags](/docs/en/add-user-data-tags) and [Custom Events](/docs/en/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](/docs/en/billing-faq#streaming-events))       |
| Data format    |       Key-value strings or numbers       |                                              JSON                                              |
| Data source    |     OneSignal SDK, API, or CSV import    |                               OneSignal SDK, API, or integrations                              |
| Data access    | Segmentation and message personalization |        Journeys 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

***

## 推奨されるタグ戦略

データタグは、**メッセージまたはオーディエンスセグメンテーションで使用したい**情報を表す必要があります。完全なユーザープロファイルやログを保存するためのものではありません—それにはバックエンドデータベースを使用してください。

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/DeCnQYA21TY?si=YnAv50tpiiVdNEX7" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

### イベントベースの行動タグ

タグでユーザーアクションを追跡します。Journeys、フォローアップ、またはリマインダーをトリガーするのに最適です。

| キー                | 値の例                         | 説明                                                     |
| ----------------- | --------------------------- | ------------------------------------------------------ |
| `cart_update`     | `"1685400000"`              | ユーザーがカートに何かを追加した最後の時刻。[時間演算子](./time-operators)を使用します。 |
| `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"`     | ロールベースのセグメンテーション       |

<Note>
  個々のユーザーを識別するには**External ID**を使用してください。この目的でタグを使用**しない**でください。[External ID](./users#external-id)と[エイリアス](./aliases)を参照してください。
</Note>

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

[変数置換](./message-personalization)を使用した名前ベースのメッセージカスタマイズに最適です。

| キー           | 値の例               | 説明           |
| ------------ | ----------------- | ------------ |
| `first_name` | `"Jon"`           | 名            |
| `last_name`  | `"Smith"`         | 姓            |
| `user_name`  | `"PokeCatcher22"` | 表示名またはスクリーン名 |

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

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

| キー           | 値の例             | 説明                                                                  |
| ------------ | --------------- | ------------------------------------------------------------------- |
| `region`     | `"New York"`    | 都市圏、オプションで[ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)を使用 |
| `postcode`   | `"94105"`       | 郵便番号または郵便コード                                                        |
| `location`   | `"Downtown LA"` | カスタム文字列の場所                                                          |
| `birthdate`  | `"915148800"`   | Unixタイムスタンプ（秒単位）（生年月日）                                              |
| `birth_year` | `"1998"`        | 4桁の生まれ年                                                             |
| `age_range`  | `"18-35"`       | 一般的なオーディエンスセグメンテーションに便利                                             |

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

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

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/e5B3nJyr_ao?si=PfVu4bHMkQJydc41" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

<br />

<Columns cols={2}>
  <Card title="SDKメソッド（推奨）">
    ユーザーがアクションを実行するときに、アプリまたはウェブサイトからリアルタイムでタグを設定します。

    * → [モバイルSDKリファレンス](./mobile-sdk-reference#data-tags)
    * → [ウェブSDKリファレンス](./web-sdk-reference#data-tags)
  </Card>

  <Card title="REST API" href="/reference/update-user">
    REST APIを使用してサーバー側でタグを追加、更新、または削除します。
  </Card>

  <Card title="Journeys" href="./journeys-overview">
    ユーザーがJourneyステップを移動するときに自動的にタグを適用します。
  </Card>

  <Card title="CSVインポート" href="./import">
    `external_id`または`subscription_id`を含むCSVをアップロードして、ユーザータグを一括更新します。
  </Card>

  <Card title="ウェブカテゴリプロンプト" href="./permission-requests">
    ユーザーに興味を自己選択するよう促し、タグとして保存します。
  </Card>

  <Card title="アプリ内メッセージ" href="./in-app-messages-setup">
    アプリ内メッセージのクリックアクションに基づいてタグを収集または更新します。
  </Card>

  <Card title="手動入力">
    OneSignalダッシュボードから直接タグを編集します。

    * **Audience > Users > User Profile > Tags**に移動します
  </Card>

  <Card title="サードパーティ統合" href="./integrations">
    一部の統合では、タグを自動的に同期できます。

    * Segment、HubSpot、Mixpanelなど
  </Card>
</Columns>

***

## FAQ

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

プランによって異なります。[プランの制限](https://onesignal.com/pricing)を確認するか、[営業に問い合わせ](https://onesignal.com/contact)てクォータを増やしてください。

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

OneSignalアプリ内で利用可能なタグの数に制限はありません。制限は、一度に各個別ユーザーに設定できるタグの数に適用されます。

制限に達しているか超えているユーザーのタグを**追加または更新できません**。最初にタグを削除してから、新しいタグを追加する2番目のリクエストを送信する必要があります。

既に設定されているタグは維持されます。

例：

プランの制限 = ユーザーあたり20タグ。

* ユーザーが19タグを持っている場合：
  * ✅ 1つの新しいタグを追加 = 成功
  * ❌ 2つ以上の新しいタグを追加 = 失敗
* ユーザーが20タグを持っている場合：
  * ❌ 新しいタグを追加 = 失敗
  * ✅ 既存のタグを1つ以上更新 = 成功

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

* ダッシュボード：**Audience > Users > Tagsカラム**
* 完全なビューには[ユーザーをエクスポート](./exporting-data)

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

* SDKまたはAPIを使用してタグを削除
* [CSVインポート](./import)を使用して一括削除
* より少ない、より再利用可能なタグを使用（例：`status:active`）

<Info>
  Need help?

  Chat with our Support team or email `support@onesignal.com`

  Please 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](/docs/en/capturing-a-debug-log)

  We're happy to help!
</Info>

***