GITBOOK-58: Tom's Oct 15 + 16 +17 changes

Author: Sofie Toft Kristensen

13/umbraco-ums/SUMMARY.md

@@ -31,9 +31,9 @@
 ## Marketers and Editors
 
 * [Introduction](marketers-and-editors/introduction/README.md)
-  * [The uMS Section](marketers-and-editors/introduction/the-umarketingsuite-section.md)
+  * [The Umbraco Engage Section](marketers-and-editors/introduction/the-umarketingsuite-section.md)
   * [Content Apps](marketers-and-editors/introduction/content-apps.md)
-  * [The uMS Cookie](marketers-and-editors/introduction/the-umarketingsuite-cookie.md)
+  * [The Umbraco Engage Cookie](marketers-and-editors/introduction/the-umarketingsuite-cookie.md)
 * [Analytics](marketers-and-editors/analytics/README.md)
   * [What is measured by default](marketers-and-editors/analytics/what-is-measured-by-default.md)
   * [Client-side Events](marketers-and-editors/analytics/client-side-events-and-additional-javascript-files/README.md)
@@ -49,7 +49,7 @@
   * [Forms](marketers-and-editors/analytics/forms.md)
   * [Videos](marketers-and-editors/analytics/videos.md)
   * [Scroll Heatmap](marketers-and-editors/analytics/scroll-heatmap.md)
-  * [Difference between Google Analytics and uMS](marketers-and-editors/analytics/difference-in-analytics-between-google-analytics-and-umarketingsuite.md)
+  * [Google Analytics vs Umbraco Engage](marketers-and-editors/analytics/difference-in-analytics-between-google-analytics-and-umarketingsuite.md)
 * [A/B Testing](marketers-and-editors/ab-testing/README.md)
   * [What is A/B testing](marketers-and-editors/ab-testing/what-is-ab-testing.md)
   * [Types of A/B Tests](marketers-and-editors/ab-testing/types-of-ab-tests/README.md)
@@ -65,10 +65,7 @@
   * [Finish an A/B Test](marketers-and-editors/ab-testing/finish-an-ab-test.md)
 * [Personalization](marketers-and-editors/personalization/README.md)
   * [Cockpit Insights](marketers-and-editors/personalization/cockpit-insights.md)
-  * [Extending Personalization](marketers-and-editors/personalization/extending-personalization/README.md)
-    * [Implement your own segment parameters](marketers-and-editors/personalization/extending-personalization/implement-your-own-segment-parameters.md)
-    * [Segment Information](marketers-and-editors/personalization/extending-personalization/segment-information.md)
-    * [Custom Scoring](marketers-and-editors/personalization/extending-personalization/custom-scoring.md)
+  * [Extending Personalization](marketers-and-editors/personalization/extending-personalization.md)
   * [Implicit and Explicit Personalization](marketers-and-editors/personalization/implicit-and-explicit-personalization/README.md)
     * [Setting up the customer journey](marketers-and-editors/personalization/implicit-and-explicit-personalization/setting-up-the-customer-journey.md)
     * [Referral Scoring](marketers-and-editors/personalization/implicit-and-explicit-personalization/referral-scoring.md)
@@ -83,10 +80,9 @@
   * [Profile detail](marketers-and-editors/profiling/profile-detail.md)
 * [Reporting](marketers-and-editors/reporting.md)
 * [Settings](marketers-and-editors/settings/README.md)
-  * [Setting up goals](marketers-and-editors/settings/setting-up-goals.md)
+  * [Goals](marketers-and-editors/settings/setting-up-goals.md)
   * [IP Filtering](marketers-and-editors/settings/ip-filtering.md)
-  * [Set up goals](marketers-and-editors/settings/setup-goals.md)
-  * [The Configuration File](marketers-and-editors/settings/the-configuration-file.md)
+  * [Configuration](marketers-and-editors/settings/the-configuration-file.md)
   * [Permissions](marketers-and-editors/settings/permissions.md)
 
 ## Developers
@@ -97,53 +93,38 @@
     * [Data Storage](developers/introduction/dataflow-pipeline/data-storage.md)
     * [Data Parsing](developers/introduction/dataflow-pipeline/data-parsing.md)
     * [Reporting](developers/introduction/dataflow-pipeline/reporting.md)
-  * [The uMS Cookie](developers/introduction/the-umarketingsuite-cookie/README.md)
+  * [The Umbraco Engage Cookie](developers/introduction/the-umarketingsuite-cookie/README.md)
     * [Module Permissions](developers/introduction/the-umarketingsuite-cookie/module-permissions.md)
   * [Performance](developers/introduction/performance.md)
 * [Analytics](developers/analytics/README.md)
-  * [What is measured by Default](developers/analytics/what-is-measured-by-default.md)
-  * [Types of Clients](developers/analytics/types-of-clients.md)
-  * [Location](developers/analytics/location.md)
-  * [Forms](developers/analytics/forms.md)
-  * [Videos](developers/analytics/videos.md)
+  * [Request tracking](developers/analytics/what-is-measured-by-default.md)
+  * [Bot detection](developers/analytics/types-of-clients.md)
+  * [Capture location data](developers/analytics/location.md)
+  * [Extending forms](developers/analytics/forms.md)
+  * [Video tracking](developers/analytics/videos.md)
   * [Scroll Heatmap](developers/analytics/scroll-heatmap.md)
-  * [Client-side Events](developers/analytics/client-side-events-and-additional-javascript-files/README.md)
-    * [Additional Measurements with our uMW Analytics Scripts](developers/analytics/client-side-events-and-additional-javascript-files/additional-measurements-with-our-ums-analytics-scripts.md)
+  * [Client-side events](developers/analytics/client-side-events-and-additional-javascript-files/README.md)
+    * [Additional measurements Umbraco Engage analytics scripts](developers/analytics/client-side-events-and-additional-javascript-files/additional-measurements-with-our-ums-analytics-scripts.md)
     * [Bridging Library for Google Analytics](developers/analytics/client-side-events-and-additional-javascript-files/bridging-library-for-google-analytics.md)
     * [Bridging Library for Google Tag Manager](developers/analytics/client-side-events-and-additional-javascript-files/bridging-library-for-google-tag-manager.md)
     * [Google Analytics Blocker Detection](developers/analytics/client-side-events-and-additional-javascript-files/google-analytics-blocker-detection.md)
     * [Create your own events](developers/analytics/client-side-events-and-additional-javascript-files/create-your-own-events.md)
   * [Extending Analytics](developers/analytics/extending-analytics/README.md)
     * [Getting the Correct IP Address](developers/analytics/extending-analytics/getting-the-correct-ip-address.md)
-    * [Implement an IP to location provider](developers/analytics/extending-analytics/implement-an-ip-to-location-provider.md)
     * [Sending data to the GTM Datalayer](developers/analytics/extending-analytics/sending-data-to-the-gtm-datalayer.md)
 * [A/B testing](developers/ab-testing/README.md)
-  * [Types of A/B tests](developers/ab-testing/types-of-ab-tests/README.md)
-    * [Single-Page A/B test](developers/ab-testing/types-of-ab-tests/single-page-ab-test.md)
-    * [Multiple Pages test](developers/ab-testing/types-of-ab-tests/multiple-pages-test.md)
-    * [Document Type Test](developers/ab-testing/types-of-ab-tests/document-type-test.md)
-    * [Split url test](developers/ab-testing/types-of-ab-tests/split-url-test.md)
-  * [A/B Test Distribution Algorithm](developers/ab-testing/ab-test-distribution-algorithm.md)
-  * [Front end rendering](developers/ab-testing/front-end-rendering.md)
-  * [Previewing an A/B test](developers/ab-testing/previewing-an-ab-test.md)
-  * [Setting up the A/B test](developers/ab-testing/setting-up-the-ab-test.md)
-  * [Monitor the A/B test](developers/ab-testing/monitor-the-ab-test.md)
-  * [Finish an A/B Test](developers/ab-testing/finish-an-ab-test.md)
-  * [Extending the Algorithms](developers/ab-testing/extending-the-algorithms.md)
-  * [C# API](developers/ab-testing/csharp-api.md)
+  * [Retrieving A/B test variants in C#](developers/ab-testing/csharp-api.md)
 * [Personalization](developers/personalization/README.md)
-  * [Implement Your own segment parameters](developers/personalization/implement-your-own-segment-parameters.md)
-  * [Segment Information](developers/personalization/segment-information.md)
-  * [Custom Scoring](developers/personalization/custom-scoring.md)
+  * [Implement your own segment parameters](developers/personalization/implement-your-own-segment-parameters.md)
+  * [Retrieve segment information from code](developers/personalization/segment-information.md)
+  * [Add custom scoring](developers/personalization/custom-scoring.md)
 * [Profiling](developers/profiling/README.md)
   * [External Profile Data](developers/profiling/external-profile-data.md)
 * [Reporting](developers/reporting.md)
 * [Settings](developers/settings/README.md)
-  * [The Configuration file](developers/settings/configuration-options-2-x.md)
-  * [IP filtering](developers/settings/ip-filtering.md)
-  * [Set up Goals](developers/settings/setup-goals.md)
-  * [Custom Goals Scoring](developers/settings/custom-goals-scoring.md)
-  * [Permissions](developers/settings/permissions.md)
+  * [Custom goals scoring](developers/settings/custom-goals-scoring.md)
+  * [Configuration](developers/settings/configuration-options-2-x/README.md)
+    * [Reporting](developers/settings/configuration-options-2-x/reporting.md)
 * [Headless](developers/headless/README.md)
   * [Using the Marketing API](developers/headless/using-the-marketing-api.md)
   * [Headless Example](developers/headless/headless-example.md)

13/umbraco-ums/developers/ab-testing/README.md

@@ -1,21 +1,14 @@
 ---
 icon: square-exclamation
-description: >-
-  uMS offers multiple ways for performaing A/B tests on your website. Learn more
-  about each option and how to configure them in this section.
+description: Umbraco Engage offers multiple ways for performaing A/B tests on your website.
 ---
 
 # A/B testing
 
-A/B testing is one of the main features of uMS. A/B testing allows you to test your website and specific pages with two sets of configurations. uMS supports both the novice and the experienced A/B tester.
+Learn more about each option and how to configure them in the [Marketing and Editors A/B Testing](../../marketers-and-editors/ab-testing/) section.
 
-This documentation section will help you out with A/B Testing, and covers the following topics:
-
-* A [brief overview](../../../../a-b-testing/what-is-a-b-testing/) of what A/B testing is.
-* The [kind of A/B Tests](../../../../a-b-testing/types-of-a-b-tests/) that uMS supports.
-* How you can [set up the A/B test](../../../../a-b-testing/setting-up-the-a-b-test/).
-* How the [results during an A/B test](../../../../a-b-testing/monitor-the-a-b-test/) can be analyzed.
-* How [a visitor is assigned](../../../../a-b-testing/a-b-test-distribution-algorithm/) the A, B or n-variant.
-* How you could [implement custom algorithms](../../../../a-b-testing/extending-the-algorithms/).
+{% content-ref url="csharp-api.md" %}
+[csharp-api.md](csharp-api.md)
+{% endcontent-ref %}
 
 <figure><img src="../../.gitbook/assets/image (12).png" alt="A/B testing in Umbraco Engage"><figcaption><p>A/B testing in Umbraco Engage</p></figcaption></figure>

13/umbraco-ums/developers/ab-testing/ab-test-distribution-algorithm.md

@@ -1,38 +1,35 @@
 ---
 description: >-
-  Explore how to retrieve active A/B test variants for visitors using the uMarketingSuite C# API.
+  Explore how to retrieve active A/B test variants for visitors using the
+  Umbraco Engage C# API.
 ---
 
-# C# API
-
-{% hint style="info" %}
-This API is available from version 1.10.0 onwards.
-{% endhint %}
+# Retrieving A/B test variants in C\#
 
 ## Retrieving Active A/B test variants
 
 You can retrieve the active A/B test variants for a visitor in different ways depending on your specific scenario:
 
-- **IAbTestingService.GetCurrentVisitorActiveAbTestVariants()**
-  - Namespace: `uMarketingSuite.Web.AbTesting`
-  - Returns the active variants for the current visitor on the current page.
-  - Can only be used with an active request context
-- **IAbTestingVisitorService.GetVisitorAbTestVariants(visitorExternalId, pageId, culture, contentTypeId)**
-  - Namespace: `uMarketingSuite.Business.AbTesting`
-  - Retrieves active A/B test variants on a specific page, without requiring a request context.
-  - The visitor external id can be retrieved using **IAnalyticsVisitorExternalIdHandler.GetExternalId()**
-- **IAbTestVisitorToVariantManager.GetActiveVisitorVariants(visitorExternalId)**
-  - Namespace: `uMarketingSuite.Business.AbTesting`
-  - Retrieves *all* active A/B test variants for the given visitor throughout the website.
-  - The visitor external id can be retrieved using **IAnalyticsVisitorExternalIdHandler.GetExternalId()**
+* **IAbTestingService.GetCurrentVisitorActiveAbTestVariants()**
+  * Namespace: `Umbraco.Engage.Web.AbTesting`
+  * Returns the active variants for the current visitor on the current page.
+  * Can only be used with an active request context
+* **IAbTestingVisitorService.GetVisitorAbTestVariants(visitorExternalId, pageId, culture, contentTypeId)**
+  * Namespace: `Umbraco.Engage.Business.AbTesting`
+  * Retrieves active A/B test variants on a specific page, without requiring a request context.
+  * The visitor external id can be retrieved using **IAnalyticsVisitorExternalIdHandler.GetExternalId()**
+* **IAbTestVisitorToVariantManager.GetActiveVisitorVariants(visitorExternalId)**
+  * Namespace: `Umbraco.Engage.Business.AbTesting`
+  * Retrieves _all_ active A/B test variants for the given visitor throughout the website.
+  * The visitor external id can be retrieved using **IAnalyticsVisitorExternalIdHandler.GetExternalId()**
 
 ### Example
 
 To use these services, inject the specified service into your code. The example below uses **IAbTestingService.GetCurrentVisitorActiveAbTestVariants()** by injecting the service into a controller:
 
 ```cs
-using uMarketingSuite.Business.AbTesting;
-using uMarketingSuite.Web.AbTesting;
+using Umbraco.Engage.Business.AbTesting;
+using Umbraco.Engage.Web.AbTesting;
 
 public class YourController : SurfaceController
 {