Skip to content

Commit b458cef

Browse files
authored
Cherry pick URL fixes from hackweek link-checking exercise (#999)
* fix some dead links * check in lots of fixes * more fixes * more fixes * more fixes * more fixes * more fixes * more fixes * more fixes * more fixes * more fixes * more fixes * a few more fixes * more fixes * unbreak this file * fix link * typo
1 parent 2b2236d commit b458cef

File tree

151 files changed

+433
-428
lines changed

Some content is hidden

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

151 files changed

+433
-428
lines changed

src/_data/catalog/destinations.yml

Lines changed: 68 additions & 68 deletions
Large diffs are not rendered by default.

src/_data/glossary.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ Computed trait: |
4242
[Computed traits](/docs/personas/computed-traits/) are per-user, or per-account [traits](#traits) that you create or “compute” in [Personas](/docs/personas/). When you build a Computed Trait, Personas adds it to relevant user profiles.
4343
4444
Custom trait: |
45-
[Custom Traits](/docs/personas/#custom-traits) are user or account properties collected from all the events you send to Personas. For example, you can add any properties that you send as a part of your track calls or identify calls (`email`, `first_name`, `last_name`) as custom traits. You can then view them in the profile explorer, and use them in your audiences, computed traits and SQL traits.
45+
[Custom Traits](/docs/personas/audiences/#custom-traits) are user or account properties collected from all the events you send to Personas. For example, you can add any properties that you send as a part of your track calls or identify calls (`email`, `first_name`, `last_name`) as custom traits. You can then view them in the profile explorer, and use them in your audiences, computed traits and SQL traits.
4646
4747
Debugger: |
4848
This is the place in the app where you can see your events flowing through Segment
@@ -84,7 +84,7 @@ Method: |
8484
A method is programming speak for "an action an object can take". It's a specific type of function that is attached to an object. All of our analytics tracking libraries create `analytics` objects, and then `track`, `identify`, `page`, [etc](/docs/connections/spec/) are methods you can invoke on those objects.
8585
8686
MTU: |
87-
Monthly Tracked Users. You can find more about how they are calculated [here](https://segment.com/docs/guides/usage-and-billing/how-are-mtus-calculated-by-segment/) but in short, they are calculated by adding the number unique userIds and number of unique anonymousIds that a customer tracks with Segment.
87+
Monthly Tracked Users. You can find more about how they are calculated [here](https://segment.com/docs/guides/usage-and-billing/mtus-and-throughput/#how-does-segment-calculate-mtus) but in short, they are calculated by adding the number unique userIds and number of unique anonymousIds that a customer tracks with Segment.
8888
8989
Object: |
9090
An object is a type of data that persists over time and can be updated, for example a Business or a User record. Objects have "traits" which record information about that object, and which can change over time. For example a "user" object could have a trait of "email" which doesn't change often, but could also have a [computed trait](#computed-trait) like `logged_in_last_7_days`. (Objects are in contrast to "[events](#event)" which happen at a single moment in time, and whose properties do not change.)

src/_includes/content/client-side-script-unverified.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Many times this is a limitation on the tool's detection process, where the detector is looking for a specific HTML element on your page. Our client side analytics.js library asynchronously loads the tool's library or pixel onto the page. As such, the detection fails.
44

5-
In order to confirm that the tool's library or pixel is actually loaded onto the page, you can open up the [javascript console](/docs/connections/sources/catalog/libraries/website/javascript#how-do-i-open-the-javascript-console-in-your-debugger-) and go to the network tab when the page is loading.
5+
In order to confirm that the tool's library or pixel is actually loaded onto the page, you can open up the [javascript console](/docs/connections/sources/catalog/libraries/website/javascript#how-do-i-open-the-javascript-console-in-your-debugger) and go to the network tab when the page is loading.
66

77
![Checking network tab to see if script loads](https://i.imgur.com/FdILEbO.gif)
88

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
### More About Identify
22

3-
To learn more about how `identify` works, check out our [Identify docs](/docs/connections/spec/identify). For example, `email` and `name` are two of our [special traits](/docs/connections/spec/identify#special-traits) that we recognize semantically.
3+
To learn more about how `identify` works, check out our [Identify docs](/docs/connections/spec/identify). For example, `email` and `name` are two of our [special traits](/docs/connections/spec/identify/#traits) that we recognize semantically.

src/_includes/content/message-anatomy.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
The most basic Segment message requires only a `userID` or `anonymousID`; all other fields are optional to allow for maximum flexibility. However, a normal Segment message has three main parts: the [common fields](/docs/spec/common/), the ["context" object](/docs/spec/common#context), and the properties (if it's an event) or traits (if it's an object).
1+
The most basic Segment message requires only a `userID` or `anonymousID`; all other fields are optional to allow for maximum flexibility. However, a normal Segment message has three main parts: the [common fields](/docs/connections/spec/common/), the ["context" object](/docs/connections/spec/common#context), and the properties (if it's an event) or traits (if it's an object).
22

33
The common fields include information specific to how the call was generated, like the timestamp and library name and version. The fields in the context object are usually generated by the library, and include information about the environment in which the call was generated: page path, user agent, OS, locale settings, etc. The properties and traits are optional and are where you customize the information you want to collect for your implementation.
44

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
### No events in my debugger
22

3-
1. Double check that you've followed all the steps in the [Quickstart](quickstart/#getting-started).
3+
1. Double check that you've followed all the steps in the [Quickstart](quickstart/).
44

55
2. Make sure that you're calling one of our API methods once the library is successfully installed—[`identify`](#identify), [`track`](#track), etc.

src/connections/data-export-options.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,8 +36,8 @@ You can use our [webhooks destination](/docs/connections/destinations/catalog/we
3636

3737
#### Iron.io
3838

39-
Another one of our destinations is [Iron.io](/docs/connections/destinations/catalog/iron.io/). They function similar to webhooks, but they will manage the message queue and allow you to run scripts on your data before routing it to another end point. Again this is similar to what Segment does for our business customers, but will require a decent amount of work from your team, however it will be much more reliable if your event volume gets high.
39+
Another one of our destinations is [Iron.io](/docs/connections/destinations/catalog/iron-io/). They function similar to webhooks, but they will manage the message queue and allow you to run scripts on your data before routing it to another end point. Again this is similar to what Segment does for our business customers, but will require a decent amount of work from your team, however it will be much more reliable if your event volume gets high.
4040

4141
#### 3rd Party Reporting APIs
4242

43-
This option is the most restrictive but might be the easiest if you need only basic basic data to be exported. A few examples would be to use the reporting APIs [Clicky](/docs/connections/destinations/catalog/clicky) or [Google Analytics](/docs/connections/destinations/catalog/google-analytics) provide (after turning those tools on in Segment and sending them data). Those APIs aren't super flexible and you won't see all the data from Segment, but for basic metrics they should work. One tool that's a bit more flexible when it comes to a reporting API is [Keen.io](/docs/connections/destinations/catalog/keen-io), which is also available on the Segment platform.
43+
This option is the most restrictive but might be the easiest if you need only basic basic data to be exported. A few examples would be to use the reporting APIs [Clicky](/docs/connections/destinations/catalog/clicky) or [Google Analytics](/docs/connections/destinations/catalog/google-analytics) provide (after turning those tools on in Segment and sending them data). Those APIs aren't super flexible and you won't see all the data from Segment, but for basic metrics they should work. One tool that's a bit more flexible when it comes to a reporting API is [Keen.io](/docs/connections/destinations/catalog/keen/), which is also available on the Segment platform.

src/connections/destination-data-control.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "How do I use Schema Controls?"
33
---
44

5-
Once you have enabled Destinations for a given Source, all of the [data](https://segment.com/docs/connections/spec/) you track will be routed to your connected tools and warehouses. If you no longer wish to send all data to a particular Destination, you can disable the Destination from the Source overview page. 
5+
Once you have enabled Destinations for a given Source, all of the [data](/docs/connections/spec/) you track will be routed to your connected tools and warehouses. If you no longer wish to send all data to a particular Destination, you can disable the Destination from the Source overview page. 
66

77
But what happens when you want to send all of your data to a warehouse, and only two specific events to an analytics tool? And once you're satisfied with your spec, how do you make sure rogue events are blocked from all of your warehouses and end tools? Segment gives you the power to control exactly what data is allowed into your Destinations, so you can protect the integrity of your data, and the decisions you make with it.
88

@@ -25,7 +25,7 @@ analytics.identify('user_123', {
2525
});
2626
```
2727

28-
Destination flags are **case sensitive** and match [the Destination's name in the docs](https://segment.com/docs/integrations) (i.e. "AdLearn Open Platform", "awe.sm", "MailChimp", etc.).
28+
Destination flags are **case sensitive** and match [the Destination's name in the docs](/docs/connections/destinations/catalog/) (i.e. "AdLearn Open Platform", "awe.sm", "MailChimp", etc.).
2929

3030
If you're on Segment's Business plan, you can filter track calls right from the Segment UI on your Source Schema page by clicking on the field in the "Integrations" column and then adjusting the toggle for each tool. We recommend using the UI if possible since it's a much simpler way of managing your filters and can be updated with no code changes on your side.
3131

@@ -35,7 +35,7 @@ If you're on Segment's Business plan, you can filter track calls right from the
3535

3636
If you no longer want to track an event, you can either remove it from your code or, if you're on the Business plan, you can block track calls right from the Segment UI on your Source Schema page by adjusting the toggle for each event.
3737

38-
![](images/asset_ZCRZqdO9.gif)
38+
![](/docs/protocols/images/asset_ZCRZqdO9.gif)
3939

4040
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. 
4141

@@ -83,7 +83,7 @@ No new identify traits will be allowed in Segment or sent to your Destinations.
8383

8484
For example, if you set your Schema Defaults for New Events to "Block," and a new event, `Order Completed`, is tracked, Segment will automatically block the event and it will not be sent to your warehouse or downstream tools. The event will continue to be blocked until you actively choose to allow it.
8585

86-
You will need to upgrade to the latest [iOS](https://segment.com/docs/connections/sources/catalog/libraries/mobile/ios/#install-the-sdk) and/or [Android](https://segment.com/docs/connections/sources/catalog/libraries/mobile/android/#step-1-install-the-library) SDKs for Schema Defaults to apply to events sent from mobile sources. 
86+
You will need to upgrade to the latest [iOS](/docs/connections/sources/catalog/libraries/mobile/ios/#install-the-sdk) and/or [Android](/docs/connections/sources/catalog/libraries/mobile/android/#step-1-install-the-library) SDKs for Schema Defaults to apply to events sent from mobile sources. 
8787

8888
## **What is considered a "new" event?**
8989

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,12 +13,12 @@ This destination is maintained by Adikteev. For any issues with the destination,
1313

1414
Currently, this destination supports events originating from Mobile sources alone.
1515

16-
You can read more about how to define a source [here](https://segment.com/docs/guides/getting-started/what-is-a-source/).
16+
You can read more about how to define a source [here](/docs/connections/sources/#what-is-a-source).
1717

1818
To get started with Adikteev and Segment, you'll need an account with Adikteev.
1919

2020
If you don't have an account with Adikteev and want to use our services together with Segment contact us here: [[email protected]](mailto:[email protected]).
2121

2222
## Track
2323

24-
Adikteev is built to understand and analyze all the events generated by your app. For us to receive and analyze the events correctly, make sure you use the right [Track](https://segment.com/docs/connections/spec/track/) events as specified by Segment's Spec.
24+
Adikteev is built to understand and analyze all the events generated by your app. For us to receive and analyze the events correctly, make sure you use the right [Track](/docs/connections/spec/track/) events as specified by Segment's Spec.

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

Lines changed: 5 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -10,13 +10,6 @@ The following documentation provides detailed explanation of how both destinatio
1010

1111
<!-- TOC depthFrom:2 depthTo:2 withLinks:1 updateOnSave:1 orderedList:0 -->
1212

13-
- [Planning for Adobe Analytics](#planning-for-adobe-analytics)
14-
- [Device-mode - Analytics.js](#device-mode-analytics-js)
15-
- [Cloud-mode - aka Server-side](#cloud-mode-aka-server-side)
16-
- [Implementing Segment for Adobe Analytics](#implementing-segment-for-adobe-analytics)
17-
- [Adobe Analytics List Variables - lVars](#adobe-analytics-list-variables-lvars)
18-
- [Adobe Analytics Properties - props](#adobe-analytics-properties-props)
19-
- [Configuring Adobe Analytics Settings](#configuring-adobe-analytics-settings)
2013
- [Setting up Adobe Analytics for Mobile](mobile/)
2114
- [Setting up Adobe Heartbeat](heartbeat/)
2215
- [Best Practices](best-practices/)
@@ -34,6 +27,7 @@ We strongly recommend that you create a tracking plan for both your Segment and
3427

3528

3629
### Choosing between Device-mode and Cloud-mode
30+
3731
If you're using device-mode javascript, by default Segment "bundles" (mobile) or "wraps" (when using Analytics.js) the Adobe libraries. In this configuration, Segment sends Events directly from the client using the Adobe Analytics `Appmeasurement.js` library. Adobe's client-side libraries can provide services to other Adobe suites and products, however they can also increase the size of your page.
3832

3933
If you prefer, you can enable [Cloud-mode](/docs/connections/destinations/#connection-modes), and send data through the Segment servers where it is then mapped and sent on to Adobe Analytics. You enable Cloud-mode for Javascript or Legacy sources from the Adobe Analytics source settings in the Segment app.
@@ -79,7 +73,7 @@ To use Adobe's Marketing Cloud Visitor ID Service, enter your **Marketing Cloud
7973

8074
"Cloud-mode" data is data sent _without_ bundling the Segment-Adobe-Analytics SDK. It can be sent using mobile libraries, Analytics.js, and other server-based sources.
8175

82-
*For more information on mobile native integrations using Segment's iOS and Android Adobe Analytics SDKs, see the [next section in this doc](#setting-up-adobe-analytics-for-mobile).*
76+
*For more information on mobile native integrations using Segment's iOS and Android Adobe Analytics SDKs, see the [page on mobile set up](mobile/).*
8377

8478
**Important**: For data sent from server-side libraries, you need to predefine your events and custom properties to send events to Adobe Analytics server-side destination. However, *for data sent from mobile devices*, we send *every* event along automatically, and you can use the Adobe Analytics [processing rules](https://marketing.adobe.com/resources/help/en_US/reference/processing_rules.html) UI to map actions, lifecycle dimensions, and custom properties from `contextData` to events, props and eVars.
8579

@@ -132,7 +126,7 @@ When we generate the XML to send to Adobe, there are a few things that happen:
132126

133127
**Important**: The Android library can collect the `userAgent` automatically - however, the iOS library cannot do so. However, since we do collect other contextual metadata about your device, we render a valid iOS userAgent string that populates all your Mobile Web Reports.
134128

135-
6. If you are using the [Marketing Cloud ID Service](https://marketing.adobe.com/resources/help/en_US/mcvid/mcvid_overview.html), you can pass the **Marketing Cloud Visitor ID** as an destination specific setting and we set that as `<marketingCloudVisitorID>`.
129+
6. If you are using the [Marketing Cloud ID Service](https://marketing.adobe.com/resources/help/en_US/mcvid/mcvid_overview.html), you can pass the **Marketing Cloud Visitor ID** as a destination-specific setting and we set that as `<marketingCloudVisitorID>`.
136130

137131
(In Node.js)
138132
```javascript
@@ -203,7 +197,7 @@ Support for additional "stateful" lifecycle dimensions is coming in a future Ado
203197

204198
## Implementing Segment for Adobe Analytics
205199

206-
This section contains information about how to implement Segment calls for Adobe Analytics. You can choose to use the [automatic Ecommerce Spec mapping](#using-default-ecommerce-spec-events) so you don't have to set up a mapping in Segment and Adobe. If you need more event types or different ones, you can implement custom [Page calls](#creating-page-calls) and [Track events](#creating-track-events) to add to the standard Ecommerce spec. <!-- TODO: You can also override or opt-out of automatically mapping the Ecommerce events by passing `integration: AA: false` as part of your call.-->
200+
This section contains information about how to implement Segment calls for Adobe Analytics. You can choose to use the [automatic Ecommerce Spec mapping](#using-default-ecommerce-spec-events) so you don't have to set up a mapping in Segment and Adobe. If you need more event types or different ones, you can implement custom [Page calls](#creating-page-calls) and [Track events](#creating-custom-track-events) to add to the standard Ecommerce spec. <!-- TODO: You can also override or opt-out of automatically mapping the Ecommerce events by passing `integration: AA: false` as part of your call.-->
207201

208202
### Using default Ecommerce Spec Events
209203

@@ -551,7 +545,7 @@ This option allows you to associate a standard Visitor ID with the event.
551545
```
552546

553547
## Link Names, Link URLs, Link Types
554-
See [this](#setting-custom-linktypes-linknames-and-linkurls) section for information about configuring these as options.
548+
See [this](best-practices/#setting-custom-linktypes-linknames-and-linkurls) section for information about configuring these as options.
555549

556550
## Configuring Adobe Analytics Settings
557551

0 commit comments

Comments
 (0)