Skip to main content
Anchor to AnalyticsSchemaField

AnalyticsSchemaField

object

Requires read_reports access scope.

A dimension or metric field in an analytics schema.

•AnalyticsSchemaFieldAggregationType!
non-null

The type of aggregation that this field performs.

•Boolean!
non-null

Whether this field can be benchmarked against other merchants.

•Boolean!
non-null

Whether this field can be used as a benchmarkable filter.

•AnalyticsSchemaFieldCategory!
non-null

The category this field belongs to.

•String!
non-null

A description of the category this field belongs to.

•String!
non-null

The display name for the category.

Anchor to customerSegmentationFiltercustomerSegmentationFilter
•String!
non-null

Filter expression for customer segmentation.

•AnalyticsSchemaDeprecation

Deprecation metadata for this field, if it has been deprecated.

•String!
non-null

A description of what the field represents.

•String!
non-null

The human-readable display name for the field.

•String

For entity-joined (ENTITY type) dimensions, the alias used to reference this field in dot-notation (e.g. customer.<alias>). Null for non-entity fields.

•[AnalyticsSchemaJoin!]!
non-null

Entity join relationships for ENTITY type dimensions.

•AnalyticsSchemaEventFieldConfig

Configuration for this field in the context of app events queries.

•String!
non-null

The raw name for the field without any schema name prefixes.

•AnalyticsSchemaFieldDataType!
non-null

The data type of the field.

•String!
non-null

A description of the formula used to calculate this field.

Anchor to hasAttributionExpressionhasAttributionExpression
•Boolean!
non-null

Whether this field has an attribution expression.

•Boolean!
non-null

Whether this field supports cumulative aggregation.

•Boolean!
non-null

Whether this field is a metafield.

•[AnalyticsSchemaJoin!]!
non-null

Join relationships for this field.

Anchor to matchesParameterSettingsmatchesParameterSettings
•AnalyticsSchemaMatchParameter

Settings to use when validating this field in a MATCHES statement.

•AnalyticsSchemaMetafieldMetadata

Metadata associated with the metafield. Empty if the field isn't a metafield.

•AnalyticsSchemaMetaobjectMetadata

Metadata associated with a metaobject-backed field.

•[String!]!
non-null

Possible values for this field.

Anchor to possibleValuesTranslationspossibleValuesTranslations
•JSON!
non-null

Localized, merchant-facing translations for the field's possible enum values, as a { value => translation } map (e.g. { "paid" => "Paid" }). Empty when the field has no enumerable values.

•[String!]!
non-null

Potential use cases for this field.

•Boolean!
non-null

Whether this field is the primary entity of the schema it belongs to.

•[String!]!
non-null

Restricts which operators can be used with this field in WHERE clauses.

•String!
non-null

The standardized format for displaying this field.

•AnalyticsSchemaFieldDataType!
non-null

The element type for array fields. For non-array fields, this is UNSPECIFIED.

•Boolean!
non-null

Whether this metric can be used as an analytics target.

•[String!]!
non-null

The tiers that this field is valid for, when the schema defines tier availability.

•AnalyticsSchemaFieldTrendIndicator!
non-null

Indicates whether an increase in this field is positive, negative, or neutral.

•AnalyticsSchemaUiHints

Hints for how to display this field in the UI.

•AnalyticsSchemaFieldVariants

Variants of this field for different funnel types.


Was this section helpful?