Altertable Ruby SDK

Official Ruby SDK for Altertable Product Analytics.

Install

Install the gem with a single command:

gem install altertable

Quick Start

Initialize the client and track your first event. Call track() to record an action a user performed.

require 'altertable'

# Initialize the Altertable client
Altertable.init('pk_live_abc123', environment: 'production')

# Track an event
Altertable.track('button_clicked', 'user_123', properties: {
  button_id: 'signup_btn',
  page: 'home'
})

API Reference

Initialization

Initialize the global Altertable client instance.

Altertable.init(api_key, options = {})

Altertable.init('pk_live_abc123', environment: 'production', debug: true)

Tracking Events

Record an action performed by a user.

Altertable.track(event, distinct_id, **options)

Altertable.track('item_purchased', 'user_123', properties: {
  item_id: 'item_999',
  price: 19.99
})

Identifying Users

Link a user ID to their traits (like email or name).

Altertable.identify(user_id, **options)

Altertable.identify('user_123', traits: {
  email: 'user@example.com',
  name: 'John Doe'
})

Alias

Merge a previous anonymous ID with a newly identified user ID.

Altertable.alias(distinct_id, new_user_id, **options)

Altertable.alias('anon_session_456', 'user_123')

Configuration

You can configure the client by passing options during initialization.

Option	Type	Default	Description
environment	String	"production"	Environment name (e.g., production, development).
base_url	String	"https://api.altertable.ai"	Base URL for API requests.
request_timeout	Integer	5	Request timeout in seconds.
release	String	nil	Application release version (e.g., commit hash).
debug	Boolean	false	Enable debug logging.
on_error	Proc	nil	Callback for handling errors.
adapter	Symbol	auto-detect	HTTP adapter to use (:faraday, :httpx, :net_http).
proxy	String, Boolean	adapter default	Proxy to use for requests. Pass a URI string to force a specific proxy, or false to disable proxying (including any HTTP_PROXY/HTTPS_PROXY environment variables) for a fixed, trusted base_url. Unset by default: the :faraday and :net_http adapters auto-detect a proxy from the environment as they normally would; :httpx never does.

License

The gem is available as open source under the terms of the MIT License.