Skip to content

Commit e33eacd

Browse files
author
Thomas Gilbert
committed
adding livelike source docs to correct integration folder
1 parent 0d341b6 commit e33eacd

File tree

2 files changed

+133
-7
lines changed
  • src/connections/sources/catalog/cloud-apps

2 files changed

+133
-7
lines changed

‎src/connections/sources/catalog/cloud-apps/livelike-source/index.md

Lines changed: 133 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,134 @@
11
---
2-
title: 'LiveLike (Source) Source'
3-
hidden: true
4-
---
2+
title: LiveLike Source
3+
id: EjYD7n6dOa
4+
---
5+
6+
[LiveLike](https://livelike.com/){:target="_blank"} is a technology company dedicated to empowering digital experiences that enable deeper fan engagement, increased retention rates, and new monetization opportunities.
7+
8+
This integration will enable you to receive related engagement and achievements from LiveLike into your Segment warehouse, which can enable and enhance your automated marketing tacics and capabilities as well as augment your analytics and first-party data for your users.
9+
10+
This source is maintained by LiveLike. For any issues with the source, [contact their Support team](mailto:[email protected]).
11+
12+
## Getting started
13+
14+
1. From your workspace's [Sources catalog page](https://app.segment.com/goto-my-workspace/sources/catalog) click **Add Source**.
15+
2. Search for "LiveLike" in the Sources Catalog, select LiveLike, and click **Add Source**.
16+
3. On the next screen, give the Source a nickname configure any other settings.
17+
18+
- The nickname is used as a label in the Segment app, and Segment creates a related schema name in your warehouse. The nickname can be anything, but we recommend using something that reflects the source itself and distinguishes amongst your environments (eg. LiveLike_Prod, LiveLike_Staging, LiveLike_Dev).
19+
20+
4. Click **Add Source** to save your settings.
21+
5. Copy the Write key from the Segment UI.
22+
6. In order to enable the integration, provide thhis Write Key to your LiveLike Account Manager so that LiveLike staff can input that Write Key into the platform to complete the process.
23+
24+
## Stream
25+
26+
LiveLike uses our 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.
27+
28+
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.
29+
30+
## Events
31+
32+
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.
33+
34+
| Event Name | Description |
35+
| ------------------ | ------------------------------------- |
36+
| Badge Rewarded | When a user receives a badge |
37+
| Quest Task Completed | When a user completes a Quest Task |
38+
| Quest Reward Awarded | When a user receives a Reward Item via a Quest Completion |
39+
| Reward Item Rewarded | When a user is rewarded via a Reward Table |
40+
| User Quest Task Progressed | When a user progresses a Quest Task |
41+
| User Quest Completed | When a user completes a Quest |
42+
43+
## Event Properties for Badge Rewarded
44+
45+
The table below list the properties included in the events listed above.
46+
47+
| Property Name | Description |
48+
| --------------- | ------------------------- |
49+
| `livelike_profile_id` | Profile ID of the LiveLike user |
50+
| `badge_id` | ID of the specific Badge the user earned |
51+
| `badge_title` | Title of the specific Badge the user earned |
52+
| `description` | Description of the specific Badge the user earned |
53+
| `earned_badge_id` | ID of the specific transaction of the user earning the Badge |
54+
| `image_url` | URL of the Badge image |
55+
| `reward_item_id` | ID of the Reward Item that's associated to the threshold to earn the Badge |
56+
| `reward_item_name` | Name of the Reward Item that's associated to the threshold to earn the Badge |
57+
| `reward_item_threshold` | Threshold amount of the Reward Item that's associated to earning the Badge |
58+
59+
## Event Properties for Quest Task Completed
60+
61+
The table below list the properties included in the events listed above.
62+
63+
| Property Name | Description |
64+
| --------------- | ------------------------- |
65+
| `livelike_profile_id` | Profile ID of the LiveLike user |
66+
| `quest_id` | ID of the Quest |
67+
| `quest_name` | Name of the Quest |
68+
| `quest_task_id` | ID of the specific Task within the Quest that was completed |
69+
| `quest_task_name` | Name of the specific Task within the Quest that was completed |
70+
| `user_quest_id` | ID of the specific relationship between the User and that Quest |
71+
| `user_quest_task_id` | ID of the specific relationship between the User and that Quest Task |
72+
73+
## Event Properties for Quest Reward Awarded
74+
75+
The table below list the properties included in the events listed above.
76+
77+
| Property Name | Description |
78+
| --------------- | ------------------------- |
79+
| `livelike_profile_id` | Profile ID of the LiveLike user |
80+
| `quest_id` | ID of the Quest the user completed to earn Rewards (if applicable) |
81+
| `quest_name` | Name of the Quest the user completed to earn Rewards (if applicable) |
82+
| `reward_item_name` | Name of the Reward Item that was rewarded |
83+
| `reward_item_amount` | Amount of the Reward Item that was rewarded |
84+
| `reward_item_balance` | The new balance of the Reward Item for the user |
85+
| `reward_item_id` | ID of the Reward Item that was rewarded |
86+
| `reward_item_transaction_id` | ID of the transaction of the User being rewarded |
87+
88+
## Event Properties for Reward Item Rewarded
89+
90+
The table below list the properties included in the events listed above.
91+
92+
| Property Name | Description |
93+
| --------------- | ------------------------- |
94+
| `livelike_profile_id` | Profile ID of the LiveLike user |
95+
| `reward_item_name` | Name of the Reward Item that was rewarded |
96+
| `reward_item_amount` | Amount of the Reward Item that was rewarded |
97+
| `reward_item_balance` | The new balance of the Reward Item for the user |
98+
| `reward_item_id` | ID of the Reward Item that was rewarded |
99+
| `reward_item_transaction_id` | ID of the transaction of the User being rewarded |
100+
101+
## Event Properties for User Quest Task Progressed
102+
103+
The table below list the properties included in the events listed above.
104+
105+
| Property Name | Description |
106+
| --------------- | ------------------------- |
107+
| `livelike_profile_id` | Profile ID of the LiveLike user |
108+
| `quest_id` | ID of the Quest |
109+
| `quest_name` | Name of the Quest |
110+
| `quest_task_id` | ID of the specific Task within the Quest that was completed |
111+
| `quest_task_name` | Name of the specific Task within the Quest that was completed |
112+
| `quest_task_target_value` | Target number of times this Task needs to be done to complete the Task |
113+
| `user_quest_id` | ID of the specific relationship between the User and that Quest |
114+
| `user_quest_task_id` | ID of the specific relationship between the User and that Quest Task |
115+
| `user_quest_task_progress` | Number of times this Task has been done so far |
116+
117+
## Event Properties for User Quest Completed
118+
119+
The table below list the properties included in the events listed above.
120+
121+
| Property Name | Description |
122+
| --------------- | ------------------------- |
123+
| `livelike_profile_id` | Profile ID of the LiveLike user |
124+
| `quest_id` | ID of the Quest |
125+
| `quest_name` | Name of the Quest |
126+
| `user_quest_id` | ID of the specific relationship between the User and that Quest |
127+
128+
## Adding Destinations
129+
130+
Now that your Source is set up, you can connect it with Destinations.
131+
132+
Log into your downstream tools and check to see that your events appear as expected, and that they contain all of the properties you expect. If your events and properties don’t appear, check the [Event Delivery](/docs/connections/event-delivery/) tool, and refer to the Destination docs for each tool for troubleshooting.
133+
134+
If there are any issues with how the events are arriving to Segment, [contact the LiveLike support team](mailto:[email protected]).

‎src/connections/sources/catalog/cloud-apps/livelike/index.md

Lines changed: 0 additions & 4 deletions
This file was deleted.

0 commit comments

Comments
 (0)