アナリティクス

公開済みのすべてのProyectaアプリに組み込まれたアナリティクス機能です。builderの Admin > Analytics を開いて、トラフィック、Web Vitals、デバイス別内訳を確認できます。

すべてのProyectaアプリにはアナリティクスが組み込まれています。インストール作業も、スニペットの貼り付けも、サードパーティのアカウント登録も不要です。データ収集はすべての公開済みアプリで自動的に動作します。builder内のアナリティクスダッシュボードは Pro プラン以上でご利用いただけます。builderで Admin > Analytics を開くと、公開済みサイトのデータを確認できます。

3つのビュー

アナリティクスには、管理サイドバーに表示される3つのビューがあります。

ビュー	表示内容
Overview	トラフィック — ページビュー数、訪問者数、セッション数、人気ページ、日別時系列チャート（参照元は Devices タブに表示）
Web Vitals	実際のユーザーから計測されたCore Web Vitals（LCP、INP、CLS）
Devices	ブラウザおよびトラフィックソース（参照元）

何のデータが収集されますか？

アナリティクスは公開済みサイト（*.proyecta.live サブドメインまたはカスタムドメイン）から自動的に収集されます。builder内のpreviewトラフィックはカウントされません。

現在の表示期間は過去7日間です。カスタム日付範囲の選択機能はロードマップに含まれています。

アクセス方法は？

builderでプロジェクトを開き、Admin ビューに切り替えてから、サイドバーで Analytics を選択してください。閲覧には Pro プラン以上が必要です。Freeプランではアップグレードの案内が表示されます。有料プランでは Overview がデフォルトで表示されます。サイドバーを使って Overview、Web Vitals、Devices を切り替えることができます。

カスタムイベントのトラッキング

自動収集されるページビューおよびWeb Vitalsに加えて、アプリ独自のカスタムイベント（サインアップ、購入、機能の利用状況など、把握したい任意の情報）を記録することもできます。カスタムイベントは自動的にアプリに紐付けられます。

アプリにはすでにトラッカーが組み込まれているため、Reactコードのどこからでも track() を呼び出すだけで利用できます。

import { track } from '@proyecta-ai/analytics';

// Fire from an event handler, an effect, or right after a successful write.
track('signup', { plan: 'pro', referrer: 'newsletter' });

track('add_to_cart', { sku: 'ABC-1' });
track('checkout', { total: 49 });

プロパティは文字列と数値のフラットオブジェクトです。track() は例外をスローしないため、nullチェックも不要です。アナリティクスがまだ初期化されていない場合、呼び出しは単に無視されるため、レンダリング中や初回描画時に呼び出しても安全です。

AIに組み込みを依頼することもできます。例："新しいユーザーが登録するたびに 'signup' イベントをトラッキングして"

よくある質問

Google AnalyticsやMixpanelを追加する必要はありますか？

いいえ。アナリティクスは組み込み済みで、公開済みのすべてのアプリで自動的に有効になります。サードパーティのプロバイダーも併用したい場合は、AIに統合を依頼することができます。Settings ページの環境変数セクションにプロバイダーのAPIキーを追加し、"Google Analyticsをアプリに追加して" と伝えてください。

有料プランが必要ですか？

データ収集はプランに関わらず、すべての公開済みアプリで動作します。Admin 内の Analytics セクションは Pro 機能です。Freeプランではアップグレードの案内が表示されます。カスタムイベントのトラッキングはどのプランでも利用できます。

データが表示されないのはなぜですか？

アナリティクスは公開済みバージョンのアプリのみをトラッキングします。まだ公開していない場合、または公開済みサイトへの過去7日間のトラフィックがない場合、パネルは空になります。builder内のpreviewトラフィックはカウントされません。（また、Proプランをご利用中であることも確認してください。ダッシュボード自体はPro限定機能です。）

データをエクスポートできますか？

現時点ではできません。CSVエクスポートはロードマップに含まれています。

日付範囲を変更できますか？

現時点ではできません。パネルは過去7日間のデータを表示します。カスタム範囲指定はロードマップに含まれています。

訪問者データは匿名化されていますか？

Proyectaのアナリティクスは、ファーストパーティクッキー（_pry_vid）を使用してリピーターを識別します。サードパーティサイトをまたいだユーザートラッキングは行いません。Cookieの同意バナーが必要かどうかは、ユーザーの居住地域の法律（例：EUではGDPRによって永続的な識別子に対する同意が必要になる場合があります）によって異なります。法的な判断については、弁護士などの専門家にご相談ください。

近日公開予定

カスタム日付範囲（24時間、30日間、任意指定）
CSVエクスポート
コンバージョン・目標トラッキング