---
title: "分析ツールが認識するIDに名前をつける"
description: "フローの画面、入力フィールド、クイズの選択肢にわかりやすいIDをつけることで、AmplitudeやMixpanelに送信されるイベントがコードではなく名前で表示されるようになります。"
---

> **AI agents**: to search Adapty docs faster and with fewer tokens, install the Adapty skill. Claude Code (self-updating via plugin): `claude plugin marketplace add adaptyteam/adapty-skills && claude plugin install adapty-skills@adapty` — other tools: `npx skills add adaptyteam/adapty-skills --all`

Adapty SDK はすべての画面表示とすべての回答をアプリに報告します。各イベントには、発生元の画面や要素の ID が含まれており、その ID がご自身のアナリティクスに表示されます。デフォルトでは画面の ID は `scr_oAPBHPa7` のような形式になるため、Amplitude や Mixpanel のファネルはコードの羅列になってしまい、コードと名前の対応表を手動で管理しなければなりません。

これらの ID は自分で名前を付けることができます。入力フィールドや選択グループはフローBuilder で命名します。画面 ID は [flow-generator スキル](flow-generator-skill) を通じて設定し、フロー内でその画面が参照されているすべての箇所で名前が変更されます。

:::important
スクリーン名の変更はフロージェネレータースキルの一部なので、追加のインストールは不要です。[フロージェネレーターのインストール手順](flow-generator-skill#install-the-skill)に従うだけで使えます。ダッシュボードのフローに変更を保存するため、まず下書きで実行し、公開する前にペイウォールビルダーで結果を確認してください。
:::

## 用途 \{#what-its-for\}

- **チームが読めるファネル**: `welcome → signup → paywall` という並びで何が起きたかがわかります。ランダムな生成コードが3つ並んでいても同じことはできません。
- **ツール横断で統一された用語**: 画面に付けた名前は、Adapty のフロー指標でも自社のアナリティクスでも同じ名前で登場するので、対応表なしに照合できます。
- **クエリで答えを出せるデータ**: クイズの選択肢に `beginner` という名前を付ければ、アナリストがそのままフィルタリングできます。生成IDでは先にデコードが必要です。

## アナリティクスで確認できるID \{#which-ids-your-analytics-sees\}

2つのイベントにIDが含まれます。[`flow_screen_showed`](ios-flow-screen-views)はユーザーが画面を開いたときに発火し、[`flow_user_input`](ios-flow-input)はユーザーが入力を行ったとき、クイズの回答を選択したとき、またはトグルを切り替えたときに発火します。各ガイドにはそれぞれのイベントのすべてのパラメーターが記載されています。この表では、画面や要素を識別するパラメーターのみを取り上げます。

| イベントパラメータ | 内容 | 設定場所 |
| :--- | :--- | :--- |
| `instanceId` | 画面のID | フロージェネレータースキル |
| `element_id` | 入力欄の **Element ID**、またはセレクタブルグループの **Group ID** | Flow Builder |
| `item_ids` | 選択されたオプションの **Element ID** | Flow Builder |

## 入力フィールドとクイズオプションに名前を付ける \{#name-inputs-and-quiz-options\}

入力フィールドと選択グループには、ビルダー内にIDフィールドがあります。入力フィールドの **Element ID** は **Input settings** にあり、フロー内の他の場所で値を参照する際に使用するIDと同じです — [入力フィールドとフォーム](builder-inputs-and-forms)を参照してください。グループの **Group ID** は **Screen settings > Selectable groups** にあり、その中の各オプションにはそれぞれ独自の **Element ID** があります。

これらすべてに、それ自体で意味が通る名前を付けてください。アナリティクスに表示される文字列がそのまま使われるためです。`birthday` や `beginner` は説明不要ですが、`el_024F` は別途マッピングが必要になります。

要素を追加するときにIDを設定してください。後から変更しないでください。条件やテキスト変数は**要素ID**を参照しており、そのIDを変更しても自動的には更新されません。エラーも表示されずに解決できなくなります。すでに動作しているフローでIDをリネームする場合は、それを使用しているすべての条件と変数を更新してください。詳細は[要素IDを変更すると条件と変数が機能しなくなる](flow-common-issues#conditions-and-variables-break-after-an-element-id-change)を参照してください。

フロー生成スキルは、作成するすべてのフローの要素IDに自動的に名前を付けます。[フロー監査スキル](flow-audit-skill)は、IDが設定されていない要素を報告します。

## スクリーンの名前を変更する \{#rename-screens\}

フロービルダーにはスクリーンのIDを入力するフィールドがないため、スキルに依頼します：

```
Give the screens in my onboarding flow readable IDs.
```

スキルは各スクリーンの名前を提案し、フロー内でそのスクリーンを参照しているすべての箇所を一括で変更します。スクリーン自体、そこへ誘導するすべてのナビゲーションアクション、およびそれに紐付くプロダクトも含めて、まとめて変更します。一部だけ変更されたスクリーン名はフローを公開不能にしてしまうため、必ずすべて同時に変更します。

これにより、変更されたスクリーン名と移動されたリファレンスの数が表示されます。また、既存のスクリーンと名前が衝突するリネームは実行されません。スクリーン ID は、すでに動作しているフローでも安全にリネームできますが、エレメント ID はそうではありません。エレメント ID をリネームすると、すべてのリファレンスが一緒に移動します。

## 確認すべき内容 \{#what-to-check\}

- **フローが公開される前にリネームする**: 収集済みのイベントは古いIDを保持するため、Adaptyのフロー指標や独自の分析に影響します。変更をまたいだファネルでは2つの半分しか埋まっていない画面が表示され、元の名前に戻してもデータは統合されません。
- **グループ内のすべてのオプションに独自のElement IDが必要**: オプションにIDがない場合、2つのオプションが同じIDを共有している場合、または**Group ID**が別の画面で再利用されている場合、グループ全体が何も報告しません（そのオプションだけでなく）。ビルダー上では何も警告されないため、オプションを追加した後にグループを確認してください。
- **IDはタイプした通りに分析に届く**: `plan_selection`や`planSelection`などのスタイルを1つ選び、フロー全体で統一して使用してください。スタイルが混在していると、生成されたコードよりクエリが難しくなります。

## 制限事項 \{#limitations\}

- **スクリーン ID はスキルからのみ変更可能**: フローbuilderにはそのためのフィールドがありません。
- **名前の変更は履歴を移行しない**: 古いイベントは古い ID を保持します。
- **入力イベントを送信しない要素がある**: パスワードフィールド、プロダクト選択、タブ切り替えはレポートを送信しません。これらに名前を付けるとフローには影響しますが、アナリティクスには影響しません。