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

# サンプルアプリ：タグ、カスタムイベント、Conversion Metrics

> サンプルアプリClean Beansが、現在の状態にタグ、行動にカスタムイベント、メッセージの成果の測定にConversion Metricsを使う方法。

このページは、1つの実在アプリを最初から最後まで追う[サンプルアプリ：OneSignalの完全な統合](https://documentation.onesignal.com/docs/ja/example-full-integration-overview.md)の一部です。アプリは**Clean Beans**という共同生活の家のための掃除当番表アプリで、Expo（React Native）とSupabaseバックエンドで構築されています。

IDはOneSignalにユーザーが誰であるかを伝えます。タグとイベントは、そのユーザーがどのような人で、何をしているかを伝えます。Clean Beansは3種類のデータを、それぞれ異なる目的に使います。

| データ | 表すもの | 用途 |
| - | - | - |
| **タグ** | ユーザーの現在の状態 | メッセージのパーソナライズとセグメントの作成 |
| **カスタムイベント** | ユーザーが今行ったこと | Journeysのトリガーとコンバージョンの測定 |
| **Conversion Metrics** | どのメッセージがイベントにつながったか | メッセージングの成果のレポート |

## タグ：ユーザーの現在の状態 \\

サインイン後、各掃除セッションの後、プロフィールの編集後に、アプリはSupabaseからいくつかの情報を集めてタグとして書き込みます。

```typescript src/lib/onesignalSync.ts theme={null}
// ── 5. Push tags to OneSignal ────────────────────────────
const tags: Record<string, string> = {
  user_name: profile.name || '',
  streak_count: String(profile.streak_count ?? 0),
  last_clean_ts: lastCleanTs,
  last_room_cleaned: lastRoomCleaned,
  avatar_filename: avatarFilename,
  household_name: householdName,
  weekly_leader: weeklyLeader,
};

OneSignal.User.addTags(tags);
```

| タグ | 例 | 主な用途 |
| - | - | - |
| `user_name` | `George` | アプリ内メッセージやメールでの呼びかけ |
| `streak_count` | `5` | 「連続記録継続中」などのセグメント |
| `last_clean_ts` | `1720454400` | [時間演算子](https://documentation.onesignal.com/docs/ja/time-operators.md)を使った「7日間非アクティブ」などのセグメント |
| `last_room_cleaned` | `Kitchen` | パーソナライズした文面 |
| `avatar_filename` | `baked_bean.png` | メッセージにユーザーのアバターを表示する |
| `household_name` | `The Smiths` | パーソナライズした文面 |
| `weekly_leader` | `George` | ランキングのメッセージ |

> [!NOTE]
>
> タグの値は文字列です。OneSignalの時間演算子で比較できるよう、タイムスタンプはUnix秒で保存してください。

## カスタムイベント：今起きたこと \\

アプリは掃除セッションの開始時と終了時にそれぞれイベントを記録します。

```typescript src/lib/onesignalSync.ts theme={null}
OneSignal.User.trackEvent('cleaning_session_started', {
  external_id: ctx.external_id,
  user_name: ctx.user_name,
  household_name: ctx.household_name,
  room_name: roomName,
});
```

```typescript src/lib/onesignalSync.ts theme={null}
OneSignal.User.trackEvent('cleaning_session_completed', {
  external_id: ctx.external_id,
  user_name: ctx.user_name,
  household_name: ctx.household_name,
  room_name: roomName,
  tasks_completed: stats.tasksCompleted,
  minutes_cleaned: Math.round(stats.minutesCleaned),
});
```

完了イベントには`tasks_completed`と`minutes_cleaned`という2つの数値が含まれます。Conversion Metricsは、OneSignalが数値として受け取ったプロパティしか合計できないため、これらは文字列ではなく数値として送信します。

セッション画面は、ユーザーが掃除した内容を確定した時点でイベントを送信し、タグを更新します。

```typescript app/clean-session.tsx theme={null}
// Fire session completed custom event and sync updated tags to OneSignal
if (room) {
  trackSessionCompleted(room.name, { tasksCompleted: ids.length, minutesCleaned: mins }).catch(console.warn);
}
syncOneSignalTags();
```

## Conversion Metrics：メッセージの成果 \\

Conversion Metricはカスタムイベントをカウントし、その前に送られたメッセージに成果として割り当てます。上記のイベントにより、Clean Beansは各リマインダーが何回の掃除セッションにつながり、合計何分の掃除になったかを確認できます。

![掃除セッションのコンバージョンメトリクスを示すOneSignalのメッセージレポート](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-conversion-metrics.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=fbb4363265a1b330198afdc0a37feefd)

掃除セッションと掃除時間が割り当てられたプッシュメッセージのレポート。

**ダッシュボードの設定。** **Settings > Analytics > Conversion Metrics**に移動し、1行につき1つのメトリクスを作成します。

| メトリクス名 | カスタムイベント | 値を追跡する | プロパティ |
| - | - | - | - |
| Cleaning sessions | `cleaning_session_completed` | いいえ | |
| Minutes cleaned | `cleaning_session_completed` | はい | `minutes_cleaned` |
| Tasks completed | `cleaning_session_completed` | はい | `tasks_completed` |

> [!WARNING]
>
> 「Track a value for each event」オプションは、数値型のプロパティを持つイベントが届いてから表示され、メトリクスの作成時にしか有効にできません。まず実際のセッションからイベントを送信し、**Data > Events & Conversions**に届いたことを確認してから、2つの値メトリクスを作成してください。

> [!NOTE]
>
> Conversion Metricsは、非推奨になりつつあるCustom Outcomes（`OneSignal.Session.addOutcome()`）に代わるものです。Clean Beansは当初Outcomesを使う予定でしたが、構築前に切り替えました。カスタムメトリクスには有料プランが必要です。クリックとアプリセッションはすべてのプランで追跡されます。

> [card] [タグ](https://documentation.onesignal.com/docs/ja/add-user-data-tags.md)
>
> タグの追加、削除、活用。

> [card] [カスタムイベント](https://documentation.onesignal.com/docs/ja/custom-events.md)
>
> SDKまたはバックエンドからイベントを送信する。

> [card] [コンバージョンメトリクス](https://documentation.onesignal.com/docs/ja/conversion-metrics.md)
>
> アトリビューションウィンドウとレポート。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.