Skip to content

Commit f671ecf

Browse files
Merge pull request #4580 from segmentio/alt-text-audit
Adding alt text [1/2]
2 parents 9841790 + cdf71a6 commit f671ecf

File tree

45 files changed

+236
-232
lines changed

Some content is hidden

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

45 files changed

+236
-232
lines changed

diagram-library/readme.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ The library file was built by Tonik, and is in Sketch. You'll need a Sketch lice
44

55
You can also export the file, or diagrams you make with it, to `.svg` format for storage.
66

7-
![](sample-diagram.png)
7+
![Diagram showing how data is transferred from Segment Tracking API to a customer's AWS S3 bucket.](sample-diagram.png)
88

99
## Using the Library
1010

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ ActiveCampaign also supports updating a contact's custom fields with this integr
7878

7979
For example, if you have a contact in ActiveCampaign with these custom fields:
8080

81-
![](images/jda1490xo_screenshot2015-12-07at3.58.27pm.png)
81+
![A screenshot of the fields page in ActiveCampaign, featuring two custom fields: Shirt Size and State.](images/jda1490xo_screenshot2015-12-07at3.58.27pm.png)
8282

8383
You can update those fields using this identify call:
8484

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

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,18 +9,18 @@ The Identity Resolution destination settings are:
99
- **Marketing Cloud ID**
1010
- **Drop VisitorID**, and **No Fallbacks for VisitorID:Server-Side Only** destination settings.
1111

12-
![](/docs/connections/destinations/catalog/adobe-analytics/images/identity-resolution.png)
12+
![A screenshot of the Adobe Analytics settings page in Segment, with the Identity Resolution section selected.](images/identity-resolution.png)
1313

1414
The Timestamp destination settings are:
1515
- **Timestamp Option**
1616
- **Send Both Timestamp and VisitorID for Timestamp Optional Reporting Suites**
1717
- **Prefer VisitorID for Hybrid Timestamp Reporting**
1818

19-
![](/docs/connections/destinations/catalog/adobe-analytics/images/timestamps.png)
19+
![A screenshot of the Adobe Analytics settings page in Segment, with the Timestamps section selected.](images/timestamps.png)
2020

2121
## Analytics.js - Device Mode
2222

23-
If you're using Analytics.js in device-mode, Segment "wraps" the Adobe libraries. In this configuration, Segment sends Events directly from the client using the Adobe Analytics [`Appmeasurement.js` library](https://docs.adobe.com/content/help/en/analytics/implementation/js/overview.html). For more information on choosing a connection mode see our section on [Choosing between Device-mode and Cloud-mode](/docs/connections/destinations/catalog/adobe-analytics/#choosing-between-device-mode-and-cloud-mode). In this section we will discuss how identity resolution is handled if you are using Analytics.js in device-mode.
23+
If you're using Analytics.js in device-mode, Segment "wraps" the Adobe libraries. In this configuration, Segment sends Events directly from the client using the Adobe Analytics [`Appmeasurement.js` library](https://docs.adobe.com/content/help/en/analytics/implementation/js/overview.html). For more information on choosing a connection mode see our section on [Choosing between Device-mode and Cloud-mode](/docs/connections/destinations/catalog/adobe-analytics/#choosing-between-device-mode-and-cloud-mode). In this section we will discuss how identity resolution is handled if you are using Analytics.js in device-mode.
2424

2525
You can enable **Drop Visitor ID** from the Segment app to prevent Adobe from creating a new user profile when you set `window.s.visitorID` with a custom value. However if you're only using Analytics.js to send data to Adobe, this can make it difficult to combine anonymous and identified users inside your reports.
2626

@@ -65,4 +65,4 @@ If **No Fallbacks for Visitor ID** is enabled, and you're setting a `marketingCl
6565

6666
This decision tree is a visual representation of how Segment's Adobe Analytics destination settings and payload data interact with Segment to determine when to send a `visitorId` to Adobe.
6767

68-
![](/docs/connections/destinations/catalog/adobe-analytics/images/adobe-identity-res-decision-tree.png)
68+
![A decision tree outlining when and how visitorId is sent from Segment, as outlined in the section above.](images/adobe-identity-res-decision-tree.png)

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ To set up Adobe Analytics as a destination for your Segment data, Segment needs
4545

4646
- If you're using Device-mode data collection with Analytics.js, or using a server-side library, you need your Adobe Report Suite ID, and your Tracking Server URL. You'll add this information in the Destination settings in the Segment app UI so that Segment can send information to Adobe. An example tracking server is `jimsbrims.sc.omtrdc.net`. You do not need to include the hypertext transfer protocol (ie. `http://`). For more information on how to identify your analytics tracking server and report suites see Adobe's [documentation here](https://docs.adobe.com/content/help/en/analytics-learn/tutorials/implementation/implementation-basics/how-to-identify-your-analytics-tracking-server-and-report-suites.html).
4747

48-
![](images/trackingurl-setup.png)
48+
![The Adobe Analytics settings page in Segment, with the General section selected.](images/trackingurl-setup.png)
4949

5050
- If you're collecting data from mobile devices, you can download the `ADBMobileConfig.json` file instead of specifying these settings in the UI which contains that information. Follow the instructions in Adobe's documentation, [here for iOS](https://marketing.adobe.com/resources/help/en_US/mobile/ios/dev_qs.html), and [here for Android](https://marketing.adobe.com/resources/help/en_US/mobile/android/dev_qs.html).
5151

@@ -84,7 +84,7 @@ Segment's Analytics.js destination loads the Adobe `visitorAPI.js` library, but
8484

8585
To use Adobe's Marketing Cloud Visitor ID Service, enter your **Marketing Cloud Organization ID** in the **Identity Resolution** settings tab in the Segment app.
8686

87-
![](images/mcvid.png)
87+
![A screenshot of the Adobe Analytics settings page in Segment, with the Identity Resolution section selected.](images/mcvid.png)
8888

8989
---
9090

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

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -71,21 +71,23 @@ You can map Segment events in your `Events V2` settings to any event variable yo
7171
7272
Here's an example of how you might map Segment events to Adobe Analytics events connected in device mode:
7373

74-
![](/docs/connections/destinations/catalog/adobe-analytics/images/eventsV2.png)
74+
<!--todo: rewrite this so that it doesn't rely on the screenshots to explain how to map events in Segment-->
75+
76+
![A screenshot of the Adobe Analytics settings page in Segment, with the Mappings section selected.](images/eventsV2.png)
7577

7678
Here's an example of how you would implement the same mapping in Adobe's Mobile Services Dashboard:
7779

78-
![](/docs/connections/destinations/catalog/adobe-analytics/images/map-event-adobe.png)
80+
![A screenshot of the Custom Metrics tab in Adobe's Mobile Services Dashboard, with one custom metric, Clicked a Button, defined.](images/map-event-adobe.png)
7981

8082
## Sending Custom Properties
8183

8284
You can use the `Context Data Variables` settings to map Segment `properties` to any context data variable defined in your Adobe Analytics Mobile Services dashboard. This includes both Adobe `props` and `eVars`. You can see a list of the Adobe variable types in your Adobe Mobile Services dashboard.
8385

84-
![](/docs/connections/destinations/catalog/adobe-analytics/images/map-property-segment.png)
86+
![A screenshot of the Adobe Analytics settings page in Segment, with the Mappings section selected.](images/map-property-segment.png)
8587

8688
Here's an example of how you would implement the same mapping in Adobe's Mobile Services Dashboard:
8789

88-
![](/docs/connections/destinations/catalog/adobe-analytics/images/map-property-adobe.png)
90+
![A screenshot of the Custom Variables tab in Adobe's Mobile Services Dashboard, with one custom variable, Color, defined.](images/map-property-adobe.png)
8991

9092

9193
<table>

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

Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -207,13 +207,15 @@ When configuring the mapping, the list of Track events must be defined in both A
207207

208208
This means that you **must** create a mapping for each event and property to a corresponding Adobe Analytics `event`, `prop`, or `eVar`.
209209

210-
The image below shows an example of how you might map an event and the corresponding custom variables in the Segment destination settings UI:
210+
The images below show an example of how you might map an event and the corresponding custom variables in the Segment destination settings UI:
211211

212-
![](/docs/connections/destinations/catalog/adobe-analytics/images/event-mapping.png)
212+
<!--todo: rewrite this so that it doesn't rely on the screenshots to explain how to map events in Segment-->
213213

214-
![](/docs/connections/destinations/catalog/adobe-analytics/images/prop-mapping.png)
214+
![A screenshot of the Adobe Analytics settings page in Segment, with the Mappings section selected and a sample event mapping under the Events tab.](images/event-mapping.png)
215215

216-
![](/docs/connections/destinations/catalog/adobe-analytics/images/eVar-mapping.png)
216+
![A screenshot of the Adobe Analytics settings page in Segment, with the Mappings section selected and a sample property mapping under the Props tab.](images/prop-mapping.png)
217+
218+
![A screenshot of the Adobe Analytics settings page in Segment, with the Mappings section selected and two sample mappings under the eVars tab.](images/eVar-mapping.png)
217219

218220
Using the sample settings in the image above, if you make the Track call example below:
219221

@@ -296,11 +298,11 @@ When you make a `page` call, here's what Segment does from the browser when you
296298

297299
6. Checks if any of the page call's properties are mapped to any custom Adobe Analytics variables such as `eVar`, `props`, and `hVar`.
298300

299-
Given the mapping setting below:
301+
Given the mapping settings below:
300302

301-
![](/docs/connections/destinations/catalog/adobe-analytics/images/props-page-mapping.png)
302-
![](/docs/connections/destinations/catalog/adobe-analytics/images/eVar-page-mapping.png)
303-
![](/docs/connections/destinations/catalog/adobe-analytics/images/hier-page-mapping.png)
303+
![A screenshot of the Adobe Analytics settings page in Segment, with the Mappings section selected and a sample property mapping under the Props tab.](images/props-page-mapping.png)
304+
![A screenshot of the Adobe Analytics settings page in Segment, with the Mappings section selected and two sample mappings under the eVars tab.](images/eVar-page-mapping.png)
305+
![A screenshot of the Adobe Analytics settings page in Segment, with the Mappings section selected and a sample event mapping under the Hierarchy Values tab.](images/hier-page-mapping.png)
304306

305307
If you make the following page call:
306308

@@ -329,7 +331,7 @@ Custom Conversion variables, also known as eVars, are how Adobe segments convers
329331
You must configure an eVar mapping in your Segment destination settings to send eVars to Adobe on Track and Page calls. When configuring the mapping, the list of eVars must be defined in the Adobe Analytics UI. Map your Adobe Analytics eVar names to the Segment property names you're using in your Segment events. Enter a Segment property name on the left and an Adobe Analytics eVar number on the right. You can view your Segment events and properties in your Schema.
330332

331333
An example eVar mapping in the Segment Destination settings UI should look like this:
332-
![](/docs/connections/destinations/catalog/adobe-analytics/images/eVar-mapping.png)
334+
![A screenshot of the Adobe Analytics settings page in Segment, with the Mappings section selected and two sample mappings under the eVars tab.](/docs/connections/destinations/catalog/adobe-analytics/images/eVar-mapping.png)
333335

334336
## Merchandising events
335337

@@ -353,7 +355,7 @@ The Segment Adobe Analytics Merchandising setting runs as follows:
353355
354356
Let's take the following example:
355357

356-
![](/docs/connections/destinations/catalog/adobe-analytics/images/merchandising-event.png)
358+
![A screenshot of the Adobe Analytics settings page in Segment, with the Mappings section selected and two sample mappings under the Merchandising tab.](images/merchandising-event.png)
357359

358360
The configuration in the example image above configures an `Order Completed` Segment event which sends Adobe Analytics:
359361
- `event1` in `s.events` with the value passed from `properties.increment`.
@@ -446,11 +448,11 @@ analytics.page({
446448

447449
Custom Traffic Variables, also known as props, allow you to correlate custom data with specific traffic-related events in Adobe. To learn more about props and how to configure them in the Adobe UI, see the documentation [here](https://docs.adobe.com/content/help/en/analytics/admin/admin-tools/traffic-variables/traffic-var.html). You can map your Segment properties in your destination settings to any of your Adobe props.
448450

449-
![](/docs/connections/destinations/catalog/adobe-analytics/images/prop-mapping.png)
451+
![A screenshot of the Adobe Analytics settings page in Segment, with the Mappings section selected and a sample property mapping under the Props tab.](images/prop-mapping.png)
450452

451453
You can either send the property value as a string (ie. `'brady'`) or as an array (`['brady', 'edelman', 'blount']`). If you choose to send them as an array, Segment defaults to join it so that it is a pipe (`|`) delimited string before sending to Adobe (ie. `'brady|edelman|blount'`). See the [documentation on setting a custom delimiter](#custom-delimiter) to learn more.
452454

453-
![](/docs/connections/destinations/catalog/adobe-analytics/images/prop-custom-delimiter.png)
455+
![A screenshot of the Adobe Analytics settings page in Segment, with the Mappings section selected and two sample properties mapped under the Props tab.](images/prop-custom-delimiter.png)
454456

455457
## List Variables - lVars
456458

@@ -465,7 +467,7 @@ For list variables and props you can either send the property value as a comma d
465467
**Note:** You must configure the custom delimiter in _both_ the Adobe Analytics dashboard, and in the Segment Adobe Analytics destination settings, for each list variable and prop. Do this in the Adobe Analytics dashboard before setting up this mapping in the Segment destination settings.
466468

467469
The example below shows how to configure the Segment custom delimiter mapping for a List Variable.
468-
![](/docs/connections/destinations/catalog/adobe-analytics/images/list-var-delimiter.png)
470+
![A screenshot of the Adobe Analytics settings page in Segment, with the Mappings section selected and a sample property with delimiter under the List Variables tab.](images/list-var-delimiter.png)
469471

470472
When you send an event:
471473
```javascript
@@ -486,7 +488,7 @@ Hierarchy variables mirror how customers can track “breadcrumbs” or “bread
486488

487489
Map your Adobe Analytics hVars to the property names you use in your Segment Page calls. Enter a Segment property name on the left, and an Adobe Analytics hVar number on the right. You can view your Segment page calls and properties in your Schema.
488490

489-
![](/docs/connections/destinations/catalog/adobe-analytics/images/hier-mapping.png)
491+
![A screenshot of the Adobe Analytics settings page in Segment, with the Mappings section selected and a sample hierarchy variable mapping under the Hierarchy Variables tab.](images/hier-mapping.png)
490492

491493
## Context Data Variables
492494
Context data variables let you define custom variables on each page that processing rules can read. See the Adobe documentation to learn more about [how to use Adobe Analytics `contextData` and use processing rules](https://docs.adobe.com/content/help/en/analytics/implementation/vars/page-vars/contextdata.html) to populate analytics variables from that data.

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

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ id: 54521fd525e721e32a72ee8e
1313
2. Search for "Adroll" in the Catalog, select it, and choose which of your sources to connect the destination to.
1414
3. Locate both your AdRoll Advertiser ID and Pixel ID in AdRoll's "Audience" tab, "AdRoll Pixel" section. Click on "View Pixel". Your Advertiser ID will be listed beside `adroll_adv_id` and your AdRoll Pixel will be listed beside `adroll_pix_id`.
1515

16-
![](images/adroll-pixel.png)
16+
![A screenshot of the Adroll Audience page, with Site Audiences selected.](images/adroll-pixel.png)
1717

1818
4. Add both your Advertiser ID and Pixel ID to your Segment Destination Settings.
1919

@@ -44,17 +44,17 @@ analytics.track('Sign-up Form Completed');
4444
```
4545
In order to send your `track` calls to AdRoll for segmenting your users, get started by creating a new "segment" in their interface, copying the "Segment ID", and pasting that following a `+` into the URL rule field.
4646

47-
![](images/adrollSegmentId.gif)
47+
![An animation that creates a new user segment in Adroll using the instructions in the preceding paragraph](images/adrollSegmentId.gif)
4848

4949
Map your client-side Analytics.js event names to the corresponding AdRoll "Segment ID" in the Segment Settings UI.
5050

51-
![](images/segmentmapping.png)
51+
![A screenshot of the Events settings in the Adroll destination settings within Segment, with two custom events, Sign-up Form Completed and Button Clicked.](images/segmentmapping.png)
5252

5353
We'll fire the correct pixel accordingly to put the user into that "segment" whenever they trigger the event you've chosen. Note that you will still need to map semantic events like `Viewed Product`, `Added Product`, and `Order Completed`.
5454

5555
Then, inside AdRoll you can create a "segment" of all users doing any of those events by adding a `+` to the segment name and adding it in the URL field, like this:
5656

57-
![](images/adroll-mapping.png)
57+
![A screenshot of the New User Segment page in Adroll, with a specified name, url pattern, and duration.](images/adroll-mapping.png)
5858

5959
### Conversion Value
6060

src/connections/destinations/catalog/adwords-remarketing-lists/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -88,7 +88,7 @@ Before you start, make sure you have administrative access to the Google Ads acc
8888
2. Give your audience a name, some event and trait criteria, then click **Preview**.
8989
3. Select “Google Ads Remarketing Lists” as a destination for your audience.
9090
4. Select either email or mobile ID to use as a custom matcher.
91-
![](images/garl-select_id.png)
91+
![A screenshot of the AdWords Remarketing Lists setup page in the Segment app, with the Connection settings dropdown showing Email and Mobile ID options.](images/garl-select_id.png)
9292

9393
5. Give your audience a name, and click **Create**.
9494

@@ -99,7 +99,7 @@ Before you start, make sure you have administrative access to the Google Ads acc
9999

100100
In Google Ads, go to **Tools & Settings** > **Shared Library** > **Audience manager** > **Audience lists**.
101101

102-
![](images/garl-audience_mgr.png)
102+
![A screenshot of the Google Ads Audience lists page, with one list currently populating.](images/garl-audience_mgr.png)
103103

104104
> info ""
105105
> **Note**: Google Ads can take 24+ hours to fully process initial audience uploads before they can be used for a campaign. If the audience is still processing, the list status appears as “Populating”.
@@ -111,7 +111,7 @@ In Google Ads, go to **Tools & Settings** > **Shared Library** > **Audience mana
111111
- Make sure you authorized Google Ads and selected the correct account.
112112
- Make sure you have administrator access for your Google Ads account. You can check that your credentials are correct by navigating to the Google Ads Remarketing Lists destination in **Engage Settings** > **Destinations**, and viewing the settings.
113113

114-
![](images/garl-configure_dest.png)
114+
![A screenshot of the Segment destinations page, with the Google AdWords Remarketing Lists destination selected.](images/garl-configure_dest.png)
115115

116116
### Audience size smaller than expected
117117

0 commit comments

Comments
 (0)