Amplitude SQL：テーブルスキーマとフィールドショートカット

特殊フィールドのショートカット

Amplitude SQLはAmplitudeのチャートエクスペリエンスに直接組み込まれているため、日付ピッカーやチャート保存エクスペリエンスなど、同じAmplitudeインターフェイスを使用できます。Amplitude SQLはまた、ショートカット用の特別なフィールドを提供します：

• **$date：**日付ピッカーからの時間範囲を適用し、時間の経過とともにクエリを更新します。イベントのイベント発生時刻を参照し、プロジェクトのタイムゾーンに従います。それ以外の場合は、Amplitude SQLはデータをUTCで返します。 **$events**と一緒に使用してください。
• **$events：**現在のプロジェクト内のテーブルの省略形です。このテーブルは、マージされたユーザーを自動的に処理します。 **$date**と一緒に使用してください。
• $amplitude_id: ユーザーのオリジナルの Amplitude ID です。 このフィールドを使用して、マージされたユーザーを自動的に処理できます。

テーブルスキーマ

Amplitude SQLは1テーブルのスキーマを使用します。 $eventsテーブルは、マージされたユーザーマッピングを自動的に処理します。マージされたユーザーテーブルも表示できるため、Amplitudeが1つにマージしたユーザー数をすばやく確認できます。

次の表は、$eventsとマージされたユーザーのスキーマを示しています。

$eventsテーブル

• $amplitude_id
  • データ型: NUMBER(38,0)
  • 説明：ユーザーのオリジナルAmplitude ID。 このフィールドを使用して、マージされたユーザーを自動的に処理できます。
• adid
  • データ型：VARCHAR(16777216)
  • 説明：（Android）Google Play サービスの広告 ID（AdID）。 Amplitudeは通常これを取り込み後に消去するため、通常は空白です。
• amplitude_attribution_ids
  • 説明：Amplitudeが内部目的で保存する広告IDの匿名化されたハッシュ値。これは広告IDが送信された場合に表示され、現在は削除されているもののadid/idfvが存在していたことを証明します。
• amplitude_event_type
  • データ型：VARCHAR(16777216)
  • 説明：Amplitudeが生成するイベントに基づくAmplitude固有の識別子です。 これはレガシーフィールドなので、すべてのクエリに対してevent_typeこれで十分です。
• amplitude_id
  • データ型: NUMBER(38,0)
  • 説明：Amplitudeがユニークユーザーをカウントするために使用する内部ID。
• app
  • データ型: NUMBER(38,0)
  • 説明：プロジェクトの [設定] ページにあるプロジェクトID。
• city
  • データ型: VARCHAR
  • 説明: 都市。
• client_event_time
  • データ型：TIMESTAMP
  • 説明：デバイスがイベントを記録した時点のローカルタイムスタンプ（UTC）。
• client_upload_time
  • データ型：TIMESTAMP
  • 説明：デバイスがイベントをアップロードした時点のローカルタイムスタンプ（UTC）。
• country
  • データ型: VARCHAR
  • 説明: 国。
• data
  • データ型: VARIANT
  • 説明：first_eventやmerged_amplitude_idなどのフィールドを格納するディクショナリ。
• device_brand
  • データ型：VARCHAR(16777216)
  • 説明：デバイスのブランド。
• device_carrier
  • データ型：VARCHAR(16777216)
  • 説明：デバイスキャリア。
• device_family
  • データ型：VARCHAR(16777216)
  • 説明：デバイスファミリ。
• device_id
  • データ型：VARCHAR(16777216)
  • 説明：デバイス固有の識別子です。
• device_manufacturer
  • データ型：VARCHAR(16777216)
  • 説明：デバイスの製造元です。
• device_model
  • データ型：VARCHAR(16777216)
  • 説明：デバイスのモデルです。
• device_type
  • データ型：VARCHAR(16777216)
  • 説明：デバイスのタイプ。
• dma
  • データ型：VARCHAR(16777216)
  • 説明: 指定マーケティング地域（DMA）です。
• event_id
  • データ型: NUMBER(38,0)
  • 説明：イベントを区別するカウンタ。
• event_time
  • データ型：TIMESTAMP
  • 説明：
    • Amplitudeのタイムスタンプ（UTC）。これは、server_received_timeとclient_upload_timeの差分によって調整されたclient_event_timeです。具体的には：
    • event_time = client_event_time + (server_received_time - client_upload_time)
    • Amplitudeはこのタイムスタンプを使用してチャート上のイベントを整理します。
    • server_received_timeとclient_upload_timeの差が60秒未満の場合、Amplitudeはevent_timeを調整せず、client_event_timeと同じ値に設定します。
• event_type
  • データ型：VARCHAR(16777216)
  • 説明：割り当てられたイベントのタイプ。
• followed_an_identify
  • データ型: ブール値
  • 説明：この現在のSDKイベントと最後に認識されたSDKイベントの間に識別イベントがあった場合はTrueです。
• groups
  • データ型: VARIANT
  • 説明：グループのタイプ。詳細については、アカウントに関するドキュメントを参照してください。
• idfa
  • データ型：VARCHAR(16777216)
  • 説明：（iOS）広告主の識別子です。 Amplitudeは通常これを取り込み後に消去するため、通常は空白です。
• ip_address
  • データ型：VARCHAR(16777216)
  • 説明：IPアドレス。
• location_lat
  • データ型：FLOAT
  • 説明：緯度。
• location_lng
  • データ型：FLOAT
  • 説明：経度。
• os_name
  • データ型：VARCHAR(16777216)
  • 説明：OS 名です。
• os_version
  • データ型：VARCHAR(16777216)
  • 説明：OS のバージョンです。
• paying
  • データ型: VARCHAR
  • 説明：ユーザーが収益を記録したことがある場合はTrue、そうでない場合は「(none)」です。プロパティ値は、Identify API を使用して変更できます。
• region
  • データ型: VARCHAR
  • 説明：リージョン。
• server_upload_time
  • データ型：TIMESTAMP
  • 説明：Amplitudeサーバーがイベントを受信した時のAmplitudeのタイムスタンプ（UTC）。
• session_id
  • データ型: NUMBER(38,0)
  • 説明：エポックからのセッション開始時刻（ミリ秒単位）。
• start_version
  • データ型: VARCHAR
  • 説明：Amplitudeが最初にユーザーを追跡したアプリのバージョン。
• user_id
  • データ型：VARCHAR(16777216)
  • 説明：指定した読み取り可能な ID。
• uuid
  • データ型：VARCHAR(16777216)
  • 説明：行ごとに一意の識別子です (送信されたイベント)。
• version_name
  • データ型：VARCHAR(16777216)
  • 説明：アプリのバージョン。

マージされたユーザーのテーブル

Amplitudeがユニークユーザーをどのように追跡しているかについては、「ユニークユーザーを追跡する方法」を参照してください。