Skip to content

Commit e21582a

Browse files
authored
Merge pull request #122 from segmentio/repo-sync
repo sync
2 parents 0283764 + b27f1d7 commit e21582a

File tree

227 files changed

+698
-729
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

227 files changed

+698
-729
lines changed

_config.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ defaults:
4242

4343
collections:
4444
release_notes:
45-
output: true
45+
output: false
4646
permalink: /:collection/:name
4747

4848
plugins_dir: ./_plugins

lychee.toml

+1-1
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ headers = []
5050
### Exclusions
5151
###
5252
# Exclude URLs from checking (supports regex)
53-
exclude = ['https://ajs.cd.segment.com/analytics.js/v1/','http://0.0.0.0:4000','https://api.segment.io/v1/', 'https://segment.com/docs/assets/docs.bundle.js','https://www.linkedin.com', 'https://segment.com/jobs/', 'https://segment.com/press/', 'https://github.com/segmentio', 'https://unpkg.com/@segment/[email protected]/standalone/consent-manager.js', '(segment.com)', '(segmentapis.com)', '(example.com)', '(schema.org)','(maxcdn)']
53+
exclude = ['(acme.com)','(webhooks.company.com)','(your-webhook-url)','https://segment.zendesk.com','(example-service)','(redacted)','(foo)','http://dl.bintray.com/swrve-inc/android','https://ajs.cd.segment.com/analytics.js/v1/','http://0.0.0.0:4000','https://api.segment.io/v1/', 'https://segment.com/docs/assets/docs.bundle.js','https://www.linkedin.com', 'https://segment.com/jobs/', 'https://segment.com/press/', 'https://github.com/segmentio', 'https://unpkg.com/@segment/[email protected]/standalone/consent-manager.js', '(segment.com)', '(segmentapis.com)', '(example.com)', '(schema.org)','(maxcdn)', '(your-org-name)', '(mywebsite)']
5454

5555
# Exclude URLs contained in a file from checking
5656
exclude_file = []

src/_includes/content/ajs-upgrade.md

+3
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
<div class="premonition success"><div class="fa fa-check-square"></div><div class="content"><p class="header">Upgrade to Analytics.js 2.0</p>
2+
<p markdown=1>Actions-based destinations require features found in [Analytics.js 2.0](/docs/connections/sources/catalog/libraries/website/javascript/). [Upgrade your Analytics.js](/docs/connections/sources/catalog/libraries/website/javascript/upgrade-to-ajs2/) source to take advantage of Actions-based destinations, performance improvements, and more.</p>
3+
</div></div>
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
{% capture name %}{{page.title | replace: 'Destination', ''}}{% endcapture %}
2+
{% capture link %}/docs/connections/destinations/catalog/actions-{{name | slugify}}{% endcapture %}
3+
{% if page.maintenance-content %}
4+
{% capture blurb %}{{page.maintenance-content}} {% endcapture %}
5+
{% else %}
6+
{% capture blurb %}A new version of this destination is available. See [{{name}} (Actions)]({{link}}) {% endcapture %}
7+
{% endif %}
8+
9+
<div class="premonition warning"><div class="fa fa-check-square"></div><div class="content"><p class="header">{{page.title | replace: 'Destination', ''}} (Classic) is in Maintenance mode</p>
10+
<p markdown=1>The {{name}} (Classic) Destination has entered maintenance mode. Future updates are limited to security updates and bug fixes. {{blurb}}</p>
11+
</div></div>

src/_includes/menu/menu-mobile.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -18,15 +18,15 @@
1818
</a>
1919
</li>
2020

21-
<li class="menu-item">
21+
<!-- <li class="menu-item">
2222
<a class="menu-item__link menu-item__link--highlight menu-item__link--icon flex flex--middle" href="{{ site.baseurl }}/release-notes/">
2323
<div class="menu-item__icon flex__column">
2424
{% include icons/megaphone.svg %}
2525
</div>
2626
2727
<div class="flex__column">Release Notes</div>
2828
</a>
29-
</li>
29+
</li> -->
3030
</ul>
3131
</nav>
3232
</div>

src/_includes/menu/menu.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -26,15 +26,15 @@
2626
</a>
2727
</li>
2828

29-
<li class="menu-item {% if currentPage == "release-notes" %}menu-item--active{% endif %}">
29+
<!-- <li class="menu-item {% if currentPage == "release-notes" %}menu-item--active{% endif %}">
3030
<a class="menu-item__link menu-item__link--highlight menu-item__link--icon flex flex--middle" href="{{ site.baseurl }}/release-notes/">
3131
<div class="menu-item__icon flex__column">
3232
{% include icons/megaphone.svg %}
3333
</div>
3434
3535
<div class="flex__column">Release Notes</div>
3636
</a>
37-
</li>
37+
</li> -->
3838

3939
<li class="menu-item menu-item--separated">
4040
<a class="menu-item__link menu-item__link--small menu-item__link--highlight" href="https://segment.com/">Back to Segment.com</a>

src/_layouts/destination.html

+5
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,11 @@
88
{{ destination-dossier | markdownify }}
99
{% endunless %}
1010

11+
{% if page.maintenance == true %}
12+
{% capture maintenance-mode %}{% include content/destination-maintenance.md %}{% endcapture %}
13+
{{maintenance-mode | markdownify}}
14+
{% endif %}
15+
1116
{{ content }}
1217

1318
{% unless page.hide-boilerplate == true %}

src/connections/destinations/actions.md

+6
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,9 @@ You can also choose which event types, event names, or event property values tri
1414

1515
Each Actions-framework Destination you see in the Segment catalog represents a feature or capability of the destination which can consume data from your Segment source. The Action clearly lists which data from the events it requires, and which data is optional. For example, Amplitude requires that you always send a `LogEvent` , or Slack always requires a `PostMessage`. Each Action also includes a default mapping which you can modify.
1616

17+
{% include content/ajs-upgrade.md %}
18+
19+
1720
## Benefits of Destination Actions
1821

1922
- **Easier setup**: Users see fewer initial settings which can decrease the time spent configuring the destination.
@@ -76,6 +79,9 @@ To set up a new Actions-framework destination for the first time:
7679

7780
## Migrate a classic destination to an actions-based destination
7881

82+
{% include content/ajs-upgrade.md %}
83+
84+
7985
Moving from a classic destination to an actions-based destination is a manual process. Segment recommends that you follow the procedure below:
8086

8187
1. Create the actions-based destination with your development or test source.

src/connections/destinations/catalog/actions-amplitude/index.md

+2
Original file line numberDiff line numberDiff line change
@@ -303,6 +303,8 @@ To use Amplitude's groups with Segment, you must enable the following Action set
303303

304304
## Migration from Amplitude Classic
305305

306+
{% include content/ajs-upgrade.md %}
307+
306308
Keep the following in mind if you plan to move to Amplitude (Actions) from a classic Amplitude destination.
307309

308310
### Amplitude (Actions) uses Amplitude's HTTP API v2

src/connections/destinations/catalog/actions-braze-cloud/index.md

+3
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,9 @@ Build your own subscription. Combine the supported [triggers](/docs/connections/
5353
{% include components/actions-fields.html name="braze-cloud" %}
5454

5555
## Migration from Braze Classic
56+
57+
{% include content/ajs-upgrade.md %}
58+
5659
Keep the following in mind if you plan to move to Braze (Actions) from the classic Braze destination.
5760
{% include components/actions-map-table.html name="braze-cloud" %}
5861

src/connections/destinations/catalog/actions-braze-web/index.md

+3
Original file line numberDiff line numberDiff line change
@@ -182,6 +182,9 @@ Build your own subscription. Combine the supported [triggers](/docs/connections/
182182
{% include components/actions-fields.html name="braze-web" %}
183183

184184
## Migration from Braze Classic
185+
186+
{% include content/ajs-upgrade.md %}
187+
185188
Keep the following in mind if you plan to move to Braze (Actions) from the classic Braze destination.
186189
{% include components/actions-map-table.html name="braze-web" %}
187190

src/connections/destinations/catalog/actions-customer-io/index.md

+3
Original file line numberDiff line numberDiff line change
@@ -54,5 +54,8 @@ Build your own subscription. Combine the supported [triggers](/docs/connections/
5454

5555
## Migration from Customer.io classic
5656

57+
{% include content/ajs-upgrade.md %}
58+
59+
5760
Keep the following in mind if you plan to move to Customer.io (Actions) from the classic Customer.io destination.
5861
{% include components/actions-map-table.html name="customer-io" %}

src/connections/destinations/catalog/actions-fullstory/index.md

+3
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,9 @@ Combine the supported [triggers](/docs/connections/destinations/actions/#compone
4949
{% include components/actions-fields.html name="fullstory" %}
5050

5151
## Migration from the classic FullStory destination
52+
{% include content/ajs-upgrade.md %}
53+
54+
5255

5356
Follow the table below to map your existing FullStory destination configuration to FullStory (Actions).
5457

src/connections/destinations/catalog/actions-slack/index.md

+5
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,8 @@ Slack (Actions) provides the following benefits over the classic Slack destinati
2424

2525

2626
## Getting Started
27+
{% include content/ajs-upgrade.md %}
28+
2729

2830
1. From the Segment web app, click **Catalog**, then click **Destinations**.
2931
2. Find the Destinations Actions item in the left navigation, and click it.
@@ -44,6 +46,9 @@ Combine the supported [triggers](/docs/connections/destinations/actions/#compone
4446

4547
## Migration from the classic Slack destination
4648

49+
{% include content/ajs-upgrade.md %}
50+
51+
4752
Follow the table below to map your existing Slack destination configuration to Slack (Actions).
4853

4954
> warning ""

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

+3-3
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ This destination is maintained by ActiveCampaign. For any issues with the destin
1919

2020
## Page
2121

22-
If you're not familiar with the Segment Specs, take a look to understand what the [Page method](https://segment.com/docs/connections/spec/page/) does. An example call would look like:
22+
If you're not familiar with the Segment Specs, take a look to understand what the [Page method](/docs/connections/spec/page/) does. An example call would look like:
2323

2424
```js
2525
analytics.page();
@@ -32,7 +32,7 @@ When you call `page`, we will send that event to ActiveCampaign as a `site track
3232

3333
## Identify
3434

35-
If you're not familiar with the Segment Specs, take a look to understand what the [Identify method](https://segment.com/docs/connections/spec/identify/) does. An example call would look like:
35+
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:
3636

3737
```js
3838
analytics.identify('ze8rt1u89', {
@@ -119,7 +119,7 @@ analytics.identify('ze8rt1u89', {
119119
```
120120
## Track
121121

122-
If you're not familiar with the Segment Specs, take a look to understand what the [Track method](https://segment.com/docs/connections/spec/track/) does. An example call would look like:
122+
If you're not familiar with the Segment Specs, take a look to understand what the [Track method](/docs/connections/spec/track/) does. An example call would look like:
123123

124124
```js
125125
analytics.track('Clicked a button', {

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

+4-4
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ This destination is maintained by AdQuick. For any issues with the destination,
2121

2222
## Page
2323

24-
If you're not familiar with the Segment Specs, take a look to understand what the [Page method](https://segment.com/docs/connections/spec/page/) does. An example call would look like:
24+
If you're not familiar with the Segment Specs, take a look to understand what the [Page method](/docs/connections/spec/page/) does. An example call would look like:
2525

2626
```
2727
analytics.page()
@@ -32,7 +32,7 @@ Page calls will be sent to AdQuick as a `pageview`.
3232

3333
## Screen
3434

35-
If you're not familiar with the Segment Specs, take a look to understand what the [Screen method](https://segment.com/docs/connections/spec/screen/) does. An example call would look like:
35+
If you're not familiar with the Segment Specs, take a look to understand what the [Screen method](/docs/connections/spec/screen/) does. An example call would look like:
3636

3737
```
3838
[[SEGAnalytics sharedAnalytics] screen:@"Home"];
@@ -43,7 +43,7 @@ Screen calls will be sent to AdQuick as a `screenview`.
4343

4444
## Identify
4545

46-
If you're not familiar with the Segment Specs, take a look to understand what the [Identify method](https://segment.com/docs/connections/spec/identify/) does. An example call would look like:
46+
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:
4747

4848
```
4949
analytics.identify('userId123', {
@@ -56,7 +56,7 @@ Identify calls will be sent to AdQuick as an `identify` event.
5656

5757
## Track
5858

59-
If you're not familiar with the Segment Specs, take a look to understand what the [Track method](https://segment.com/docs/connections/spec/track/) does. An example call would look like:
59+
If you're not familiar with the Segment Specs, take a look to understand what the [Track method](/docs/connections/spec/track/) does. An example call would look like:
6060

6161
```
6262
analytics.track('Clicked Login Button')

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

+6-8
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,7 @@ rewrite: true
33
title: AdRoll Destination
44
---
55

6-
[AdRoll](https://developers.adroll.com/) is a retargeting network that allows you to show ads to visitors who've landed on your site while browsing the web. The AdRoll Destination is open-source. You can browse the code on [GitHub](https://github.com/segment-integrations/analytics.js-integration-adroll).
7-
8-
This document was last updated on January 26, 2018. If you notice any gaps, outdated information or simply want to leave some feedback to help us improve our documentation, [let us know](https://segment.com/help/contact)!
6+
[AdRoll](https://adroll.com/) is a retargeting network that allows you to show ads to visitors who've landed on your site while browsing the web. The AdRoll Destination is open-source. You can browse the code on [GitHub](https://github.com/segment-integrations/analytics.js-integration-adroll).
97

108
## Getting Started
119

@@ -21,26 +19,26 @@ This document was last updated on January 26, 2018. If you notice any gaps, outd
2119

2220
## Page
2321

24-
If you're not familiar with the Segment Specs, take a look to understand what the [Page method](https://segment.com/docs/connections/spec/page/) does. An example call would look like:
22+
If you're not familiar with the Segment Specs, take a look to understand what the [Page method](/docs/connections/spec/page/) does. An example call would look like:
2523
```javascript
2624
analytics.page()
2725
```
2826
_**NOTE:** The `page` call **must** be made on a page for any `identify` or `track` events to be sent to AdRoll. Our Analytics.js snippet includes a `page` call by default so you should be fine, unless you've manually removed the page call from your Analytics.js snippet._
2927

3028
## Identify
3129

32-
If you're not familiar with the Segment Specs, take a look to understand what the [Identify method](https://segment.com/docs/connections/spec/identify/) does. An example call would look like:
30+
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:
3331
```javascript
3432
analytics.identify('123', {
3533
3634
});
3735
```
38-
Set a `userId` using the `identify` call which will then be passed it to AdRoll each time a [`track`](https://segment.com/docs/connections/destinations/catalog/adroll/#track) call is made. If you pass an `email` trait, we'll send that to AdRoll by setting `window.adroll_email` to that value.
36+
Set a `userId` using the `identify` call which will then be passed it to AdRoll each time a [`track`](/docs/connections/destinations/catalog/adroll/#track) call is made. If you pass an `email` trait, we'll send that to AdRoll by setting `window.adroll_email` to that value.
3937

4038

4139
## Track
4240

43-
If you're not familiar with the Segment Specs, take a look to understand what the [Track method](https://segment.com/docs/connections/spec/track/) does. An example call would look like:
41+
If you're not familiar with the Segment Specs, take a look to understand what the [Track method](/docs/connections/spec/track/) does. An example call would look like:
4442
```javascript
4543
analytics.track('Sign-up Form Completed');
4644
```
@@ -90,7 +88,7 @@ analytics.track('Vewed Product', {
9088

9189
### **Legacy:** Named Segments
9290

93-
Prior to rolling out Segment ID's, AdRoll allowed "named segments". If your account was created prior to 2015, then the track events you send from the browser using our [`analytics.track`](https://segment.com/docs/connections/destinations/catalog/adroll/#track) method will be passed on to AdRoll as `adroll_segments` with the segment being the snake-cased event name.
91+
Prior to rolling out Segment ID's, AdRoll allowed "named segments". If your account was created prior to 2015, then the track events you send from the browser using our [`analytics.track`](/docs/connections/destinations/catalog/adroll/#track) method will be passed on to AdRoll as `adroll_segments` with the segment being the snake-cased event name.
9492

9593
## Troubleshooting
9694

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

+5-5
Original file line numberDiff line numberDiff line change
@@ -17,12 +17,12 @@ This destination is maintained by Adtriba. For any issues with the destination,
1717

1818
1. From the Segment web app, click **Catalog**.
1919
2. Search for "Adtriba" in the Catalog, select it, and choose which of your sources to connect the destination to.
20-
3. Enter the "Project Tracker ID / API Key" into your Segment Settings UI which you can find from your [Adtriba dashboard](https://console.adtriba.com).
20+
3. Enter the "Project Tracker ID / API Key" into your Segment Settings UI which you can find on the Adtriba dashboard.
2121
4. Validate the forwarded events by checking the Tracking Report under the "Tracking" tab.
2222

2323
## Page
2424

25-
If you're not familiar with the Segment Specs, take a look to understand what the [Page method](https://segment.com/docs/connections/spec/page/) does. An example call would look like:
25+
If you're not familiar with the Segment Specs, take a look to understand what the [Page method](/docs/connections/spec/page/) does. An example call would look like:
2626

2727
```
2828
analytics.page()
@@ -33,7 +33,7 @@ Page calls will be sent to Adtriba as a `pageview`.
3333

3434
## Identify
3535

36-
If you're not familiar with the Segment Specs, take a look to understand what the [Identify method](https://segment.com/docs/connections/spec/identify/) does. An example call would look like:
36+
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:
3737

3838
```
3939
analytics.identify('userId123', {
@@ -46,7 +46,7 @@ Identify calls will be sent to Adtriba as an `identify` event.
4646

4747
## Track
4848

49-
If you're not familiar with the Segment Specs, take a look to understand what the [Track method](https://segment.com/docs/connections/spec/track/) does. An example call would look like:
49+
If you're not familiar with the Segment Specs, take a look to understand what the [Track method](/docs/connections/spec/track/) does. An example call would look like:
5050

5151
```
5252
analytics.track('Conversion', {
@@ -58,4 +58,4 @@ analytics.track('Conversion', {
5858

5959
Track calls will be sent to Adtriba as a `track` event.
6060

61-
Trigger additional events by using [Semantic Events](https://segment.com/docs/connections/spec/semantic/) in order to enrich the Adtriba machine learning process.
61+
Trigger additional events by using [Semantic Events](/docs/connections/spec/semantic/) in order to enrich the Adtriba machine learning process.

src/connections/destinations/catalog/algolia-insights/index.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ This destination is maintained by [Algolia](https://www.algolia.com/). For any i
2222

2323
1. From the Segment web app, click **Catalog**.
2424
2. Search for "Algolia" in the Catalog, select it, and choose which of your sources to connect the destination to.
25-
3. Enter the "App ID" & "API Key" into your Segment Settings UI which you can find from your [Algolia Dashboard](https://www.algolia.com/apps/), under API Keys menu.
25+
3. Enter the "App ID" & "API Key" into your Segment Settings UI which you can find on the Algolia Dashboard, under API Keys menu.
2626

2727
_**NOTE:** The Algolia Insights Destination is not a plug-and-play integration. It requires you to modify your frontend code to send additional Algolia-related data like index name, queryID, etc._
2828

@@ -32,9 +32,9 @@ You can read more about how to send Algolia-related data to Segment from [the do
3232

3333
## Track
3434

35-
If you're not familiar with the Segment Specs, take a look to understand what the [Track method](https://segment.com/docs/connections/spec/track/) does.
35+
If you're not familiar with the Segment Specs, take a look to understand what the [Track method](/docs/connections/spec/track/) does.
3636

37-
Algolia supports the following six events from Segment's [Ecommerce Spec](https://segment.com/docs/connections/spec/ecommerce/v2/).
37+
Algolia supports the following six events from Segment's [Ecommerce Spec](/docs/connections/spec/ecommerce/v2/).
3838

3939
<table>
4040
<tr>

0 commit comments

Comments
 (0)