Segment
What is Segment?
With Segment, you can collect, transform, send, and archive your first-party customer data. Segment simplifies the process of collecting data and connecting new tools, allowing you to spend more time using your data, and less time trying to collect it. You can use Segment to track events that happen when a user interacts with the interfaces. “Interfaces” is Segment’s generic word for any digital properties you own: your website, mobile apps, and processes that run on a server or OTT device.
When you capture interaction data in Segment, you can send it (often in real-time) to your marketing, product, analytics tools, and data warehouses. In most cases, you won’t even need to touch your tracking code to connect to new tools.
How Segment Works?
In a nutshell, the Segment libraries (Sources) generate messages about what’s happening in your site or app and send them to the Segment servers. The segment then translates the content of those messages into different formats for use by other tools (which the Segment calls Destinations) and sends the translated messages to those tools. The Segment servers also archive a copy of the data and can send data to your storage systems (such as databases, warehouses, or bulk-storage buckets).
How Livelike and Segment will benefit your platform?
When livelike is set as the destination, the segment will send data to livelike, enabling customers to provide rewards and perform automation in response to events that occur within the source application.
Improved User Engagement: Livelike enables customers to offer rewards to their users in response to specific events within their source application. This can help increase user engagement and retention by providing a more personalized and gamified user experience.
Automation: By integrating Segment and Livelike, customers can automate the process of delivering rewards to users based on specific events or triggers within their application. This can save time and resources by eliminating the need for manual intervention.
Enhanced Data Analysis: Segment provides detailed insights and analytics about user behavior and interactions with the source application. By integrating with Livelike, customers can gain further insights into how users engage with reward systems and gamification features, allowing for more informed decision-making and optimization of the user experience.
Flexibility: Both Livelike and Segment are highly customizable and can be tailored to meet the specific needs of each individual customer. This allows for a more personalized and effective approach to engaging users and delivering rewards.
Livelike can be configured as a Source as well as Destination on Segment Dashboard.
How to configure LiveLike as a Destination on Segment Dashboard?
Make sure you have an account with Segment
Make sure you have an account with Segment and have access to their dashboard.
We have made enabling this feature very easy for you and please follow the below steps in LiveLike CMS for integration.
- Navigate to Integrations then look for Segment and click Connect button to start integrating.
- Copy the Client id and Producer Token
From the Segment web app dashboard, navigate to Connections > Catalog. Under the Destinations tab, search for “LiveLike Cloud Mode (Actions)”, and select the destination.
- Click Configure LiveLike button on the top right.
- Select the source that will send data to “LiveLike Cloud Mode (Actions)”, click Next to enter the name of your destination.
- Enter Destination name, select Fill in settings manually and click Save
- Paste the corresponding Client ID and Producer Token. Enable Destination and Save Changes.
Data flow from Segment to Livelike as Destination
Client Side Integration
Before sending events to Segment and making Livelike compatible to accept the data, you will need to send additional properties in the payload.
Refer to LiveLike Cloud Mode (Actions) Destination for more details.
Segment as a source
This integration will enable you to receive related engagement and achievement data from LiveLike into your Segment instance, which can enable and enhance your automated marketing tactics and capabilities as well as augment your analytics and first-party and zero-party data for your users. This is relevant if, for example, you wanted to know when your users earned badges, completed quests, or earned rewards, in real-time.
Enabling Segment source integration with LiveLike
- From your workspace’s Sources catalog page click Add Source.
- Search for LiveLike in the Sources Catalog. Select LiveLike, and click Add Source.
-
Give the Source a name and configure any other settings.
The name is used as a label in the Segment app, and Segment creates a related schema name in your warehouse. The name can be anything, but Segment recommends using something that reflects the source itself and distinguishes amongst your environments (for example, LiveLike_Prod, LiveLike_Staging, LiveLike_Dev).
- Click Add Source to save your settings.
- Copy the Write Key from the Segment UI.
- Provide the write Key to your LiveLike Account Manager so that LiveLike staff can input that write key into the platform to complete the process and enable the integration.
How to configure Segment Source Integration in the LiveLike CMS
- Go to the Integrations tab in the LiveLike CMS.
- Select Segment from the list.
- Enter or paste the Write Key from Segment in the field.
- Press “Connect Segment” for finishing the setup.
Data flow from Segment to LiveLike as a Source
User voted on a poll→ Earned points→ Based on the points → Badge rewarded (info) → Sent to segment
Stream
LiveLike uses Segment’s stream Source component to send Segment event data. It uses a server-side track method(s) to send data to Segment. These events are then available in any destination that accepts server-side events, and available in a schema in your data warehouse, so you can query using SQL.
The default behavior is for LiveLike to pass the userId associated with the event, which usually is your already-known userId, as well as a LiveLike User Profile ID as livelike_profile_id inside the Properties object within the Track event payload.
Events
The table below lists events that LiveLike sends to Segment. These events appear as tables in your warehouse, and as regular events in other Destinations. LiveLike includes the userId if available.
| EVENT NAME | DESCRIPTION |
|---|---|
| Badge Rewarded | When a user receives a badge. |
| Quest Task Completed | When a user completes a Quest Task. |
| Quest Reward Awarded | When a user receives a Reward Item via a Quest Completion. |
| Reward Item Rewarded | When a user is rewarded via a Reward Table. |
| User Quest Task Progressed | When a user progresses a Quest Task. |
| User Quest Completed | When a user completes a Quest. |
Event Properties for Badge Rewarded
The table below lists the properties included in Badge Rewarded event.
| PROPERTY NAME | DESCRIPTION |
|---|---|
| livelike_profile_id | The profile ID of the LiveLike user. |
| badge_id | The ID of the specific Badge the user earned. |
| badge_title | The title of the specific Badge the user earned. |
| description | The description of the specific Badge the user earned. |
| earned_badge_id | The ID of the specific transaction of the user earning the Badge. |
| image_url | The URL of the Badge image. |
| reward_item_id | The ID of the Reward Item that’s associated to the threshold to earn the Badge. |
| reward_item_name | The name of the Reward Item that’s associated to the threshold to earn the Badge. |
| reward_item_threshold | The threshold amount of the Reward Item that’s associated to earning the Badge. |
Event Properties for Quest Task Completed
The table below lists the properties included in the Quest Task Completed event.
| PROPERTY NAME | DESCRIPTION |
|---|---|
| livelike_profile_id | The profile ID of the LiveLike user. |
| quest_id | The ID of the Quest. |
| quest_name | The name of the Quest. |
| quest_task_id | The ID of the specific Task within the Quest that was completed. |
| quest_task_name | The name of the specific Task within the Quest that was completed. |
| user_quest_id | The ID of the specific relationship between the User and that Quest. |
| user_quest_task_id | The ID of the specific relationship between the User and that Quest Task. |
Event Properties for Quest Reward Awarded
The table below lists the properties included in the Quest Reward Awarded event.
| PROPERTY NAME | DESCRIPTION |
|---|---|
| livelike_profile_id | The profile ID of the LiveLike user. |
| quest_id | The ID of the Quest the user completed to earn Rewards (if applicable). |
| quest_name | The name of the Quest the user completed to earn Rewards (if applicable). |
| reward_item_name | The name of the Reward Item that was rewarded. |
| reward_item_amount | The amount of the Reward Item that was rewarded. |
| reward_item_balance | The new balance of the Reward Item for the user. |
| reward_item_id | The ID of the Reward Item that was rewarded. |
| reward_item_transaction_id | The ID of the transaction of the User being rewarded. |
Event Properties for Reward Item Rewarded
The table below lists the properties included in the Reward Item Rewarded event.
| PROPERTY NAME | DESCRIPTION |
|---|---|
| livelike_profile_id | The profile ID of the LiveLike user. |
| reward_item_name | The name of the Reward Item that was rewarded. |
| reward_item_amount | The amount of the Reward Item that was rewarded. |
| reward_item_balance | The new balance of the Reward Item for the user. |
| reward_item_id | The ID of the Reward Item that was rewarded. |
| reward_item_transaction_id | The ID of the transaction of the User being rewarded. |
Event Properties for User Quest Task Progressed
The table below lists the properties included in the User Quest Task Progressed event.
| PROPERTY NAME | DESCRIPTION |
|---|---|
| livelike_profile_id | The profile ID of the LiveLike user. |
| quest_id | The ID of the Quest. |
| quest_name | The name of the Quest. |
| quest_task_id | The ID of the specific Task within the Quest that was completed. |
| quest_task_name | The name of the specific Task within the Quest that was completed. |
| quest_task_target_value | The target number of times this Task needs to be done to complete the Task. |
| user_quest_id | The ID of the specific relationship between the User and that Quest. |
| user_quest_task_id | The ID of the specific relationship between the User and that Quest Task. |
| user_quest_task_progress | The number of times this Task has been done so far. |
Event Properties for User Quest Completed
The table below lists the properties included in the User Quest Completed event.
| PROPERTY NAME | DESCRIPTION |
|---|---|
| livelike_profile_id | The profile ID of the LiveLike user. |
| quest_id | The ID of the Quest. |
| quest_name | The name of the Quest. |
| user_quest_id | The ID of the specific relationship between the User and that Quest. |
Client Side Integration
Before sending evens to Segment and make Livelike compatible to accept the data, you will need to send additional properties in the payload
Refer LiveLike Cloud Mode (Actions) Destination for more details.
Updated 5 months ago
You will successfully complete Livelike as Destination and Source on Segment after completing all the above steps. The next step is to set up the Rewards. Please read this documentation to set up rewards.