カスタムイベント | 文書 - Roblox クリエーターハブ

カスタムイベントは、他のイベントでは完全には把握できないゲーム特有のメトリクスを追跡することを可能にします。これには以下が含まれます：

採用 — 特定のUIコンポーネントをクリックしたユーザーは何人ですか？
ユーザー行動 — 各マップで最も頻繁に使用される能力は何ですか？
コアループ — 殺戮/死亡比率は異なる武器間でどのように比較されますか？

ゲームがカスタムイベントを追跡し始めると、クリエイターハブの分析ダッシュボードでExploreページが解放されます。最大100のカスタムイベントをゲームに追加できます。

カスタムイベントを追跡する

Exploreページを解放するには、まずゲームでカスタムイベントを追跡する必要があります。監視し、ゲームを改善するために最も重要なメトリクスを特定することから始めてください。イベントは日ごとに集計されるため、ページにチャートが表示されるまでに最大で24時間かかる場合があります。

イベントはサーバーからのみ送信でき、公開されたゲームでのみ使用できます。クライアントやスタジオからは送信できません。

カウンター

カウンターは値なしでキャプチャされる一回限りのイベントです。特定のイベントが発生した回数を追跡するためにカウンターを使用できます。ボタンをクリックする、クエストを開始する、ツールを使用するなどの単一アクションに対してカウンターを使用します。

イベントは自動的にイベントのカウントとユニークユーザーのカウントの両方を追跡します。値の集計に対しては、カウンターイベントはデフォルトの値1を持つイベントとして扱われます。これは、最大値/最小値/平均値の集計が常に1になり、合計がイベントの総数に等しくなることを意味します。


local AnalyticsService = game:GetService("AnalyticsService")

AnalyticsService:LogCustomEvent(
    player,
    "MissionStarted" -- イベント名
)

値を持つイベント

ユーザーがミッションに費やす時間や殺戮/死亡比率など、より定量的データを必要とするメトリクスのために、値を持つイベントを追跡することもできます。これは、レート制限内に収まるようにイベントをバッチで送信する方法としても使用できます。つまり、1体のゾンビを10回殺すのではなく、10体のゾンビを殺すと送信します。


local AnalyticsService = game:GetService("AnalyticsService")

AnalyticsService:LogCustomEvent(
    player,
    "MissionCompletedDuration", -- イベント名
    120 -- イベント値
)

イベントの集計

すべてのイベントメトリクスには以下の集計が含まれ、スライスおよびダイシングのサポートがあります：

カウント
ユニークユーザーのカウント
平均値
合計値
最小値
最大値
ユーザーごとの平均値

集計タイプを選択してExploreページでイベントの集計を表示します。

カスタムイベントデータをフィルタリングするためのすべての異なる集計オプションのリスト.

カスタムフィールドを使用する

カスタムイベントは、カスタムフィールドでセグメント間の比較を容易にするためのサポートをもたらします。たとえば、各イベントに対してクエスト名を提供して、ユーザーが最も好むものを確認したり、クラスにプレイヤークラスを添付して、クラスが特定の殺戮/死亡比率を持っているかどうかを確認できます。

ブレークダウンセレクターを使用してカスタムフィールドで分解することができます。

比較できる3つのカスタムフィールドを示すドロップダウン、および年齢、性別、オペレーティングシステムなどの標準的なブレークダウン.

カスタムフィールドはイベント名よりも常に使用するべきです。なぜなら、イベント名にはカーディナリティの制限がカスタムフィールドよりも遥かに厳しいからです。カスタムフィールドを使用することで、フィールド値に基づいたイベントの視覚化も可能になります。

たとえば、PlantCabbage、PlantTurnip、PlantPepperという3つの別々のイベントの代わりに、PlantSeedという単一のイベントとカスタムフィールド値Plant - Cabbage、Plant - Turnip、Plant - Pepperを持つことができます。このようにして、植えられた種の総数を視覚化すると同時に、同じ視覚化内で各植物を比較することも可能になります。これにより、イベント名のカーディナリティも減少します。

詳細については、カスタムフィールドを参照してください。

カスタムイベントを使用してゲームを成長させる

カスタムイベントを使用すると、最も重要なメトリクスを追跡でき、プレイヤーが特定の機能やコンテンツとどのように相互作用しているかについての洞察を得ることができます。これらのイベントを利用して、プレイヤーの行動パターンを明らかにし、コアゲームループを最適化してください。

参照ゲームPlantでは、HarvestPlantイベントがプレイヤーが熟した植物を収穫するたびに発火します。カスタムイベントを使用して、各植物のタイプで分解されたユーザーごとの1日あたりの平均収穫植物数を追跡できます：

ゲーム内のコンテンツの多様性を向上させ、プレイヤーにコアループの一環として他のオプションを探索させることを奨励してください。
ユーザーが他の植物と比較してなぜダイコンを大幅に好むのか、ダイコンが引き起こす不均衡（たとえば、経済イベントとの関連）を調査してください。
植える種、水をやる植物、ショップに行くなど、ループ内でのイベント追跡を増やし、プレイヤー行動や改善すべき他の領域をより良く追跡してください。