Skip to content

Commit 2a9b32b

Browse files
Release 21.49.1
Release 21.49.1
2 parents a3fe3cf + df462b1 commit 2a9b32b

File tree

16 files changed

+141
-99
lines changed

16 files changed

+141
-99
lines changed

src/_data/landing.yml

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ sections:
44
section:
55
- name: Getting started with Segment
66
icon: getting-started.svg
7-
description: "Learn about Segment, work through a basic implementation, plan a full implementation and learn about features and extensions. "
7+
description: "Learn about Segment, plan and work through a basic implementation, and explore features and extensions."
88
path: /getting-started/
99
- section_title: How can Segment help you?
1010
section_col: 6
@@ -19,22 +19,22 @@ sections:
1919
path: /protocols/
2020
- name: Personalize interactions
2121
icon: personas.svg
22-
description: "Improve customer interactions by building audiences to power personalized experiences."
22+
description: "Improve customer interactions by building audiences that power personalized experiences."
2323
path: /personas/
2424
- name: Respect users' privacy
2525
icon: privacy.svg
26-
description: "Use Segment's tools for data discovery and policy enforcement to keep customer data private."
26+
description: "Keep customer data private with Segment's data discovery and policy enforcement tools."
2727
path: /privacy/
2828

2929
- section_title: Get Data into Segment
30-
section_description: "The Segment Spec provides guidance on meaningful data to capture, and the best format for it, across all of our libraries and APIs. When you use these formats it’s simple to send data to downstream tools."
30+
section_description: "The Segment Spec helps you identify, capture, and format meaningful data for use with Segment libraries and APIs as well as downstream tools."
3131
section_col: 4
3232
section:
3333
- name: Segment calls
34-
description: "Use Track, Page, and Identify, and learn about the other calls Segment tracking is built on."
34+
description: "Use Track, Page, Identify, and other Segment tracking calls."
3535
path: /connections/spec/
3636
- name: Common traits
37-
description: "Save time by letting the Segment calls collect information automatically."
37+
description: "Save time by letting Segment calls collect information for you."
3838
path: /connections/spec/common/
3939
- name: Use case specs
4040
description: "Use our business-case specs to ensure that your tools get the most from your data."
@@ -45,17 +45,17 @@ sections:
4545
section:
4646
- name: Segment for Developers
4747
icon: git-repo.svg
48-
description: "An overview of the basics of your Segment implementation."
48+
description: "The basics of your Segment implementation."
4949
path: /guides/intro-impl/
5050
- name: How-To Guides
5151
icon: book.svg
52-
description: "Over a dozen how-to guides to help you accomplish common tasks."
52+
description: "Over a dozen how-to guides that help you accomplish common tasks."
5353
path: /guides/how-to-guides/
5454

5555
- section_title: Connect your app to Segment
5656
section_col: 4
5757
section:
58-
- name: Javascript
58+
- name: JavaScript
5959
path: /connections/sources/catalog/libraries/website/javascript/
6060
- name: HTTP Tracking API
6161
path: /connections/sources/catalog/libraries/server/http-api/

src/_includes/components/feedback.html

Lines changed: 16 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
<div class="flex flex--wrap waffle waffle--large waffle--xxlarge@medium">
2-
<div class="flex__column flex__column--12 flex__column--6@medium flex">
2+
<div class="flex__column flex__column--12 flex__column--4@medium flex">
33
<div class="feedback-box flex flex--stack flex--justify waffle waffle--large@medium">
44
<div class="flex__column flex__column--shrink">
55
<div class="feedback-box__content">
66
<h3>Need support?</h3>
77

8-
<p>Questions? Problems? Need more info? Contact us, and we can help!</p>
8+
<p>Questions? Problems? Need more info? Contact Segment Support for assistance!</p>
99
</div>
1010
</div>
1111

@@ -14,16 +14,24 @@ <h3>Need support?</h3>
1414
</div>
1515
</div>
1616
</div>
17-
18-
<div class="flex__column flex__column--12 flex__column--6@medium flex">
17+
<div class="flex__column flex__column--12 flex__column--4@medium flex">
18+
<div class="flex__column flex__column--shrink">
19+
<div class="feedback-box__content">
20+
<h3>Help improve these docs!</h3>
21+
{%include sidebar/edit-tools.html %}
22+
</div>
23+
</div>
24+
</div>
25+
<div class="flex__column flex__column--12 flex__column--4@medium flex">
1926
<div class="feedback-box flex flex--stack flex--justify waffle waffle--none waffle--large@medium">
2027
<div class="flex__column flex__column--shrink">
2128
<div class="feedback-box__content">
2229
<h3>Was this page helpful?</h3>
2330

2431
<div class="flex gutter gutter--large">
2532
<div class="flex__column flex__column--shrink">
26-
<button class="button button-hollow gutter gutter--small" data-feedback-button="helpful" data-active-class="button-fill button-fill--secondary">
33+
<button class="button button-hollow gutter gutter--small" data-feedback-button="helpful"
34+
data-active-class="button-fill button-fill--secondary">
2735
<span class="button__icon">
2836
{% include icons/symbols/thumb-up.svg %}
2937
</span>
@@ -33,7 +41,8 @@ <h3>Was this page helpful?</h3>
3341
</div>
3442

3543
<div class="flex__column flex__column--shrink">
36-
<button class="button button-hollow gutter gutter--small" data-feedback-button="unhelpful" data-active-class="button-fill button-fill--gray">
44+
<button class="button button-hollow gutter gutter--small" data-feedback-button="unhelpful"
45+
data-active-class="button-fill button-fill--gray">
3746
<span class="button__icon">
3847
{% include icons/symbols/thumb-down.svg %}
3948
</span>
@@ -52,4 +61,5 @@ <h3>Was this page helpful?</h3>
5261
</div>
5362
</div>
5463
</div>
64+
5565
</div>

src/_sass/components/_button.scss

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,4 +39,5 @@
3939
padding: 8px 0px;
4040
text-align: left;
4141
color: #8f95b2;
42+
display: block;
4243
}

src/connections/destination-data-control.md

Lines changed: 24 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,4 +37,27 @@ If you no longer want to track an event, you can either remove it from your code
3737

3838
![](/docs/protocols/images/event-filters.png)
3939

40-
Once you block an event in Segment, we'll stop forwarding it to all of your Destinations, including your warehouses. You can remove it from your code at your leisure. In addition to blocking track calls, Business plan customers can block all Page and Screen calls, as well as Identify traits and Group properties. 
40+
Once you block an event in Segment, Segment stops forwarding it to all of your Destinations, including your warehouses. You can remove it from your code at your leisure. In addition to blocking track calls, Business plan customers can block all Page and Screen calls, as well as Identify traits and Group properties. 
41+
42+
## Export your Source Schema
43+
44+
Segment allows you to download your Source Schema as a CSV file, maximizing portability and access to event data. You can download a copy of your schema by visiting the Source Schema page.
45+
46+
![](images/export-source-schema.png)
47+
48+
CSV files generate based on the current view of your Source Schema. Any search parameters or filters you apply to the current Source Schema view also apply to the CSV.
49+
50+
You can download the following Track events:
51+
- Event Name
52+
- Last Seen (UTC)
53+
- If greater than 30 days, the value is "more than 30 days ago"
54+
- Allowed Count
55+
- Blocked Count
56+
- Total Count
57+
- Planned (available for Protocols customers with a connected Tracking Plan)
58+
- Values are "planned" or "unplanned"
59+
60+
Export Schema is not available for Identify or Group events.
61+
62+
> note ""
63+
> Export Schema doesn't include any actual values (for example, personal data) for the events, properties, and traits you are tracking for a specific source. Properties aren't included in the CSV.

src/connections/destinations/catalog/appcues/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ hide-cmodes: true
1010

1111
1. From the Segment web app, click **Catalog**.
1212
2. Search for "Appcues" in the Catalog, select it, and choose the source you'll connect to the destination.
13-
3. In the destination settings, enter your `Appcues Id` (for client-side integration functionality) and/or your `API Key` (for server-side integration functionality) from the [Appcues account page](https://my.appcues.com/account).
13+
3. In the destination settings, enter your `Account ID` (for client-side integration functionality) and/or your `API Key` (for server-side integration functionality) from the [Appcues account page](https://my.appcues.com/account).
1414

1515
### Server
1616

src/connections/destinations/catalog/braze/index.md

Lines changed: 33 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -137,8 +137,6 @@ Segment sends Page calls to Braze as custom events if you have enabled either **
137137
> info "Tip"
138138
> Add Segment's open-source [Middleware](https://github.com/segmentio/segment-braze-mobile-middleware) tool to optimize your integration. This tool limits [Data Point](https://www.braze.com/docs/user_guide/onboarding_with_braze/data_points/) use by debouncing duplicate identify() calls from Segment. For more information, see the project's [README](https://github.com/segmentio/segment-braze-mobile-middleware/blob/master/README.md#how-does-this-work).
139139

140-
141-
142140
If you're not familiar with the Segment Specs, take a look to understand what the [Identify method](/docs/connections/spec/identify/) does. An example call would look like:
143141
144142
```js
@@ -151,10 +149,42 @@ analytics.identify('ze8rt1u89', {
151149
152150
When you Identify a user, Segment passes that user's information to Braze with `userId` as Braze's External User ID.
153151
154-
If you are using a device-mode connection, Braze's SDK also automatically assigns a `braze_id` to every user. This allows Braze to capture anonymous activity from the device by matching on `braze_id` instead of `userId`. This applies to _device-mode connections_.
152+
If you're using a device-mode connection, Braze's SDK assigns a `device_id` and a backend identifier, `braze_id`, to every user. This allows Braze to capture anonymous activity from the device by matching on those identifiers instead of `userId`. This applies to _device-mode connections_.
155153
156154
To send anonymous user data in cloud-mode, you must manually include the user's `braze_id` in all your Segment API calls in the `integrations.Braze.braze_id` or `context.integrations.Braze.braze_id` object.
157155

156+
### Capture the braze_id of anonymous users
157+
158+
Pass one of the many identifiers that may exist on an anonymous user profile to the [Braze's User by Identifier REST endpoint](https://www.braze.com/docs/api/endpoints/export/user_data/post_users_identifier/){:target='_blank'} to capture and export the `braze_id`. These identifiers include:
159+
- email address
160+
- phone number
161+
- device_id
162+
163+
Choose an identifier that is available on the user profile at that point in the user lifecycle.
164+
165+
For example, if you pass device_id to the User by Identifier endpoint:
166+
167+
```js
168+
{
169+
"device_id": “{{device_id}}",
170+
"fields_to_export": ["braze_id"]
171+
}
172+
```
173+
174+
The endpoint returns:
175+
176+
```js
177+
{
178+
"users": [
179+
{
180+
"braze_id": “{{braze_id}}"
181+
}
182+
],
183+
"message": "success"
184+
}
185+
```
186+
187+
158188
> info "Tip"
159189
> Braze is complex. If you decide to use the `braze_id`, consider [contacting Segment Success Engineering](https://segment.com/help/contact/) or a Solutions Architect to verify your Braze implementation.
160190

src/connections/destinations/catalog/databrain/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ rewrite: true
44
redirect_from: '/connections/destinations/catalog/supervised-ai/'
55
---
66

7-
[DataBrain](https://usedatabrain.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners) is a tool for product-led companies that helps Sales and Customer Success teams close deals, adopt products, and retain customers through data and analytics. It ingests data from Segment and leverages machine learning techniques to send users automated alerts, and predict churn, conversion, and retention on any event you need to track.
7+
[DataBrain](https://usedatabrain.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners) is a tool for product-led companies that helps Sales and Customer Success teams close deals, increase product adoption, and retain customers. DataBrain ingests data from Segment and leverages machine learning techniques to send users automated alerts, and predict churn, conversion, and retention on any event you need to track.
88

99
This destination is maintained by DataBrain. For any issues with the destination, [contact the DataBrain Support team](mailto:[email protected]).
1010

src/connections/destinations/catalog/facebook-app-events/index.md

Lines changed: 30 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -249,10 +249,36 @@ You will have to be sure that the [IDFA](/docs/connections/sources/catalog/libra
249249

250250
Similarly, on Android, you'll need to include the Play Services Ads library as [mentioned here](/docs/connections/sources/catalog/libraries/mobile/android/#how-do-you-handle-unique-identifiers-) in order for the `advertisingId` to populate.
251251

252-
Once you have added these, you will start to see the `context.device.advertisingId` populate and the `context.device.adTrackingEnabled` flag set to `true` unless the user has ad tracking limited or is using a mobile ad blocker.
253-
254-
_Note_: While the network is deprecated, the relevant iOS [framework](https://developer.apple.com/reference/iad) is not.
255-
252+
Once you've added these, you will start to see the `context.device.advertisingId` populate and the `context.device.adTrackingEnabled` flag set to `true` unless the user has ad tracking limited or is using a mobile ad blocker.
253+
254+
> note ""
255+
> While the network is deprecated, the relevant iOS [framework](https://developer.apple.com/reference/iad) is not.
256+
257+
Facebook requires that payloads include the following:
258+
- `context.device.id`
259+
- `context.device.type`
260+
- `context.os.version`
261+
262+
For example:
263+
264+
```json
265+
{
266+
"anonymousId": "507f191e810c19729de860ea",
267+
"event": "Event Name",
268+
​ "context": {
269+
"device": {
270+
"id": "B5372DB0-C21E-11E4-8DFC-AA07A5B093DB",
271+
"type": "ios"
272+
},
273+
"os": {
274+
"version": "8.1.3"
275+
}
276+
},
277+
"messageId": "bbac-11e4-8dfc-aa07a53436b09b45567i8245237824",
278+
"type": "track",
279+
"userId": "97980cfea0067"
280+
}
281+
```
256282

257283
### Missing custom events
258284

src/connections/destinations/catalog/google-analytics/index.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@
22
title: Google Universal Analytics Destination
33
strat: google
44
hide-dossier: true
5+
redirect_from:
6+
- '/connections/destinations/catalog/google-universal-analytics'
57
---
68

79
> warning "Migrate mobile implementations to Firebase"

src/connections/destinations/catalog/index-all.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
22
title: Destination list
3+
hide-dossier: true
34
---
45

56

0 commit comments

Comments
 (0)