st_smart_metrics: Smart Metrics Fetching with Automatic ID Resolution

In sensortowerR: Interface to 'Sensor Tower' Mobile App Intelligence API

Smart Metrics Fetching with Automatic ID Resolution

Description

Enhanced metrics fetching that automatically handles ID resolution, caching, and fallbacks to minimize API calls.

Usage

st_smart_metrics(
  app_ids,
  metrics = c("revenue", "downloads"),
  start_date = Sys.Date() - 30,
  end_date = Sys.Date() - 1,
  countries = "WW",
  granularity = "daily",
  auto_resolve = TRUE,
  use_cache = TRUE,
  parallel = TRUE,
  auth_token = Sys.getenv("SENSORTOWER_AUTH_TOKEN"),
  verbose = TRUE
)

Arguments

app_ids	Character vector. Can be any mix of iOS IDs, Android IDs, or Sensor Tower unified IDs.
metrics	Character vector. Metrics to fetch (e.g., "revenue", "downloads", "dau").
start_date	Date or character string. Start date for metrics.
end_date	Date or character string. End date for metrics.
countries	Character vector. Country codes (default "WW").
granularity	Character. Date granularity ("daily", "weekly", "monthly").
auto_resolve	Logical. Automatically resolve IDs using cache/API (default TRUE).
use_cache	Logical. Use ID cache to minimize lookups (default TRUE).
parallel	Logical. Use parallel processing (default TRUE).
auth_token	Character string. Your Sensor Tower API authentication token.
verbose	Logical. Print progress messages.

Value

A tibble with metrics in long format

Examples

## Not run: 
# Mixed ID types - automatically resolved
metrics <- st_smart_metrics(
  app_ids = c(
    "553834731", # Candy Crush iOS
    "com.king.candycrushsaga", # Candy Crush Android
    "5ba4585f539ce75b97db6bcb" # Star Trek unified ID
  ),
  metrics = c("revenue", "downloads", "dau"),
  start_date = "2024-01-01",
  end_date = "2024-12-31"
)

## End(Not run)

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