Method: properties.runFunnelReport

Google アナリティクスのイベントデータのカスタマイズされた目標到達プロセス レポートを返します。API から返されるデータは、リクエストされたディメンションと指標の列を含む表です。

目標到達プロセスデータ探索では、ユーザーがコンバージョンに至るまでのステップをビジュアル表示し、各ステップでのユーザーの動向をすばやく確認できます。たとえば、見込み顧客がどのように買い物客になり、その後どのように顧客に変わるか、一見客がどのようにリピーターになるのかといったことです。この情報により、非効率的または放棄されたカスタマー ジャーニーを改善できます。詳しくは、GA4 のファネル データ探索をご覧ください。

この方法は、ベータ版に入る前に構文や機能に関するフィードバックを収集する目的で、アルファ版(安定版)で導入されています。この API に関するフィードバックは、Google Analytics Data API の目標到達プロセス レポートのフィードバックにご記入ください。

HTTP リクエスト

POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
property

string

省略可。イベントがトラッキングされる Google アナリティクス GA4 プロパティの識別子。本文ではなく URL パスで指定します。詳しくは、プロパティ ID を確認する方法をご覧ください。バッチ リクエスト内では、このプロパティを指定しないか、バッチレベルのプロパティと一致させる必要があります。

例: properties/1234

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現
{
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "funnel": {
    object (Funnel)
  },
  "funnelBreakdown": {
    object (FunnelBreakdown)
  },
  "funnelNextAction": {
    object (FunnelNextAction)
  },
  "funnelVisualizationType": enum (FunnelVisualizationType),
  "segments": [
    {
      object (Segment)
    }
  ],
  "limit": string,
  "dimensionFilter": {
    object (FilterExpression)
  },
  "returnPropertyQuota": boolean
}
フィールド
dateRanges[]

object (DateRange)

省略可。読み取るデータの期間。複数の期間をリクエストすると、各レスポンス行にゼロから始まる期間のインデックスが含まれます。2 つの期間が重複している場合は、重複する日のイベントデータが両方の期間のレスポンス行に含まれます。

funnel

object (Funnel)

省略可。このリクエストのファネルの設定。このファネル設定は必須です。

funnelBreakdown

object (FunnelBreakdown)

省略可。指定すると、この内訳により、ファネル テーブルのサブレポートのレスポンスにディメンションが追加されます。この内訳ディメンションでは、ファネルの各ステップが内訳ディメンションの一意の値に展開されます。たとえば、deviceCategory ディメンションの内訳では、mobiletabletdesktop、および合計の行が作成されます。

funnelNextAction

object (FunnelNextAction)

省略可。指定すると、次のアクションによって、目標到達プロセスのビジュアリゼーションのサブレポートのレスポンスにディメンションが追加されます。この「次のアクション」ディメンションでは、目標到達プロセスの各ステップが、次のアクションの一意の値に展開されます。たとえば、「eventName」ディメンションの次のアクションでは、複数のイベント(session_startclick など)と合計の行が作成されます。

次のアクションは、eventName と、ほとんどのページ / スクリーン ディメンション(pageTitlepagePath など)のみをサポートしています。

funnelVisualizationType

enum (FunnelVisualizationType)

省略可。目標到達プロセスのビジュアリゼーション タイプでは、目標到達プロセスのビジュアリゼーションのサブレポートのレスポンスに表示されるディメンションを制御します。指定しない場合は STANDARD_FUNNEL が使用されます。

segments[]

object (Segment)

省略可。セグメントの構成セグメントはプロパティのデータのサブセットです。セグメントを含むファネル レポートでは、ファネルはセグメントごとに評価されます。

このリクエストで指定された各セグメントは、レスポンスに別々の行を生成します。レスポンスでは、各セグメントが名前で識別されます。

セグメント パラメータは省略可能です。リクエストは 4 つのセグメントに制限されます。

limit

string (int64 format)

省略可。返される行数。指定しない場合は、10,000 行が返されます。API は、リクエストした数に関係なく、リクエストあたり最大 250,000 行を返します。limit は正数でなければなりません。

また、ディメンション値の数が limit より少ない場合、API はリクエストされた limit よりも少ない行を返すことがあります。

dimensionFilter

object (FilterExpression)

省略可。ディメンション フィルタを使用すると、特定のディメンション値のみをレポートに表示できます。詳しくは、レポートの作成: ディメンション フィルタで例をご覧ください。このフィルタでは指標を使用できません。

returnPropertyQuota

boolean

省略可。このアナリティクス プロパティの割り当ての現在の状態を返すかどうかを切り替えます。割り当ては PropertyQuota で返されます。

レスポンスの本文

ファネル レポートのレスポンスには 2 つのサブレポートが含まれます。2 つのサブレポートは、ディメンションと指標の組み合わせが異なります。

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現
{
  "funnelTable": {
    object (FunnelSubReport)
  },
  "funnelVisualization": {
    object (FunnelSubReport)
  },
  "propertyQuota": {
    object (PropertyQuota)
  },
  "kind": string
}
フィールド
funnelTable

object (FunnelSubReport)

ファネルの表は、ファネルのステップ、セグメント、内訳ディメンション、アクティブ ユーザー数、完了率、放棄率、放棄率を含むレポートです。

セグメントがリクエストされた場合にのみ、このレスポンスにセグメント ディメンションが存在します。内訳ディメンションは、リクエストされた場合にのみこのレスポンスに含まれます。

funnelVisualization

object (FunnelSubReport)

ファネルのビジュアリゼーションは、ファネルのステップ、セグメント、日付、次のアクションのディメンション、アクティブ ユーザーが含まれたレポートです。

セグメントがリクエストされた場合にのみ、このレスポンスにセグメント ディメンションが存在します。日付ディメンションは、TRENDED_FUNNEL ファネル タイプでリクエストされた場合にのみ、このレスポンスに含まれます。次のアクション ディメンションは、リクエストされた場合にのみレスポンスに含まれます。

propertyQuota

object (PropertyQuota)

このリクエストを含む、このアナリティクスのプロパティの割り当て状態。

kind

string

このメッセージのリソースの種類を識別します。この kind は常に固定文字列「analyticsData#runFunnelReport」です。JSON でレスポンス タイプを区別するのに役立ちます。

承認スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

DateRange

連続する日付セット: startDatestartDate + 1、...、endDate。リクエストは最大 4 つの期間を指定できます。

JSON 表現
{
  "startDate": string,
  "endDate": string,
  "name": string
}
フィールド
startDate

string

クエリの開始日(この日付を含む)。YYYY-MM-DD の形式で指定します。endDate より後の日付は指定できません。NdaysAgoyesterdaytoday の形式も使用できます。その場合、日付はプロパティのレポートのタイムゾーンに基づいて推定されます。

endDate

string

クエリの終了日(両端を含む)。YYYY-MM-DD の形式で指定します。startDate より前の日付を指定することはできません。NdaysAgoyesterdaytoday の形式も使用できます。その場合、日付はプロパティのレポートのタイムゾーンに基づいて推定されます。

name

string

この期間に名前を割り当てます。レポート レスポンスでは、ディメンション dateRange にこの名前が設定されます。設定した場合、date_range_ または RESERVED_ で始めることはできません。設定しない場合、期間の名前はリクエスト内のゼロから始まるインデックス(date_range_0date_range_1 など)になります。

ファネル

ファネル レポート リクエストでファネルを設定します。ファネルでは、ユーザーが一連のステップを通過するとレポートされます。

目標到達プロセスデータ探索では、ユーザーがコンバージョンに至るまでのステップをビジュアル表示し、各ステップでのユーザーの動向をすばやく確認できます。たとえば、見込み顧客がどのように買い物客になり、その後どのように顧客に変わるか、一見客がどのようにリピーターになるのかといったことです。この情報から、非効率なカスタマー ジャーニーや、放棄されるカスタマー ジャーニーの改善を図ることができます。

JSON 表現
{
  "isOpenFunnel": boolean,
  "steps": [
    {
      object (FunnelStep)
    }
  ]
}
フィールド
isOpenFunnel

boolean

オープン ファネルでは、ユーザーはどのステップからでもファネルに入ります。クローズド ファネルでは、最初のステップからファネルを開始する必要があります。省略可。指定しない場合は、クローズド ファネルが使用されます。

steps[]

object (FunnelStep)

このファネルの一連のステップ。

FunnelStep

ステップでは、測定するカスタマー ジャーニーを定義します。ステップには、ユーザーがファネルのステップに含まれる条件が 1 つ以上含まれています。

JSON 表現
{
  "name": string,
  "isDirectlyFollowedBy": boolean,
  "filterExpression": {
    object (FunnelFilterExpression)
  },
  "withinDurationFromPriorStep": string
}
フィールド
name

string

このステップの識別名。指定しない場合、ステップの名前は 1 から始まるインデックス付き名になります(例: 「0. 「1. 」など)。この名前は、funnelStepName ディメンションによって返される文字列値を定義します。たとえば、リクエストの第 3 の目標到達プロセスのステップで name = Purchase を指定すると、目標到達プロセス レポートのレスポンスで 3. Purchase が生成されます。

isDirectlyFollowedBy

boolean

true の場合、このステップは前のステップに直接続く必要があります。false の場合、前のステップとこのステップの間にイベントが存在する可能性があります。指定しない場合、isDirectlyFollowedBy は false として扱われます。

filterExpression

object (FunnelFilterExpression)

ユーザーがファネル ジャーニーのこのステップに含まれる条件。

withinDurationFromPriorStep

string (Duration format)

指定した場合、このステップは前のステップの完了からこの期間内に完了する必要があります。withinDurationFromPriorStep には、マイクロ秒単位のエンドポイントが含まれます。たとえば、5 秒間は 4.9 秒または 5.0 秒で完了できますが、5 秒と 1 マイクロ秒では完了できません。

withinDurationFromPriorStep は省略可能です。指定しない場合は、ステップを任意の期間で区切ることができます。

s」で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

FunnelFilterExpression

ファネル フィルタの組み合わせを表します。

JSON 表現
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelFilterExpressionList)
  },
  "orGroup": {
    object (FunnelFilterExpressionList)
  },
  "notExpression": {
    object (FunnelFilterExpression)
  },
  "funnelFieldFilter": {
    object (FunnelFieldFilter)
  },
  "funnelEventFilter": {
    object (FunnelEventFilter)
  }
  // End of list of possible types for union field expr.
}
フィールド
共用体フィールド exprFunnelFilterExpression のフィルタの種類を 1 つ指定します。expr は次のいずれかになります。
andGroup

object (FunnelFilterExpressionList)

andGroup の FunnelFilterExpression は AND 関係です。

orGroup

object (FunnelFilterExpressionList)

orGroup の FunnelFilterExpression は OR 関係にあります。

notExpression

object (FunnelFilterExpression)

FunnelFilterExpression が notExpression の NOT になっています。

funnelFieldFilter

object (FunnelFieldFilter)

ディメンションまたは指標のファネル フィルタ。

funnelEventFilter

object (FunnelEventFilter)

単一のイベント名のイベントに一致するフィルタを作成します。パラメータ フィルタ式が指定されている場合、このイベント フィルタに一致するのは、単一のイベント名とパラメータ フィルタ式の両方に一致するイベントのサブセットのみです。

FunnelFilterExpressionList

ファネルのフィルタ式のリスト。

JSON 表現
{
  "expressions": [
    {
      object (FunnelFilterExpression)
    }
  ]
}
フィールド
expressions[]

object (FunnelFilterExpression)

ファネルのフィルタ式のリスト。

FunnelFieldFilter

ディメンションまたは指標の値をフィルタする式。

JSON 表現
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
フィールド
fieldName

string

ディメンション名または指標名。

共用体フィールド one_filter。1 種類のフィルタを指定します。one_filter は次のいずれかになります。
stringFilter

object (StringFilter)

文字列関連のフィルタ。

inListFilter

object (InListFilter)

リスト内の値のフィルタ。

numericFilter

object (NumericFilter)

数値または日付の値のフィルタ。

betweenFilter

object (BetweenFilter)

2 つの値の間のフィルタ。

StringFilter

文字列のフィルタ

JSON 表現
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
フィールド
matchType

enum (MatchType)

このフィルタのマッチタイプ。

value

string

照合に使用される文字列値。

caseSensitive

boolean

true の場合、文字列値の大文字と小文字は区別されます。

MatchType

文字列フィルタのマッチタイプ

列挙型
MATCH_TYPE_UNSPECIFIED 未指定
EXACT 文字列値との完全一致。
BEGINS_WITH 文字列値で始まります。
ENDS_WITH 文字列値で終わる。
CONTAINS 文字列値が含まれます。
FULL_REGEXP 正規表現と文字列値との完全一致。
PARTIAL_REGEXP 正規表現と文字列値との部分一致。

InListFilter

結果は文字列値のリストに入っている必要があります。

JSON 表現
{
  "values": [
    string
  ],
  "caseSensitive": boolean
}
フィールド
values[]

string

文字列値のリスト。空でない必要があります。

caseSensitive

boolean

true の場合、文字列値の大文字と小文字は区別されます。

NumericFilter

数値または日付の値をフィルタします。

JSON 表現
{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}
フィールド
operation

enum (Operation)

このフィルタのオペレーション タイプ。

value

object (NumericValue)

数値または日付値。

オペレーション

数値フィルタに適用される演算

列挙型
OPERATION_UNSPECIFIED (指定なし)
EQUAL 等しい
LESS_THAN 次より小さい
LESS_THAN_OR_EQUAL 次の値以下
GREATER_THAN 次の値を上回る
GREATER_THAN_OR_EQUAL 次の値以上

NumericValue

数値を表すため。

JSON 表現
{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}
フィールド
共用体フィールド one_value。数値 one_value には次のいずれか 1 つだけを指定できます。
int64Value

string (int64 format)

整数値

doubleValue

number

double 値

BetweenFilter

結果が 2 つの数値の間にある必要があることを示す場合。

JSON 表現
{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}
フィールド
fromValue

object (NumericValue)

この番号で始まります。

toValue

object (NumericValue)

末尾がこの番号。

FunnelEventFilter

単一のイベント名のイベントに一致するフィルタを作成します。パラメータ フィルタ式が指定されている場合、このイベント フィルタに一致するのは、単一のイベント名とパラメータ フィルタ式の両方に一致するイベントのサブセットのみです。

JSON 表現
{
  "eventName": string,
  "funnelParameterFilterExpression": {
    object (FunnelParameterFilterExpression)
  }
}
フィールド
eventName

string

このフィルタは、この単一のイベント名のイベントに一致します。イベント名は必須です。

funnelParameterFilterExpression

object (FunnelParameterFilterExpression)

指定すると、このフィルタは、単一のイベント名とパラメータ フィルタ式の両方に一致するイベントに一致します。

パラメータ フィルタ式内では、パラメータ フィルタのみを使用できます。

FunnelParameterFilterExpression

パラメータのファネル フィルタの組み合わせを表します。

JSON 表現
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "orGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "notExpression": {
    object (FunnelParameterFilterExpression)
  },
  "funnelParameterFilter": {
    object (FunnelParameterFilter)
  }
  // End of list of possible types for union field expr.
}
フィールド
共用体フィールド exprFunnelParameterFilterExpression のフィルタの種類を 1 つ指定します。expr は次のいずれかになります。
andGroup

object (FunnelParameterFilterExpressionList)

andGroup の FunnelParameterFilterExpression は AND 関係です。

orGroup

object (FunnelParameterFilterExpressionList)

orGroup の FunnelParameterFilterExpression は OR 関係です。

notExpression

object (FunnelParameterFilterExpression)

FunnelParameterFilterExpression が notExpression の NOT です。

funnelParameterFilter

object (FunnelParameterFilter)

ファネルの基本パラメータ フィルタ。

FunnelParameterFilterExpressionList

ファネル パラメータのフィルタ式のリスト。

JSON 表現
{
  "expressions": [
    {
      object (FunnelParameterFilterExpression)
    }
  ]
}
フィールド
expressions[]

object (FunnelParameterFilterExpression)

ファネル パラメータのフィルタ式のリスト。

FunnelParameterFilter

ファネルのパラメータ値をフィルタする式。

JSON 表現
{

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
フィールド
共用体フィールド one_parameter。フィルタするフィールド。one_parameter は次のいずれかになります。
eventParameterName

string

このフィルタは、指定されたイベント パラメータで評価されます。イベント パラメータは、イベントのパラメータとしてログに記録されます。イベント パラメータには、「firebase_screen」や「currency」などのフィールドが含まれます。

イベント パラメータは、セグメントとファネルでのみ使用でき、EventFilter の子孫フィルタでのみ使用できます。EventFilter の子孫フィルタでは、イベント パラメータまたはアイテム パラメータのいずれかを使用する必要があります。

itemParameterName

string

このフィルタは、指定されたアイテム パラメータに基づいて評価されます。アイテム パラメータは、アイテム配列にパラメータとして記録されます。商品アイテム パラメータには、「item_name」や「item_category」などのフィールドがあります。

アイテム パラメータはセグメントとファネルでのみ使用でき、EventFilter の子孫フィルタでのみ使用できます。EventFilter の子孫フィルタでは、イベント パラメータまたはアイテム パラメータのいずれかを使用する必要があります。

アイテム パラメータは e コマース イベントでのみ使用できます。e コマース イベントについて詳しくは、e コマースを測定するガイドをご覧ください。

共用体フィールド one_filter。1 種類のフィルタを指定します。one_filter は次のいずれかになります。
stringFilter

object (StringFilter)

文字列関連のフィルタ。

inListFilter

object (InListFilter)

リスト内の値のフィルタ。

numericFilter

object (NumericFilter)

数値または日付の値のフィルタ。

betweenFilter

object (BetweenFilter)

2 つの値の間のフィルタ。

FunnelBreakdown

内訳を表示すると、目標到達プロセスの表のサブレポートのレスポンスにディメンションが追加されます。

JSON 表現
{
  "breakdownDimension": {
    object (Dimension)
  },
  "limit": string
}
フィールド
breakdownDimension

object (Dimension)

ファネル テーブルのサブレポートのレスポンスに追加されたディメンション列。内訳ディメンションでは、ファネルの各ステップの内訳が表示されます。funnelBreakdown を指定する場合は、有効な breakdownDimension を指定する必要があります。

limit

string (int64 format)

レスポンスで返す内訳ディメンションの個別の値の最大数。上限が指定されていない場合は、5limit が使用されます。上限は 0 以下、15 以下にする必要があります。

ディメンション

ディメンションはデータの属性です。たとえば、ディメンション「city」はイベントが発生した都市を示します。レポートのレスポンスのディメンション値は文字列です。たとえば、都市は「パリ」や「ニューヨーク」です。

JSON 表現
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
フィールド
name

string

ディメンションの名前。runReportbatchRunReports などの主要なレポート メソッドでサポートされているディメンション名の一覧については、API ディメンションをご覧ください。runRealtimeReport メソッドでサポートされているディメンション名の一覧については、リアルタイム ディメンションをご覧ください。runFunnelReport メソッドでサポートされているディメンション名の一覧については、ファネル ディメンションをご覧ください。

dimensionExpression を指定した場合、name には、使用可能な文字セット内の任意の文字列を指定できます。たとえば、dimensionExpressioncountrycity を連結する場合、そのディメンションを countryAndCity と呼び出せます。選択するディメンション名は、正規表現 ^[a-zA-Z0-9_]$ と一致する必要があります。

ディメンションは、dimensionFilterorderBysdimensionExpressionpivotsname によって参照されます。

dimensionExpression

object (DimensionExpression)

1 つのディメンションは、複数のディメンションの式の結果になることがあります。たとえば、ディメンション「country, city」の場合は concatenate(country, ", ", city)。

DimensionExpression

複数のディメンションの式の結果であるディメンションを表現するために使用します。使用例: 1)lowerCase(dimension) 2) concatenate(dimension1, symbol, dimension2)。

JSON 表現
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
フィールド
共用体フィールド one_expressionDimensionExpression に 1 つのディメンション式を指定します。one_expression は次のいずれかになります。
lowerCase

object (CaseExpression)

ディメンション値を小文字に変換するために使用します。

upperCase

object (CaseExpression)

ディメンション値を大文字に変換するために使用します。

concatenate

object (ConcatenateExpression)

ディメンション値を 1 つのディメンションにまとめるために使用します。たとえば、ディメンション「country, city」の場合は concatenate(country, ", ", city)。

CaseExpression

ディメンション値を 1 つの大文字 / 小文字に変換するために使用します。

JSON 表現
{
  "dimensionName": string
}
フィールド
dimensionName

string

ディメンションの名前。この名前は、リクエストのディメンション フィールド内の名前を参照する必要があります。

ConcatenateExpression

ディメンション値を 1 つのディメンションにまとめるために使用します。

JSON 表現
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
フィールド
dimensionNames[]

string

ディメンションの名前。この名前は、リクエストのディメンション フィールド内の名前を参照する必要があります。

delimiter

string

ディメンション名の間に配置される区切り文字。

区切り文字は多くの場合、| や "," などの 1 文字ですが、より長い文字列にすることもできます。ディメンション値に区切り文字が含まれている場合は、レスポンスに両方が区別なく含まれます。たとえば、ディメンション 1 の値が「US,FR」、ディメンション 2 の値が「JP」、区切り文字が「,」の場合、レスポンスには「US,FR,JP」が含まれます。

FunnelNextAction

「次のアクション」は、ユーザーが 1 ステップを達成した後、同じユーザーが次のステップを達成するまでの間のディメンションの値を示します。たとえば、nextActionDimensioneventName の場合、i のファネルのステップの行の nextActionDimension は、ユーザーを i のファネルのステップに導いたイベントの後、i+1 のファネルのステップを達成する前の最初のイベントを返します。

JSON 表現
{
  "nextActionDimension": {
    object (Dimension)
  },
  "limit": string
}
フィールド
nextActionDimension

object (Dimension)

目標到達プロセスのビジュアリゼーションのサブレポートのレスポンスに追加されたディメンション列。次のアクション ディメンションは、ユーザーが目標到達プロセスの第 i ステップを達成した後、このディメンションの次のディメンション値を返します。

nextActionDimension は現在、eventName と、ほとんどのページ / スクリーン ディメンション(pageTitlepagePath など)のみをサポートしています。nextActionDimension をディメンション式にすることはできません。

limit

string (int64 format)

レスポンスで返す内訳ディメンションの個別の値の最大数。上限が指定されていない場合は、5limit が使用されます。上限は 0 以下、5 以下にする必要があります。

FunnelVisualizationType

ファネルの可視化のサブレポート レスポンスに含まれるディメンションを制御します。

列挙型
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED 未指定のタイプ。
STANDARD_FUNNEL 標準的な(段階的な)ファネル。レスポンスの目標到達プロセス ビジュアリゼーションのサブレポートに日付は含まれません。
TRENDED_FUNNEL ファネルのトレンドグラフ(折れ線グラフ)。レスポンスの目標到達プロセス ビジュアリゼーションのサブレポートには、日付ディメンションが含まれます。

分類して表示

セグメントはアナリティクスのデータの一部です。たとえば、すべてのユーザーのうち、特定の国や都市のユーザーだけを 1 つのセグメントに設定したり、特定の商品ラインを購入したユーザー、サイトの特定のページにアクセスしたユーザー、アプリで特定のイベントをトリガーしたユーザーを別のセグメントに指定したりすることなどができます。

詳しくは、GA4 セグメント ビルダーについての記事をご覧ください。

JSON 表現
{
  "name": string,

  // Union field one_segment_scope can be only one of the following:
  "userSegment": {
    object (UserSegment)
  },
  "sessionSegment": {
    object (SessionSegment)
  },
  "eventSegment": {
    object (EventSegment)
  }
  // End of list of possible types for union field one_segment_scope.
}
フィールド
name

string

このセグメントの名前。指定しない場合、セグメントの名前は「Segment」となります。この名前は、segment ディメンションによって返される文字列値を定義します。segment ディメンションでは、セグメント名の先頭に、リクエスト内のセグメントの 1 から始まるインデックス番号が付加されます(例: 「1. 「セグメント」「2. セグメント」など)。

共用体フィールド one_segment_scope。セグメントは 1 つのスコープで指定されます。one_segment_scope は次のいずれかになります。
userSegment

object (UserSegment)

ユーザー セグメントは、サイトまたはアプリを利用したユーザーのサブセットです。

sessionSegment

object (SessionSegment)

セッション セグメントは、サイトまたはアプリで発生したセッションのサブセットです。

eventSegment

object (EventSegment)

イベント セグメントは、サイトまたはアプリで発生したイベントのサブセットです。

UserSegment

ユーザー セグメントは、サイトやアプリを利用したユーザーのサブセットです。たとえば、商品を購入したことがあるユーザー、つまりショッピング カートに商品を追加したものの、購入には至らなかったユーザーなどです。

JSON 表現
{
  "userInclusionCriteria": {
    object (UserSegmentCriteria)
  },
  "exclusion": {
    object (UserSegmentExclusion)
  }
}
フィールド
userInclusionCriteria

object (UserSegmentCriteria)

このセグメントに含めるユーザーを定義します。省略可。

exclusion

object (UserSegmentExclusion)

このセグメントから除外するユーザーを定義します。省略可。

UserSegmentCriteria

ユーザーのイベントが条件に含まれる場合、そのユーザーは条件に一致します。

JSON 表現
{
  "andConditionGroups": [
    {
      object (UserSegmentConditionGroup)
    }
  ],
  "andSequenceGroups": [
    {
      object (UserSegmentSequenceGroup)
    }
  ]
}
フィールド
andConditionGroups[]

object (UserSegmentConditionGroup)

ユーザーがこれらの andConditionGroupsandSequenceGroups のそれぞれに一致する場合、この条件に一致します。andSequenceGroups が指定されている場合、andConditionGroups は空になることがあります。

andSequenceGroups[]

object (UserSegmentSequenceGroup)

ユーザーがこれらの andSequenceGroupsandConditionGroups のそれぞれに一致する場合、この条件に一致します。andConditionGroups が指定されている場合、andSequenceGroups は空になることがあります。

UserSegmentConditionGroup

条件を指定することで、セグメントに含めるデータとセグメントから除外するデータを指定できます。

JSON 表現
{
  "conditionScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
フィールド
conditionScoping

enum (UserCriteriaScoping)

データが条件グループに一致しているかどうかに基づいて、データがセグメントに追加または除外されます。このスコープは、条件グループが一致と判断されるまでに segmentFilterExpression が評価されるイベントの数を定義します。たとえば、conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION の場合、セッション内のすべてのイベントで式が評価され、このユーザーに対して条件グループが一致するかどうかが決定されます。たとえば、conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT の場合、式は 1 つのイベントで評価され、このユーザーに条件グループが一致するかどうかが判定されます。

省略可。指定しない場合は、conditionScoping = ACROSS_ALL_SESSIONS が使用されます。

segmentFilterExpression

object (SegmentFilterExpression)

データがこの式と一致するかどうかに基づいて、セグメントに追加または除外されます。式は、ディメンション、指標、パラメータの条件を表します。

UserCriteriaScoping

スコープでは、ユーザーが条件を満たしているかどうかを評価する際に考慮するイベントを指定します。

列挙型
USER_CRITERIA_SCOPING_UNSPECIFIED 条件のスコープが指定されていません。指定しないでください。
USER_CRITERIA_WITHIN_SAME_EVENT 1 つのイベント内で条件が満たされると、そのユーザーは条件に一致します。
USER_CRITERIA_WITHIN_SAME_SESSION 1 回のセッションで条件が満たされると、そのユーザーは条件に一致します。
USER_CRITERIA_ACROSS_ALL_SESSIONS ユーザーのいずれかのイベントで条件が満たされると、ユーザーはその条件に一致します。

SegmentFilterExpression

セグメント フィルタの組み合わせを表します。

JSON 表現
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentFilterExpressionList)
  },
  "orGroup": {
    object (SegmentFilterExpressionList)
  },
  "notExpression": {
    object (SegmentFilterExpression)
  },
  "segmentFilter": {
    object (SegmentFilter)
  },
  "segmentEventFilter": {
    object (SegmentEventFilter)
  }
  // End of list of possible types for union field expr.
}
フィールド
共用体フィールド exprSegmentFilterExpression のフィルタの種類を 1 つ指定します。expr は次のいずれかになります。
andGroup

object (SegmentFilterExpressionList)

andGroup の SegmentFilterExpression は AND 関係です。

orGroup

object (SegmentFilterExpressionList)

orGroup の SegmentFilterExpression は OR 関係にあります。

notExpression

object (SegmentFilterExpression)

SegmentFilterExpression が notExpression の NOT である。

segmentFilter

object (SegmentFilter)

プリミティブ セグメント フィルタ。

segmentEventFilter

object (SegmentEventFilter)

単一のイベント名のイベントに一致するフィルタを作成します。パラメータ フィルタ式が指定されている場合、このイベント フィルタに一致するのは、単一のイベント名とパラメータ フィルタ式の両方に一致するイベントのサブセットのみです。

SegmentFilterExpressionList

セグメント フィルタ式のリスト。

JSON 表現
{
  "expressions": [
    {
      object (SegmentFilterExpression)
    }
  ]
}
フィールド
expressions[]

object (SegmentFilterExpression)

セグメント フィルタ式のリスト

SegmentFilter

ディメンションまたは指標の値をフィルタする式。

JSON 表現
{
  "fieldName": string,
  "filterScoping": {
    object (SegmentFilterScoping)
  },

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
フィールド
fieldName

string

ディメンション名または指標名。

filterScoping

object (SegmentFilterScoping)

フィルタのスコープを指定します。

共用体フィールド one_filterFilter のフィルタの種類を 1 つ指定します。one_filter は次のいずれかになります。
stringFilter

object (StringFilter)

文字列関連のフィルタ。

inListFilter

object (InListFilter)

リスト内の値のフィルタ。

numericFilter

object (NumericFilter)

数値または日付の値のフィルタ。

betweenFilter

object (BetweenFilter)

2 つの値の間のフィルタ。

SegmentFilterScoping

スコープでは、セグメント フィルタを評価する際に、複数のイベントのディメンションと指標をどのように考慮するかを指定します。

JSON 表現
{
  "atAnyPointInTime": boolean
}
フィールド
atAnyPointInTime

boolean

atAnyPointInTime が true の場合、このフィルタは、リクエストの期間内のイベントに対して true と評価されると、すべてのイベントで true と評価されます。

この atAnyPointInTime パラメータは、レポート内のイベントの期間を拡張しません。atAnyPointInTime が true の場合、このフィルタの評価時にレポートの期間内のイベントのみが考慮されます。

この atAnyPointInTime は、条件のスコープが ACROSS_ALL_SESSIONS の場合にのみ指定でき、シーケンスでは指定できません。

条件のスコープが ACROSS_ALL_SESSIONS の場合、指定されていない場合は atAnyPointInTime = false が使用されます。

SegmentEventFilter

単一のイベント名のイベントに一致するフィルタを作成します。パラメータ フィルタ式が指定されている場合、このイベント フィルタに一致するのは、単一のイベント名とパラメータ フィルタ式の両方に一致するイベントのサブセットのみです。

JSON 表現
{
  "eventName": string,
  "segmentParameterFilterExpression": {
    object (SegmentParameterFilterExpression)
  }
}
フィールド
eventName

string

このフィルタは、この単一のイベント名のイベントに一致します。イベント名は必須です。

segmentParameterFilterExpression

object (SegmentParameterFilterExpression)

指定すると、このフィルタは、単一のイベント名とパラメータ フィルタ式の両方に一致するイベントに一致します。

パラメータ フィルタ式内では、パラメータ フィルタのみを使用できます。

SegmentParameterFilterExpression

パラメータのセグメント フィルタの組み合わせを表します。

JSON 表現
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "orGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "notExpression": {
    object (SegmentParameterFilterExpression)
  },
  "segmentParameterFilter": {
    object (SegmentParameterFilter)
  }
  // End of list of possible types for union field expr.
}
フィールド
共用体フィールド exprSegmentParameterFilterExpression のフィルタの種類を 1 つ指定します。expr は次のいずれかになります。
andGroup

object (SegmentParameterFilterExpressionList)

andGroup の SegmentParameterFilterExpression は AND 関係です。

orGroup

object (SegmentParameterFilterExpressionList)

orGroup の SegmentParameterFilterExpression は OR 関係にあります。

notExpression

object (SegmentParameterFilterExpression)

SegmentParameterFilterExpression が notExpression の NOT である。

segmentParameterFilter

object (SegmentParameterFilter)

プリミティブ セグメント パラメータ フィルタ。

SegmentParameterFilterExpressionList

セグメント パラメータのフィルタ式のリスト。

JSON 表現
{
  "expressions": [
    {
      object (SegmentParameterFilterExpression)
    }
  ]
}
フィールド
expressions[]

object (SegmentParameterFilterExpression)

セグメント パラメータのフィルタ式のリスト。

SegmentParameterFilter

セグメント内のパラメータ値をフィルタする式。

JSON 表現
{
  "filterScoping": {
    object (SegmentParameterFilterScoping)
  },

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
フィールド
filterScoping

object (SegmentParameterFilterScoping)

フィルタのスコープを指定します。

共用体フィールド one_parameter。フィルタするフィールド。one_parameter は次のいずれかになります。
eventParameterName

string

このフィルタは、指定されたイベント パラメータで評価されます。イベント パラメータは、イベントのパラメータとしてログに記録されます。イベント パラメータには、「firebase_screen」や「currency」などのフィールドが含まれます。

イベント パラメータは、セグメントとファネルでのみ使用でき、EventFilter の子孫フィルタでのみ使用できます。EventFilter の子孫フィルタでは、イベント パラメータまたはアイテム パラメータのいずれかを使用する必要があります。

itemParameterName

string

このフィルタは、指定されたアイテム パラメータに基づいて評価されます。アイテム パラメータは、アイテム配列にパラメータとして記録されます。商品アイテム パラメータには、「item_name」や「item_category」などのフィールドがあります。

アイテム パラメータはセグメントとファネルでのみ使用でき、EventFilter の子孫フィルタでのみ使用できます。EventFilter の子孫フィルタでは、イベント パラメータまたはアイテム パラメータのいずれかを使用する必要があります。

アイテム パラメータは e コマース イベントでのみ使用できます。e コマース イベントについて詳しくは、e コマースを測定するガイドをご覧ください。

共用体フィールド one_filter。1 種類のフィルタを指定します。one_filter は次のいずれかになります。
stringFilter

object (StringFilter)

文字列関連のフィルタ。

inListFilter

object (InListFilter)

リスト内の値のフィルタ。

numericFilter

object (NumericFilter)

数値または日付の値のフィルタ。

betweenFilter

object (BetweenFilter)

2 つの値の間のフィルタ。

SegmentParameterFilterScoping

スコープでは、セグメント パラメータ フィルタを評価する際に複数のイベントをどのように考慮するかを指定します。

JSON 表現
{
  "inAnyNDayPeriod": string
}
フィールド
inAnyNDayPeriod

string (int64 format)

指定した日数にわたってパラメータを蓄積してから、フィルタを適用します。条件のスコープが ACROSS_ALL_SESSIONS または WITHIN_SAME_SESSION の場合にのみサポートされます。パラメータが event_count の場合にのみサポートされます。

たとえば、inAnyNDayPeriod が 3、eventName が「purchase」、イベント パラメータが「event_count」で、フィルタの条件が 5 より大きい場合、このフィルタでは、レポートの期間内の連続する 3 日の期間ごとに購入イベントのイベント数が累積されます。ユーザーは、このフィルタの条件を満たし、連続する 3 日間で 5 を超える購入イベント数がこのセグメントに含まれます。たとえば、2021 年 11 月 1 日~ 2021 年 11 月 3 日、2021 年 11 月 2 日~ 2021 年 11 月 4 日、2021 年 11 月 3 日~ 2021 年 11 月 5 日などが考えられます。

期間の開始日近くに N 日間の期間を設定する目的でデータが拡張されることはありません。たとえば、レポートの対象期間が 2021 年 11 月 1 日から 2021 年 11 月 10 日で、inAnyNDayPeriod = 3 の場合、レポートの期間外のイベントデータは読み取られないため、最初の 2 日間の期間は事実上短縮されます。たとえば、最初の 4 つの期間は、2021-11-01 ~ 2021-11-01、2021-11-01 ~ 2021-11-02、2021-11-01 ~ 2021-11-03、2021-10-2011 ~ 2021-11-01 になります。

inAnyNDayPeriod は省略可能です。指定しない場合、segmentParameterFilter は各イベントに個別に適用されます。

UserSegmentSequenceGroup

ユーザーがセグメントのメンバーとなるために特定の順序で実行する必要がある条件を定義します。

JSON 表現
{
  "sequenceScoping": enum (UserCriteriaScoping),
  "sequenceMaximumDuration": string,
  "userSequenceSteps": [
    {
      object (UserSequenceStep)
    }
  ]
}
フィールド
sequenceScoping

enum (UserCriteriaScoping)

ユーザーがシーケンスに一致するには、スコープですべてのシーケンス ステップが満たされる必要があります。たとえば sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION の場合、ユーザーがシーケンスに一致するためには、すべてのシーケンス ステップが 1 つのセッション内で完了する必要があります。sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT はサポートされていません。

省略可。指定しない場合は、conditionScoping = ACROSS_ALL_SESSIONS が使用されます。

sequenceMaximumDuration

string (Duration format)

シーケンス全体を実行する期間を定義します(例: 30 分)。sequenceMaximumDuration には、マイクロ秒単位のエンドポイントが含まれます。たとえば、最大継続時間が 5 秒のシーケンスは、4.9 秒または 5.0 秒で完了できますが、5 秒と 1 マイクロ秒では完了できません。

sequenceMaximumDuration は省略可能です。指定しない場合、シーケンスは任意の時間で完了できます。

s」で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

userSequenceSteps[]

object (UserSequenceStep)

順序付けられた一連の条件ステップ。ユーザーが UserSegmentSequenceGroup と一致するようにするには、イベントが各ステップを完了する必要があります。

UserSequenceStep

このユーザーがシーケンスに一致するために、指定されたステップ順序で発生する必要がある条件。

JSON 表現
{
  "isDirectlyFollowedBy": boolean,
  "stepScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
フィールド
isDirectlyFollowedBy

boolean

true の場合、このステップを満たすイベントは、最後のステップを達成したイベントの次のイベントでなければなりません。false の場合、このステップは間接的に前のステップの後に続きます。たとえば、前のステップとこのステップの間にイベントがある可能性があります。最初のステップでは isDirectlyFollowedBy を false にする必要があります。

stepScoping

enum (UserCriteriaScoping)

ユーザーがシーケンスに一致するには、このシーケンス ステップがスコープで満たされる必要があります。たとえば sequenceScoping = WITHIN_SAME_SESSION の場合、ユーザーがシーケンスに一致するためには、このシーケンス ステップが 1 つのセッション内で完了する必要があります。stepScoping = ACROSS_ALL_SESSIONS は、sequenceScoping = ACROSS_ALL_SESSIONS の場合にのみ許可されます。

省略可。指定しない場合、stepScopingsequenceScoping と同じ UserCriteriaScoping を使用します。

segmentFilterExpression

object (SegmentFilterExpression)

ユーザーのイベントがこの式と一致する場合、ユーザーはこのシーケンス ステップに一致します。式は、ディメンション、指標、パラメータの条件を表します。

UserSegmentExclusion

このセグメントから除外するユーザーを指定します。

JSON 表現
{
  "userExclusionDuration": enum (UserExclusionDuration),
  "userExclusionCriteria": {
    object (UserSegmentCriteria)
  }
}
フィールド
userExclusionDuration

enum (UserExclusionDuration)

ユーザーが userExclusionCriteria と一致した場合に除外する期間を指定します。

省略可。指定しない場合は、USER_EXCLUSION_TEMPORARYuserExclusionDuration が使用されます。

userExclusionCriteria

object (UserSegmentCriteria)

この条件を満たすユーザーは、userExclusionDuration のセグメントのメンバーから除外されます。

UserExclusionDuration

ユーザーが userExclusionCriteria と一致した場合に除外する期間のオプションを列挙します。

列挙型
USER_EXCLUSION_DURATION_UNSPECIFIED 除外期間が指定されていません。指定しないでください。
USER_EXCLUSION_TEMPORARY ユーザーが userExclusionCriteria 条件を満たしている期間中は、一時的にセグメントからユーザーを除外します。
USER_EXCLUSION_PERMANENT ユーザーが userExclusionCriteria 条件を満たす場合に、セグメントからそのユーザーを完全に除外します。

SessionSegment

セッション セグメントfとはサイトやアプリで発生したセッションのサブセットのことで、特定の広告キャンペーンから発生したすべてのセッションなどが該当します。

JSON 表現
{
  "sessionInclusionCriteria": {
    object (SessionSegmentCriteria)
  },
  "exclusion": {
    object (SessionSegmentExclusion)
  }
}
フィールド
sessionInclusionCriteria

object (SessionSegmentCriteria)

このセグメントに含めるセッションを定義します。省略可。

exclusion

object (SessionSegmentExclusion)

このセグメントから除外するセッションを定義します。省略可。

SessionSegmentCriteria

セッションのイベントが条件の条件を満たしている場合、そのセッションは条件に一致します。

JSON 表現
{
  "andConditionGroups": [
    {
      object (SessionSegmentConditionGroup)
    }
  ]
}
フィールド
andConditionGroups[]

object (SessionSegmentConditionGroup)

セッションがこれらの andConditionGroups のそれぞれと一致する場合、セッションはこの条件に一致します。

SessionSegmentConditionGroup

条件を指定することで、セグメントに含めるデータとセグメントから除外するデータを指定できます。

JSON 表現
{
  "conditionScoping": enum (SessionCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
フィールド
conditionScoping

enum (SessionCriteriaScoping)

データが条件グループに一致しているかどうかに基づいて、データがセグメントに追加または除外されます。このスコープは、条件グループが一致と判断されるまでに segmentFilterExpression が評価されるイベントの数を定義します。たとえば、conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION の場合、セッション内のすべてのイベントで式が評価され、条件グループがこのセッションに一致するかどうかが決定されます。たとえば、conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT の場合、式は 1 つのイベントで評価され、条件グループはこのセッションに一致するかどうかを判断します。

省略可。指定しない場合は、WITHIN_SAME_SESSIONconditionScoping が使用されます。

segmentFilterExpression

object (SegmentFilterExpression)

データがこの式と一致するかどうかに基づいて、セグメントに追加または除外されます。式は、ディメンション、指標、パラメータの条件を表します。

SessionCriteriaScoping

スコープでは、セッションが基準を満たしているかどうかを評価する際に考慮するイベントを指定します。

列挙型
SESSION_CRITERIA_SCOPING_UNSPECIFIED 条件のスコープが指定されていません。指定しないでください。
SESSION_CRITERIA_WITHIN_SAME_EVENT 1 つのイベント内で条件が満たされると、そのセッションは条件に一致します。
SESSION_CRITERIA_WITHIN_SAME_SESSION 1 回のセッションで条件が満たされると、そのセッションは条件に一致します。

SessionSegmentExclusion

このセグメントから除外するセッションを指定します。

JSON 表現
{
  "sessionExclusionDuration": enum (SessionExclusionDuration),
  "sessionExclusionCriteria": {
    object (SessionSegmentCriteria)
  }
}
フィールド
sessionExclusionDuration

enum (SessionExclusionDuration)

セッションが sessionExclusionCriteria と一致した場合に除外する期間を指定します。

省略可。指定しない場合は、SESSION_EXCLUSION_TEMPORARYsessionExclusionDuration が使用されます。

sessionExclusionCriteria

object (SessionSegmentCriteria)

この条件を満たすセッションは、sessionExclusionDuration のセグメントから除外されます。

SessionExclusionDuration

セッションが sessionExclusionCriteria と一致した場合に、除外期間を指定するオプションを列挙します。

列挙型
SESSION_EXCLUSION_DURATION_UNSPECIFIED 除外期間が指定されていません。指定しないでください。
SESSION_EXCLUSION_TEMPORARY セッションが「sessionExclusionCriteria」条件を満たしている期間中は、そのセッションを一時的にセグメントから除外します。
SESSION_EXCLUSION_PERMANENT セッションが sessionExclusionCriteria 条件を満たす場合、そのセッションはセグメントから完全に除外されます。

EventSegment

イベント セグメントは、サイトまたはアプリで発生したイベントのサブセットです。たとえば、特定の地域で発生したすべての購入イベントや、特定のオペレーティング システムで発生した app_exception イベントなどです。

JSON 表現
{
  "eventInclusionCriteria": {
    object (EventSegmentCriteria)
  },
  "exclusion": {
    object (EventSegmentExclusion)
  }
}
フィールド
eventInclusionCriteria

object (EventSegmentCriteria)

このセグメントに含めるイベントを定義します。省略可。

exclusion

object (EventSegmentExclusion)

このセグメントで除外するイベントを定義します。省略可。

EventSegmentCriteria

イベントが条件に含まれる場合、そのイベントは条件に一致します。

JSON 表現
{
  "andConditionGroups": [
    {
      object (EventSegmentConditionGroup)
    }
  ]
}
フィールド
andConditionGroups[]

object (EventSegmentConditionGroup)

イベントがこれらの andConditionGroups のそれぞれと一致する場合、イベントはこの条件に一致します。

EventSegmentConditionGroup

条件を指定することで、セグメントに含めるデータとセグメントから除外するデータを指定できます。

JSON 表現
{
  "conditionScoping": enum (EventCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
フィールド
conditionScoping

enum (EventCriteriaScoping)

conditionScoping は常に EVENT_CRITERIA_WITHIN_SAME_EVENT になります。

省略可。指定しない場合は、EVENT_CRITERIA_WITHIN_SAME_EVENTconditionScoping が使用されます。

segmentFilterExpression

object (SegmentFilterExpression)

データがこの式と一致するかどうかに基づいて、セグメントに追加または除外されます。式は、ディメンション、指標、パラメータの条件を表します。

EventCriteriaScoping

スコープでは、イベントが条件を満たしているかどうかを評価する際に考慮するイベントを指定します。

列挙型
EVENT_CRITERIA_SCOPING_UNSPECIFIED 条件のスコープが指定されていません。指定しないでください。
EVENT_CRITERIA_WITHIN_SAME_EVENT 1 つのイベント内で条件が満たされた場合、そのイベントは条件に一致します。

EventSegmentExclusion

このセグメントから除外するイベントを指定します。

JSON 表現
{
  "eventExclusionDuration": enum (EventExclusionDuration),
  "eventExclusionCriteria": {
    object (EventSegmentCriteria)
  }
}
フィールド
eventExclusionDuration

enum (EventExclusionDuration)

eventExclusionDuration は常に PERMANENTLY_EXCLUDE になります。

省略可。指定しない場合は、EVENT_EXCLUSION_PERMANENTeventExclusionDuration が使用されます。

eventExclusionCriteria

object (EventSegmentCriteria)

この条件を満たすイベントは、eventExclusionDuration のセグメントのメンバーから除外されます。

EventExclusionDuration

イベントが eventExclusionCriteria と一致する場合に除外の存続期間に関するオプションを列挙します。

列挙型
EVENT_EXCLUSION_DURATION_UNSPECIFIED 除外期間が指定されていません。指定しないでください。
EVENT_EXCLUSION_PERMANENT イベントが eventExclusionCriteria 条件を満たす場合、そのイベントをセグメントから完全に除外します。

FilterExpression

ディメンション フィルタまたは指標フィルタを表現するため。同じ FilterExpression 内のフィールドは、すべてのディメンションまたはすべての指標である必要があります。

JSON 表現
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FilterExpressionList)
  },
  "orGroup": {
    object (FilterExpressionList)
  },
  "notExpression": {
    object (FilterExpression)
  },
  "filter": {
    object (Filter)
  }
  // End of list of possible types for union field expr.
}
フィールド
共用体フィールド exprFilterExpression に 1 種類のフィルタ式を指定します。expr は次のいずれかになります。
andGroup

object (FilterExpressionList)

andGroup の FilterExpressions は AND 関係です。

orGroup

object (FilterExpressionList)

orGroup の FilterExpressions は OR 関係にあります。

notExpression

object (FilterExpression)

FilterExpression が notExpression の NOT である。

filter

object (Filter)

プリミティブ フィルタ。同じ FilterExpression で、フィルタのフィールド名はすべて、すべてのディメンションまたはすべての指標にする必要があります。

FilterExpressionList

フィルタ式のリスト。

JSON 表現
{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}
フィールド
expressions[]

object (FilterExpression)

フィルタ式のリスト。

フィルタ

ディメンションまたは指標の値をフィルタする式。

JSON 表現
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
フィールド
fieldName

string

ディメンション名または指標名。ディメンションまたは指標で定義された名前を指定する必要があります。

共用体フィールド one_filterFilter のフィルタの種類を 1 つ指定します。one_filter は次のいずれかになります。
stringFilter

object (StringFilter)

文字列関連のフィルタ。

inListFilter

object (InListFilter)

リスト内の値のフィルタ。

numericFilter

object (NumericFilter)

数値または日付の値のフィルタ。

betweenFilter

object (BetweenFilter)

2 つの値の間のフィルタ。

FunnelSubReport

ファネルのサブレポートには、ディメンションと指標のデータ値が含まれます。たとえば、12 人のユーザーが目標到達プロセスの 2 番目のステップに到達したとします。

JSON 表現
{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "metadata": {
    object (FunnelResponseMetadata)
  }
}
フィールド
dimensionHeaders[]

object (DimensionHeader)

ディメンションの列について説明します。ファネル レポートでは、サブレポートのレスポンスにファネルのステップ ディメンションが常に含まれます。リクエストに応じて、内訳、日付、次のアクションなどのディメンションがレスポンスに含まれる場合があります。

metricHeaders[]

object (MetricHeader)

指標の列について説明します。ファネル レポートでは、サブレポートのレスポンスに常にアクティブ ユーザーが含まれます。ファネルの表には、完了率、放棄率、放棄率などの追加の指標が含まれています。

rows[]

object (Row)

レポート内のディメンション値の組み合わせと指標値の行。

metadata

object (FunnelResponseMetadata)

ファネル レポートのメタデータ。

DimensionHeader

レポートのディメンション列についての説明です。レポートでディメンションがリクエストされると、行と DimensionHeaders 内に列エントリが生成されます。ただし、フィルタや式だけで使用されるディメンションではレポートに列が作成されないため、ヘッダーは生成されません。

JSON 表現
{
  "name": string
}
フィールド
name

string

ディメンションの名前。

MetricHeader

レポートの指標列を示します。レポートでリクエストされる表示指標により、行と MetricHeaders 内に列エントリが生成されます。ただし、フィルタや式だけで使用される指標ではレポートに列が作成されないため、ヘッダーは生成されません。

JSON 表現
{
  "name": string,
  "type": enum (MetricType)
}
フィールド
name

string

指標の名前。

type

enum (MetricType)

指標のデータ型。

MetricType

指標の値の型。

列挙型
METRIC_TYPE_UNSPECIFIED 未指定のタイプ。
TYPE_INTEGER 整数型。
TYPE_FLOAT 浮動小数点型。
TYPE_SECONDS 秒。特別な浮動小数点数型です。
TYPE_MILLISECONDS ミリ秒単位の期間。特殊な浮動小数点数型です。
TYPE_MINUTES 分単位の期間。特別な浮動小数点数型です。
TYPE_HOURS 時間単位。特別な浮動小数点数型です。
TYPE_STANDARD 標準タイプのカスタム指標(特別な浮動小数点タイプ)。
TYPE_CURRENCY 金額。特別な浮動小数点数型です。
TYPE_FEET フィート単位の長さ。特別な浮動小数点数型です。
TYPE_MILES マイル単位の長さ。特別な浮動小数点数型です。
TYPE_METERS メートル単位の長さ。特別な浮動小数点数型です。
TYPE_KILOMETERS キロメートル単位の長さ。特別な浮動小数点数型です。

各行のレポートデータ。たとえば、RunReportRequest に次の内容が含まれているとします。

"dimensions": [
  {
    "name": "eventName"
  },
  {
    "name": "countryId"
  }
],
"metrics": [
  {
    "name": "eventCount"
  }
]

eventName が「in_app_purchase」、countryId が「JP」、eventCount が 15 の行は次のようになります。

"dimensionValues": [
  {
    "value": "in_app_purchase"
  },
  {
    "value": "JP"
  }
],
"metricValues": [
  {
    "value": "15"
  }
]
JSON 表現
{
  "dimensionValues": [
    {
      object (DimensionValue)
    }
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
フィールド
dimensionValues[]

object (DimensionValue)

リクエストされたディメンション値のリスト。ピボット レポートでは、ディメンションの値は、ピボットに含まれるディメンションに対してのみリストされます。

metricValues[]

object (MetricValue)

リクエストされた表示可能な指標値のリスト。

DimensionValue

ディメンションの値。

JSON 表現
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
フィールド
共用体フィールド one_value。ディメンション値 one_value には、次のいずれか 1 つのみを指定できます。
value

string

ディメンション タイプが文字列の場合は、文字列の値。

MetricValue

指標の値。

JSON 表現
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
フィールド
共用体フィールド one_value。指標値 one_value は次のいずれかになります。
value

string

測定値。タイプについては、MetricHeader をご覧ください。

FunnelResponseMetadata

ファネル レポートのレスポンス メタデータには、ファネル レポートに関する追加情報が含まれます。

JSON 表現
{
  "samplingMetadatas": [
    {
      object (SamplingMetadata)
    }
  ]
}
フィールド
samplingMetadatas[]

object (SamplingMetadata)

ファネル レポートの結果がサンプリングされている場合は、このファネル レポートで使用されているイベントの割合を示します。期間ごとに 1 つの samplingMetadatas が入力されます。各 samplingMetadatas は、リクエストで指定された期間の日付範囲に対応します。

ただし、結果がサンプリングされない場合、このフィールドは定義されません。

SamplingMetadata

ファネル レポートの結果がサンプリングされた場合、このメタデータは、期間中にこのファネル レポートに使用されたイベントの割合を示します。サンプリングとは、大規模なデータセットから有意な情報を明らかにするために、すべてのデータのサブセットを分析することです。

JSON 表現
{
  "samplesReadCount": string,
  "samplingSpaceSize": string
}
フィールド
samplesReadCount

string (int64 format)

このサンプル レポートで特定の期間に読み取られたイベントの合計数。このファネル レポートで分析されたこのプロパティのデータのサブセットのサイズです。

samplingSpaceSize

string (int64 format)

このプロパティのデータに含まれるイベントのうち、特定の期間にこの目標到達プロセス レポートで分析できたものの合計数。サンプリングにより、より大きなデータセットに関する有意義な情報が得られます。これは、より大きなデータセットのサイズです。

このファネル レポートで使用された利用可能なデータの割合を計算するには、samplesReadCount/samplingSpaceSize を計算します。

PropertyQuota

このアナリティクス プロパティのすべての割り当ての現在の状態。プロパティの割り当てをすべて使い切ると、そのプロパティへのリクエストはすべてリソース不足エラーを返します。

JSON 表現
{
  "tokensPerDay": {
    object (QuotaStatus)
  },
  "tokensPerHour": {
    object (QuotaStatus)
  },
  "concurrentRequests": {
    object (QuotaStatus)
  },
  "serverErrorsPerProjectPerHour": {
    object (QuotaStatus)
  },
  "potentiallyThresholdedRequestsPerHour": {
    object (QuotaStatus)
  },
  "tokensPerProjectPerHour": {
    object (QuotaStatus)
  }
}
フィールド
tokensPerDay

object (QuotaStatus)

標準のアナリティクス プロパティでは 1 日あたり最大 20 万トークン、アナリティクス 360 プロパティでは 1 日あたり 200 万トークンを使用できます。ほとんどの場合、リクエストで使用するトークンは 10 個未満です。

tokensPerHour

object (QuotaStatus)

標準のアナリティクス プロパティでは 1 時間あたり最大 40,000 トークン、アナリティクス 360 プロパティでは 1 時間あたり 400,000 トークンを使用できます。API リクエストで消費されるトークンの数は 1 つだけです。その数は、1 時間、1 日、プロジェクトごとの 1 時間あたりのすべての割り当てから差し引かれます。

concurrentRequests

object (QuotaStatus)

標準のアナリティクス プロパティでは、最大 10 個の同時リクエストを送信できます。アナリティクス 360 プロパティでは、最大 50 個の同時リクエストを使用できます。

serverErrorsPerProjectPerHour

object (QuotaStatus)

サーバーエラーは、標準のアナリティクス プロパティとクラウド プロジェクトのペアでは 1 時間あたり最大 10 件、アナリティクス 360 プロパティとクラウド プロジェクトのペアでは 1 時間あたり最大 50 件です。

potentiallyThresholdedRequestsPerHour

object (QuotaStatus)

アナリティクスのプロパティは、1 時間あたり最大 120 件のリクエストを送信でき、ディメンションにしきい値が設定されている可能性があります。バッチ リクエストでは、リクエストにしきい値が設定される可能性があるディメンションが含まれている場合、各レポート リクエストはこの割り当てに対して個別にカウントされます。

tokensPerProjectPerHour

object (QuotaStatus)

アナリティクスのプロパティでは、1 プロジェクトあたり 1 時間あたり最大 35% のトークンを使用できます。つまり、標準のアナリティクス プロパティでは 1 プロジェクトあたり 1 時間あたり最大 14,000 トークン、アナリティクス 360 プロパティでは 1 プロジェクトあたり 1 時間あたり最大 140,000 トークンを使用できます。API リクエストで消費されるトークンの数は 1 つだけです。その数は、1 時間、1 日、プロジェクトごとの 1 時間あたりのすべての割り当てから差し引かれます。

QuotaStatus

特定の割り当てグループの現在の状態。

JSON 表現
{
  "consumed": integer,
  "remaining": integer
}
フィールド
consumed

integer

このリクエストによって消費される割り当て。

remaining

integer

このリクエストの後に残っている割り当て。