Skip to main content
All CollectionsConnections
Segment Connections
Segment Connections

Sync product traits and trigger events in Segment to power your analytics and downstream tools

Simon Herd avatar
Written by Simon Herd
Updated this week

🧩 Overview

The Segment integration makes it easy to send product engagement data from Accoil into your data pipeline. Whether you're syncing traits for enrichment or triggering events in real time, Accoil connects directly to your Segment source with no setup overhead.

By connecting Accoil to Segment, you can:

  • Send Identify and Group calls with engagement traits on a per-profile basis

  • Trigger custom events or trait updates via Accoil Automation Rules

  • Manually sync traits for users or groups at any time


What you can do with Segment


📊 Sync Traits from Accoil to Segment

Accoil syncs traits from your configured profiles to Segment on a regular basis. You can:

  • Enable or disable syncing per profile

  • Choose to sync either:

    • Segment names only, or

    • All traits (including engagement score, activation, adoption, last active, etc.)

These traits are sent using standard Identify (for users) and Group (for accounts) calls in Segment.

🧠 How It Works

  • Users are identified by their tracking_id

  • Groups are identified by their group_id

  • For Group calls, Segment requires a userId, so Accoil uses the userId of the oldest active user in the group

Traits follow the same naming convention used across integrations:
Accoil_[ProfileName][TraitName] (with spaces removed from the profile name)


⚙️ Use Segment in Automation Rules

Accoil also allows you to trigger real-time actions in Segment via automation:

  • Send Trait – Update a user or group trait dynamically

  • Send Event – Send a custom event (e.g., HighEngagementAlert, ChurnRiskEntered) to Segment

These events can then be picked up by other tools in your Segment ecosystem for personalized messaging, analytics, or orchestration.


🔄 Manually Trigger a Trait Sync

In addition to regular syncs, you can manually trigger a sync for any user or group:

  • From any user or group profile in Accoil

  • Or from a list view by selecting one or more entities

  • Use the Actions dropdown and choose Sync to Segment


Admin Setup & Configuration


⚙️ How to Connect Accoil to Segment

There’s no authentication or OAuth flow required.

To connect:

  1. In Accoil, go to Settings > Connections

  2. Find Segment and click Connect

  3. Paste in your Segment write key
    (We recommend using a Segment HTTP API Source for this connection)

That’s it—once saved, Accoil will we able to start sending data to Segment for all enabled profiles.


🔁 Controlling Trait Sync per Profile

You can configure sync settings for each profile individually:

  • Enable or disable syncing for the profile

  • Choose to sync:

    • Segment names only, or

    • All traits, including engagement score, activation, adoption, last active, and more

These settings determine what data is included in the Identify and Group calls to Segment.

📛 Trait Naming Convention

The traits Accoil sends to Segment follow the same naming format used in Intercom and HubSpot, so your teams can work with consistent field names across tools:

Accoil_[ProfileName]_[TraitName]
  • The profile name has all spaces removed

  • The trait name is appended directly after

Example: For a profile named Trial Users, the engagement score trait would appear as:

Accoil_TrialUsers_EngagementScore

These traits will appear in Segment as part of the traits object in Identify and Group calls, making them easy to route into downstream tools like Customer.io, Amplitude, or your data warehouse.


🧠 Use Cases by Team

Team

How Segment + Accoil Helps

Data & Analytics

Enrich Segment profiles with product traits for analysis or modeling

Growth / Marketing

Use Accoil traits in downstream tools for targeted messaging

Customer Success

Monitor product behavior and trigger alerts in CRMs or dashboards

Engineering / DataOps

Integrate product usage data into your broader data stack without extra instrumentation


🛠 Troubleshooting

  • Not seeing traits in Segment? Check that the write key is correct and the source is active

  • No traits for a specific profile? Make sure syncing is enabled and set to “All traits”

  • Manual sync not working? Confirm the user or group has a valid tracking_id or group_id

Still need help? Reach out to the Accoil team—we’re happy to assist.


✅ Summary

The Segment integration is the fastest way to get Accoil’s engagement data into your analytics and orchestration tools. With Identify and Group calls, automation triggers, and simple setup via write key, it’s a low-effort, high-impact connection for data-rich teams.

Have more advanced use cases? Let us know—we’d love to hear how you’re using Segment with Accoil.

Did this answer your question?