分析ツールが認識するIDに名前をつける

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

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

用途

• チームが読めるファネル: welcome → signup → paywall というシーケンスを見れば何が起きたかが分かります。自動生成されたコードが3つ並んでいても伝わりません。
• 自社ツール全体で共通の語彙: アプリが転送するすべてのイベントが同じ方法でスクリーンに名前を付けるため、ファネル、コホート、ダッシュボードフィルターがルックアップテーブルなしで一致します。
• クエリできる回答: beginner という名前のクイズ選択肢は、アナリストがフィルタリングできる値です。自動生成されたIDは先に解読する必要があります。

アナリティクスで確認できるID

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

入力フィールドとクイズオプションに名前を付ける

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

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

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

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

スクリーンの名前を変更する

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

Give the screens in my onboarding flow readable IDs.

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

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

確認すべき内容

• フローが公開される前にリネームする: すでに収集済みのイベントは古いIDを保持します。変更をまたぐファネルでは、2つの半分しか埋まっていない画面が表示され、元の名前に戻しても統合されません。AdaptyのフローメトリクスもIDで画面行をグループ化するため、同様に分割されます。リネームされた画面は同じラベルで2行目として追加されます。
• グループ内のすべてのオプションに独自のElement IDが必要: オプションのIDが欠けている場合、2つのオプションで同じIDを共有している場合、または Group ID が別の画面で再利用されている場合、オプション単体だけでなくグループ全体のレポートが機能しなくなります。ビルダー上では何もフラグを立てないため、オプションを追加した後はグループを確認してください。
• IDはアナリティクスに入力したとおりに届く: plan_selection や planSelection のようにスタイルを統一し、フロー全体で一貫して使用してください。スタイルが混在していると、生成されたコードよりもクエリが難しくなります。

制限事項

• スクリーン ID はスキルを通じてのみ変更可能: フロービルダーにはそのためのフィールドがありません。
• Adapty のフロー指標にはこれらの名前が表示されません: フロー指標では、フローの公開バージョンに基づいてスクリーンに <position>. <caption> というラベルが付与されるため、スクリーンの ID に関わらず 9. Paywall A のように表示されます。ここでの ID は自社のアナリティクスにのみ反映されます。
• 名前の変更は履歴を移行しません: 古いイベントは古い ID のまま保持されます。
• 一部の要素は入力イベントを送信しません: パスワードフィールド、プロダクト選択、タブの切り替えはレポートされません。これらに名前を付けてもフローに影響するだけで、アナリティクスには反映されません。