From e37d71f056502e8852be093eb8677687b2473321 Mon Sep 17 00:00:00 2001 From: Borys Bielinskyi Date: Fri, 15 Oct 2021 14:56:05 +0300 Subject: [PATCH 1/5] Update information about the Airship destination and source --- .../destinations/catalog/airship/index.md | 80 +++++++++++++------ .../catalog/cloud-apps/airship/index.md | 10 ++- 2 files changed, 61 insertions(+), 29 deletions(-) diff --git a/src/connections/destinations/catalog/airship/index.md b/src/connections/destinations/catalog/airship/index.md index 9b45466f0f..99307dd6bd 100644 --- a/src/connections/destinations/catalog/airship/index.md +++ b/src/connections/destinations/catalog/airship/index.md @@ -3,9 +3,14 @@ rewrite: true title: Airship Destination --- -Airship gives brands the data, channels, orchestration and services they need to deliver push notifications, emails, SMS, in-app messages, and more to the right person in the right moment — building trust, boosting engagement, driving action and growing value. +Airship gives brands the data, channels, orchestration and services they need to deliver push notifications, emails, SMS, in-app messages, and more to the right person at the right moment — building trust, boosting engagement, driving action, and growing value. + +[Airship Cloud-mode Destination integration](https://docs.airship.com/partners/segment/#destination) enables users to set Airship Tags and Custom Events through Segment's `identify`, `track`, and `group` API calls. + +Segment `track` API calls are received by Airship as Custom Events. The traits of the Segments `identify` API call are interpreted as either `tags` or `attributes`. Tags are all traits that contains a boolean value (either `true` or `false`). A trait which contains a non-boolean value -- and is known to Airship -- becomes an attribute. + +Segment `group` API calls associate a named user with a group. Similar to `identify` API calls, `group` calls contain a set of `traits` that Airship uses as `tags` and `attributes`. -[Airship Cloud-mode Destination integration](https://docs.airship.com/partners/segment/#destination) enables users to set Airship Tags and Custom Events through Segment Identify and Track events. This destination is maintained by Airship. For any issues [contact the Airship Support team](mailto:support@airship.com). @@ -20,22 +25,23 @@ This destination is maintained by Airship. For any issues [contact the Airship S Follow these steps to configure the integration -1. From the Segment web app, click **Catalog**. -2. Search for "Airship" in the Catalog, select it, and choose which of your sources to connect the destination to. -3. Enter the "API Key" into your Segment Settings UI. -* Steps to create an Access Token to enable integration from Airship outlined [here](https://docs.airship.com/partners/segment/#access-token). Save this Access Token & API Key for the pasting into Segment Settings UI. -4. For Identify Events, be sure to set up a Tag Group first within Airship. Steps outlined [here](https://docs.airship.com/partners/segment/#tag-group). +1. Log in to your Segment workspace +2. Go to the **Catalog** and click the **Destinations** tab. +3. Find the `Airship` destination (under *SMS & Push Notifications*), click the *Airship* tile and then click the *Configure Airship* button. +4. In the *Select Source* dialog, select a source and click *Confirm Source*. +5. Toggle on *Airship EU Data Center* if you are implemented in Airship's European Data Center (if you are not sure which data center you are on please [contact the Airship support team](mailto:support@airship.com)). +3. Enter the *App Key* and Access Token that you copied when setting up the Real-Data Streaming integration in Airship. See [Airship documentation for steps to create an Access Token](https://docs.airship.com/partners/segment/#access-token). +4. For `identify` events, first [set up a tag group within Airship](https://docs.airship.com/partners/segment/#tag-group). +5. For `attributes`, first [predefine them in Airship](https://docs.airship.com/guides/messaging/user-guide/audience/segmentation/attributes/#add-attributes). ## Requirements -To use the Segment Destination integration, you must implement Named Users in Airship. The Segment UserID must match the Named User ID in Airship. - -If your `named_user_id` and `UserID` do not match, Airship will not be able to associate Identify or Track events to the proper user in Airship. This would prevent you from effectively issuing automated messages or attaching user attributes from Segment within Airship +To use the Segment Destination integration, you must implement `Named Users` in Airship. The Segment UserID must match the Named User ID in Airship. If your `named_user_id` and `UserID` do not match, Airship will not be able to associate `identify` or `track` events to the proper user in Airship. You will not be able to issue automated messages or to attach user attributes from Segment within Airship. See [Tags and Named Users](https://docs.airship.com/guides/audience/tags-named-users/) or the [Named Users API](https://docs.airship.com/api/ua/#tag/named-users) for more information about configuring named users. ## Identify -If you haven't had a chance to review the Segment spec, take a look tounderstand what the [Identify method](https://segment.com/docs/connections/spec/identify/) does. An example call would look like: +To understand what the [identify API call](https://segment.com/docs/connections/spec/identify/) does, be sure to review the Segment spec. An example call would look like: ``` analytics.identify('jill', { @@ -44,20 +50,24 @@ analytics.identify('jill', { }); ``` -Identify calls will be sent to Airship as an `identify` event. When an `identify` event is received, Airship will use the `userId` to set named users tags. To take advantage of identify features, in Airship you must set up a tag group called `segment-integration` and a named user must exist for the `userId`. The value of the property name will be true/false value. +The `identify` API calls are sent to Airship as `identify` events. When an `identify` event is received, Airship will use the `userId` to set attributes or tags for named users. To take advantage of attributes, you must first predefine them in Airship individually. To take advantage of identify features, in Airship you must set up a tag group called `segment-integration` and a named user must exist for the `userId`. The value of the property name will be either `true` or `false`. + +**Segment Identify Events to Airship Attributes** + +Airship attributes are used for profile enrichment, message personalization, segment building, and user analytics. **Segment Identify Events to Airship Tags** -Airship Tags are used for profile enrichment, message triggering, segment building, and user analytics. +Airship tags are used for profile enrichment, message triggering, segment building, and user analytics. -Example Use cases: -* Identify event sets an Airship tag on a user is flagged as liking a specific product category -* Identify event sets an Airship tag on a user registers for an account +Example use cases in Airship: +* An `identify` event sets a tag to mark the user as *liking a specific product category* +* An `identify` event sets an attribute on a user who *registers for an account* ## Track -Use this Destination to send `Track` events to Airship for message triggering and analytics. +Use this destination to send `track` events to Airship for message triggering and analytics. -If you haven't had a chance to review the Segment spec, take a look to understand what the [Track method](https://segment.com/docs/connections/spec/track/) does. An example call would look like: +For more information about the [track API call](https://segment.com/docs/connections/spec/track/) review the Segment spec. An example call would look like: ``` analytics.track('Product Clicked', { @@ -69,25 +79,43 @@ analytics.track('Product Clicked', { }); ``` -Track calls will be sent to Airship as a `track` event. When a `track` event is received, an Airship custom event will be created. The event's properties will be automatically added as properties on the custom event and if revenue is present that will be set at the custom event's value. +The `track` API calls are sent to Airship as `track` events. As soon as a `track` event is received, Airship will create a custom event. The properties of the the `track` event are automatically added as properties on the custom event. If `revenue` is present for the `track` event, then it is set as the value of the custom event. -There is a maximum limit of 20 properties for track events. A custom event will not be created for a `track` event whose properties count exceeds the limit. +Note that a custom event will not be created for a `track` event which has more than 20 properties. **Segment Track Events to Airship Custom Events** -Airship Custom Events are used to trigger automated messages for Mobile App, Web Notifications, Email, and SMS messages. +Airship custom events are used to trigger automated messages for Mobile App, Web Notifications, Email, and SMS messages. + +Example use cases: +* The `track` event triggers an Airship custom event on a user who has `abandoned a cart` and an Airship message is triggered for reengagement +* The `track` event triggers an Airship custom event on a user who has `uninstalled the app` to trigger an SMS, Email, or Web Notification -Example Use cases: -* Track event triggers an Airship Custom Event on a user who has abandoned cart and an Airship message is triggered for reengagement -* Track event triggers an Airship Custom Event on a user who uninstalled the app to trigger an SMS, Email, or Web Notification +Custom events and tags sent from Segment are automatically populated within Airship Performance Analytics reporting dashboards. + +## Group + +For more information about the [group API call](https://segment.com/docs/connections/spec/group/) review the Segment spec. An example call would look like: + +``` +analytics.group('1234', { + name: 'Initech', + industry: 'Technology', + employees: 329, + plan: 'enterprise', + totalBilled: 830 +}); +``` -Custom Events and Tags sent from Segment are automatically populated within Airship Performance Analytics reporting dashboards. +When you call `group`, Segment sends a custom attribute to Airship with the name `airship_segment_group_`, where `` is the group's ID passed as one of its parameters. For example, if the group's ID is `1234` then the custom attribute name is `airship_segment_group_1234`. The value of the custom attribute is `true`. +To take advantage of `group` features as tags, set up a tag group called `segment-integration-group` in Airship. A *named user* must exist for the `userID`. # Leveraging this data in Airship -Follow the below guides for further explaination and the different ways of leveraging this data with Airship. +The following guides further explain the different ways of leveraging this data with Airship. * [Cloud-mode Custom Events vs Audience Tags](https://docs.airship.com/guides/interaction/custom-events/#custom-events-vs-audience-tags) * [Message Targeting with Tags](https://docs.airship.com/guides/audience/tags-named-users/) * [Creating a Segment with Tags](https://docs.airship.com/tutorials/audience/segments-builder/) * [Message Automation with Event Triggering](https://docs.airship.com/tutorials/orchestration/automation/automation/) +* [Message Personalization with Attributes](https://docs.airship.com/guides/messaging/user-guide/audience/segmentation/attributes/) diff --git a/src/connections/sources/catalog/cloud-apps/airship/index.md b/src/connections/sources/catalog/cloud-apps/airship/index.md index f7e5ffdd80..fc19ffb5e4 100644 --- a/src/connections/sources/catalog/cloud-apps/airship/index.md +++ b/src/connections/sources/catalog/cloud-apps/airship/index.md @@ -2,11 +2,11 @@ title: Airship Source --- -[Airship](https://www.airship.com) gives brands the data, channels, orchestration and services they need to deliver push notifications, emails, SMS, in-app messages, and more to the right person in the right moment — building trust, boosting engagement, driving action and growing value. +[Airship](https://www.airship.com) gives brands the data, channels, orchestration and services they need to deliver push notifications, emails, SMS, in-app messages, and more to the right person at the right moment — building trust, boosting engagement, driving action and growing value. -Real-Time Data Stream automatically collects user-level data and sends the data to Segment for analysis or action through other Destination integrations. At Airship, we understand that seamlessly tying data across platforms can be a complex task. This integration removes the development so users can get back to understanding their audience and reaching them on their preferred channel. +Real-Time Data Streaming automatically collects user-level data and sends the data to Segment for analysis or action through other Destination integrations. At Airship, we understand that seamlessly tying data across platforms can be a complex task. This integration removes the development so users can get back to understanding their audience and reaching them on their preferred channel. -This Source integration is maintained by Airship. For any issues with the source, [contact the Airship Support team](mailto:partner-integration-ua@airship.com). +This Source integration is maintained by Airship. For any issues with the source, [contact the Airship Support team](mailto:support@airship.com). > success "" > **Good to know**: This page is about the Airship Segment source, which sends data _into_ Segment. There's also a page about the [Airship Segment destination](/docs/connections/destinations/catalog/airship/), which receives data from Segment! @@ -28,6 +28,10 @@ This Source integration is maintained by Airship. For any issues with the source Below is a table of events that Airship sends to Segment. These events will show up as tables in your warehouse, and as regular events in your other Destinations. Airship will send through the `userId` if available. + + + + From 935ba352b2f9c9dd00c4bdf23d1e11be3259196a Mon Sep 17 00:00:00 2001 From: Borys Bielinskyi Date: Mon, 18 Oct 2021 20:58:47 +0300 Subject: [PATCH 2/5] Make corrections to Airship destination based on provided feedback --- .../destinations/catalog/airship/index.md | 114 +++++++++++++++--- 1 file changed, 100 insertions(+), 14 deletions(-) diff --git a/src/connections/destinations/catalog/airship/index.md b/src/connections/destinations/catalog/airship/index.md index 99307dd6bd..7b3469614b 100644 --- a/src/connections/destinations/catalog/airship/index.md +++ b/src/connections/destinations/catalog/airship/index.md @@ -5,7 +5,7 @@ title: Airship Destination Airship gives brands the data, channels, orchestration and services they need to deliver push notifications, emails, SMS, in-app messages, and more to the right person at the right moment — building trust, boosting engagement, driving action, and growing value. -[Airship Cloud-mode Destination integration](https://docs.airship.com/partners/segment/#destination) enables users to set Airship Tags and Custom Events through Segment's `identify`, `track`, and `group` API calls. +[Airship Cloud-mode Destination integration](https://docs.airship.com/partners/segment/#destination) enables users to set Airship tags, attributes, and custom events through Segment's `identify`, `track`, and `group` API calls. Segment `track` API calls are received by Airship as Custom Events. The traits of the Segments `identify` API call are interpreted as either `tags` or `attributes`. Tags are all traits that contains a boolean value (either `true` or `false`). A trait which contains a non-boolean value -- and is known to Airship -- becomes an attribute. @@ -35,7 +35,7 @@ Follow these steps to configure the integration 5. For `attributes`, first [predefine them in Airship](https://docs.airship.com/guides/messaging/user-guide/audience/segmentation/attributes/#add-attributes). ## Requirements -To use the Segment Destination integration, you must implement `Named Users` in Airship. The Segment UserID must match the Named User ID in Airship. If your `named_user_id` and `UserID` do not match, Airship will not be able to associate `identify` or `track` events to the proper user in Airship. You will not be able to issue automated messages or to attach user attributes from Segment within Airship. +To use the Segment Destination integration, you must implement `Named Users` in Airship. The Segment UserID must match the Named User ID in Airship. If your `named_user_id` and `UserID` do not match, Airship will not be able to associate `identify`, `track`, or `group` events to the proper user in Airship. You will not be able to issue automated messages or to attach user attributes from Segment within Airship. See [Tags and Named Users](https://docs.airship.com/guides/audience/tags-named-users/) or the [Named Users API](https://docs.airship.com/api/ua/#tag/named-users) for more information about configuring named users. @@ -81,8 +81,6 @@ analytics.track('Product Clicked', { The `track` API calls are sent to Airship as `track` events. As soon as a `track` event is received, Airship will create a custom event. The properties of the the `track` event are automatically added as properties on the custom event. If `revenue` is present for the `track` event, then it is set as the value of the custom event. -Note that a custom event will not be created for a `track` event which has more than 20 properties. - **Segment Track Events to Airship Custom Events** Airship custom events are used to trigger automated messages for Mobile App, Web Notifications, Email, and SMS messages. @@ -94,21 +92,109 @@ Custom events and tags sent from Segment are automatically populated within Airs ## Group -For more information about the [group API call](https://segment.com/docs/connections/spec/group/) review the Segment spec. An example call would look like: +For more information about the [group API call](https://segment.com/docs/connections/spec/group/) review the Segment spec. + +When you call `group`, the integration sets either Airship tags or attributes for +corresponding Segment traits. A *named user* must exist in Airship for the corresonding +value of `userID` in Segment. + +**UserID in Segment group API call** ``` -analytics.group('1234', { - name: 'Initech', - industry: 'Technology', - employees: 329, - plan: 'enterprise', - totalBilled: 830 -}); +{ +... +"userId": "test-user-69w86c" +... +} +``` + +**Named user in the correspnding Airship payload*** +``` +{ +"audience": { + "named_user_id": "test_user-69w86c" +}, +... +} +``` + +Airship tags are set for those Segment traits that contain a boolean value (either `true` +or `false`). All tags from `group` API calls are added to the `segment-integration-group` tag +group. + +**A Segment group call containing boolean traits** + ``` +... +"traits:" { + "hiring": true, + "has-remote-employees": false, + ... +} +... +``` + +**Setting the corresponding Airship tags** + +``` +... +"add": { + "segment-integration-group": ["hiring"] +}, +"remove": { + "segment_integration-group": ["has-remote-employees"] +} +... +``` + +For Segment traits that contain values of other types, such as numeric or text, Airship sets custom attributes. The integration maps the Segment group trait `name` to the Airship predefined attribute `company`. All other traits are prefixed with `airship_segment_group_`. Names of nested traits also include their parent traits delimited by underscore (_). -When you call `group`, Segment sends a custom attribute to Airship with the name `airship_segment_group_`, where `` is the group's ID passed as one of its parameters. For example, if the group's ID is `1234` then the custom attribute name is `airship_segment_group_1234`. The value of the custom attribute is `true`. +**A Segment group call containing non-boolean traits** -To take advantage of `group` features as tags, set up a tag group called `segment-integration-group` in Airship. A *named user* must exist for the `userID`. +``` +... +"traits": { + "name": "Initech", + "industry": "Technology", + "employees": 329, + "address": { + "city": "Portland", + ... + } +} +... +``` + +**Setting the corresponding Airship attributes** +``` +... +"attributes": [ +{ + "action": "set", + "key": "company", + "value": "Initech", + ... +}, +{ + "action": "set", + "key": "airship_segment_group_industry", + "value": "Technology", + ... +}, +{ + "action": "set", + "key": "airship_segment_group_employees", + "value": 329, + ... +}, +{ + "action": "set", + "key": "airship_segment_group_address_city", + "value": "Portland", + ... +} +... +``` # Leveraging this data in Airship From b31852b6b7f0834ba6cf802321e8b4558ab618b1 Mon Sep 17 00:00:00 2001 From: markzegarelli Date: Mon, 18 Oct 2021 13:18:00 -0700 Subject: [PATCH 3/5] made catalog after airship update [netlify-build] --- src/_data/catalog/destination_categories.yml | 2 +- src/_data/catalog/destinations.yml | 154 +++++++++++++++++-- src/_data/catalog/source_categories.yml | 2 +- src/_data/catalog/sources.yml | 2 +- src/_data/catalog/warehouse_papi.yml | 2 +- 5 files changed, 144 insertions(+), 18 deletions(-) diff --git a/src/_data/catalog/destination_categories.yml b/src/_data/catalog/destination_categories.yml index 52098dd423..9af84471dc 100644 --- a/src/_data/catalog/destination_categories.yml +++ b/src/_data/catalog/destination_categories.yml @@ -1,5 +1,5 @@ # AUTOGENERATED FROM PUBLIC API. DO NOT EDIT -# destination categories last updated 2021-10-08 +# destination categories last updated 2021-10-18 items: - display_name: A/B Testing slug: a-b-testing diff --git a/src/_data/catalog/destinations.yml b/src/_data/catalog/destinations.yml index c7ece1088d..a999345022 100644 --- a/src/_data/catalog/destinations.yml +++ b/src/_data/catalog/destinations.yml @@ -1,5 +1,5 @@ # AUTOGENERATED FROM PUBLIC API. DO NOT EDIT -# destination data last updated 2021-10-08 +# destination data last updated 2021-10-18 items: - display_name: 2mee name: 2mee @@ -1035,7 +1035,7 @@ items: identify: true group: true alias: false - page: true + page: false platforms: browser: true mobile: true @@ -6059,6 +6059,71 @@ items: page](https://fly.customer.io/account/customerio_integration). required: true label: Site ID +- display_name: Customer.io Actions + name: Customer.io Actions + slug: customer-io-actions + hidden: false + url: connections/destinations/catalog/customer-io-actions + previous_names: + - Actions Customerio + - Customer.io Actions + website: https://customer.io + status: PUBLIC_BETA + categories: + - Email Marketing + logo: + url: https://cdn.filepicker.io/api/file/GyZ581zaSTmv9T1ivLE0 + mark: + url: https://cdn.filepicker.io/api/file/w8zEnnazRwaPhGG4lLux + methods: + track: true + identify: true + group: true + alias: true + page: true + platforms: + browser: true + mobile: false + server: true + components: [] + browserUnbundlingSupported: false + browserUnbundlingPublic: false + replay: false + connection_modes: + device: + web: false + mobile: false + server: false + cloud: + web: false + mobile: false + server: false + summary: No connection mode information available. + cmode_type: none + case: '0' + settings: + - name: accountRegion + type: select + defaultValue: US 🇺🇸 + description: Learn about [Account Regions](https://customer.io/docs/data-centers/). + required: true + label: Account Region + - name: apiKey + type: string + defaultValue: '' + description: >- + Customer.io API key. This can be found on your [API Credentials + page](https://fly.customer.io/settings/api_credentials). + required: true + label: API Key + - name: siteId + type: string + defaultValue: '' + description: >- + Customer.io site ID. This can be found on your [API Credentials + page](https://fly.customer.io/settings/api_credentials). + required: true + label: Site ID - display_name: CustomerSuccessBox name: CustomerSuccessBox slug: customersuccessbox @@ -7812,7 +7877,7 @@ items: type: string defaultValue: '' description: >- - Your Pixel ID, from the snippet created on the [Facebook Pixel creation + Your Pixel ID from the snippet created on the [Facebook Pixel creation page](https://www.facebook.com/ads/manager/pixel/facebook_pixel/). required: true label: Pixel ID @@ -8014,20 +8079,22 @@ items: type: boolean defaultValue: false description: >- - If true, we will initialize Facebook Pixel with any user traits that's - been cached in the Segment cookies from your previous `.identify()` calls. + If enabled, we will initialize Facebook Pixel with any user traits that + have been cached in the Segment cookies from your previous `.identify()` + calls. required: false label: Enable Advanced Matching - name: keyForExternalId type: string defaultValue: '' description: >- - Please indicated a user trait key which you would like Segment to use to + Please indicate a user trait key which you would like Segment to use to send an `external_id` to Facebook Pixel using advanced matching. Segment will use the value of this trait to map it to Facebook Pixel's - `external_id`. + `external_id`. Note: **Enable Advanced Matching** must be enabled to use + this setting. required: false - label: 'Client-Side Only: Advanced Match Trait Key for External ID' + label: Advanced Match Trait Key for External ID - name: legacyEvents type: text-map defaultValue: {} @@ -8056,7 +8123,7 @@ items: type: string defaultValue: '' description: >- - Your Pixel ID, from the snippet created on the [Facebook Pixel creation + Your Pixel ID from the snippet created on the [Facebook Pixel creation page](https://www.facebook.com/ads/manager/pixel/facebook_pixel/). required: true label: Pixel ID @@ -8086,10 +8153,11 @@ items: type: boolean defaultValue: false description: >- - Enable this setting if you want to send, `userId` (or `anonymousId` if not - present) as external Id to Facebook. + Enable this setting if you want to send `userId` (or `anonymousId` if not + present) as `external_id` to Facebook when using advanced matching. Note: + **Enable Advanced Matching** must be enabled to use this setting. required: false - label: Use UserId or Anonymous Id as External Id + label: Use User ID or Anonymous ID as External ID - name: valueIdentifier type: select defaultValue: value @@ -14968,10 +15036,10 @@ items: - Personalization logo: url: >- - https://public-segment-devcenter-production.s3.amazonaws.com/de56ef24-11ea-4cc6-8df2-19db90ff5c1c.svg + https://public-segment-devcenter-production.s3.amazonaws.com/8bef9c9a-f29b-4019-8a93-687a77d538a9.svg mark: url: >- - https://public-segment-devcenter-production.s3.amazonaws.com/6aeb55d8-ffc0-468b-a5f7-21f8b2aa18e0.svg + https://public-segment-devcenter-production.s3.amazonaws.com/b77aa858-b09d-444a-94cc-39d6c7115283.svg methods: track: false identify: true @@ -17990,6 +18058,12 @@ items: cmode_type: cloud-only case: '5' settings: + - name: endpoint + type: select + defaultValue: https://api.segment.io + description: Choose the endpoint corresponding to your region. + required: true + label: Endpoint - name: repeatKeys type: array defaultValue: [] @@ -20679,6 +20753,58 @@ items: description: "Please set a Startdeliver user custom field to match a Segment event on. You can find your custom fields here –\_https://app.startdeliver.com/settings/fields." required: true label: Startdeliver user custom field to match on +- display_name: Statsig + name: Statsig + slug: statsig + hidden: false + url: connections/destinations/catalog/statsig + previous_names: + - Statsig + website: https://www.statsig.com + status: PUBLIC_BETA + categories: + - A/B Testing + - Analytics + logo: + url: https://cdn.filepicker.io/api/file/LC02PCIyQaR7Lpt0Ulk1 + mark: + url: >- + https://public-segment-devcenter-production.s3.amazonaws.com/476760b5-b915-42ea-9682-ce1217f47af0.svg + methods: + track: true + identify: true + group: true + alias: true + page: true + platforms: + browser: true + mobile: true + server: true + components: [] + browserUnbundlingSupported: false + browserUnbundlingPublic: false + replay: false + connection_modes: + device: + web: false + mobile: false + server: false + cloud: + web: false + mobile: false + server: false + summary: No connection mode information available. + cmode_type: none + case: '0' + settings: + - name: apiKey + type: string + defaultValue: '' + description: >- + Copy the Statsig Server Secret Key for your Statsig Project here: + https://console.statsig.com/api_keys + required: true + label: API Key - display_name: Stitch Data name: Stitch Data slug: stitch-data diff --git a/src/_data/catalog/source_categories.yml b/src/_data/catalog/source_categories.yml index f971d8465d..3becdb4d96 100644 --- a/src/_data/catalog/source_categories.yml +++ b/src/_data/catalog/source_categories.yml @@ -1,5 +1,5 @@ # AUTOGENERATED FROM PUBLIC API. DO NOT EDIT -# source cateogries last updated 2021-10-08 +# source cateogries last updated 2021-10-18 items: - display_name: A/B Testing slug: a-b-testing diff --git a/src/_data/catalog/sources.yml b/src/_data/catalog/sources.yml index 1499fda710..0daef589df 100644 --- a/src/_data/catalog/sources.yml +++ b/src/_data/catalog/sources.yml @@ -1,5 +1,5 @@ # AUTOGENERATED FROM PUBLIC API. DO NOT EDIT -# sources last updated 2021-10-08 +# sources last updated 2021-10-18 items: - display_name: .NET slug: net diff --git a/src/_data/catalog/warehouse_papi.yml b/src/_data/catalog/warehouse_papi.yml index 4477a588b9..e3647a4f9e 100644 --- a/src/_data/catalog/warehouse_papi.yml +++ b/src/_data/catalog/warehouse_papi.yml @@ -1,5 +1,5 @@ # AUTOGENERATED FROM PUBLIC API. DO NOT EDIT -# warehouse data last updated 2021-10-08 +# warehouse data last updated 2021-10-18 items: - display_name: Azure SQL Data Warehouse slug: azuresqldw From fb72e1a970215c9851a6f9a4551faa77a8818cd1 Mon Sep 17 00:00:00 2001 From: Borys Bielinskyi Date: Tue, 19 Oct 2021 18:20:47 +0300 Subject: [PATCH 4/5] Airship destination - fix a typo --- src/connections/destinations/catalog/airship/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/connections/destinations/catalog/airship/index.md b/src/connections/destinations/catalog/airship/index.md index 7b3469614b..9fcc71f351 100644 --- a/src/connections/destinations/catalog/airship/index.md +++ b/src/connections/destinations/catalog/airship/index.md @@ -142,7 +142,7 @@ group. "segment-integration-group": ["hiring"] }, "remove": { - "segment_integration-group": ["has-remote-employees"] + "segment-integration-group": ["has-remote-employees"] } ... ``` From ae2d7eda99336e7e0a424eb01c72b0f0a5764604 Mon Sep 17 00:00:00 2001 From: markzegarelli Date: Tue, 19 Oct 2021 09:26:46 -0700 Subject: [PATCH 5/5] edits for grammar and style --- .../destinations/catalog/airship/index.md | 40 ++++++++++--------- 1 file changed, 21 insertions(+), 19 deletions(-) diff --git a/src/connections/destinations/catalog/airship/index.md b/src/connections/destinations/catalog/airship/index.md index 9fcc71f351..71d89a46ab 100644 --- a/src/connections/destinations/catalog/airship/index.md +++ b/src/connections/destinations/catalog/airship/index.md @@ -41,7 +41,7 @@ See [Tags and Named Users](https://docs.airship.com/guides/audience/tags-named-u ## Identify -To understand what the [identify API call](https://segment.com/docs/connections/spec/identify/) does, be sure to review the Segment spec. An example call would look like: +To understand the Identify API call, review the Segment [Identify](/docs/connections/spec/identify/) spec. An example call looks like: ``` analytics.identify('jill', { @@ -52,11 +52,12 @@ analytics.identify('jill', { The `identify` API calls are sent to Airship as `identify` events. When an `identify` event is received, Airship will use the `userId` to set attributes or tags for named users. To take advantage of attributes, you must first predefine them in Airship individually. To take advantage of identify features, in Airship you must set up a tag group called `segment-integration` and a named user must exist for the `userId`. The value of the property name will be either `true` or `false`. -**Segment Identify Events to Airship Attributes** +### Segment Identify Events to Airship Attributes Airship attributes are used for profile enrichment, message personalization, segment building, and user analytics. -**Segment Identify Events to Airship Tags** +## Segment Identify Events to Airship Tags + Airship tags are used for profile enrichment, message triggering, segment building, and user analytics. Example use cases in Airship: @@ -67,7 +68,7 @@ Example use cases in Airship: Use this destination to send `track` events to Airship for message triggering and analytics. -For more information about the [track API call](https://segment.com/docs/connections/spec/track/) review the Segment spec. An example call would look like: +For more information about the Track API call review the Segment [Track]((/docs/connections/spec/track/)) spec. An example call looks like: ``` analytics.track('Product Clicked', { @@ -81,7 +82,8 @@ analytics.track('Product Clicked', { The `track` API calls are sent to Airship as `track` events. As soon as a `track` event is received, Airship will create a custom event. The properties of the the `track` event are automatically added as properties on the custom event. If `revenue` is present for the `track` event, then it is set as the value of the custom event. -**Segment Track Events to Airship Custom Events** +### Segment Track Events to Airship Custom Events + Airship custom events are used to trigger automated messages for Mobile App, Web Notifications, Email, and SMS messages. Example use cases: @@ -92,13 +94,13 @@ Custom events and tags sent from Segment are automatically populated within Airs ## Group -For more information about the [group API call](https://segment.com/docs/connections/spec/group/) review the Segment spec. +For more information about the Group API call review the Segment [Group](/docs/connections/spec/group/) spec. When you call `group`, the integration sets either Airship tags or attributes for -corresponding Segment traits. A *named user* must exist in Airship for the corresonding +corresponding Segment traits. A *named user* must exist in Airship for the corresponding value of `userID` in Segment. -**UserID in Segment group API call** +### UserID in Segment group API call ``` { @@ -108,7 +110,7 @@ value of `userID` in Segment. } ``` -**Named user in the correspnding Airship payload*** +### Named user in the corresponding Airship payload ``` { "audience": { @@ -122,7 +124,7 @@ Airship tags are set for those Segment traits that contain a boolean value (eith or `false`). All tags from `group` API calls are added to the `segment-integration-group` tag group. -**A Segment group call containing boolean traits** +### A Segment group call with boolean traits ``` ... @@ -134,7 +136,7 @@ group. ... ``` -**Setting the corresponding Airship tags** +### Setting the corresponding Airship tags ``` ... @@ -149,7 +151,7 @@ group. For Segment traits that contain values of other types, such as numeric or text, Airship sets custom attributes. The integration maps the Segment group trait `name` to the Airship predefined attribute `company`. All other traits are prefixed with `airship_segment_group_`. Names of nested traits also include their parent traits delimited by underscore (_). -**A Segment group call containing non-boolean traits** +### A Segment group call with non-boolean traits ``` ... @@ -165,7 +167,7 @@ For Segment traits that contain values of other types, such as numeric or text, ... ``` -**Setting the corresponding Airship attributes** +### Setting the corresponding Airship attributes ``` ... "attributes": [ @@ -196,12 +198,12 @@ For Segment traits that contain values of other types, such as numeric or text, ... ``` -# Leveraging this data in Airship +## Leverage this data in Airship The following guides further explain the different ways of leveraging this data with Airship. -* [Cloud-mode Custom Events vs Audience Tags](https://docs.airship.com/guides/interaction/custom-events/#custom-events-vs-audience-tags) -* [Message Targeting with Tags](https://docs.airship.com/guides/audience/tags-named-users/) -* [Creating a Segment with Tags](https://docs.airship.com/tutorials/audience/segments-builder/) -* [Message Automation with Event Triggering](https://docs.airship.com/tutorials/orchestration/automation/automation/) -* [Message Personalization with Attributes](https://docs.airship.com/guides/messaging/user-guide/audience/segmentation/attributes/) +* [Cloud-mode Custom Events vs Audience Tags](https://docs.airship.com/guides/interaction/custom-events/#custom-events-vs-audience-tags){:target="_blank"} +* [Message Targeting with Tags](https://docs.airship.com/guides/audience/tags-named-users/){:target="_blank"} +* [Creating a Segment with Tags](https://docs.airship.com/tutorials/audience/segments-builder/){:target="_blank"} +* [Message Automation with Event Triggering](https://docs.airship.com/tutorials/orchestration/automation/automation/){:target="_blank"} +* [Message Personalization with Attributes](https://docs.airship.com/guides/messaging/user-guide/audience/segmentation/attributes/){:target="_blank"}
Attribute OperationIndicates a change in the device's attributes. Because attribute operations are related to a device they have a *device* field.
Open Occurs when a user opens your app.