🧩 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 theuserId
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:
In Accoil, go to Settings > Connections
Find Segment and click Connect
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
orgroup_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.