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

# カスタムイベントの保存と保持

> カスタムイベントを保存してセグメントを作成したりユーザープロファイルで確認したりできるようにし、各イベントの保持期間を選択し、保存したイベントを管理します。

[カスタムイベント](./custom-events)からセグメントを作成したい場合や、ユーザーのプロファイルでイベント履歴を確認したい場合は、保存を有効にしてください。このページでは、保存によって何ができるか、有効化の方法、イベントごとの保持期間の選び方、保存したイベントの管理方法について説明します。

<Warning>
  カスタムイベントの保存と保持は現在ロールアウト中で、まもなくすべてのアプリで利用可能になります。**Data > Events & Conversions**に保存バナーが表示されない場合、お使いのアプリではまだ利用できません。
</Warning>

## 前提条件

* 有料プラン。カスタムイベントの取り込みはFreeプランでは利用できません。
* カスタムイベントの保持期間設定を編集する権限。課金条件への同意と保持期間の変更の両方に必要です。権限がない場合、ダッシュボードは権限を持つアカウント上の担当者に連絡するよう促します。

## 保存によってできること

カスタムイベントは、保存の有無にかかわらず、OneSignalが受信した時点でJourneys、コンバージョン指標、Liquidパーソナライゼーションを動作させます。イベントを保存すると、次の2つが追加されます：

* **セグメント。** ユーザーが実行した（または実行していない）イベントからセグメントを作成し、オーディエンスをターゲットにする場面ならどこでもそのセグメントを使用できます。
* **ユーザープロファイル。** 各ユーザーのイベント履歴をプロファイルで確認でき、個々のユーザーが何をいつ行ったかを把握できます。

イベントの保持期間が長いほど、セグメントとユーザープロファイルが遡れる期間も長くなり、最大90日まで遡れます。

## 保存を有効にする

**Data > Events & Conversions**に移動します。アプリが保存されていないイベントを送信している場合、ページ上部のバナーでその旨が通知されます。

<Steps>
  <Step title="保存プロンプトを開く">
    Events & Conversionsページでバナーを選択します。
  </Step>

  <Step title="このアプリのデフォルト保持期間を選択する">
    各アプリは、他のアプリとは独立した独自のデフォルトを持ちます。デフォルトは、このアプリで個別の保持期間設定を持たないすべてのイベントに適用され、アプリが既に受信したイベントに適用するかどうかも選択できます。デフォルトは後から変更でき、個々のイベントごとに上書きすることもできます。
  </Step>

  <Step title="課金条件に同意する">
    同意した瞬間から保存が開始されます。OneSignalは誰が同意したかを記録し、組織の管理者にメールで通知します。
  </Step>
</Steps>

<Check>
  これらのステップを完了すると、アプリの保存が有効になります！これ以降にOneSignalが受信するすべてのイベントは、デフォルトの保持期間にわたって保存されます。
</Check>

## イベントごとに保持期間を設定する

保持期間とは、OneSignalが保存された各イベントを保持する期間であり、最大90日です。アプリのデフォルトはすべてのイベントに適用され、個々のイベントごとに上書きできます。

<Steps>
  <Step title="イベントを開く">
    **Data > Events & Conversions**に移動し、**Event List**タブを開いてイベントを選択します。
  </Step>

  <Step title="保持期間を選択する">
    詳細ビューで、そのイベントの保持期間を設定します。この設定は、このイベントに限りアプリのデフォルトを上書きします。
  </Step>
</Steps>

## 保存したイベントを管理する

保存する必要がなくなったイベントや、より短い期間で保存したいイベントの保持期間を短縮できます。OneSignalは新しい期間の外にあるイベントを削除し、残りを保持します。

<Warning>
  削除は即時ではなく夜間に実行されるため、保存イベント数への変更の反映は翌日になります。
</Warning>

## 課金のタイミング

OneSignalへのカスタムイベントの送信は、すべての有料プランで無料です。OneSignalは、セグメンテーションのために保存されたイベントに対してのみ課金します。

イベントは、保存の有無にかかわらず、Journeys、コンバージョン指標、Liquidパーソナライゼーションを動作させます。イベントを保存すると、2つの機能が追加されます。イベントからセグメントを作成できることと、ユーザープロファイルでイベントを確認できることです。

保存は、アカウント上で保持期間設定を編集する権限を持つ人が課金条件に同意するまでオフのままです。それまでの間、OneSignalはイベントを受信し、保存せずにJourneys、コンバージョン指標、Liquidパーソナライゼーションで利用できるようにします。

各プランには、保存イベントの月間割り当てが含まれています。OneSignalは、その割り当てを超えたイベントに対して、プランの超過料金レートで課金します。このレートは、保存を有効にする際にダッシュボードに表示されます。

| プラン          | 月間の保存イベント割り当て |
| ------------ | ------------- |
| Growth       | 1,000,000     |
| Professional | 5,000,000     |
| Enterprise   | 10,000,000    |

割り当ては組織レベルで適用されるため、1つのアプリで保存されたイベントは、組織内の他のアプリで保存されたイベントと同じ合計にカウントされます。

課金は、請求サイクルの終了時に、その時点で保存されているイベントに対して行われます。OneSignalはプランに含まれる割り当てを差し引き、残りをプランの超過料金レートで課金します。割り当て以下であれば、保存料金は一切かかりません。

課金はサイクル終了時の保存イベント数を参照するため、それより前に保持期間を短縮すると、そのサイクルの請求額が減ります。夜間の削除が実行される時間を十分に確保してください。

現在の状況を確認するには、**Organizations > Billing**に移動します。保存イベントの合計が、他の使用量とともにイベント別の内訳で表示されます。また、OneSignalは、割り当ての80%と100%に達した時点で組織の管理者にメールで通知します。

## FAQ

### 送信したが保存していないイベントにも料金がかかりますか？

いいえ。イベントの送信は、すべての有料プランで無料です。課金されるのは、請求サイクル終了時に保存されているイベントに対してのみです。

### 90日より古いイベントでセグメントを作成できますか？

いいえ。現在の保持期間の上限は90日です。

### イベントをNot storedに設定するとJourneyが壊れますか？

いいえ。**Not stored**（0日）は、OneSignalがイベントを保持しないことを意味しますが、Journeys、コンバージョン指標、Liquidパーソナライゼーションはいずれも、OneSignalがイベントを受信した時点で読み取るため、イベントの保存の有無にかかわらず同じように動作します。保存されたイベントを必要とするのは、セグメントとユーザープロファイルだけです。

### 誰が保存の有効化や保持期間の変更を行えますか？

カスタムイベントの保持期間設定を編集する権限を持つアカウント上の担当者です。同じ権限で、課金条件への同意、アプリのデフォルトの設定、個々のイベントの保持期間の変更をすべて行えます。

### アプリが1,000個の一意のイベント名に達するとどうなりますか？

各アプリは最大**1,000個の一意のカスタムイベント名**を送信できます。アプリが既に使用している名前で送信されたイベントは常に受け入れられるため、上限に達しても既存のイベント送信が中断されることはありません。

アプリが1,000個の名前に達すると、*新しい*名前で送信されたイベントは拒否されます。OneSignalはリクエスト全体ではなく個々のイベントを拒否するため、同じバッチ内の他のイベントは通常どおり処理されます。APIは`errors`配列を含むHTTP `202`を返し、拒否された各イベントにはエラーコード`too many event names`が付与されます。

拒否されたイベントは保存されず、課金されず、Journeyのトリガー、メッセージのパーソナライズ、セグメントでの使用もできません。ただし、**Data > Events & Conversions**には、失敗理由「This app has reached its limit of unique event names」とともに失敗として表示されるため、どの名前が拒否されたかを確認できます。

空きを作るには、使用しなくなったカスタムイベント名を削除してください。名前を削除するとそのスロットが解放され、その名前で保存されているイベントは完全に削除されます。

<Note>
  Custom Eventsページは、イベントが拒否される前に、アプリが900個の一意のイベント名を超えた時点で警告を表示します。
</Note>

保持期間と名前の上限は別のものです。イベントをNot storedに設定するとOneSignalはそのイベントを保持しなくなりますが、名前はスロットを保持したままです。スロットを解放できるのは名前の削除だけです。手順については[イベント名の上限](./custom-events#event-name-limits)を参照してください。

## 関連ページ

<Columns cols={2}>
  <Card title="カスタムイベント" icon="bolt" href="./custom-events">
    イベントを送信し、Journeys、セグメント、パーソナライゼーションで使用します。
  </Card>

  <Card title="課金FAQ" icon="receipt" href="./billing-faq#event-related-billing">
    OneSignalが請求書の残りの部分をどのように計算するか。
  </Card>
</Columns>
