% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/windows.R
\name{summarise_gazepoint_engagement_windows}
\alias{summarise_gazepoint_engagement_windows}
\title{Summarise Gazepoint engagement-dial windows}
\usage{
summarise_gazepoint_engagement_windows(
  data,
  group_columns = NULL,
  value_column = "DIAL",
  validity_column = "DIALV",
  exclude_zero = FALSE
)
}
\arguments{
\item{data}{A data frame or a path to a Gazepoint CSV export.}

\item{group_columns}{Optional grouping columns defining windows, such as
\code{c("USER", "MEDIA_ID")}.}

\item{value_column}{Engagement-dial value column. Defaults to \code{"DIAL"}.}

\item{validity_column}{Engagement-dial validity column. Defaults to
\code{"DIALV"}.}

\item{exclude_zero}{Should zero values be excluded from usable summaries?}
}
\value{
A data frame with one row per window.
}
\description{
Summarises Gazepoint engagement-dial values within participant, trial,
stimulus, AOI, or other user-defined windows.
}
