Bucket Web (Actions) Destination
Additional versions of this destination are available
This page is about the Bucket Web (Actions) Destination. See below for information about other versions of the Bucket destination:
Bucket is a feature-focused analytics software that empowers software teams with a repeatable approach to shipping features that satisfy customers.
Bucket maintains this destination. For any issues with the destination, contact the Bucket Support team.
If you are using both the Bucket Web (Actions) destination and the server side Bucket destination on the same source, avoid duplicate event tracking by disabling the “Track Event” mapping in Bucket Web (Actions).
Benefits of Bucket Web (Actions) compared to Bucket Classic
Bucket Web (Actions) provides the following benefits over the classic Bucket destination:
- Clearer mapping of data. Actions-based destinations let you define the mapping between the data Segment receives from your source and the data Segment sends to the destination.
- Automatically enables Live Satisfaction prompts in your app, giving you fully-automated customer satisfaction scores and feedback on your features.
Getting started
- From the Destinations catalog page in the Segment App, click Add Destination.
- Search for “Bucket Web” in the Destinations Catalog, and select the Bucket Web (Actions) destination.
- Select a source to send data to the Bucket destination.
- Go to Bucket’s Settings and find and copy the Publishable Key on the Tracking page.
- Enter the Publishable Key as Publishable Key in the “Bucket Web (Actions)” destination settings in Segment.
Destination Settings
| Setting | Description |
|---|---|
| Publishable Key | Required. The publishable key for your Bucket environment, found on the tracking page on app.bucket.co. |
Available Presets
Bucket Web (Actions) has the following presets:
| Preset Name | Trigger | Default Action |
|---|---|---|
| Group | Event type = "group" |
Identify Company |
| Track Event | Event type = "track" |
Track Event |
| Identify User | Event type = "identify" |
Identify User |
Available Actions
Build your own Mappings. Combine supported triggers with the following Bucket Web-supported actions:
Mapping limits per destination
Individual destination instances have support a maximum of 50 mappings.
Track Event
Map a Segment track() event to Bucket
Track Event is a Web action. The default Trigger is: type = "track"
| Field | Description |
|---|---|
| Event name* | Type: STRINGThe event name |
| User ID* | Type: STRINGUnique identifier for the user |
| Event Properties | Type: OBJECTObject containing the properties of the event |
Identify Company
Creates or updates a Company in Bucket and associates the user with it
Identify Company is a Web action. The default Trigger is: type = "group"
| Field | Description |
|---|---|
| Company ID* | Type: STRINGUnique identifier for the company |
| User ID* | Type: STRINGUnique identifier for the user |
| Company Attributes | Type: OBJECTAdditional information to associate with the Company in Bucket |
Identify User
Creates or updates a user profile in Bucket. Also initializes Live Satisfaction
Identify User is a Web action. The default Trigger is: type = "identify"
| Field | Description |
|---|---|
| User ID* | Type: STRINGUnique identifier for the User |
| User Attributes | Type: OBJECTAdditional information to associate with the User in Bucket |
Content security policies (CSP)
If you are running with strict Content Security Policies active on your website, you must enable these directives in order to use this destination:
| Directive | Values | Module | Reason |
|---|---|---|---|
| script-src-elem | https://cdn.jsdelivr.net | bootstrap | Loads the Bucket tracking SDK from a CDN |
| connect-src | https://tracking.bucket.co | tracking | Used for all tracking methods: analytics.identify(), analytics.group() and analytics.track() |
| connect-src | https://livemessaging.bucket.co | live satisfaction | Server sent events from the Bucket Live Feedback service, which allows for automatically collecting feedback when a user used a feature. |
| style-src | ‘unsafe-inline’ | feedback UI | The feedback UI is styled with inline styles. Not having this directive results unstyled HTML elements. |
As HTTP-header:
Content-Security-Policy: script-src-elem https://cdn.jsdelivr.net; connect-src https://livemessaging.bucket.co https://tracking.bucket.co; style-src 'unsafe-inline'
As <meta>-tag:
<meta http-equiv="Content-Security-Policy" content="script-src-elem https://cdn.jsdelivr.net; connect-src https://livemessaging.bucket.co https://tracking.bucket.co; style-src 'unsafe-inline'">
Settings
Segment lets you change these destination settings from the Segment app without having to touch any code.
| Setting | Description |
|---|---|
| Publishable Key (required) |
string. The publishable key for your Bucket environment, found on the tracking page on app.bucket.co. |
This page was last modified: 15 May 2024
Need support?
Questions? Problems? Need more info? Contact Segment Support for assistance!