Skip to content

Commit 8877322

Browse files
authored
Merge branch 'master' into DOC-226
2 parents ddb3e38 + 38710d6 commit 8877322

File tree

9 files changed

+40
-28
lines changed

9 files changed

+40
-28
lines changed

src/_data/catalog/overrides-list.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
11
items:
22
- hubspot
33
- iterable
4+
- google-ads-gtag

src/_data/catalog/overrides.yml

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,3 +37,6 @@ items:
3737
accepts cloud-mode data from all Segment source types. It does not offer device-mode connections.
3838
cmode_type: mixed
3939
case: '5'
40+
- slug: google-ads-gtag
41+
previous_names:
42+
- Google AdWords New

src/_includes/content/destination-footer.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@
55

66
{% if currentIntegration.platforms.server == true %}
77
{% unless page.hide-personas-partial == true %}
8+
{% assign overridesList = site.data.catalog.overrides-list.items %}
9+
810

911
## Personas
1012

@@ -69,10 +71,14 @@ Segment lets you change these destination settings from the Segment app without
6971
## Adding {{ currentIntegration.display_name }} to the integrations object
7072

7173
To add {{ currentIntegration.display_name }} to the `integrations` JSON object (for example, [to filter data from a specific source](/docs/guides/filtering-data/#filtering-with-the-integrations-object)), use one of the following valid names for this integration:
74+
{% if page.name-override %}
75+
{% assign currentIntegration = site.data.catalog.overrides.items | where: "slug", currentSlug | first %}
76+
{% endif %}
7277

7378
{% for valid_name in currentIntegration.previous_names %}
7479
- {{ valid_name }}
7580
{% endfor %}
81+
7682
{% endunless %}
7783
{% endif %}
7884

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
1-
A warehouse is a central repository of data collected from one or more sources. This is what commonly comes to mind you think about a relational database: structured data that fits neatly into rows and columns.
1+
A warehouse is a central repository of data collected from one or more sources. This is what commonly comes to mind when you think about a relational database: structured data that fits neatly into rows and columns.
22

3-
In Segment, a Warehouse is a special type destination. Instead of streaming data to the destination all the time, we load data to them in bulk at a regular intervals. When we load data, we insert and update events and objects, and automatically adjust their schema to fit the data you've sent to Segment.
3+
In Segment, a Warehouse is a special type of destination. Instead of streaming data to the destination all the time, we load data to them in bulk at regular intervals. When we load data, we insert and update events and objects, and automatically adjust their schema to fit the data you've sent to Segment.

src/connections/destinations/catalog/amazon-lambda/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: Amazon Lambda Destination
33
rewrite: true
4+
hide-personas-partial: true
45
---
56

67
Segment makes it easy to send your data to AWS Lambda (and lots of other destinations). Once you collect your data using Segment's [open source libraries](/docs/connections/sources/catalog/), Segment translates and routes your data to AWS Lambda in the format it can use.

src/connections/destinations/catalog/google-ads-gtag/index.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,10 @@ title: 'Google Ads (Gtag) Destination'
33
beta: true
44
redirect_from: '/connections/destinations/catalog/google-adwords-new/'
55
strat: google
6+
name-override: true
67
---
78

8-
## Before you begin...
9+
## Before you begin
910

1011
If you're using the [new Google Ads (Gtag) experience](https://support.google.com/adwords/answer/6095821?hl=en&ref_topic=3165803), you can enable the **Google Ads (Gtag)** Destination (previously called "Google Adwords New") in the Segment catalog. The new Google Ads uses a Global Site Tag (Gtag) and event snippets.
1112

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

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ title: Pendo Destination
55

66
[Pendo](http://www.pendo.io/) is a product cloud that helps product teams deliver software users love. With Pendo, product teams can understand product usage, collect feedback, measure NPS, onboard users, and announce new features in app—all without requiring engineering resources.
77

8-
This destination is maintained by Pendo. For any issues with the destination, [contact the Pendo Support team](https://help.pendo.io/).
8+
Pendo maintains this destination. For any issues with the destination, [contact the Pendo Support team](https://help.pendo.io/).
99

1010
## Getting Started
1111

@@ -19,21 +19,21 @@ Your changes appear in the Segment CDN in about 45 minutes, and then Analytics.j
1919

2020
This pulls in all page and click events without needing to make additional method calls.
2121

22-
### Server
22+
### Cloud-mode configuration
2323

24-
If you are implementing server-side, follow the steps above to add Pendo continue with steps below to add a Webhook destination:
24+
To add the Pendo destination using Cloud-mode, use the [Webhooks](/docs/connections/destinations/catalog/webhooks) destination to enable Segment to send data to Pendo through a webhook.
2525

2626
1. From the Segment web app, click **Catalog**.
27-
2. Search for "Webhooks" in the Catalog, select it, and choose which of your Javascript sources to connect the destination to.
27+
2. Search for **Webhooks** in the Catalog, select it, and choose which of your Javascript sources to connect the destination to.
2828
3. Add the following as your Webhook URL: `https://pendo-io.appspot.com/data/segmentio/YOUR_PENDO_API_KEY` and replace `YOUR_PENDO_API_KEY` with your actual Pendo API Key which you can find in the Pendo UI under [Site Settings](https://app.pendo.io/admin) > Basic Information > API Key.
2929
4. Headers are not required in Webhook configuration. Once you're done adding in your URL, save changes.
3030
5. Using Track method also requires a setting enabled on your Pendo subscription. contact Pendo to enable this feature flag for your account.
3131

32-
To learn more about server-side data to Pendo, check out their [support documentation](https://help.pendo.io/resources/support-library/integrations/segment-integration.html#send-server-side-data-to-pendo).
32+
To learn more about server-side data to Pendo, see Pendo's [support documentation](https://help.pendo.io/resources/support-library/integrations/segment-integration.html#send-server-side-data-to-pendo){:target = "_blank"}.
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
```javascript
3939
analytics.identify("userId1", {
@@ -44,12 +44,12 @@ analytics.identify("userId1", {
4444
});
4545
```
4646

47-
When you send an Identify call, we will pass that user's information to Pendo with `userId` as Pendo's visitor ID. User traits that you pass are mapped to visitor metadata in Pendo.
47+
When you send an Identify call, Segment passes that user's information to Pendo with `userId` as Pendo's visitor ID. User traits that you pass are mapped to visitor metadata in Pendo.
4848

4949

5050
## Group
5151

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

5454
```javascript
5555
analytics.group("0e8c78ea9d97a7b8185e8632", {
@@ -60,11 +60,11 @@ analytics.group("0e8c78ea9d97a7b8185e8632", {
6060
});
6161
```
6262

63-
When you send a Group call, we will send `groupId` as the Pendo as account ID. Group traits are mapped to account metadata in Pendo. If you are using Pendo account data, group calls (fields `groupId` & `traits`) are required.
63+
When you send a Group call, Segment sends `groupId` as the Pendo as account ID. Group traits are mapped to account metadata in Pendo. If you are using Pendo account data, group calls (fields `groupId` & `traits`) are required.
6464

6565
## Track
6666

67-
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:
67+
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:
6868

6969
```javascript
7070
analytics.track("Registered", {
@@ -74,6 +74,6 @@ analytics.track("Registered", {
7474
});
7575
```
7676

77-
When you send a Track call, we will send it as a Pendo Track Event. Note that `groupId` is not included by default in a Track call, but it is highly recommended to add as a property.
77+
When you send a Track call, Segment sends it as a Pendo Track Event. Note that `groupId` is not included by default in a Track call, but it is highly recommended to add as a property.
7878

79-
Pendo will map `groupId` to an account ID. For more information on Pendo's Track Events, check out their [support documentation](https://help.pendo.io/resources/support-library/integrations/track-events.html).
79+
Pendo maps `groupId` to an account ID. For more information on Pendo's Track Events, check out their [support documentation](https://help.pendo.io/resources/support-library/integrations/track-events.html).

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

Lines changed: 12 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,6 @@ title: Webhooks Destination
44
---
55
Segment Webhooks submit real-time user data to your own HTTP endpoints. A Webhook is an HTTP callback: a simple event-notification using HTTP POST. A web application implementing Webhooks will POST a message to a URL when certain things happen.
66

7-
This document was last updated on January 28, 2018. If you notice any gaps, out-dated information or simply want to leave some feedback to help us improve our documentation, [let us know](https://segment.com/help/contact)!
8-
97
## Getting Started
108

119
{% include content/connection-modes.md %}
@@ -14,17 +12,18 @@ This document was last updated on January 28, 2018. If you notice any gaps, out-
1412
2. Search for "Webhooks" in the Catalog, select it, and choose which of your sources to connect the destination to.
1513
3. Specify up to five different Webhook URLs, you would like to forward data to.
1614
4. Add in any header values you would like to add to the HTTP requests
17-
5. If you require authentication, add in a [shared secret](https://segment.com/docs/connections/destinations/catalog/webhooks/#authentication).
18-
6. Toggle on Webhooks and we will start sending all the requests received by Segment's API.
15+
5. If you require authentication, add in a [shared secret](/docs/connections/destinations/catalog/webhooks/#authentication).
16+
6. Once enabled, Segment sends data to the configured webhook
1917

20-
**Note:** We'll send you HTTP(s) POST requests that look like the below for each type. Note with each call, you'll also receive a [`context`](/docs/connections/spec/common/#context) object that provides information about the user's device, IP address, etc. As you start experimenting, we recommend trying the Webhooks destination with [RequestBin.com](https://requestbin.com/) and [ultrahook](http://www.ultrahook.com) to immediately start seeing requests coming through.
18+
> info ""
19+
> **Note:** With each call, Segment sends receive a [`context`](/docs/connections/spec/common/#context) object that provides information about the user's device, IP address, etc. As you start experimenting, test the Webhooks destination with [RequestBin.com](https://requestbin.com/) and [ultrahook](http://www.ultrahook.com) to see requests as they come through.
2120
2221
## Webhooks timeouts
2322

2423
When Segment sends an event to a webhook endpoint, the service must respond within 5 seconds. If Segment does not receive a response within that period, the system logs a timeout error and [retries the event later](/docs/connections/destinations/#retries-between-segment-and-destinations).
2524

2625
## Page
27-
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:
26+
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:
2827
```
2928
POST https://your-webhook-url.com/x
3029
```
@@ -48,7 +47,7 @@ Content-Type: application/json
4847
```
4948
## Screen
5049

51-
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:
50+
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:
5251
```
5352
POST https://your-webhook-url.com/x
5453
```
@@ -82,7 +81,7 @@ Content-Type: application/json
8281
```
8382
## Identify
8483

85-
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:
84+
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:
8685
```
8786
POST https://your-webhook-url.com/x
8887
```
@@ -106,7 +105,7 @@ Content-Type: application/json
106105
```
107106
## Track
108107

109-
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:
108+
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:
110109
```
111110
POST https://your-webhook-url.com/x
112111
```
@@ -129,7 +128,7 @@ Content-Type: application/json
129128
```
130129
## Alias
131130

132-
If you're not familiar with the Segment Specs, take a look to understand what the [Alias method](https://segment.com/docs/connections/spec/alias/) does. An example call would look like:
131+
If you're not familiar with the Segment Specs, take a look to understand what the [Alias method](/docs/connections/spec/alias/) does. An example call would look like:
133132
```
134133
POST https://your-webhook-url.com/x
135134
```
@@ -148,7 +147,7 @@ Content-Type: application/json
148147
```
149148
## Group
150149

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

153152
```
154153
POST https://your-webhook-url.com/x
@@ -176,7 +175,7 @@ Content-Type: application/json
176175

177176
## Delete
178177

179-
When you create a deletion request, for each affected source that has webhooks enabled we will forward a notification so that you can kick off any automations needed on your side. An example call would look like:
178+
When you create a deletion request, for each affected source that has webhooks enabled, Segment forwards a notification so that you can kick off any automations needed on your side. An example call would look like:
180179

181180
```
182181
POST https://your-webhook-url.com/x
@@ -196,7 +195,7 @@ Content-Type: application/json
196195
## Appendices
197196
### Authentication
198197

199-
If you want to authenticate the requests being sent to your webhook endpoint, you can input a `sharedSecret` in the advanced option settings. If you provide this, we will sign your requests using the shared secret and the body of the request, and add that as the ​`X-Signature`​ header. We calculate a SHA1 digest using the shared secret and the JSON-stringified body of the request.
198+
If you want to authenticate the requests being sent to your webhook endpoint, you can input a `sharedSecret` in the advanced option settings. If you provide this, Segment signs your requests using the shared secret and the body of the request, and add that as the ​`X-Signature`​ header. Segment calculates a SHA1 digest using the shared secret and the JSON-stringified body of the request.
200199

201200
An example of how one might authenticate the requests would be:
202201

vale-styles/Vocab/Docs/accept.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,3 +45,4 @@ viewability
4545
measurability
4646
Lightbox
4747
gmail
48+
(?:P|p)endo

0 commit comments

Comments
 (0)