プラットフォーム
1 つのプロジェクトにアプリ、その Web サイト、そのバックエンドをまとめられ、ダッシュボードではそれぞれを個別に表示できます。
1 つのプロジェクトは、プロダクトの複数の部分からイベントを受け取れます。たとえばゲームの iOS アプリ、Web サイト、API がすべて 1 つのプロジェクトに送信できます。そうすれば 1 人のユーザーを(user_id で)それらをまたいで追えますし、ダッシュボードでは引き続き 1 つの部分だけを表示することもできます。
これには 2 つの側面があります。各イベントの platform フィールドと、プロジェクトに設定するプラットフォームの一覧です。
各イベントのプラットフォーム
すべてのイベントは platform を持ちます。プロダクトのどの部分が送ったかを表します。SDK は次の値を送ります。
| SDK | プラットフォーム |
|---|---|
| Swift | OS:ios、macos、tvos、visionos。watchOS では apple |
| Android | android |
| React Native、Flutter | 下層のネイティブ SDK が決める OS:ios または android |
| JavaScript | ブラウザーでは web、Node では node |
| Python | python |
| Go | go |
| JVM(Java と Kotlin) | jvm |
もっと具体的な名前のほうがわかりやすい場合は、設定で上書きしてください。たとえばバックエンドには platform: "api"、キューのコンシューマーには platform: "worker" とします。名前のルールは環境と同じで、小文字の英字、数字、-、_ からなる 32 文字以内です。
プラットフォームのないイベントが届くと、サーバーは SDK 名と OS から割り出します(iOS 上の lyrelog-swift は ios、os_name: "web" の lyrelog-js は web)。それができなければ OS 名そのものを使います。
プロジェクトのプラットフォーム
Settings の Platforms セクションには、プロジェクトにイベントを送っているものが 1 つずつカードになり、それが何かを設定できます。
| プラットフォーム | Lyrelog に伝えること | Lyrelog がそれで行うこと |
|---|---|---|
| iOS アプリ、Mac アプリ | App Store のページ:名前で検索するか、リンクを貼り付けます | アプリの名前、デベロッパー、評価、バージョン、bundle id を表示します |
| Android アプリ | Google Play のパッケージ名(com.example.app)または Play のリンク | Google Play でアプリの名前とアイコンを取得します |
| Web サイト | アドレス(example.com) | サイトのアイコンを取得します |
| サーバー | 言語:Node、Python、Go、Java、Kotlin、Swift、Ruby、PHP、.NET、Rust、Elixir、Other | 対応する環境のルールを表示します |
こうして取得したアイコンは、プロジェクトのアイコンにできます(Settings の Icon)。プラットフォームを削除すると、その情報とアイコンは消えます。App Store のページの情報は、iOS アプリも Mac アプリも残っていなくなったときに消えます。
過去 30 日間のイベントに、プロジェクトにまだ登録されていないプラットフォームからのものがあると、Settings がそれを知らせ、Add them を表示します。イベントのプラットフォームとプロジェクトのプラットフォームの対応は次のとおりです。ios、tvos、visionos は iOS アプリ、macos は Mac アプリ、android は Android アプリ、web は Web サイト、api、node、python、go、jvm はサーバー(言語がわかればその言語付き)です。Web サイトと Android アプリはアドレスやパッケージ名が必要なので、入力待ちのカードとして開きます。
プラットフォームを変更できるのはオーナーだけです。
プラットフォームで絞り込む
- トップバー: プロジェクトが複数のプラットフォームからイベントを受け取っていると、環境ピッカーに Platform セクションが加わり、過去 30 日間にイベントのあったプラットフォームが一覧され、All platforms も選べます。選択はプロジェクトごとにブラウザーに記憶され、すべてのページに適用されます。環境とプラットフォームを参照してください。
- エクスプローラー: Platform フィルターには 1 つまたは複数の値を指定でき、除外もできます(「Platform is not web」)。
どちらも、プロジェクトの一覧ではなく、各イベントの platform で絞り込みます。