Merge pull request #4673 from segmentio/develop

stayseesong · web-flow · commit 78981f61ec3f · 2023-05-02T11:03:27.000-07:00
Release 23.18.1
diff --git 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 2023-04-27 
+# destination categories last updated 2023-05-02 
 items:
 - display_name: A/B Testing
   slug: a-b-testing
diff --git 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 2023-04-27 
+# destination data last updated 2023-05-02 
 items:
 - id: 637e8d185e2dec264895ea89
   display_name: 1Flow
@@ -15647,7 +15647,7 @@ items:
   methods:
     track: true
     identify: true
-    group: false
+    group: true
     alias: false
     screen: false
     page: true
@@ -61577,7 +61577,7 @@ items:
   previous_names:
   - TikTok Audiences
   website: https://ads.tiktok.com/help/article/custom-audiences
-  status: PUBLIC_BETA
+  status: PUBLIC
   categories:
   - Advertising
   logo:
diff --git a/src/_data/catalog/regional-supported.yml b/src/_data/catalog/regional-supported.yml
@@ -1,5 +1,5 @@
 # AUTOGENERATED LIST OF CONNECTIONS THAT SUPPORT REGIONAL
-# Last updated 2023-04-27 
+# Last updated 2023-05-02 
 warehouses:
   - id: WcjBCzUGff
     display_name: Azure SQL Data Warehouse
@@ -250,7 +250,7 @@ sources:
       - us
   - id: ymOV6oZKJ9
     display_name: CSharp
-    hidden: false
+    hidden: true
     slug: csharp
     url: connections/sources/catalog/libraries/mobile/csharp
     regions:
diff --git 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 2023-04-27 
+# source cateogries last updated 2023-05-02 
 items:
   - display_name: A/B Testing
     slug: a-b-testing
diff --git 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 2023-04-27 
+# sources last updated 2023-05-02 
 items:
   - id: 8HWbgPTt3k
     display_name: .NET
diff --git a/src/connections/destinations/catalog/actions-tiktok-audiences/index.md b/src/connections/destinations/catalog/actions-tiktok-audiences/index.md
@@ -4,16 +4,12 @@ id: 63d2e550fb90f1632ed8820a
 hide-personas-partial: true
 hide-boilerplate: true
 hide-dossier: false
-hidden: true
 ---
 
 The TikTok Audiences destination enables advertisers to send Engage audiences to TikTok as Custom Audiences using [TikTok's Segment API](https://ads.tiktok.com/marketing_api/docs?id=1739940504185857){:target="_blank"}.
 
 By using Segment's TikTok Audiences destination, you can increase traffic and drive conversions with hyper-relevant ads that promote product discovery.
 
-> info ""
-> The TikTok Audiences destination is in beta and is in active development. Some functionality may change before it becomes generally available.
-
 ## Getting started
 
 ### Prerequisites
diff --git a/src/connections/destinations/catalog/blackbaud-raisers-edge-nxt/index.md b/src/connections/destinations/catalog/blackbaud-raisers-edge-nxt/index.md
@@ -0,0 +1,33 @@
+---
+title: Blackbaud Raiser's Edge NXT Destination
+hide-boilerplate: true
+hide-dossier: false
+---
+
+[Blackbaud Raiser's Edge NXT](https://www.blackbaud.com/products/blackbaud-raisers-edge-nxt){:target="_blank"}
+is a comprehensive cloud-based fundraising and donor management software solution built specifically
+for nonprofits and the social good community.
+
+## Getting started
+
+1. From the Segment app, click **Catalog**, then click **Destinations**.
+2. Search for **Blackbaud Raiser's Edge NXT** in the Destinations Catalog, and select the destination.
+3. Click **Configure Blackbaud Raiser's Edge NXT** in the top-right corner of the screen.
+4. Select the source that will send data to Raiser's Edge NXT.
+5. On the **Basic Settings** screen, click **Connect to Blackbaud Raiser's Edge NXT**, and authenticate with
+your Blackbaud Developer account.
+6. Visit the Blackbaud ["My subscriptions"](https://developer.blackbaud.com/subscriptions/){:target="_blank"}
+page, copy your **Primary access key**, and paste the value into the **Blackbaud API Subscription Key** field.
+7. Follow the steps in the Destinations Actions documentation on
+[Customizing mappings](/docs/connections/destinations/actions/#customizing-mappings). You must select which
+Event Types and/or Event Names will trigger each mapping.
+8. Enable the destination and configured mappings.
+
+## Note on Authentication
+
+If you wish to connect multiple sources to the Blackbaud Raiser's Edge NXT destination, you must
+authenticate using a different Blackbaud Developer account for each source. If you authenticate using the
+same Blackbaud Developer account with more than one source, only the most recent source will send data to
+Raiser's Edge NXT.
+
+{% include components/actions-fields.html %}
diff --git a/src/connections/destinations/catalog/inkit/index.md b/src/connections/destinations/catalog/inkit/index.md
@@ -3,37 +3,38 @@ title: Inkit Destination
 rewrite: true
 id: 5f0746ced1c79b49ddee49fd
 ---
-[Inkit](https://inkit.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners) connects to hundreds of printers with complete visibility. Instantly use global print infrastructure with Inkit's developer friendly APIs, dashboards, and reporting. Connect, track, and manage critical business communications faster than ever before.
-
-The Inkit Destination is in beta, which indicates ongoing development. To join the Inkit beta program, or if you have any feedback to help improve the Inkit Destination and its documentation, [contact the Inkit support team](mailto:support@inkit.com).
+[Inkit](https://inkit.com){:target="_blank"} empowers organizations to securely generate and distribute documents - both digitally as well as through direct mail. 
+For example, automatically create and send electronic documents like invoices, reports, notices, and more using a magic link or e-delivery. Or generate and send documents for e-signature, storage, postcards, letters, and more, all powered by the Inkit integration for Segment.
 
 > note ""
-> Inkit maintains this destination. For any issues with the destination, [contact the Inkit support team](mailto:support@inkit.com).
-
+> Inkit maintains this destination. For any issues with the destination, [email the Inkit support team](mailto:support@inkit.com).
 
 ## Getting Started
 
 Add the destination:
 
 1. From the Destinations catalog page in your Segment workspace, click **Add Destination**.
-2. Search for "INKIT" in the Destinations Catalog, and select the "INKIT" destination.
-3. Choose which Source should send data to the "INKIT" destination.
+2. Search for "Inkit" in the Destinations Catalog, and select the "Inkit" destination.
+3. Choose which Source should send data to the "Inkit" destination.
 
 Get the Inkit API Key:
 
-1. Go to the [INKIT Integrations](https://app.inkit.io/#/account/integrations), find and copy the "API key".
-2. Enter the "API Key" in the "INKIT" destination settings in Segment.
+1. [Sign up](https://app.inkit.com/auth-init){:target="_blank"} and create an Inkit account.
+2. Follow [the instructions to create an API key](https://docs.inkit.com/docs/add-an-api-key-to-your-account){:target="_blank"}.
+3.	Enter the “API Key” in the “Inkit” destination settings in Segment.
+
 
 To use a Template ID:
 
-1. From the Destinations catalog page in your Segment workspace, click **Add Destination**.
-2. Search for "INKIT" in the Destinations Catalog, and select the "INKIT" destination.
-3. Choose which Source should send data to the "INKIT" destination.
-4. Go to the [INKIT Templates](https://app.inkit.io/#/templates), find the desired template.
-5. Click the three dots on the far right side and select "Copy Id".
-6. Paste the id into the "template_id" field when setting up the destination.
+1.	From the Destinations catalog page in your Segment workspace, click Add Destination.
+2.	Search for “Inkit” in the Destinations Catalog, and select the “Inkit” destination.
+3.	Choose which Source should send data to the “Inkit” destination.
+4.	[Create a template](https://docs.inkit.com/docs/create-a-template) in Word, PDF, HTML, Excel, or PowerPoint.
+5.	Copy the Template ID to the “Templates” tab in the Inkit web app.
+6.	Paste the id into the “template_id” field when setting up the Destination in Segment.
+
 
-For more information, see INKIT [documentation](https://docs.inkit.com/docs/inkit-postcards-api).
+For more information, see the Inkit [documentation](https://docs.inkit.com/docs/welcome-to-inkit){:target="_blank"}.
 
 ## Expected Data
 
@@ -61,14 +62,13 @@ If you aren't familiar with the Segment Spec, see the [Identify method documenta
 > note""
 > All address elements should be satisified within the segment's user identity
 (exception of address_line_2 which is a custom entry)
-
 Expected Requirements
 
 ```js
 analytics.identify('userId123', {
     template_id:"<template_id>", (required)
-    first_name: "Elon", (required)
-    last_name: "Musk", (optional)
+    first_name: "Nick", (required)
+    last_name: "Fury", (optional)
     address_line_1: "1 Rocket Road", (required)
     address_line_2: "Suite 1", (optional)
     address_city: "Hawthorne", (required)
@@ -99,8 +99,8 @@ Custom Fields Call
 ```js
 analytics.identify('userId123', {
     template_id:"<template_id>",
-    email:"elon@spacex.com",
-    company:"SpaceX",
+    email:"n.fury@shield.com",
+    company:"SHIELD",
     phone:"3107099497",
     subscription: "premium",
     custom_field_example: "content"
@@ -109,4 +109,4 @@ analytics.identify('userId123', {
 
 All other fields are then added to the user's profile as custom fields within Inkit's dashboard.
 
-Segment sends Identify calls to INKIT as an `identify` event.
+Segment sends Identify calls to Inkit as an `identify` event.
diff --git a/src/connections/sources/catalog/libraries/mobile/csharp/index.md b/src/connections/sources/catalog/libraries/mobile/csharp/index.md
@@ -0,0 +1,4 @@
+---
+title: 'CSharp Source'
+hidden: true
+---
diff --git a/src/connections/sources/catalog/libraries/mobile/kotlin-android/index.md b/src/connections/sources/catalog/libraries/mobile/kotlin-android/index.md
@@ -149,7 +149,7 @@ To get started with the Analytics-Kotlin mobile library:
 
 5. Enable Java 8+ API desugaring.
 
-    The SDK internally uses a number of Java 8 language APIs through desugaring. Make sure your project either [enables desugaring](https://developer.android.com/studio/write/java8-support#library-desugaring)) or requires a minimum API level of 26.
+    If you're on a version prior to `1.10.4`, the SDK internally uses a number of Java 8 language APIs through desugaring, which requires you to either [enable desugaring](https://developer.android.com/studio/write/java8-support#library-desugaring), have a minimum API level of 26, or upgrade to the latest version. If you're on version `1.10.4` and above, you don't need desugaring. 
 
 > info ""
 > You'll find configuration options such as IDFA collection and automatic screen tracking in Segment’s [Plugin Examples repository](https://github.com/segmentio/analytics-kotlin/tree/main/samples/kotlin-android-app/src/main/java/com/segment/analytics/next/plugins){:target="_blank"}.
diff --git a/src/connections/sources/catalog/libraries/mobile/kotlin-android/kotlin-android-faq.md b/src/connections/sources/catalog/libraries/mobile/kotlin-android/kotlin-android-faq.md
@@ -47,10 +47,8 @@ Yes. Please refer to the [Java Compatibility](https://github.com/segmentio/analy
 
 ## My app crashes with NoClassDefFoundError Failed resolution of: Ljava/time/Instant
 
-The SDK internally uses a number of Java 8 language API through desugaring (see [Java 8+ API](https://developer.android.com/studio/write/java8-support#library-desugaring) desugaring support). Please make sure your project:
+If you're on a version prior to `1.10.4`, the SDK internally uses a number of Java 8 language APIs through desugaring (see [Java 8+ API](https://developer.android.com/studio/write/java8-support#library-desugaring) desugaring support). Please make sure your project either uses Android Gradle plugin 4.0.0 or higher, has a minimum API level of 26, or is upgraded to the latest SDK.
 
-- either uses Android Gradle plugin 4.0.0 or higher
-- or requires a minimum API level of 26.
 
 ## My deeplinks are not tracked?
 
diff --git a/src/connections/sources/catalog/libraries/server/csharp/index.md b/src/connections/sources/catalog/libraries/server/csharp/index.md
@@ -3,7 +3,8 @@ title: Analytics for CSharp (C#)
 strat: csharp
 id: 
 redirect_from:
-   - '/connections/sources/catalog/libraries/mobile/unity'          
+   - '/connections/sources/catalog/libraries/mobile/unity'
+   - '/connections/sources/catalog/libraries/mobile/csharp/'          
 ---
 
 With Analytics-CSharp, you can add Segment analytics to your C# based app which includes Unity, Xamarin, .NET. Analytics-CSharp helps you measure your users, product, and business. It unlocks insights into your app's funnel, core business metrics, and whether you have product-market fit. The Analytics-CSharp library is open-source [on GitHub](https://github.com/segmentio/analytics-csharp){:target="_blank"}. 
diff --git a/src/connections/sources/catalog/libraries/server/go/quickstart.md b/src/connections/sources/catalog/libraries/server/go/quickstart.md
@@ -27,7 +27,7 @@ When you create a Source in the Segment web app, it tells the Segment servers th
 Installing our Go library is easy, just run the following:
 
 ```bash
-go get gopkg.in/segmentio/analytics-go.v3
+go get github.com/segmentio/analytics-go/v3
 ```
 
 Then just import the library and initialize a new client your Segment source's **Write Key**, like so:
diff --git a/src/connections/sources/catalog/libraries/website/javascript/querystring.md b/src/connections/sources/catalog/libraries/website/javascript/querystring.md
@@ -5,13 +5,13 @@ strat: ajs
 
 Analytics.js can trigger Track and Identify events based on the URL query string. You can use this when tracking email click-throughs, social media clicks, and digital advertising.
 
-Here are the query parameters to use:
+Here are the *optional* query parameters to use:
 
 | Parameter             | Description                             | Triggers                                                                                                                                        |
 | --------------------- | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
-| `ajs_uid`             | The userId to pass to an Identify call. | This triggers an Identify call.                                                                                                                 |
-| `ajs_event`           | The event name to pass to a Track call. | This triggers a Track call.                                                                                                                     |
-| `ajs_aid`             | The `anonymousId` to set for the user.  | This function returns the current `anonymousId`. When a value is passed, this function sets an `anonymousId` value.                             |
+| `ajs_uid`   | The userId to pass to an Identify call. | This triggers an Identify call.                                                                                                                 |
+| `ajs_event` | The event name to pass to a Track call. | This triggers a Track call.                                                                                                                     |
+| `ajs_aid`   | The `anonymousId` to set for the user.  | This function returns the current `anonymousId`. When a value is passed, this function sets an `anonymousId` value.                             |
 | `ajs_prop_<property>` | A property to pass to the Track call.    | This won't implicitly trigger an event and is dependent on you also passing `ajs_event`. This property is included in the resulting Track call. |
 | `ajs_trait_<trait>`   | A trait to pass to the Identify call.    | This won't implicitly trigger any call and is dependent on you also passing `ajs_uid`. This trait is included in the resulting Identify call.   |
 
diff --git a/src/connections/sources/catalog/libraries/website/javascript/single-page-apps.md b/src/connections/sources/catalog/libraries/website/javascript/single-page-apps.md
@@ -45,3 +45,7 @@ To track more than the page field, pass those fields in as additional properties
 Analytics.js ships with a function called analytics.ready() which lets you make calls to the native integrations that Segment loads for you before they actually initialize. For instance, this is where you could choose to load a live chat widget only for users that you haven't yet identified with a userId.
 
 Since the code in the head of your website is executed only on initial page load or a refresh, you can still make calls to those native tools, but they won't run on each emulated page view.
+
+## How can I track UTMs on a single-page application?
+
+Segment automatically captures UTMs that you pass in URLs. You can also [manually pass UTMs](/docs/connections/sources/catalog/libraries/website/javascript/#default-page-properties) into the context campaign fields.
diff --git a/src/protocols/apis-and-extensions/typewriter.md b/src/protocols/apis-and-extensions/typewriter.md

-Original file line number
+Diff line change
@@ @@ -0,0 +1,4 @@ @@
 +---
 +title: 'CSharp Source'
 +hidden: true
 +---