|
1 | 1 | title: Shopify - Powered by Fueled
|
2 | 2 | ---
|
3 | 3 |
|
4 |
| -[Fueled](https://fueled.io){:target="_blank"} is a 1st-party Attribution Suite, designed specifically for eCommerce. Fueled collects all of the first-party and zero-party events that fire on a Shopify website, and sends them to Segment. Fueled leverages a combination of "client-side" and "server-side" event tracking to provide reliable, accurate event tracking in Segment. Fueled tracks "offline purchase events, such as point-of-sale orders and subscription rebilling events triggered by apps like ReCharge Payments, Smartrr, Bold Subscritions, and Skio. |
| 4 | +[Fueled](https://fueled.io){:target="_blank"} is a 1st-party event collector, designed specifically for eCommerce. Fueled captures the first-party and zero-party events that fire on a Shopify website, and sends them to various destinations - most notably, Segment. Fueled leverages a combination of "client-side" and "server-side" event collection technologies to provide reliable, accurate event tracking. In addition to tracking website events in the browser, Fueled tracks "offline" purchase events, such as point-of-sale orders and subscription rebilling events triggered by Shopify apps like ReCharge Payments, Smartrr, Bold Subscritions, and Skio. |
5 | 5 |
|
6 | 6 | With Fueled, Shopify merchants can implement Segment event tracking in minutes — without writing any code.
|
7 | 7 |
|
| 8 | +**Shopify merchants can try our Segment integration for free for 15 days.** |
| 9 | + |
8 | 10 | This integration is maintained by [Fueled ](https://fueled.io){ :target=" _blank"}. [Contact the Fueled Support team ](mailto:[email protected]) with any questions.
|
9 | 11 |
|
10 | 12 | ## Getting started
|
11 | 13 |
|
12 |
| -Installing Fueled's Shopify integration for Segment is a 2-step process: |
| 14 | +Installing Fueled's Shopify Source integration for Segment is a 2-step process: |
13 | 15 |
|
14 | 16 | ### Adding the "Shopify - Powered by Fueled" Source in Segment
|
15 | 17 |
|
16 | 18 | 1. From your workspace's [Sources catalog page](https://app.segment.com/goto-my-workspace/sources/catalog){:target="_blank”} click **Add Source**.
|
17 |
| -2. Search for "Shopify - Powered by Fueled" in the Sources Catalog, select "Shopify - Powered by Fueled", and click **Add Source**. |
18 |
| -3. On the next screen, give the Source a nickname. |
19 |
| -4. Click **Add Source** to save your settings. |
20 |
| -5. Copy the Write key from the Segment UI. |
| 19 | +2. Find "Shopify - Powered by Fueled" in the Segment Sources Catalog, and click **Add Source**. |
| 20 | +3. Give your Shopify Source a "nickname" and click **Save**. |
| 21 | +4. Copy the Write key from the Segment UI. |
21 | 22 |
|
22 | 23 | ### Enabling the "Fueled Attribution Suite" in Shopify
|
23 | 24 |
|
24 | 25 | 1. **Log in** to your Shopify Store account.
|
25 | 26 | 2. Go the [Shopify app store listing](https://apps.shopify.com/fueled-attribution-suite){:target="_blank”} for ***Fueled Attribution Suite***.
|
26 | 27 | 3. Click **Add app** to install the Fueled Attribution Suite.
|
27 | 28 | 4. Within the Fueled App in the Shopify Admin UI, click into the **Plans** tab and choose the **Fueled Advanced Plan**.
|
28 |
| -5. Once you have confirmed your Fueled Advanced Plan, go to the **Segment** tab and add |
29 |
| -6. Add the Segment Write key for the source that is going to send data in the **Segment Writekey** field form. |
| 29 | +5. Once you have confirmed your Fueled Advanced Plan, go to the **Segment** tab. |
| 30 | +6. Add the Segment Write key for the Segment Source that is going to send data in the **Segment Writekey** field form. |
30 | 31 | 7. Configure client-side and server side tracking settings in the **Tracking Setup** tab.
|
31 | 32 |
|
32 | 33 | ## Stream
|
33 | 34 |
|
34 |
| -> (delete after reading) Clarify the type of Segment events your integration will send. |
| 35 | +Fueled's Shopify Source streams events into Segment. It uses server-side methods to send `track` , `identify` , and `page` events to Segment. These events are then available in any Segment Destination that accepts server-side events, and are available in a schema in your data warehouse, so you can query using SQL. |
35 | 36 |
|
36 |
| -<integration_name> uses our stream Source component to send Segment event data. It uses a server-side (select from `track`, `identify`, `page`, `group`) 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. |
| 37 | +The default behavior is for Fueled to pass the email address of identified users as the Segment `userId` , when it's available. |
37 | 38 |
|
38 |
| -> (delete after reading) Clarify how your integration includes user identifiers in your event payloads, the example below is from Klaviyo: |
| 39 | +## Events |
39 | 40 |
|
40 |
| -The default behavior is for Klaviyo to pass the userId associated with the email recipient as the userId. There are cases in which Klaviyo does not have an associated userId, in which case the email address will be passed in as the anonymousId. |
| 41 | +The table below lists events that Fueled's Shopify Source automatically sends to Segment. These events appear as tables in your warehouse, and as regular events in other Destinations. Fueled's Shopify Source includes the `userId` (the Shoper customer's email address) if available. |
41 | 42 |
|
42 |
| -> (delete after reading) For each of the below sections, populate the event and properties that a customer would expect to receive in their downstream tools from your Event Source. |
| 43 | +Fueled's Shopify Source also supports *custom events* captured client-side by our javascript library and sent to Segment. To learn more about sending custom events to Segment, visit this [Learning Center article](https://learn.fueled.io/apps/shopify/shopify-event-tracking/customizing-client-side-shopify-events){:target="_blank”}. |
43 | 44 |
|
44 |
| -## Events |
| 45 | +### Fueled Standard Events |
45 | 46 |
|
46 |
| -The table below lists events that <integration_name> sends to Segment. These events appear as tables in your warehouse, and as regular events in other Destinations. <integration_name> includes the `userId` if available. |
| 47 | +Fueled's Shopify Source integration follows Segment's [eCommerce event specification](https://segment.com/docs/connections/spec/ecommerce/v2/){:target="_blank”}. |
47 | 48 |
|
48 |
| -| Event Name | Description | |
49 |
| -| ------------------ | ------------------------------------- | |
50 |
| -| Email Sent | Email was sent successfully | |
51 |
| -| Email Opened | Prospect opened the email | |
52 |
| -| Link Clicked | Prospect clicked the tracking link | |
53 |
| -| Email Replied | Prospect replied to email sent | |
54 |
| -| Email Bounced | Email servers rejected the email | |
55 |
| -| Email Unsubscribed | Prospect clicked the unsubscribe link | |
| 49 | +Automatically tracked events are listed below: |
56 | 50 |
|
| 51 | +| Event Name | Description | |
| 52 | +| -------------------- | ------------------------------------------------ | |
| 53 | +| Page | User viewed a page on the website | |
| 54 | +| Identify | User identified themselves via log-in, account creation, or email signup | |
| 55 | +| Account Created | User created an account | |
| 56 | +| Account Updated | User updated their account | |
| 57 | +| Cart Viewed | User viewed their shopping cart | |
| 58 | +| Checkout Started | User initiated the order process | |
| 59 | +| Order Completed | User completed the order | |
| 60 | +| Order Updated | User updated the order | |
| 61 | +| Product Added | User added a product to their shopping cart | |
| 62 | +| Product Removed | User removed a product from their shopping cart | |
| 63 | +| Product List Viewed | User viewed a product list or collection | |
| 64 | +| Product Viewed | User viewed a product details | |
| 65 | +| Products Searched | User searched for products | |
57 | 66 |
|
58 | 67 | ## Event Properties
|
59 | 68 |
|
60 |
| -The table below list the properties included in the events listed above. |
| 69 | +For a complete list of all event properties and how they map to specific Shopify Storefront APIs and objects, visit: [Fueled's Shopify-to-Segment Mapping Documentation](https://learn.fueled.io/integrations/destinations/segment.com/segment-event-specifications){:target="_blank”}. |
| 70 | + |
| 71 | +## Headless Shopify Integrations |
| 72 | + |
| 73 | +Fueled can be implemented on "headless" or "composable" Shopify sites. Fueled provides out-of-the-box integrations for: |
| 74 | + |
| 75 | +* Pack Digital composable Shopify sites |
| 76 | +* Headless Shopify sites running on TakeShape.io |
| 77 | +* Composable Shopify sites running on Next Commerce |
| 78 | + |
| 79 | +Contact [Fueled ](mailto:[email protected]) for more information on these composable integrations. |
| 80 | + |
| 81 | +## Additional Shopify App Source Integrations for Segment |
| 82 | + |
| 83 | +Fueled offers Segment Source integrations for a number of Shopify Marketplace apps. These integrations are available by contacting Fueled's customer support team at: [[email protected]](mailto:[email protected]). |
| 84 | + |
| 85 | +Additional Segment integrations powered by Fueled include: |
61 | 86 |
|
62 |
| -| Property Name | Description | |
63 |
| -| --------------- | ------------------------- | |
64 |
| -| `event` | Email event type | |
65 |
| -| `userId` | Prospect user ID | |
66 |
| -| `email_id` | ID of the email | |
67 |
| -| `from_id` | Sender email ID | |
68 |
| -| `email_subject` | Subject line of the email | |
69 |
| -| `link` | URL of the link clicked | |
70 |
| - |
| 87 | +* ReCharge Payments subscription events (`subscription_created`, `subscription_paused`, `subscription_canceled`) |
| 88 | +* Yotpo Reviews (`product_review_created`, `product_review_updated`, `site_review_created`, `site_review_updated`) |
| 89 | +* Gorgias customer support events (`ticket_created`, `ticket_updated`) |
| 90 | +* Loop Returns webhook events |
71 | 91 |
|
72 | 92 | ## Adding Destinations
|
73 | 93 |
|
74 |
| -Now that your Source is set up, you can connect it with Destinations. |
| 94 | +Now that your Shopify Source is set up, you can connect it with Destinations. |
75 | 95 |
|
76 | 96 | 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.
|
77 | 97 |
|
|
0 commit comments