Segment

What Is This Integration

The Segment integration sends supported Pharos lifecycle and checkout events to Segment.

It allows your team to use Segment as the central event pipeline for analytics, destinations, and downstream data tools.

When to Use It

Use Segment when you want:

• Pharos events available in your broader analytics stack
• a central event router for multiple destinations
• control over which supported events are forwarded

Prerequisites

Before configuring Segment, make sure:

• you have a Segment workspace and source
• you have the Segment write key
• you know which Pharos source events you want to forward

How to Configure It in Pharos

1. Open the Segment integration page in admin settings.
2. Enable the integration.
3. Enter the Segment write key.
4. Review the list of supported source events.
5. Enable or disable events individually as needed.
6. Override the outgoing event name if your Segment naming convention requires it.
7. Save the settings.

What Happens After It Is Enabled

After the integration is enabled:

• Pharos evaluates supported events against your event mapping settings
• enabled events are forwarded to Segment
• disabled events are skipped
• renamed events are sent using the external name you configured

How to Verify It Is Working

To verify the setup:

• triggering a supported checkout or billing event in Pharos
• confirming the event arrives in Segment
• confirming the event name matches your configured mapping

Limitations or Important Notes

• only supported Pharos events can be sent
• disabled events are not forwarded
• this integration depends on a valid write key

Troubleshooting

If events do not appear in Segment:

• confirm the integration is enabled
• confirm the write key is correct
• confirm the specific source event is enabled
• confirm you triggered an event that Pharos supports for Segment forwarding