Google Analytics Data V1alpha Client - Class RunFunnelReportRequest (0.18.0)

Reference documentation and code samples for the Google Analytics Data V1alpha Client class RunFunnelReportRequest.

The request for a funnel report.

Generated from protobuf message google.analytics.data.v1alpha.RunFunnelReportRequest

Namespace

Google \ Analytics \ Data \ V1alpha

Methods

__construct

Constructor.

Parameters
NameDescription
dataarray

Optional. Data for populating the Message object.

↳ propertystring

Optional. A Google Analytics GA4 property identifier whose events are tracked. Specified in the URL path and not the body. To learn more, see where to find your Property ID. Within a batch request, this property should either be unspecified or consistent with the batch-level property. Example: properties/1234

↳ date_rangesarray<Google\Analytics\Data\V1alpha\DateRange>

Optional. Date ranges of data to read. If multiple date ranges are requested, each response row will contain a zero based date range index. If two date ranges overlap, the event data for the overlapping days is included in the response rows for both date ranges.

↳ funnelGoogle\Analytics\Data\V1alpha\Funnel

Optional. The configuration of this request's funnel. This funnel configuration is required.

↳ funnel_breakdownGoogle\Analytics\Data\V1alpha\FunnelBreakdown

Optional. If specified, this breakdown adds a dimension to the funnel table sub report response. This breakdown dimension expands each funnel step to the unique values of the breakdown dimension. For example, a breakdown by the deviceCategory dimension will create rows for mobile, tablet, desktop, and the total.

↳ funnel_next_actionGoogle\Analytics\Data\V1alpha\FunnelNextAction

Optional. If specified, next action adds a dimension to the funnel visualization sub report response. This next action dimension expands each funnel step to the unique values of the next action. For example a next action of the eventName dimension will create rows for several events (for example session_start & click) and the total. Next action only supports eventName and most Page / Screen dimensions like pageTitle and pagePath.

↳ funnel_visualization_typeint

Optional. The funnel visualization type controls the dimensions present in the funnel visualization sub report response. If not specified, STANDARD_FUNNEL is used.

↳ segmentsarray<Google\Analytics\Data\V1alpha\Segment>

Optional. The configurations of segments. Segments are subsets of a property's data. In a funnel report with segments, the funnel is evaluated in each segment. Each segment specified in this request produces a separate row in the response; in the response, each segment identified by its name. The segments parameter is optional. Requests are limited to 4 segments.

↳ limitint|string

Optional. The number of rows to return. If unspecified, 10,000 rows are returned. The API returns a maximum of 250,000 rows per request, no matter how many you ask for. limit must be positive. The API can also return fewer rows than the requested limit, if there aren't as many dimension values as the limit.

↳ dimension_filterGoogle\Analytics\Data\V1alpha\FilterExpression

Optional. Dimension filters allow you to ask for only specific dimension values in the report. To learn more, see Creating a Report: Dimension Filters for examples. Metrics cannot be used in this filter.

↳ return_property_quotabool

Optional. Toggles whether to return the current state of this Analytics Property's quota. Quota is returned in PropertyQuota.

getProperty

Optional. A Google Analytics GA4 property identifier whose events are tracked. Specified in the URL path and not the body. To learn more, see where to find your Property ID.

Within a batch request, this property should either be unspecified or consistent with the batch-level property. Example: properties/1234

Returns
TypeDescription
string

setProperty

Optional. A Google Analytics GA4 property identifier whose events are tracked. Specified in the URL path and not the body. To learn more, see where to find your Property ID.

Within a batch request, this property should either be unspecified or consistent with the batch-level property. Example: properties/1234

Parameter
NameDescription
varstring
Returns
TypeDescription
$this

getDateRanges

Optional. Date ranges of data to read. If multiple date ranges are requested, each response row will contain a zero based date range index. If two date ranges overlap, the event data for the overlapping days is included in the response rows for both date ranges.

Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setDateRanges

Optional. Date ranges of data to read. If multiple date ranges are requested, each response row will contain a zero based date range index. If two date ranges overlap, the event data for the overlapping days is included in the response rows for both date ranges.

Parameter
NameDescription
vararray<Google\Analytics\Data\V1alpha\DateRange>
Returns
TypeDescription
$this

getFunnel

Optional. The configuration of this request's funnel. This funnel configuration is required.

Returns
TypeDescription
Google\Analytics\Data\V1alpha\Funnel|null

hasFunnel

clearFunnel

setFunnel

Optional. The configuration of this request's funnel. This funnel configuration is required.

Parameter
NameDescription
varGoogle\Analytics\Data\V1alpha\Funnel
Returns
TypeDescription
$this

getFunnelBreakdown

Optional. If specified, this breakdown adds a dimension to the funnel table sub report response. This breakdown dimension expands each funnel step to the unique values of the breakdown dimension. For example, a breakdown by the deviceCategory dimension will create rows for mobile, tablet, desktop, and the total.

Returns
TypeDescription
Google\Analytics\Data\V1alpha\FunnelBreakdown|null

hasFunnelBreakdown

clearFunnelBreakdown

setFunnelBreakdown

Optional. If specified, this breakdown adds a dimension to the funnel table sub report response. This breakdown dimension expands each funnel step to the unique values of the breakdown dimension. For example, a breakdown by the deviceCategory dimension will create rows for mobile, tablet, desktop, and the total.

Parameter
NameDescription
varGoogle\Analytics\Data\V1alpha\FunnelBreakdown
Returns
TypeDescription
$this

getFunnelNextAction

Optional. If specified, next action adds a dimension to the funnel visualization sub report response. This next action dimension expands each funnel step to the unique values of the next action. For example a next action of the eventName dimension will create rows for several events (for example session_start & click) and the total.

Next action only supports eventName and most Page / Screen dimensions like pageTitle and pagePath.

Returns
TypeDescription
Google\Analytics\Data\V1alpha\FunnelNextAction|null

hasFunnelNextAction

clearFunnelNextAction

setFunnelNextAction

Optional. If specified, next action adds a dimension to the funnel visualization sub report response. This next action dimension expands each funnel step to the unique values of the next action. For example a next action of the eventName dimension will create rows for several events (for example session_start & click) and the total.

Next action only supports eventName and most Page / Screen dimensions like pageTitle and pagePath.

Parameter
NameDescription
varGoogle\Analytics\Data\V1alpha\FunnelNextAction
Returns
TypeDescription
$this

getFunnelVisualizationType

Optional. The funnel visualization type controls the dimensions present in the funnel visualization sub report response. If not specified, STANDARD_FUNNEL is used.

Returns
TypeDescription
int

setFunnelVisualizationType

Optional. The funnel visualization type controls the dimensions present in the funnel visualization sub report response. If not specified, STANDARD_FUNNEL is used.

Parameter
NameDescription
varint
Returns
TypeDescription
$this

getSegments

Optional. The configurations of segments. Segments are subsets of a property's data. In a funnel report with segments, the funnel is evaluated in each segment.

Each segment specified in this request produces a separate row in the response; in the response, each segment identified by its name. The segments parameter is optional. Requests are limited to 4 segments.

Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setSegments

Optional. The configurations of segments. Segments are subsets of a property's data. In a funnel report with segments, the funnel is evaluated in each segment.

Each segment specified in this request produces a separate row in the response; in the response, each segment identified by its name. The segments parameter is optional. Requests are limited to 4 segments.

Parameter
NameDescription
vararray<Google\Analytics\Data\V1alpha\Segment>
Returns
TypeDescription
$this

getLimit

Optional. The number of rows to return. If unspecified, 10,000 rows are returned. The API returns a maximum of 250,000 rows per request, no matter how many you ask for. limit must be positive.

The API can also return fewer rows than the requested limit, if there aren't as many dimension values as the limit.

Returns
TypeDescription
int|string

setLimit

Optional. The number of rows to return. If unspecified, 10,000 rows are returned. The API returns a maximum of 250,000 rows per request, no matter how many you ask for. limit must be positive.

The API can also return fewer rows than the requested limit, if there aren't as many dimension values as the limit.

Parameter
NameDescription
varint|string
Returns
TypeDescription
$this

getDimensionFilter

Optional. Dimension filters allow you to ask for only specific dimension values in the report. To learn more, see Creating a Report: Dimension Filters for examples. Metrics cannot be used in this filter.

Returns
TypeDescription
Google\Analytics\Data\V1alpha\FilterExpression|null

hasDimensionFilter

clearDimensionFilter

setDimensionFilter

Optional. Dimension filters allow you to ask for only specific dimension values in the report. To learn more, see Creating a Report: Dimension Filters for examples. Metrics cannot be used in this filter.

Parameter
NameDescription
varGoogle\Analytics\Data\V1alpha\FilterExpression
Returns
TypeDescription
$this

getReturnPropertyQuota

Optional. Toggles whether to return the current state of this Analytics Property's quota. Quota is returned in PropertyQuota.

Returns
TypeDescription
bool

setReturnPropertyQuota

Optional. Toggles whether to return the current state of this Analytics Property's quota. Quota is returned in PropertyQuota.

Parameter
NameDescription
varbool
Returns
TypeDescription
$this