Chartbeat Destination

Chartbeat quick info

Chartbeat accepts Page, Alias, Group, Identify, and Track calls. If you reference it in the Integrations object, call it “Chartbeat”.

Chartbeat accepts device-mode data only from Analytics.js.

Our Chartbeat destination code is open-source on GitHub if you want to check it out.

Getting Started

When you enable Chartbeat in the Segment web app, your changes appear in the Segment CDN in about 45 minutes, and then Analytics.js starts asynchronously loading chartbeat.js onto your page. This means you should remove Chartbeat’s snippet from your page.

  • Your Chartbeat real-time dashboard will start showing live concurrent visitors.

Chartbeat is only supported on the client-side.


Page

The page method in Analytics.js will call Chartbeat’s virtualPage function with either the Url you provide or the current window’s pathname. Use the page method if you have a one-page app that doesn’t reload the browser page between views.

You can also set a section and author for each page. For example, analytics.page('putSectionHere', 'putNameOfPageHere', { author: 'putAuthorNameHere' }.

Supported Sources and Connection Modes

Before you start, make sure Chartbeat supports the source type and connection mode you’ve chosen to implement. You can learn more about connection modes here.

Web Mobile Server
📱 Device-mode ⬜️ ⬜️
☁️ Cloud-mode ⬜️ ⬜️ ⬜️

Settings

Segment lets you change these destination settings from the Segment app without having to touch any code.

Setting Description
Domain
(required)
string. The same domain name you entered when adding your site’s dashboard to Chartbeat. Don’t include the www. because Chartbeat handles that for you automatically.
sendNameAndCategoryAsTitle
(required)
boolean, defaults to FALSE .

Chartbeat expects the document.title ( Segment page’s props.title) to populate as title. </br> </br> This setting respects Segment’s legacy behavior of setting the page name and category as title for existing users, but defaults new users to the correct behavior of sending document.title as title to Chartbeat, and allows current users to opt-in to the correct behavior if they chose.
UID
(required)
string. You can find your UID on the Chartbeat Adding The Code page.
Use Chartbeat Video Script boolean, defaults to FALSE .

If you select this option, we’ll load chartbeat_video.js instead of chartbeat.js. The video library has the ability to listen for play/pause events from HTML5 video tags and common 3rd party video players.

This page was last modified: 20 Oct 2020



Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
or
Create free account