Ruby product analytics installation

1

Install the gem

Required

Add the PostHog Ruby gem to your Gemfile:

Gemfile

gem "posthog-ruby"

2

Configure PostHog

Required

Initialize the PostHog client with your API key and host:

Ruby
posthog = PostHog::Client.new({
    api_key: "<ph_project_api_key>",
    host: "https://us.i.posthog.com",
    on_error: Proc.new { |status, msg| print msg }
})

3

Send events

Optional

Once installed, you can manually send events to test your integration:

Ruby
posthog.capture({
    distinct_id: 'user_123',
    event: 'button_clicked',
    properties: {
        button_name: 'signup'
    }
})

By default, for backwards compatibility reasons, events are sent with person profile processing enabled. This means a person profile will be created for each user who triggers an event.

If you want to disable person profile processing for certain events, send the event with the following property:

Ruby
"$process_person_profile": false

4

Next steps

Recommended

Resource	Description
Capturing events	Learn how to capture custom events beyond autocapture
Identifying users	Associate events with specific users
Creating insights	Build trends, funnels, and retention charts
Group analytics	Track events at the company or account level

Community questions

Was this page useful?

Questions about this page? or post a community question.