カスタム数式:構文と定義

Amplitude アカデミー

カスタム数式を使用して高度なビジュアライゼーションを作成する

高度な比較の作成、ローリングおよび累積指標の適用、トレンドの視覚化など、すべてを1つのチャートで行うことができます。

今すぐ始める

イベントセグメンテーションまたはデータテーブルチャートでは、[測定基準]モジュールの[詳細設定]ドロップダウンにある[数式]オプションを使用すると、分析を実行する際にさらに柔軟になります。カスタム数式は、同じチャート上の分析を比較するのにも役立ちます。

20種類以上のカスタム数式から選択して、必要なメトリクスをプロットできます。 同じチャートに最大 10 個の数式をプロットできます。数式はセミコロンで区切られます。

この記事では、カスタム数式の仕組みについて説明し、すぐに使用できる数式の例を紹介します。

このページでは、セグメント化チャートとデータテーブルチャートにある数式関数について説明します。メトリクスエクスプローラーは新しい分析のデフォルトのチャートで、数式はメトリクスに対して算術を使用し、各入力は独自の測定方法設定から測定値を取得します。メトリクスエクスプローラーとデータテーブルは、セッションごとの収益など、イベントとセッション入力を組み合わせたハイブリッド式もサポートしています。

実験結果のチャートも数式メトリクスを使用していますが、その方法はイベントセグメンテーションやデータテーブルのチャートとは異なります。これらの違いについて詳しくは、Amplitudeの実験結果チャートで数式メトリックを使用する方法に関するヘルプセンターの記事を参照してください。

数式の構文

数式では、[イベント]モジュールで選択されたイベントを、対応する文字で参照してください。関数とパラメータは大文字と小文字を区別しません。 また、次の算術演算を実行することもできます。

  • 括弧()。
  • 加算(+)。
  • 減算(-)。
  • 乗算(*)。
  • 除算(/)。

たとえば、数式UNIQUES(A)の文字AはイベントView Item Detailsを表し、数式UNIQUES(B)の文字BはイベントAdd Item to Cartを表します。 この設定により、アイテムの詳細を表示したユーザーと、アイテムをカートに入れたユーザーとの比率が表示されます。

イベントからなる数式を作成し、各イベントをプロパティごとにグループ化できます。 この数式が有効になるには、セグメント化するすべてのイベントでプロパティの値が一致している必要があります。

たとえば、Page Nameというイベントがある場合、次のプロパティ値は一致しません。

  • Tutorial および TUTORIAL(大文字と小文字を区別します)。
  • 1 および 1.0(文字が一致していません)。

プロパティをグループ化する順序も重要です。 両方のイベントにグループ化基準値が同じ順序で指定されている必要があります。そうでない場合、Amplitudeはイベントに一致するグループ化基準値がないことを警告します。

複数項の数式によるランキング

グループ化基準で複数項の数式指標を使用する場合、Amplitudeは最終的な計算値ではなく、数式内のすべての指標におけるユニークユーザー数の合計に基づいてグループをランク付けします。このランキングは、カーディナリティの高い結果において、どのグループが表示されるかに影響を与える場合があります。詳細については、「Data Tablesの列ランキング動作」を参照してください。

カスタム数式を使用して、あるコホートのユーザーが別のコホートのユーザーよりも特定のイベントを何倍多くトリガーするかを明らかにします。

2 つの異なるコホートまたはユーザーセグメント間でメトリックを比較するには、イベントを表す文字にセグメント番号を追加します:UNIQUES(A1)/UNIQUES(A2)。この設定により、同じイベントに対する各コホートのパフォーマンス比率が、グラフ上に1本のラインとして表示されます。

数式に次の接頭辞を追加することで、メトリックをパーセントまたはドルで表示することもできます。

  • パーセンテージ(%:)。
  • ドル($:)。

使用可能な数式のリスト

このセクションでは、使用可能な数式をタイプ別にリストします(メトリック、集計、および関数)。 数式名をクリックすると、その構文を確認できます。

メトリックの数式

メトリック数式を使用すると、関心のある特定のイベントのメトリックをクエリできます。 これらの数式では緑色の色分けが使用されます。 各メトリクスの数式では、パラメータとして、対象のイベントに対応する文字を指定する必要があります。

集計式

集計数式を使用すると、関心のあるメトリックとイベントについて、移動平均または移動ウィンドウを照会できます。これらの数式では紫色の色分けが使用されます。 各集計数式には、集計対象のメトリック、関心のあるイベント、および集計対象の間隔という 3 つの要素が必要です。

関数式

関数式を使用すると、関心のある特定のイベントやメトリックについて数学関数をクエリできます。 これらの数式では青色の色分けが使用されます。 各関数式には、定数またはイベントを含む別の式のいずれかの値が必要です。

メトリックの数式

ACTIVE

イベントをトリガーしたアクティブユーザーの割合を返します。

これは Measured カードのActive %のメトリックと同じですが、ここでは小数点形式で表示されます。

例

ACTIVE(A)では、View Item Detailsイベントをトリガーしたアクティブ ユーザーの割合が表示されます。

ARPAU

アクティブユーザーごとの総収益を通貨形式で返します。

ARPAUは、イベントの数値プロパティでグループ化した場合にのみ機能します。$:プレフィックスはオプションです。プレフィックスが存在することにより、出力形式が通貨であることを保証します。

例

一般的な E コマース企業におけるアクティブユーザーあたりの平均収益を計算するには、ARPAUを使用します。

ARPAUを集計数式と組み合わせて使用することはできません。

AVG

ユーザーがイベントをトリガーした平均回数を返します。

例

AVG(A); AVG(B)では、ユーザーが View Item Details(イベント A)をトリガーした平均回数と、ユーザーが Add Item to Cart(イベント B)をトリガーした平均回数を同じチャートに表示しています。

FREQPERCENTILE

すべてのユーザーにわたって入力されたイベント発生頻度のパーセンタイル数を返します。

パーセンタイルは、値の特定の割合が下回る値を示す尺度です。 その結果を使用して、パワーユーザーの行動コホートを作成し、コホートに含まれていないユーザーと彼らを区別するものを分析できます。

例

FREQPERCENTILE(A, 0.9)では、View Item Detailsイベントをトリガーしたユーザーの 90 パーセンタイル値を示しています。

HIST

選択した期間におけるユニークユーザーごとのイベント頻度の分布を返します。

ユーザーセッションチャートでは、セッションがメトリックの対象となるため、HISTの構文が若干異なります。

この変種は、ユーザー セッションの持続時間を把握したい場合に使用します。

PERCENTILE

グループ化対象のプロパティの入力されたパーセンタイルを返します。

この関数は、イベントの数値プロパティでグループ化した場合にのみ使用できます。

例

PERCENTILE(A, 0.9)は、すべてのComplete Purchaseイベントの収益の90パーセンタイル値を返します。PERCENTILEは、ロード時間を追跡し、ロード時間の一定割合が特定のしきい値を下回っていることを確認する場合にも役立ちます。

PROPAVG

グループ化したプロパティ値の平均値を返します。

PROPAVGは、イベントの数値プロパティでグループ化した場合にのみ機能します。複数のプロパティでグループ化した場合、数式は最初のグループバイ句を使用して計算を実行します。

PROPAVG数式は、選択したプロパティ値が(none)のイベントを無視します。

例

PROPAVG を使用して、特定の日に完了した購入によって生み出された平均収益を計算します。

PROPCOUNT

イベントがグループ化されているプロパティに対して、一意のプロパティ値の数を返します。

PROPCOUNT は、異なるプロパティ値の推定値です。 この推定値はHyperLogLogアルゴリズムに基づいており、その精度は処理対象となるデータ量に依存します。プロパティのカーディナリティに応じて、一意な値が 12,000 件未満の場合は相対誤差がおおよそ 0.1% 程度、一意なプロパティ値が 12,000 件を超える場合は最大 0.5% 程度の相対誤差が発生することがあります。

例

DAU チャートでは、PROPCOUNT(A)指定した期間中にアクティブユーザーが存在した異なる国の数を取得します。

PROPCOUNTAVG

指定されたプロパティに対して各ユーザーが持つ異なる値の平均数を返します。

例

ある音楽アプリでは、各Play Song or VideoイベントでGenre_Typeプロパティを取得しています。 Genre_Typeでグループ化されたPlay Song or VideoでPROPCOUNTAVGを実行すると、Play Song or Videoを起動するユーザーあたりのユニークなGenre_Type値の平均数が返されます。

PROPHIST

選択した期間におけるグループ化基準となるプロパティ値の分布を返します。

PROPHISTは、イベントに関する数値のグループ化基準プロパティで動作します。複数のプロパティでグループ化した場合、数式は最初のグループバイ句を使用して計算を実行します。

例

PROPHIST(A)には、選択した期間中に購入を完了したユーザーのカート金額のヒストグラムが表示されます。

PROPMAX

イベントをグループ化しているプロパティの最大値を返します。

PROPMIN

イベントをグループ化する基準となるプロパティの最小値を返します。

PROPSUM

イベントをグループ化しているプロパティ値の合計を返します。

PROPSUMは、イベントの数値プロパティでグループ化した場合にのみ機能します。複数のプロパティでグループ化した場合、数式は最初のグループバイ句を使用して計算を実行します。

例

PROPSUM(A)は、Complete Purchaseイベントによって生み出された総収益を示しています。

ユーザーセッションチャートでは、セッションがメトリックの対象となるため、PROPSUMの構文が若干異なります。

以下のグラフは、すべてのセッションにわたって合計された合計時間を秒単位で示しています。

30 日間にわたるすべてのセッションを合計した合計セッション時間(秒単位)。
PROPSUMを使用した合計セッション時間
日付すべてのユーザー
2026年2月17日2,701,635
2026年2月18日2,946,038
2026年2月19日3,352,326
2026年2月20日4,605,211
2026年2月21日2,697,097
2026年2月22日2,304,097
2026年2月23日2,893,595
2026年2月24日1,564,727
2026年2月25日2,285,273
2026年2月26日3,583,397
2026年2月27日3,372,945
2026年2月28日2,318,270
2026年3月1日2,179,330
2026年3月2日4,746,058
2026年3月3日3,896,858
2026年3月4日3,447,772
2026年3月5日2,590,969
2026年3月6日2,149,860
2026年3月7日1,127,278
2026年3月8日962,262
2026年3月9日1,027,359
2026年3月10日1,575,275
2026年3月11日2,097,366
2026年3月12日2,995,249
2026年3月13日2,662,049
2026年3月14日1,612,425
2026年3月15日1,180,276
2026年3月16日1,350,090
2026年3月17日1,449,910
2026年3月18日1,700,000

この線は、その日のすべてのセッションを合計し、毎日のセッション時間を秒単位でプロットしたものです。この値は週単位のリズムに従って推移し、最も忙しい日には上昇し、最も少ない日には下降するため、プロットは月間を通じておおよそ最低値の日と最高値の日の間で変動します。この数値は、集計エンゲージメント量として捉えてください。これは、各日にユーザーがセッションに費やした合計時間を示すものであり、個々のユーザーの行動を示すものではありません。

REVENUETOTAL

収益プロパティの総額を通貨形式で返します。

REVENUETOTALは、イベントの数値プロパティでグループ化した場合にのみ機能します。$:プレフィックスはオプションです。プレフィックスが存在することにより、出力形式が通貨であることを保証します。

例

$:REVENUETOTAL(A)は、購入によって生み出された日ごとの総収益を示しています。

TOTALS

ユーザーがイベントをトリガーした回数の合計を返します。

例

TOTALS(A); TOTALS(B)は、ユーザーがアイテムの詳細を表示した総回数(イベント A)に、ユーザーがアイテムをカートに追加した総回数(イベント B)を加算した合計を示しています。

UNIQUES

イベントをトリガーしたユニークユーザーの数を返します。

ユーザーセッションチャートでは、セッションがメトリックの対象となるため、UNIQUESの構文が若干異なります。

この例

UNIQUES(A)/UNIQUES(B)は、1 分以上のセッションに参加したユーザーと、1 つ以上のSearch Itemsイベントを含むセッションに参加したユーザーとの比率を示しています。

1分を超えるセッションに参加しているユーザーと、[アイテム検索]イベントを含むセッションに参加しているユーザーとの比率(30日間、日単位)。
UNIQUESを使用したセッションエンゲージメント率
日付イギリス
2026年2月18日1.52
2026年2月19日1.33
2026年2月20日1.32
2026年2月21日1.31
2026年2月22日1.36
2026年2月23日1.36
2026年2月24日1.34
2026年2月25日1.34
2026年2月26日1.33
2026年2月27日1.33
2026年2月28日1.33
2026年3月1日1.31
2026年3月2日1.31
2026年3月3日1.52
2026年3月4日1.3
2026年3月5日1.33
2026年3月6日1.32
2026年3月7日1.35
2026年3月8日1.36
2026年3月9日1.58
2026年3月10日1.31
2026年3月11日1.35
2026年3月12日1.31
2026年3月13日1.38
2026年3月14日1.32
2026年3月15日1.34
2026年3月16日1.31
2026年3月17日1.61
2026年3月18日1.32
2026年3月19日1.28

この線は、1分を超えるセッションに参加したユニークユーザー数と、セッションにSearch Itemsイベントが含まれているユニークユーザーとの比率を示しています。この値は1以上のままであるため、任意の日において、長期セッションユーザー数は一貫して検索ユーザー数を上回ります。 この比率はおおむね安定して推移し、ときおり1日だけ急上昇することがあります。「セッション」の上昇が持続している場合は、検索アクティビティと比較して長い「セッション」の方が増加していることを意味します。「セッション」の下降が持続している場合は、検索結果が長い「セッション」のエンゲージメントに追いついていることを意味します。

EVENTTOTALS

各セッション中にトリガーされたイベントの総数を返します。

この数式メトリクスは、ユーザーセッションチャートでのみ機能します。

例

EVENTTOTALS(A)は、すべてのセッションにわたるPage Viewedイベント数を返します。

SESSIONTOTALS

セッション数を返します。 ユーザーセッションとイベントセグメンテーションの両方のチャートで使用できます。

SESSIONTOTALSに渡す値は、使用しているチャートによって異なります。

例

以下の設定は、英国のすべてのユーザーについて、各セッション中に少なくとも 1 つのAdd to Cartイベントを完了した過去 30 日間の日別セッション数の合計を示しています。

各セッションで少なくとも1回「カートに追加」イベントを完了した英国ユーザーの、30 日間における1日あたりの合計セッション数。
SESSIONTOTALS を使用したセッションの合計数
日付イギリス
2026年2月18日1,736
2026年2月19日1,830
2026年2月20日1,845
2026年2月21日797
2026年2月22日687
2026年2月23日2,350
2026年2月24日2,139
2026年2月25日2,002
2026年2月26日1,797
2026年2月27日1,612
2026年2月28日846
2026年3月1日693
2026年3月2日2,399
2026年3月3日1,846
2026年3月4日1,762
2026年3月5日1,875
2026年3月6日1,676
2026年3月7日799
2026年3月8日755
2026年3月9日2,416
2026年3月10日1,983
2026年3月11日1,952
2026年3月12日1,942
2026年3月13日1,761
2026年3月14日820
2026年3月15日734
2026年3月16日2,597
2026年3月17日1,936
2026年3月18日1,989
2026年3月19日1,924

この線は、セッション内で少なくとも1つのAdd to Cartイベントを完了した英国のユーザーの1日あたりのセッション総数を示しています。この傾向は週単位で明確に現れます。平日は一定の水準を保ちますが、週末になると明確に落ち込みます。このパターンから、このセグメントは主に平日に買い物をすることがわかります。そのため、マーチャンダイジングやキャンペーンのタイミングは、週末ではなく平日に合わせてください。

SEMANTICTOTALS

配列プロパティのカウント方法を明示的に制御しながら、イベントの総発生回数を返します。

これにより、カートプロパティによるグループ化を行う際に、イベント合計および平均の測定設定で利用可能なカウントオプションへ、数式ベースでアクセスできます。

例

ある Checkout イベントには cart プロパティ item_list.product_categoryがあります。同じプロダクトカテゴリ「タコス」の下に2つのタコス(1つのクランチータコスと1つのソフトタコス)が1つのCheckoutイベントに含まれている場合:

  • SEMANTICTOTALS(A, UNIQUE_ARRAY_VALUES)は、1件のチェックアウトイベントをカウントします。
  • SEMANTICTOTALS(A, ALL_VALUES)は、2件のチェックアウトアイテムをカウントします。

TOTALSのデフォルトの動作は変更されません(「アイテムの数え方」と同等です)。 イベントをカウントするかアイテムをカウントするかを明示的に選択する必要がある場合SEMANTICTOTALSに使用します。

集計式

CUMSUM

選択したイベントのメトリックを、チャートの時間枠にわたる累計値とともに返します。

CUMSUM(UNIQUES, A) は、各データポイントにおける一意ユーザー数を重複排除した上で返します。

例

過去30日間のComplete Purchaseイベントによる収益の日次の累積合計。2 月 22 日のデータポイントは、2 月 20、21、22 日に発生した収益の合計です。

ROLLAVG

選択したイベントのメトリックを、選択した期間の移動平均とともに返します。

日次チャートでは、1日の間隔でのみ移動平均を使用できます。

例

: 毎日のアクティブユーザー数に週間のローリング平均を重ね合わせます。 青い線は日次アクティブユーザーを示し、緑色の線は週間の移動平均を示しています。この比較を使用して、毎日のアクティブユーザー数がローリング平均よりも高いか低いかを確認できます。

ROLLWIN

指定した日数、週数、または月数のローリングウィンドウで選択されたイベントのメトリックを返します。

チャートに表示される日、週、または月は、そのウィンドウ期間の最終日を表します。

例

このグラフは、まず各時間間隔の新規ユーザー数を計算し、次にその上にローリングウィンドウ集計を実行します。

ROLLWINBEFORE

指定した数回の間隔にわたってローリングウィンドウで選択されたイベントのメトリックを返します。このメトリックは、コホートフィルタの前に適用されます。

例

このグラフは、まず各時間間隔のアクティブ ユーザー数を計算し、次にその上に新しいユーザー コホート フィルターを適用します。

関数式

EXP

e を指定した値の累乗として返します。

例では、

EXP(AVG(A)) e をユーザーがチケットを購入する平均回数の累乗として計算しています。

LN

値の自然対数、つまりeを底とする対数を返します。

この例

LN(UNIQUES(A))では、イベント A をトリガーしたユニークユーザー数の自然対数を計算しています。

LOG

指定された基数に対する値の対数を返します。

例

LOG(UNIQUES(A), 3)は、3 を底とするユニーク アクティブ ユーザー数の対数を返します。

LOG10

値の10を底とする対数を返します。

例

LOG10(AVG(A))は、ユーザーが Complete Purchase をトリガーした平均回数の常用対数を返します。

POWER

指定された指数で累乗した値を返します。

例

POWER(UNIQUES(A), 2)は、イベント A をトリガーしたユニークユーザーの数の二乗を返します。

SQRT

値の平方根を返します。

例

SQRT(TOTALS(A))は、ユーザーがイベント A をトリガーした総回数の平方根を返します。

TRENDLINE

値に対する通常最小二乗法による線形回帰トレンドラインを返します。

比較のためにこの数式と並んで別のカスタム数式をプロットすることを強く検討してください。 そうでない場合、このTRENDLINE関数はチャート上にコンテキストのない直線を表示します。

例

TRENDLINE を使用して、曲またはビデオを購入したユーザー数のトレンドラインを把握し、それをユニークユーザー数と比較します。

これは役に立ちましたか?

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

このページでは