ドキュメント

サポート

Analytics

Analytics

クエリパラメーター値への SQL データエクスプローラー利用法

Learn how to query custom event parameters in SQL Data Explorer with practical examples.
読み終わるまでの所要時間 2 分最終更新 15日前

概要

SQL データエクスプローラーツールを使用して、特定のパラメーターの値を分析します。 以下に、パラメーター値を分析する複数の方法とともにクエリの実際的な例とコメントを示し、ゲーム用にそれらのクエリを複製する方法をよりよく理解できるようにします。

手順

  • 以下のすべての例では、同じコンテキストを使用します。プレイヤーがキャラクターを選び、ダンジョンを開始して完了し、ダンジョンで健康状態を回復するためにポーションを使用するロールプレイングゲーム (RPG) です。
  • これらのクエリを複製するときに、強調表示されているクエリ項目を置き換えて、自身のイベント名とパラメーターに合わせてください。

クエリ

1. 特定の時間範囲内 (日単位) に使用された平均ポーション数

with potionsStats as (selectEVENT_DATE,EVENT_JSON:potionsUsed::Integer as potionsFROM EVENTS where EVENT_DATE > CURRENT_DATE-7 and EVENT_DATE < current_date and EVENT_NAME=’dungeonCompleted’)select EVENT_DATE as “Date”, round(avg(potions)) as “Average Potions Used”from potionsStatsgroup by EVENT_DATEorder by EVENT_DATE
ノート: 
  • potionsStats
    はサブクエリです。     
  • potionsUsed
    は、ダンジョンで使用されたポーション数をログに記録するために 
    dungeonCompleted
    イベントで送信されるパラメーターです。     
  • potions
    は、EVENT_JSON:
    potionsUsed
    ::Integer に付ける名前です     
  • 7
    は、分析する時間範囲です。この場合は、過去 7 日間です
  • 行 8 で、以下を呼び出します。
    • X 軸のイベント日付。
    • 整数を取得するために 
      potions
      を端数処理した平均。ただし、小数部分を調べたい場合は削除できます。
  • Y 軸の端数処理平均演算にわかりやすい名前 (
    Average Potions Used
    ) を付けます。

2. 特定の時間範囲 (合計時間範囲) 内に使用された平均ポーション数

ある特定の時点での消費量を確認するためにプレイヤーごとに使用された平均ポーション数を把握するには、以下の例を使用します。 
with potionsStats as (selectEVENT_NAME,EVENT_JSON:potionsUsed::Integer as potionsFROM EVENTS where EVENT_DATE > CURRENT_DATE-7 and EVENT_DATE < current_date and EVENT_NAME='dungeonCompleted')select EVENT_NAME as “Dungeon Completed”, round(avg(potions)) as “Average Potions Used”from potionStatsgroup by 1

3. ダンジョン名ごとの平均使用ポーション数

プレイヤーがゲームでポーションを使用している場所を把握してダンジョンのバランスを取るには、以下の例を使用します。プレイヤーがゲームでポーションを使用している場所を把握してダンジョンのバランスを取るには、以下の例を使用します。 
with potionsAndDungeons as (selectEVENT_JSON:dungeonName::string as dungeonName,EVENT_JSON:potionsUsed::integer as potionsFROM EVENTS where EVENT_DATE > CURRENT_DATE-7 and EVENT_NAME='dungeonCompleted')select dungeonName as “Dungeon”, avg(potions) as "Average potions used"from potionsAndDungeonsgroup by dungeonNameorder by dungeonName
ノート: 
  • potionsUsed
    と 
    dungeonCompleted
    では、前の 2 つのクエリと同じベースを維持します。
  • dungeonCompleted
    イベントで送信されるパラメーター (完了したダンジョンの名前をログに記録) である 
    dungeonName
    を使用しています。これは Y 軸で使用されます。

4. ダンジョンでのキャラクターの使用割合 (キャラクター名ごと)

以下の例を使用して、ゲームで最も人気のあるキャラクターを確認します。 
selectEVENT_JSON:characterName::STRING as character,((count(EVENT_JSON:characterName::STRING)) / ( select count(*) from eventswhere EVENT_NAME = 'dungeonCompleted' and EVENT_DATE > current_date-7)) as percentagefrom eventswhere EVENT_NAME = 'dungeonCompleted' and EVENT_DATE > current_date-7group by characterorder by percentage desc
ノート: 
  • characterName
    を 
    character
    と呼びます。これは 
    dungeonCompleted
    イベントで送信されるパラメーターで、選択したキャラクターをログに記録します。これは X 軸で使用されます。
  • 行 3 と 4 で、各キャラクター名の合計数を、完了したダンジョンの合計数で除算して、Y 軸に必要なパーセンテージを取得します。

5. ダンジョン名ごとのキャラクター使用回数のピボットテーブル

以下の例を使用して、ダンジョン名ごとのキャラクターの使用回数を明確にします。これは、キャラクターとダンジョンのバランス向上に役立ちます。 
selectEVENT_JSON:characterName::INTEGER,EVENT_JSON:dungeonName::STRING,count(EVENT_JSON:dungeonName::STRING) as dungeonCountfrom eventswhere EVENT_NAME = 'dungeonCompleted'and EVENT_DATE > current_date-7group by 1,2
ノート: コメント
  • SQL データエクスプローラーはピボットテーブルの可視化をまだ行わないため、結果を csv にエクスポートし、スプレッドシートに可視化を作成する必要があります。
  • キャラクター名、ダンジョンパラメーター、およびダンジョン名の個数を呼び出します。
  • このクエリを処理した後で、以下を行う必要があります。
  1. Share (共有) ボタンを使用して、結果を csv としてエクスポートします。
  2. csv ファイルをスプレッドシートに開きます。
  3. データからピボットテーブルを作成します。
  4. ピボットテーブルからチャートを作成します。
\
![](/analytics/media/images/copy-of-sql-excel.png)

\

\
![](/analytics/media/images/copy-of-sql-table.png)

\

\
![](/analytics/media/images/copy-of-sql-query-bar.png)

\