Skip to contentSkip to navigationSkip to topbar
On this page
Looking for more inspiration?Visit the
(information)
You're in the right place! Segment documentation is now part of Twilio Docs. The content you are used to is still here—just in a new home with a refreshed look.

Accoil Analytics Destination


Destination Info
  • Accepts Page, Alias, Group, Identify and Track calls.
  • Refer to it as Accoil Analytics in the Integrations object
  • This integration is partner owned. Please reach out to the partner's support for any issues.

Accoil(link takes you to an external page) is a product analytics platform built specifically for B2B go-to-market (GTM) teams, like product, sales, marketing, customer success, and support. It enables you to track feature adoption, monitor user journeys, and enhance activation and conversion rates. By sending your product event data to Accoil using Segment, you unlock actionable insights that drive informed decisions across your organization.

For any questions or help with Accoil, contact the Accoil support team(link takes you to an external page).


Benefits of integrating with Accoil

benefits-of-integrating-with-accoil page anchor
  • Comprehensive Analytics: Gain detailed insights into your product's performance across features, customer segments, and stages of the user journey.
  • Enhanced Collaboration: Create account- and user-level audiences that trigger timely actions across tools like Slack, Intercom, HubSpot, and more.
  • Actionable Insights: Teams from sales to customer success can leverage Accoil's data to make informed decisions, improve engagement, and uncover growth opportunities.
  • Seamless Integration: Accoil integrates effortlessly with popular tools like HubSpot, Intercom, Slack, and Segment itself, making it easy to utilize your product data within your existing workflows.
  • User-Friendly Interface: Designed to be intuitive, Accoil allows any team to build and use product engagement profiles without needing advanced analytical skills.

Accoil is most effective when used with Segment. Here's how it functions:

  1. Send event data: Use Segment to funnel your product event data into Accoil. Focus on the events that are most significant to your product and users.
  2. Build engagement profiles: Teams can easily create and manage product engagement profiles, helping monitor feature adoption, user engagement, and buyer journey stages.
  3. Connect to your tools: Once your profiles are set up, Accoil connects to your GTM tools—like Slack, Intercom, HubSpot, and more. With detailed account and user insights, teams can take meaningful actions, like alerting sales about accounts that have reached key milestones or notifying customer success about potential churn risks.

To start using the Accoil destination:

  1. In your Segment workspace, navigate to the Catalog page(link takes you to an external page) and search for "Accoil Analytics".
  2. Select Accoil Analytics from the results and click Add Destination.
  3. Choose the Segment source you want to connect to Accoil.
  4. Navigate to your Accoil dashboard and find your API Key under General Account Settings. Copy this API Key.
  5. Paste the API Key into the Accoil destination settings within Segment, then click "Connect" to complete the integration.

Property nameTypeRequiredDescription
API Keypassword
required

Your Accoil.com API Key. You can find your API Key in your Accoil account settings.


Accoil Analytics has the following presets

Preset NameTriggerDefault Action
Identify CallsEvent type = "identify"Identify
Page CallsEvent type = "page"Page
Track CallsEvent type = "track"Track
Screen CallsEvent type = "screen"Screen
Group CallsEvent type = "group"Group

Build your own Mappings. Combine supported triggers with the following Accoil Analytics-supported actions:

(information)

Mapping limits per destination

Individual destination instances have support a maximum of 50 mappings.

Post to Accoil

post-to-accoil page anchor

Send Data to Accoil Analytics

Post to Accoil is a Cloud action. The default Trigger is type = "track"

This action does not have any fields.

Identify Accounts (groups) in Accoil

Group is a Cloud action. The default Trigger is type = "group"

Property nameTypeRequiredDescription
Anonymous IDSTRING

Optional

Anonymous id


User IDSTRING

Optional

The ID associated with the user


Group IDSTRING
required

The group id


NameSTRING

Optional

The name of the account. Without providing a name, accounts are displayed using a numeric ID, making them harder to identify. (Highly Recommended)


Created atSTRING

Optional

Helps calculate account tenure. If no createdAt is provided, the earliest createdAt from the associated users will be used. (Highly Recommended)


StatusSTRING

Optional

The overall status of your the account subscription. Possible options include: Free, Trial, Paid, Cancelled (Highly Recommended)


PlanSTRING

Optional

The plan type helps in segmenting accounts by their subscription tier (e.g., starter, pro, enterprise). (Recommended)


MRRNUMBER

Optional

Monthly recurring revenue (MRR) is important for segmenting accounts by value. It also allows Accoil to show the dollar value of different segments. Ideally this is passed in cents eg $99 becomes 9900. (Highly Recommended)


TraitsOBJECT

Optional

Optionally send all traits to associate with the user or the group


TimestampSTRING
required

The timestamp of the event

Send page events to Accoil

Page is a Cloud action. The default Trigger is type = "page"

Property nameTypeRequiredDescription
User IDSTRING

Optional

The ID associated with the user


Page NameSTRING

Optional

The name of the page


TimestampSTRING
required

The timestamp of the event

Track a user action in Accoil

Track is a Cloud action. The default Trigger is type = "track"

Property nameTypeRequiredDescription
Event NameSTRING
required

The event name


User IDSTRING
required

The ID associated with the user


TimestampSTRING
required

The timestamp of the event

Send screen events to Accoil

Screen is a Cloud action. The default Trigger is type = "screen"

Property nameTypeRequiredDescription
User IDSTRING

Optional

The ID associated with the user


Screen NameSTRING

Optional

The name of the screen


TimestampSTRING
required

The timestamp of the event

Identify a user in Accoil

Identify is a Cloud action. The default Trigger is type = "identify"

Property nameTypeRequiredDescription
User IDSTRING
required

The ID associated with the user


EmailSTRING

Optional

Email addresses are highly recommended as they are often used to identify users across multiple platforms. (Highly Recommended)


NameSTRING

Optional

Providing a name helps display users in Accoil. If no name is provided, the email address is displayed instead. (Highly Recommended)


RoleSTRING

Optional

Describes the user's role in your product such as Admin, Owner, Team Member. (Suggested)


Account StatusSTRING

Optional

Capturing the account status on the user can be helpful to segment users. Possible options include: Free, Trial, Paid, Cancelled (Suggested)


Created atSTRING

Optional

When was the user created, including this ensures that tenure tracking is accurate. (Highly Recommended)


TraitsOBJECT

Optional

Optionally send all traits to associate with the user or the group


TimestampSTRING
required

The timestamp of the event


Accoil supports the following Segment methods, which map directly to Accoil's API:

Identify calls recognize individual users and their attributes.

Example Call:

1
analytics.identify('userId123', {
2
email: 'user@example.com',
3
name: 'John Doe',
4
createdAt: '2023-05-12T08:00:00Z' // ISO 8601 or Unix timestamp format
5
});

Group calls link users to accounts and records account-level attributes.

Example Call:

1
analytics.group('accountId123', {
2
name: 'Example Company',
3
createdAt: '2021-03-15T09:00:00Z', // ISO 8601 or Unix timestamp format
4
mrr: 3000,
5
status: 'active'
6
});

Track calls record specific user actions, like "Login" or "Purchase".

Use the "Noun_Verb" format to name your events, for example, Report Created or Purchase Completed.

Example Call:

1
analytics.track('Purchase Completed', {
2
item: 'Book',
3
price: 25.00
4
});

Page and Screen calls convert navigation calls into Track events to monitor user interactions within your product.

Example Calls:

1
analytics.page('Home Page');
2
analytics.screen('Dashboard');

  • Created At Date: Ensure the createdAt field for users and accounts is in ISO 8601 or Unix timestamp format for accurate tenure tracking.
  • Trait Handling: Accoil stores traits sent with Identify and Group calls, but traits passed with Track calls are not stored. Only event names and counts are recorded.
  • Event Aggregation: Accoil simplifies event tracking by aggregating daily event counts.
  • Page and Screen Calls: These calls are automatically converted into Track events for easier monitoring of user navigation.

This integration empowers your team to make data-driven decisions, improving your product and customer experiences. For further assistance, please contact the Accoil support team(link takes you to an external page).