st_active_users: Fetch Active User Metrics with a Tidy Long Output

View source: R/st_active_users.R

st_active_usersR Documentation

Fetch Active User Metrics with a Tidy Long Output

Description

Lightweight wrapper around [st_batch_metrics()] focused only on active-user metrics ('dau', 'wau', 'mau'). Returns a tidy long-format tibble that is designed for straightforward tidyverse chaining.

Usage

st_active_users(
  os,
  app_list,
  metrics = c("dau", "wau", "mau"),
  date_range = list(start_date = Sys.Date() - 90, end_date = Sys.Date() - 1),
  countries,
  granularity = "monthly",
  parallel = FALSE,
  verbose = TRUE,
  auth_token = NULL,
  max_cores = 2
)

Arguments

os

Character. Required. Operating system: '"ios"', '"android"', or '"unified"'.

app_list

List or data frame containing app information. Same formats accepted by [st_batch_metrics()].

metrics

Character vector. Active-user metrics to return. Must be one or more of '"dau"', '"wau"', '"mau"'. Default is all three.

date_range

List with 'start_date' and 'end_date'.

countries

Character vector of country codes.

granularity

Character granularity ('"daily"', '"weekly"', '"monthly"', '"quarterly"'). Default '"monthly"'.

parallel

Logical. Whether to use parallel processing.

verbose

Logical. Whether to print progress messages.

auth_token

Character string. Sensor Tower API token. Defaults to 'SENSORTOWER_AUTH_TOKEN' environment variable.

max_cores

Integer. Maximum cores for parallel processing.

Value

A tibble with columns including 'original_id', 'app_name', 'app_id', 'app_id_type', 'date', 'country', 'metric', and 'value'.


sensortowerR documentation built on March 18, 2026, 5:07 p.m.