You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ destinationInfo.display_name }} {{ destinationInfo.connection_modes.summary }} {% if destinationInfo.connection_modes.case == "mixed" %} {{destinationInfo.display_name}} accepts device-mode data from {% if destinationInfo.connection_modes.device.mobile and destinationInfo.connection_modes.device.web %} mobile and web{% elsif destinationInfo.connection_modes.device.mobile %} mobile{% elsif destinationInfo.connection_modes.device.web %} web{% endif %} sources.{% endif %} {% if destinationInfo.browserUnbundlingSupported %} You can change the {{destinationInfo.display_name}} connection mode for Analytics.js sources from the destination settings in the Segment web app.
36
+
If you reference it in the <ahref="/docs/guides/filtering-data/#filtering-with-the-integrations-object">Integrations object</a>, call it “{{destinationInfo.previous_names | join: '", or "' }}”.
Friendbuy is a referral marketing and campaign optimization platform.
4
6
5
7
## Getting Started
6
8
7
-
Setting up Friendbuy is very simple!
9
+
{% include content/connection-modes.md %}
8
10
9
11
1. Log in to your Friendbuy account and go to **Integration Code**.
10
12
2. Copy the **Site ID** above the snippet box.
@@ -15,34 +17,35 @@ Setting up Friendbuy is very simple!
15
17
16
18
This destination allows you to:
17
19
18
-
- Map your Page calls to facilitate [Widget Management](http://developers.friendbuy.com/#widget-management)
19
-
- Map your Identify calls to facilitate [Customer Tracking](http://developers.friendbuy.com/#customer-tracking)
20
-
- Map your Track calls to facilitate [Order Tracking](http://developers.friendbuy.com/#order-tracking) and [Product Tracking](http://developers.friendbuy.com/#product-tracking)
20
+
- Map your Page calls to enable [Widget Management](http://developers.friendbuy.com/#widget-management)
21
+
- Map your Identify calls to enable [Customer Tracking](http://developers.friendbuy.com/#customer-tracking)
22
+
- Map your Track calls to enable [Order Tracking](http://developers.friendbuy.com/#order-tracking) and [Product Tracking](http://developers.friendbuy.com/#product-tracking)
23
+
21
24
22
-
----------
23
25
## Page
24
26
25
27
To load specific widgets on different web pages, you can configure your settings to map your _named_ Page call(s) to specific Friendbuy Widget(s). You can also configure a several optional [advanced widget configurations](http://developers.friendbuy.com/#widget-options) such as **auto delay** and **custom parameters**.
26
28
27
-
<!-- TODO: convert this long gif into text instrucitons.
Friendbuy has two Widgets you can map to your Page calls:
31
+
32
+
**Site Wide Widgets**
33
+
34
+
Friendbuy recommends you to load these widgets on all your web pages. To use these widgets, you can add them under the *Side Wide Widgets* setting.
31
35
32
-
There are two types of Widgets you can map to your Page calls:
36
+
> info ""
37
+
> You don't need to map a site wide widget if the **Call To Action** type is a ribbon served by Friendbuy. This overlay widget loads when Segment loads the Friendbuy library.
33
38
34
-
- Site Wide Widgets
35
-
- These types of widgets are recommended by Friendbuy to load on all your webpages. If you wish to use these types of widgets, you can add them under the *Side Wide Widgets* setting. _NOTE_: You are NOT required to map a site wide widget if the **Call To Action** type is a ribbon served by Friendbuy. This type of overlay widget will just load when we boot up Friendbuy's library.
39
+
**Other widgets**
36
40
37
-
- Other widgets
38
-
- All other widgets will fall under this category whereby you can map the `name` of a unique Segment `.page()` call to a widget ID.
41
+
All other widgets will fall under this category whereby you can map the `name` of a unique Segment `.page()` call to a widget ID.
39
42
40
-
_NOTE_: If you have mapped a site wide overlay widget loads on every `.page()` call, even if we have loaded a different widget on the page that you have explicitly mapped.
43
+
> info ""
44
+
> If you have mapped a site wide overlay widget, it loads on every `.page()` call.
41
45
42
-
----------
43
46
## Identify
44
47
45
-
When you call `.identify()`, we will send the following mapped traits:
48
+
When you call `.identify()`, Segment sends the following mapped traits:
46
49
47
50
|**Segment Traits**|**Friendbuy Standard Fields**|
This Destination accepts only `Order Completed` events as decribed in our [ecommerce spec](https://segment.com/docs/connections/spec/ecommerce/v2/#order-completed).
90
+
This Destination accepts `Order Completed` events as described in the Segment [ecommerce spec](/docs/connections/spec/ecommerce/v2/#order-completed).
88
91
89
92
Friendbuy has a concept of [Order Tracking](http://developers.friendbuy.com/#order-tracking) and [Product Tracking](http://developers.friendbuy.com/#product-tracking) where the former describes how to send data about the top level order whereas the latter documents instructions on sending data about each of the product within that order.
90
93
91
-
When sending the order details, we will make the following translation:
94
+
When you send order details, Segment makes the following translation:
92
95
93
96
|**Segment Properties**|**Friendbuy Standard Fields**|
@@ -97,7 +100,7 @@ When sending the order details, we will make the following translation:
97
100
|`revenue`|`amount`|
98
101
|`coupon`|`coupon_code`|
99
102
100
-
Then we will iterate over each item in your `properties.products` and send the following mapping:
103
+
Then Segment iterates over each item in your `properties.products` and send the following mapping:
101
104
102
105
103
106
|**Segment Properties**|**Friendbuy Standard Fields**|
@@ -106,12 +109,12 @@ Then we will iterate over each item in your `properties.products` and send the f
106
109
|`price`|`price`|
107
110
|`quantity`|`quantity`|
108
111
109
-
**NOTE**: You can optionally specify if the customer who made the order is a new customer by passing `new_customer` under your integration specific options:
110
-
111
-
```js
112
-
integrations: {
113
-
Friendbuy: {
114
-
newCustomer:true,
115
-
}
116
-
}
117
-
```
112
+
> info ""
113
+
> You can optionally specify if the customer who made the order is a new customer by passing `new_customer` under your integration specific options:
Copy file name to clipboardexpand all lines: src/connections/sources/catalog/libraries/website/javascript/custom-proxy.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -120,7 +120,7 @@ You need the "Domain Name" for the next step, so keep this browser window open.
120
120
121
121
#### Add CNAME Record to DNS
122
122
123
-
Next, add a CNAME record to your DNS settings. Go to your domain registrar and add a new record to your DNS of type "CNAME".
123
+
Next, add a CNAME record for the Segment proxy to your organizations DNS settings. Use a name that makes it clear what you are using the subdomain for, for example `analytics.mysite.com`. Go to your domain registrar and add a new record to your DNS of type "CNAME".
0 commit comments