diff --git a/.github/styles/UmbracoDocs/Acronyms.yml b/.github/styles/UmbracoDocs/Acronyms.yml index 4bd3033f6d9..62a6b0a7af9 100644 --- a/.github/styles/UmbracoDocs/Acronyms.yml +++ b/.github/styles/UmbracoDocs/Acronyms.yml @@ -87,3 +87,4 @@ exceptions: - JPG - JPEG - BCC + - SSD diff --git a/13/umbraco-engage/developers/ab-testing/README.md b/13/umbraco-engage/developers/ab-testing/README.md index 377910e8dbb..77d7a3711a4 100644 --- a/13/umbraco-engage/developers/ab-testing/README.md +++ b/13/umbraco-engage/developers/ab-testing/README.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: Umbraco Engage offers multiple ways for performaing A/B tests on your website. --- diff --git a/13/umbraco-engage/developers/ab-testing/csharp-api.md b/13/umbraco-engage/developers/ab-testing/csharp-api.md index 295ba29e895..014adc49bc7 100644 --- a/13/umbraco-engage/developers/ab-testing/csharp-api.md +++ b/13/umbraco-engage/developers/ab-testing/csharp-api.md @@ -4,7 +4,7 @@ description: >- Umbraco Engage C# API. --- -# Retrieving A/B test variants in C\# +# Retrieving A/B test variants in C# ## Retrieving Active A/B test variants diff --git a/13/umbraco-engage/developers/analytics/client-side-events-and-additional-javascript-files/README.md b/13/umbraco-engage/developers/analytics/client-side-events-and-additional-javascript-files/README.md index f24e0d9aa38..91f89e9cb18 100644 --- a/13/umbraco-engage/developers/analytics/client-side-events-and-additional-javascript-files/README.md +++ b/13/umbraco-engage/developers/analytics/client-side-events-and-additional-javascript-files/README.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Learn about what scripts can be used to connect with other data-gathering tools. diff --git a/13/umbraco-engage/developers/analytics/client-side-events-and-additional-javascript-files/bridging-library-for-google-analytics.md b/13/umbraco-engage/developers/analytics/client-side-events-and-additional-javascript-files/bridging-library-for-google-analytics.md index 83737f7f784..5386327ad07 100644 --- a/13/umbraco-engage/developers/analytics/client-side-events-and-additional-javascript-files/bridging-library-for-google-analytics.md +++ b/13/umbraco-engage/developers/analytics/client-side-events-and-additional-javascript-files/bridging-library-for-google-analytics.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: Learn how to bridge Google Analytics with the data in Umbraco Engage. --- diff --git a/13/umbraco-engage/developers/analytics/client-side-events-and-additional-javascript-files/bridging-library-for-google-tag-manager.md b/13/umbraco-engage/developers/analytics/client-side-events-and-additional-javascript-files/bridging-library-for-google-tag-manager.md index 45d6809b417..c70a5d83dad 100644 --- a/13/umbraco-engage/developers/analytics/client-side-events-and-additional-javascript-files/bridging-library-for-google-tag-manager.md +++ b/13/umbraco-engage/developers/analytics/client-side-events-and-additional-javascript-files/bridging-library-for-google-tag-manager.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: Learn how to bridge data between Google Tag Manager and Umbraco Engage. --- diff --git a/13/umbraco-engage/developers/analytics/client-side-events-and-additional-javascript-files/create-your-own-events.md b/13/umbraco-engage/developers/analytics/client-side-events-and-additional-javascript-files/create-your-own-events.md index 936aaa6e669..4176d203ced 100644 --- a/13/umbraco-engage/developers/analytics/client-side-events-and-additional-javascript-files/create-your-own-events.md +++ b/13/umbraco-engage/developers/analytics/client-side-events-and-additional-javascript-files/create-your-own-events.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: Learn how to create and add custom events to Umbraco Engage. --- diff --git a/13/umbraco-engage/developers/analytics/client-side-events-and-additional-javascript-files/google-analytics-blocker-detection.md b/13/umbraco-engage/developers/analytics/client-side-events-and-additional-javascript-files/google-analytics-blocker-detection.md index b13d2542684..7091b6b2b02 100644 --- a/13/umbraco-engage/developers/analytics/client-side-events-and-additional-javascript-files/google-analytics-blocker-detection.md +++ b/13/umbraco-engage/developers/analytics/client-side-events-and-additional-javascript-files/google-analytics-blocker-detection.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: Learn how Umbraco Engage handles visitors who use blocker detection. --- diff --git a/13/umbraco-engage/developers/analytics/extending-analytics/sending-data-to-the-gtm-datalayer.md b/13/umbraco-engage/developers/analytics/extending-analytics/sending-data-to-the-gtm-datalayer.md index 19894cb80b9..7d43e069c6d 100644 --- a/13/umbraco-engage/developers/analytics/extending-analytics/sending-data-to-the-gtm-datalayer.md +++ b/13/umbraco-engage/developers/analytics/extending-analytics/sending-data-to-the-gtm-datalayer.md @@ -4,7 +4,7 @@ description: >- Engage to the Google Tag Manager (GTM) data layer in Razor templates. --- -# Sending data to the GTM Datalayer +# Sending data to the Google Tag Manager (GTM) Datalayer Umbraco Engage provides a partial view that pushes variables related to A/B testing and personalization to the Google Tag Manager (GTM) data layer. diff --git a/13/umbraco-engage/developers/analytics/forms.md b/13/umbraco-engage/developers/analytics/forms.md index df21d27579c..6445a16c7de 100644 --- a/13/umbraco-engage/developers/analytics/forms.md +++ b/13/umbraco-engage/developers/analytics/forms.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: Learn how data from Umbraco Forms is tracked with Umbraco Engage. --- diff --git a/13/umbraco-engage/developers/analytics/location.md b/13/umbraco-engage/developers/analytics/location.md index b8807771f92..fe601286786 100644 --- a/13/umbraco-engage/developers/analytics/location.md +++ b/13/umbraco-engage/developers/analytics/location.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: Learn how to implement an IP to location provider. --- diff --git a/13/umbraco-engage/developers/analytics/scroll-heatmap.md b/13/umbraco-engage/developers/analytics/scroll-heatmap.md index 213dde2e305..193ae9eb3e7 100644 --- a/13/umbraco-engage/developers/analytics/scroll-heatmap.md +++ b/13/umbraco-engage/developers/analytics/scroll-heatmap.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Learn how you can use the Scroll Heatmap in Umbraco Engage to gather data on the behavior of your visitors. diff --git a/13/umbraco-engage/developers/analytics/types-of-clients.md b/13/umbraco-engage/developers/analytics/types-of-clients.md index ce81bb77d9b..e1e48915ebf 100644 --- a/13/umbraco-engage/developers/analytics/types-of-clients.md +++ b/13/umbraco-engage/developers/analytics/types-of-clients.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Learn more about how Umbraco Engage distinguishes between bots and real visitors. diff --git a/13/umbraco-engage/developers/analytics/videos.md b/13/umbraco-engage/developers/analytics/videos.md index 8c34e491063..7c16fec597b 100644 --- a/13/umbraco-engage/developers/analytics/videos.md +++ b/13/umbraco-engage/developers/analytics/videos.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: This article describes what data is tracked from videos on your website. --- diff --git a/13/umbraco-engage/developers/analytics/what-is-measured-by-default.md b/13/umbraco-engage/developers/analytics/what-is-measured-by-default.md index a8aa063562d..41dd421907d 100644 --- a/13/umbraco-engage/developers/analytics/what-is-measured-by-default.md +++ b/13/umbraco-engage/developers/analytics/what-is-measured-by-default.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: Learn what Umbraco Engage tracks before any additional configuration is added. --- diff --git a/13/umbraco-engage/developers/introduction/the-umbraco-engage-cookie/README.md b/13/umbraco-engage/developers/introduction/the-umbraco-engage-cookie/README.md index f74fd423abf..cdda30f6913 100644 --- a/13/umbraco-engage/developers/introduction/the-umbraco-engage-cookie/README.md +++ b/13/umbraco-engage/developers/introduction/the-umbraco-engage-cookie/README.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Learn how the Umbraco Engage cookie works and how the functionality can be tested. diff --git a/13/umbraco-engage/developers/personalization/README.md b/13/umbraco-engage/developers/personalization/README.md index 93f95473f64..2bbb033c173 100644 --- a/13/umbraco-engage/developers/personalization/README.md +++ b/13/umbraco-engage/developers/personalization/README.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- The personalization provided by Umbraco Umbraco Engage is built so users can personalize the content or layout of any page without programming skills from diff --git a/13/umbraco-engage/developers/personalization/custom-scoring.md b/13/umbraco-engage/developers/personalization/custom-scoring.md index 17694868fe3..9abcd87b968 100644 --- a/13/umbraco-engage/developers/personalization/custom-scoring.md +++ b/13/umbraco-engage/developers/personalization/custom-scoring.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- The main two pillars of personalization that the Umbraco Engage offers are personas and customer journeys. @@ -20,9 +19,11 @@ To implement our example above, we will be using the `ICustomerJourneyService`. To resolve the required services, we will use Dependency Injection: {% code overflow="wrap" %} + ```csharp ICustomerJourneyGroupRepository _customerJourneyGroupRepository;ICustomerJourneyService _customerJourneyService;public MyController(ICustomerJourneyGroupRepository customerJourneyGroupRepository, ICustomerJourneyService customerJourneyService){ _customerJourneyGroupRepository = customerJourneyGroupRepository; _customerJourneyService = customerJourneyService;} ``` + {% endcode %} We will now request Umbraco Engage to provide the customer journey step "**Do**" from the group "**Customer Journey**". @@ -32,10 +33,12 @@ This is the default name for the customer journey upon installation. {% endhint %} {% code overflow="wrap" %} + ```csharp var customerJourneyGroup = _customerJourneyGroupRepository.GetAll().FirstOrDefault(group => group.Title == "Customer Journey"); var stepDo = customerJourneyGroup.Steps.FirstOrDefault(step => step.Title == "Do"); ``` + {% endcode %} We can now inspect the step **Do** variable and find its `ID`. To score the step, we provide the `ID` and the score to the `CustomerJourneyService`: diff --git a/13/umbraco-engage/developers/personalization/implement-your-own-segment-parameters.md b/13/umbraco-engage/developers/personalization/implement-your-own-segment-parameters.md index 7a17e77b809..5ab5da974a8 100644 --- a/13/umbraco-engage/developers/personalization/implement-your-own-segment-parameters.md +++ b/13/umbraco-engage/developers/personalization/implement-your-own-segment-parameters.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Umbraco Engage has different built-in segment parameters to build segments, such as "Customer Journey" and "Time of Day". @@ -77,15 +76,17 @@ public class DayOfWeekSegmentRuleFactory : ISegmentRuleFactory } ``` -We are using the class `DayOfWeekSegmentRuleConfig` as a representation of the configuration of the rule, which is not strictly necessary but makes it easier. The configuration is stored as a string in the database but in code, we like to have IntelliSense so we parse the stored configuration to this class: +We are using the class `DayOfWeekSegmentRuleConfig` as a representation of the configuration of the rule, which is not strictly necessary but makes it easier. The configuration is stored as a string in the database or IntelliSense support in code. The stored configuration is parsed into this class: {% code overflow="wrap" %} + ```csharp public class DayOfWeekSegmentRuleConfig { public DayOfWeek DayOfWeek { get; set; } } ``` + {% endcode %} The segment rule factory needs to be registered so Umbraco Engage can use it.\ @@ -247,7 +248,7 @@ We want to display the picked day to the user: ``` -We store the chosen day of the week as an integer 0-6 ($ctrl.config.dayOfWeek) but in the display component, we want to show the actual day (e.g. `Monday`). Our rule definition defines the mapping in its `data.days` property so we convert it using that and display the name of the day. +The chosen day of the week is stored as an integer (0-6) in `$ctrl.config.dayOfWeek`, but in the display component shows the actual day (for example. `Monday`). Our rule definition defines the mapping in its `data.days` property so we convert it using that and display the name of the day. * `segment-rule-day-of-week-display.js` diff --git a/13/umbraco-engage/developers/personalization/segment-information.md b/13/umbraco-engage/developers/personalization/segment-information.md index 0da392d62c1..9ad61f9389d 100644 --- a/13/umbraco-engage/developers/personalization/segment-information.md +++ b/13/umbraco-engage/developers/personalization/segment-information.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Sometimes you need more fine-grained personalization for your website. For this purpose the Umbraco Engage exposes a service called the diff --git a/13/umbraco-engage/developers/profiling/external-profile-data.md b/13/umbraco-engage/developers/profiling/external-profile-data.md index db4a25b7173..0c5e92977bb 100644 --- a/13/umbraco-engage/developers/profiling/external-profile-data.md +++ b/13/umbraco-engage/developers/profiling/external-profile-data.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Umbraco Engage does not provide a built-in way to add additional data to a profile. You can store the data in any format and in any way. diff --git a/13/umbraco-engage/developers/reporting.md b/13/umbraco-engage/developers/reporting.md index 3f6db4ccf5e..b483c88616e 100644 --- a/13/umbraco-engage/developers/reporting.md +++ b/13/umbraco-engage/developers/reporting.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- It is recommended to continuously monitor the personalization on your website. This can be done from the Reporting dashboard. diff --git a/13/umbraco-engage/developers/settings/custom-goals-scoring.md b/13/umbraco-engage/developers/settings/custom-goals-scoring.md index b28508a312d..69b7308d8f7 100644 --- a/13/umbraco-engage/developers/settings/custom-goals-scoring.md +++ b/13/umbraco-engage/developers/settings/custom-goals-scoring.md @@ -18,7 +18,7 @@ Creating the goal is similar to creating a page view or page event goal. The **g ![goal id](../../.gitbook/assets/engage-custom-goal-ID.png) -## Trigger goal in C\# +## Trigger goal in C# To trigger the goal, execute C# code during the visitor's pageview. Inject `Umbraco.Engage.Business.Analytics.Goals.IGoalService`, which has a `TriggerGoal(long goalId, int value)` method. An implementation looks like: @@ -45,7 +45,7 @@ The method automatically determines the current page view, linking the goal to a To trigger a goal outside of an HTTP request, use the overload of **TriggerGoal** that takes the GUID of the pageview. -Retrieve this pageview GUID during the original request using the **Umbraco.Engage.Business.Analytics.Common.IPageviewGuidManager**. You will need to store this pageview GUID for later use when invoking: +Retrieve the pageview GUID in the original request using **Umbraco.Engage.Business.Analytics.Common.IPageviewGuidManager**. You will need to store this pageview GUID for later use when invoking: ```cs _goalService.TriggerGoal(pageviewGuid, goalId, value); diff --git a/13/umbraco-engage/getting-started/for-developers/README.md b/13/umbraco-engage/getting-started/for-developers/README.md index f3b7c52ff95..323d0cb41b4 100644 --- a/13/umbraco-engage/getting-started/for-developers/README.md +++ b/13/umbraco-engage/getting-started/for-developers/README.md @@ -16,7 +16,7 @@ Get insights on sizing your infrastructure to meet your project's demands. Discover best practices for setting up load balancing and managing continuous integration and deployment environments. -## [Content Delivery Network Recommendations](content-delivery-network-recommendations.md) +## [Content Delivery Network (CDN) Recommendations](content-delivery-network-recommendations.md) Explore recommended CDN options to improve content delivery speeds. diff --git a/13/umbraco-engage/getting-started/for-marketers-and-editors/cockpit.md b/13/umbraco-engage/getting-started/for-marketers-and-editors/cockpit.md index 076e9221d3c..240e24ab803 100644 --- a/13/umbraco-engage/getting-started/for-marketers-and-editors/cockpit.md +++ b/13/umbraco-engage/getting-started/for-marketers-and-editors/cockpit.md @@ -11,25 +11,17 @@ The cockpit lets you check out all the stored data when browsing the website. It You should see the Umbraco Engage Cockpit on the left or right side of the screen: -
- -
Cockpit

Cockpit

- -
+![Cockpit](../../.gitbook/assets/engage-cockpit-3.png) Click **Open** to see all the features of the Cockpit: -
- -
Cockpit features

Cockpit features

- -
+![Cockpit features](../../.gitbook/assets/engage-cockpit-overview.png) ## Access to the cockpit When the Umbraco Engage code has been added to the page you can see it when you are logged in to Umbraco. Visitors to your website do not have access to the Cockpit. -If you do not see the Cockpit while the Umbraco back-office runs on a different domain please contact the technical team and refer to the [load balancing / CM / CD environments](../for-developers/loadbalancing-and-cm-cd-environments.md) section. +If the Cockpit is missing while the Umbraco backoffice runs on a different domain, contact the technical team. You can also refer to the [Load Balancing and CM/CD Environments](../for-developers/loadbalancing-and-cm-cd-environments.md) article. ### Data reporting client-side @@ -43,11 +35,7 @@ The following information is tracked: * All [fired events](../../developers/analytics/client-side-events-and-additional-javascript-files/create-your-own-events.md) are tracked. * Every out-click to other domains, a pdf file or excel file is measured by default. -
- -
Cockpit Analytics.

Cockpit Analytics.

- -
+![Cockpit Analytics](../../.gitbook/assets/engage-cockpit-analytics.png) ### Data reporting server-side @@ -61,18 +49,10 @@ In this section you can see all the data that is captured on the server side: Also, you have the option to delete your Umbraco Engage cookie -
- -
Delete Umbraco Engage cookies.

Delete Umbraco Engage cookies.

- -
+![Delete Umbraco Engage cookies](../../.gitbook/assets/engage-cockpit-analytics-2.png) ### Segments In the segments section, you can see which segments are configured and which are applied to the current visitor. -
- -
Segments

Segments

- -
+![Segments](../../.gitbook/assets/engage-cockpit-personalization.png) diff --git a/13/umbraco-engage/getting-started/for-marketers-and-editors/marketing-resources.md b/13/umbraco-engage/getting-started/for-marketers-and-editors/marketing-resources.md index 3b41ba3ada2..f9b40b5bfda 100644 --- a/13/umbraco-engage/getting-started/for-marketers-and-editors/marketing-resources.md +++ b/13/umbraco-engage/getting-started/for-marketers-and-editors/marketing-resources.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Add extra Umbraco Engage functionality to your website using the templates detailed in this section. diff --git a/13/umbraco-engage/installation/licensing.md b/13/umbraco-engage/installation/licensing.md index caa7f6c0112..7f3e7993236 100644 --- a/13/umbraco-engage/installation/licensing.md +++ b/13/umbraco-engage/installation/licensing.md @@ -44,7 +44,7 @@ There are a few differences as to what the licenses cover: * Each individual subdomain has to be specified as part of the license (e.g. `subdomain.mysite.com`), wildcard subdomains are not allowed. {% hint style="info" %} -If you have multiple backoffice domains pointing at the same installation, you have the option to purchase and [add **additional domains**](the-licensing-model.md#add-additional-domains) to your license. +If multiple backoffice domains share the same installation, you have to purchase and add [**additional domains**](the-licensing-model.md#add-additional-domains) to your license. This is an add-on domain for existing licenses. Refunds will not be given for this product. {% endhint %} diff --git a/13/umbraco-engage/marketers-and-editors/ab-testing/README.md b/13/umbraco-engage/marketers-and-editors/ab-testing/README.md index fd4dddd356b..aea82f48b54 100644 --- a/13/umbraco-engage/marketers-and-editors/ab-testing/README.md +++ b/13/umbraco-engage/marketers-and-editors/ab-testing/README.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Umbraco Engage offers multiple ways for performaing A/B tests on your website. Learn more about each option and how to configure them in this section. diff --git a/13/umbraco-engage/marketers-and-editors/ab-testing/ab-test-distribution-algorithm.md b/13/umbraco-engage/marketers-and-editors/ab-testing/ab-test-distribution-algorithm.md index 6e4baadf4ab..c494a77b9cf 100644 --- a/13/umbraco-engage/marketers-and-editors/ab-testing/ab-test-distribution-algorithm.md +++ b/13/umbraco-engage/marketers-and-editors/ab-testing/ab-test-distribution-algorithm.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Umbraco Engage distributes visitors randomly across the different variants of your A/B tests. diff --git a/13/umbraco-engage/marketers-and-editors/ab-testing/finish-an-ab-test.md b/13/umbraco-engage/marketers-and-editors/ab-testing/finish-an-ab-test.md index 3e88a712bf2..0b6ba622288 100644 --- a/13/umbraco-engage/marketers-and-editors/ab-testing/finish-an-ab-test.md +++ b/13/umbraco-engage/marketers-and-editors/ab-testing/finish-an-ab-test.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- When the A/B test has enough data for a statistically complete picture, Umbraco Engage will notify you. You can also end the test at any time. diff --git a/13/umbraco-engage/marketers-and-editors/ab-testing/front-end-rendering.md b/13/umbraco-engage/marketers-and-editors/ab-testing/front-end-rendering.md index 240ab4aaca8..3fbf1b7e726 100644 --- a/13/umbraco-engage/marketers-and-editors/ab-testing/front-end-rendering.md +++ b/13/umbraco-engage/marketers-and-editors/ab-testing/front-end-rendering.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Umbraco Engage takes care of applying the correct styles to the pages part of your A/B tests. diff --git a/13/umbraco-engage/marketers-and-editors/ab-testing/monitor-the-ab-test.md b/13/umbraco-engage/marketers-and-editors/ab-testing/monitor-the-ab-test.md index 6b7d3d1051c..e3d9156dfaa 100644 --- a/13/umbraco-engage/marketers-and-editors/ab-testing/monitor-the-ab-test.md +++ b/13/umbraco-engage/marketers-and-editors/ab-testing/monitor-the-ab-test.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Umbraco Engage provides the ability to continuously monitor the A/B tests you are running on your website. It is recommended to disable tests that perform diff --git a/13/umbraco-engage/marketers-and-editors/ab-testing/previewing-an-ab-test.md b/13/umbraco-engage/marketers-and-editors/ab-testing/previewing-an-ab-test.md index 6f118616e70..49a082c7f3e 100644 --- a/13/umbraco-engage/marketers-and-editors/ab-testing/previewing-an-ab-test.md +++ b/13/umbraco-engage/marketers-and-editors/ab-testing/previewing-an-ab-test.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- When running A/B tests using Umbraco Engage it recommended to preview the test before running it. Learn how this is done. diff --git a/13/umbraco-engage/marketers-and-editors/ab-testing/setting-up-the-ab-test.md b/13/umbraco-engage/marketers-and-editors/ab-testing/setting-up-the-ab-test.md index 87b5540155f..1c631cee10d 100644 --- a/13/umbraco-engage/marketers-and-editors/ab-testing/setting-up-the-ab-test.md +++ b/13/umbraco-engage/marketers-and-editors/ab-testing/setting-up-the-ab-test.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- To set up an A/B test in Umbraco Engage you need to go through a series of steps. Learn more about the required configuration is required for initating a diff --git a/13/umbraco-engage/marketers-and-editors/ab-testing/types-of-ab-tests/README.md b/13/umbraco-engage/marketers-and-editors/ab-testing/types-of-ab-tests/README.md index 0cb3364f938..77d9f2fa2f7 100644 --- a/13/umbraco-engage/marketers-and-editors/ab-testing/types-of-ab-tests/README.md +++ b/13/umbraco-engage/marketers-and-editors/ab-testing/types-of-ab-tests/README.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Get an overview of the available types of A/B tests you can run with Umbraco Engage. diff --git a/13/umbraco-engage/marketers-and-editors/ab-testing/types-of-ab-tests/document-type-test.md b/13/umbraco-engage/marketers-and-editors/ab-testing/types-of-ab-tests/document-type-test.md index 200f62d144c..763e770372f 100644 --- a/13/umbraco-engage/marketers-and-editors/ab-testing/types-of-ab-tests/document-type-test.md +++ b/13/umbraco-engage/marketers-and-editors/ab-testing/types-of-ab-tests/document-type-test.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Umbraco Engage enables running A/B tests on pages using a specified Document Type. This article covers how and when to use this type of test. diff --git a/13/umbraco-engage/marketers-and-editors/ab-testing/types-of-ab-tests/multiple-pages-test.md b/13/umbraco-engage/marketers-and-editors/ab-testing/types-of-ab-tests/multiple-pages-test.md index 250ed646429..5e735645d29 100644 --- a/13/umbraco-engage/marketers-and-editors/ab-testing/types-of-ab-tests/multiple-pages-test.md +++ b/13/umbraco-engage/marketers-and-editors/ab-testing/types-of-ab-tests/multiple-pages-test.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Umbraco Engage provides the option to run A/B tests across multiple pages. This article covers how and when to use this type of test. diff --git a/13/umbraco-engage/marketers-and-editors/ab-testing/types-of-ab-tests/single-page-ab-test.md b/13/umbraco-engage/marketers-and-editors/ab-testing/types-of-ab-tests/single-page-ab-test.md index 8aab3d53724..ffb55fce652 100644 --- a/13/umbraco-engage/marketers-and-editors/ab-testing/types-of-ab-tests/single-page-ab-test.md +++ b/13/umbraco-engage/marketers-and-editors/ab-testing/types-of-ab-tests/single-page-ab-test.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Umbraco Engage provides the option to set up A/B testing on individual pages. This article covers how and when to use this type of test. diff --git a/13/umbraco-engage/marketers-and-editors/ab-testing/what-is-ab-testing.md b/13/umbraco-engage/marketers-and-editors/ab-testing/what-is-ab-testing.md index 4e66a9aa9b8..24da876440c 100644 --- a/13/umbraco-engage/marketers-and-editors/ab-testing/what-is-ab-testing.md +++ b/13/umbraco-engage/marketers-and-editors/ab-testing/what-is-ab-testing.md @@ -1,27 +1,32 @@ +--- +description: >- + Learn how A/B testing helps optimize your website by comparing different versions to improve performance, integrated seamlessly with Umbraco Engage. +--- + # What is A/B testing It goes too far to give a total overview of what A/B testing is. There are some great resource out there that can inspire you and can go in real depth what A/B testing is. -For now we will stick with this explaination: A/B testing is a methodical way of testing (and hopefully improving) your website. By serving two or more versions of a webpage, contentblock or website to different visitors results can be gathered which version is performing better for a specific conversion goal. +For now we will stick with this explaination: A/B testing is a methodical way of testing (and hopefully improving) your website. By serving multiple versions of a webpage, content block, or website to different visitors, gathering data on which version performs better for a specific goal. ## Why should you A/B test your website? -Your website is always underperforming its potential. Your website will never have a conversion rate of 100% (all visitors do exactly what you want them to do) and probably not even near that conversion rate. By testing specific parts of your website you can experiment and hopefully increase your conversion rate. The internet gives you the ability to test with different variants of your website and see what happens. +Your website is always underperforming its potential. Your website will never have a conversion rate of 100% and probably not even near that conversion rate. All visitors do exactly what you want them to do. By testing specific parts of your website you can experiment and hopefully increase your conversion rate. The internet gives you the ability to test with different variants of your website and see what happens. ## A/B Testing in Umbraco -There are already a lot of great A/B testing tooling out there (Google Experiments, Optimizely, Visual Website Optimizer). They do a really great job on A/B testing but they all lack a key feature that Umbraco Engage has; Umbraco Engage is fully integrated within Umbraco. This allows you to integrate A/B testing in your daily workflow instead of an add-on on top of your website. This means: +There are already a lot of great A/B testing tooling out there (Google Experiments, Optimizely, Visual Website Optimizer). They do a really great job on A/B testing but they lack a key feature that Umbraco Engage offers: full integration within Umbraco. This allows you to integrate A/B testing in your daily workflow instead of an add-on on top of your website. This means: -* You can A/B test your content in exactly the same and user-friendly way that Umbraco does. This will enable you and your editors to start A/B testing really easy. -* The A/B test is rendered automatically without any additional line of code. This means that you don't have to reserve time to "implement A/B testing". It is just there and you can start immediately start testing. Also that means there is no content flickering like in many other tools (just for fun... Google for "[A/B Testing flickering](https://www.google.com/search?q=ab+testing+flickering)"...) -* You can use all the resources that Umbraco gives you. You can reuse images of the media library, you can pick contentblock as you are used, and you do not have to worry about changing url's while doing a test. +* You can A/B test your content in the same user-friendly way as Umbraco does, allowing you and your editors to start A/B testing. +* The A/B test is rendered automatically without any additional line of code. This means that you don't have to reserve time to "implement A/B testing". It is there and you can start testing immediately. Also that means there is no content flickering like in many other tools. +* You can use all the resources that Umbraco gives you. You can reuse images of the media library, you can pick contentblock as you are used, and you do not have to worry about changing URL's while doing a test. * Within Umbraco Engage you will see that A/B tests are running, so your fellow editors are aware of this and will not ruin your experiments * Because we use first-party analytics and cookies you will track data across all your visitors and not only on a subset of customers which do not have any ad- and cookie block tooling * Our A/B test is context aware and will make sure that the A/B test is render everywhere correctly. For example; if you are testing a catchy product title it will automatically not render only that new title on the page itself, but also on your overview, your homepage, your shopping cart or at any other place you're using the title. This is impossible with any other tool! ## Some great resources -There are a lot of books out there that do a great job explaining the importance of A/B testing and why you should start testing your website today. A short list of the books that inspired the Umbraco Engage team: +Many books explain the importance of A/B testing and why you should start testing your website today. A short list of the books that inspired the Umbraco Engage team: * Dan Siroker and Pete Koomen. _A/B Testing. The most powerful way to turn clicks into customers_. Hoboken, New Jersey: John Wiley & Sons, Inc., 2013. [Print](https://www.amazon.com/Testing-Most-Powerful-Clicks-Customers/dp/1118792416) * Chris Goward. _You should test that!_ Indianapolis, Indiana: John Wiley & Sons, Inc., 2013. [Print](https://www.amazon.com/You-Should-Test-That-Optimization/dp/1118301307) diff --git a/13/umbraco-engage/marketers-and-editors/analytics/campaigns.md b/13/umbraco-engage/marketers-and-editors/analytics/campaigns.md index 39919512759..7781a52d612 100644 --- a/13/umbraco-engage/marketers-and-editors/analytics/campaigns.md +++ b/13/umbraco-engage/marketers-and-editors/analytics/campaigns.md @@ -10,27 +10,29 @@ In the **Campaigns** tab of the Umbraco Engage, you can view all analytics data You can add five different parameters to your URLs: -* **utm\_source**: Identify the advertiser, site, publication that is sending traffic to your property. For example: google, newsletter4, billboard. -* **utm\_medium**: The advertising or marketing medium. For example: cpc, banner, email newsletter. -* **utm\_campaign**: The individual campaign name, slogan, promo code for a product. -* **utm\_term**: Identify paid search keywords. If you are manually tagging paid keyword campaigns, you should also use _utm\_term_ to specify the keyword. -* **utm\_content**: Used to differentiate similar content or links within the same ad. For example: if you have two call-to-action links within the same email message, you can use _utm\_content_ and set different values for each so you can tell which version is more effective. +* `utm_source`: Identify the advertiser, site, publication that is sending traffic to your property. For example: google, newsletter4, billboard. +* `utm_medium`: The advertising or marketing medium. For example: cpc, banner, email newsletter. +* `utm_campaign`: The individual campaign name, slogan, promo code for a product. +* `utm_term`: Identify paid search keywords. If you are manually tagging paid keyword campaigns, you should also use _utm_term_ to specify the keyword. +* `utm_content`: Used to differentiate similar content or links within the same ad. For example: if you have two call-to-action links within the same email message, you can use _utm_content_ and set different values for each so you can tell which version is more effective. Each parameter must be paired with a value that you assign. Each parameter-value pair then contains campaign-related information. -For example, if you want to link from a newsletter to the pricing page of the umbraco.com, you can use the following parameters: +For example, if you want to link from a newsletter to the pricing page of umbraco.com, you can use the following parameters: -* **utm\_source** = newsletter-july-2024 to identify that this visitor came from this specific newsletter -* **utm\_medium** = newsletter to show that the medium was a newsletter -* **utm\_campaign** = more\_signups because that newsletter was part of a larger campaign -* **utm\_content** = bottom\_button to identify a specific link in the newsletter +* `utm_source`: Newsletter-july-2024 to identify that this visitor came from this specific newsletter +* `utm_medium`: Newsletter to show that the medium was a newsletter +* `utm_campaign`: More_signups because that newsletter was part of a larger campaign +* `utm_content`: Bottom_button to identify a specific link in the newsletter If you want to use these parameters, you will need to set up the URL like: {% code overflow="wrap" %} -``` + +```none https://www.umbraco.com/pricing/?utm_source=newsletter-july-2024&utm_medium=newsletter&utm_campaign=more_signups&utm_content=bottom_button ``` + {% endcode %} ## Campaign Report diff --git a/13/umbraco-engage/marketers-and-editors/analytics/client-side-events-and-additional-javascript-files.md b/13/umbraco-engage/marketers-and-editors/analytics/client-side-events-and-additional-javascript-files.md index d4775618dce..cf69838de22 100644 --- a/13/umbraco-engage/marketers-and-editors/analytics/client-side-events-and-additional-javascript-files.md +++ b/13/umbraco-engage/marketers-and-editors/analytics/client-side-events-and-additional-javascript-files.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Learn about what scripts can be used to connect with other data-gathering tools. diff --git a/13/umbraco-engage/marketers-and-editors/analytics/forms.md b/13/umbraco-engage/marketers-and-editors/analytics/forms.md index 88480af3cd3..9afa6aef8ed 100644 --- a/13/umbraco-engage/marketers-and-editors/analytics/forms.md +++ b/13/umbraco-engage/marketers-and-editors/analytics/forms.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: Learn how data from Umbraco Forms is tracked with Umbraco Engage. --- diff --git a/13/umbraco-engage/marketers-and-editors/analytics/google-analytics-vs-umbraco-engage.md b/13/umbraco-engage/marketers-and-editors/analytics/google-analytics-vs-umbraco-engage.md index 9a23a41131b..f3b562724fe 100644 --- a/13/umbraco-engage/marketers-and-editors/analytics/google-analytics-vs-umbraco-engage.md +++ b/13/umbraco-engage/marketers-and-editors/analytics/google-analytics-vs-umbraco-engage.md @@ -8,4 +8,4 @@ description: >- You can see a difference in statistics (Pageviews, Visitors, etc.) between Google Analytics and Umbraco Engage. -Umbraco Engage will collect pageviews unless Google Analytics / GTM is blocked or GA / GTM cookies are not accepted. So approx. 10% - 25% more pageviews in Umbraco Engage compared to GA should be considered as normal depending on the audience with the current available information. +Umbraco Engage will collect pageviews unless Google Analytics (GA)/Google Tag Manager (GTM) is blocked or GA/GTM cookies are not accepted. So approx. 10% - 25% more pageviews in Umbraco Engage compared to GA should be considered as normal depending on the audience with the current available information. diff --git a/13/umbraco-engage/marketers-and-editors/analytics/location.md b/13/umbraco-engage/marketers-and-editors/analytics/location.md index 7ad482f788d..34479d3deac 100644 --- a/13/umbraco-engage/marketers-and-editors/analytics/location.md +++ b/13/umbraco-engage/marketers-and-editors/analytics/location.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: Learn about what localization data is tracked and how you can view it. --- diff --git a/13/umbraco-engage/marketers-and-editors/analytics/scroll-heatmap.md b/13/umbraco-engage/marketers-and-editors/analytics/scroll-heatmap.md index 70e412b4a5c..2bf46820812 100644 --- a/13/umbraco-engage/marketers-and-editors/analytics/scroll-heatmap.md +++ b/13/umbraco-engage/marketers-and-editors/analytics/scroll-heatmap.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Learn how you can use the Scroll Heatmap in Umbraco Engage to gather data on the behaviour of your visitors. diff --git a/13/umbraco-engage/marketers-and-editors/analytics/types-of-clients.md b/13/umbraco-engage/marketers-and-editors/analytics/types-of-clients.md index 0d6aa0253af..0a1213017cd 100644 --- a/13/umbraco-engage/marketers-and-editors/analytics/types-of-clients.md +++ b/13/umbraco-engage/marketers-and-editors/analytics/types-of-clients.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Learn more about how Umbraco Engage distinguishes between bots and real visitors. @@ -7,9 +6,9 @@ description: >- # Types Of Clients -Engage only tracks '**real**' visitors and discard any visit we determine to be from a bot. The data for bots is not stored in Umbraco Engage and cannot be viewed in the Analytics section. \ -\ -From an SEO perspective, bots, search engine crawlers, spiders, and the like, will always see the default content so no personalization and no participation in an A/B test. +Engage tracks only **real** visitors, filtering out bot traffic. The data for bots is not stored in Umbraco Engage and is excluded from the Analytics section. + +From a Search Engine Optimization (SEO) perspective, bots and crawlers always see the default content, with no personalization or participation in A/B tests. The tracking of a visitor is done via the following steps: diff --git a/13/umbraco-engage/marketers-and-editors/analytics/videos.md b/13/umbraco-engage/marketers-and-editors/analytics/videos.md index c99f89d5f90..cc06ab6bfe8 100644 --- a/13/umbraco-engage/marketers-and-editors/analytics/videos.md +++ b/13/umbraco-engage/marketers-and-editors/analytics/videos.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: This article describes what data is tracked from videos on your website. --- diff --git a/13/umbraco-engage/marketers-and-editors/analytics/what-is-measured-by-default.md b/13/umbraco-engage/marketers-and-editors/analytics/what-is-measured-by-default.md index bf4d2e47f21..5e014ac3b85 100644 --- a/13/umbraco-engage/marketers-and-editors/analytics/what-is-measured-by-default.md +++ b/13/umbraco-engage/marketers-and-editors/analytics/what-is-measured-by-default.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: Learn what Umbraco Engage tracks before any additional configuration is added. --- diff --git a/13/umbraco-engage/marketers-and-editors/introduction/README.md b/13/umbraco-engage/marketers-and-editors/introduction/README.md index cd8d7819229..613af289534 100644 --- a/13/umbraco-engage/marketers-and-editors/introduction/README.md +++ b/13/umbraco-engage/marketers-and-editors/introduction/README.md @@ -7,7 +7,7 @@ description: >- # Introduction -This section covers a range of topics, including an introduction to the platform and its various components, personalization, reporting, and so on. +This section covers topics such as an introduction to the platform, its components, personalization, reporting, and more.
AnalyticsanalyticsDocumentations Icons_Umbraco_Deploy_Setup.png
A/B Testingab-testingDocumentations Icons_Umbraco_Deploy_Deployment_Workflow (1).png
PersonalizationpersonalizationDocumentations Icons_Umbraco_Workflow_Section_Overview.png
diff --git a/13/umbraco-engage/marketers-and-editors/introduction/the-umbraco-engage-cookie.md b/13/umbraco-engage/marketers-and-editors/introduction/the-umbraco-engage-cookie.md index 6b180afe8f2..f15f401fea3 100644 --- a/13/umbraco-engage/marketers-and-editors/introduction/the-umbraco-engage-cookie.md +++ b/13/umbraco-engage/marketers-and-editors/introduction/the-umbraco-engage-cookie.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Learn how the Umbraco Engage cookie works and how the functionality can be tested. diff --git a/13/umbraco-engage/marketers-and-editors/personalization/implicit-and-explicit-personalization/campaign-scoring.md b/13/umbraco-engage/marketers-and-editors/personalization/implicit-and-explicit-personalization/campaign-scoring.md index da3b73499cf..e7e9c942d02 100644 --- a/13/umbraco-engage/marketers-and-editors/personalization/implicit-and-explicit-personalization/campaign-scoring.md +++ b/13/umbraco-engage/marketers-and-editors/personalization/implicit-and-explicit-personalization/campaign-scoring.md @@ -7,42 +7,44 @@ description: >- # Campaign Scoring -### Setting up your campaigns +## Setting up your campaigns Campaigns are automatically scored by using utm-parameters, that you may be already using for your marketing campaigns. You can add 5 different parameters to your URL: -* **utm\_source**: Identify the advertiser, site, publication, etc. that is sending traffic to your property, for example, Google, newsletter4, billboard. -* **utm\_medium**: The advertising or marketing medium, for example, CPC, banner, email newsletter. -* **utm\_campaign**: The individual campaign name, slogan, and promo code for a product. -* **utm\_term**: Identify paid search keywords. If you are manually tagging paid keyword campaigns, you should also use utm\_term to specify the keyword. -* **utm\_content**: Used to differentiate similar content, or links within the same ad. For example, if you have two call-to-action links within the same email message, you can use utm\_content and set different values for each so you can tell which version is more effective. +* `utm_source`: Identify the advertiser, site, publication, etc. that is sending traffic to your property, for example, Google, newsletter4, billboard. +* `utm_medium`: The advertising or marketing medium, for example, Cost Per Click (CPC), banner, email newsletter. +* `utm_campaign`: The individual campaign name, slogan, and promo code for a product. +* `utm_term`: Identify paid search keywords. If you are manually tagging paid keyword campaigns, you should also use utm_term to specify the keyword. +* `utm_content`: Used to differentiate similar content, or links within the same ad. For example, if you have two call-to-action links within the same email message, you can use utm_content and set different values for each so you can tell which version is more effective. Each parameter must be paired with a value that you assign. Each parameter-value pair then contains campaign-related information. For example, if you want to link from a newsletter to the pricing page of the umbraco.com, you can use the following parameters: -* **utm\_source** = newsletter-july-2024 to identify that this visitor came from this specific newsletter -* **utm\_medium** = newsletter to show that the medium was a newsletter -* **utm\_campaign** = more\_signups because that newsletter was part of a bigger campaign -* **utm\_content** = bottom\_button to identify a specific link in the newsletter +* `utm_source` = newsletter-july-2024 to identify that this visitor came from this specific newsletter +* `utm_medium` = newsletter to show that the medium was a newsletter +* `utm_campaign` = more_signups because that newsletter was part of a bigger campaign +* `utm_content` = bottom_button to identify a specific link in the newsletter If you want to use these parameters you'll need to set the URL as: {% code overflow="wrap" %} -``` + +```none https://www.umarketingsuite.com/pricing/?utm_source=newsletter-july-2021&utm_medium=newsletter&utm_campaign=more_signups&utm_content=bottom_button ``` + {% endcode %} -### Scoring your campaigns +## Scoring your campaigns Now that you've created URLs for campaigns they will automatically be tracked by Umbraco Engage and you can score them for implicit personalization purposes. going to **Personalization** -> **Campaign scoring** you will see all the campaign groups, the campaigns you already scored, and the campaigns that need scoring. -
Scoring your campaign.

Scoring your campaign.

+![Scoring your campaign](../../../.gitbook/assets/engage-personalization-campaign-scoring.png) -#### Creating a campaign group +### Creating a campaign group First, you need to create one or more campaign groups. Campaign groups allow grouping campaigns so you do not have to set personas and customer journey scoring for each campaign only on a group level. @@ -56,11 +58,11 @@ You can add a new campaign group by clicking "**Add new group**". This will open -In this case, we created a campaign group "**A campaign group for developers**" and assigned **7 points** to the **developer** persona. This means when visitors come to the website via a URL with utm-parameters part of this campaign group, get 7 points for the developer persona. +In this case, we created a campaign group "**A campaign group for developers**" and assigned **7 points** to the **developer** persona. Visitors arriving via a URL with utm-parameters part of this campaign group, get 7 points for the developer persona. Because we haven't assigned any campaigns yet, in this case, the group will never be triggered. -#### Unscored campaigns +### Unscored campaigns In the tab "**Unscored campaigns**" you find all campaigns that have not been assigned yet. Remember again that campaigns are created by adding `utm-parameters` to your URL. As soon as Umbraco Engage detects a new combination of utm-parameters it will add that combination to the list of Unscored Campaigns. @@ -68,7 +70,7 @@ An example of this tab could look like this:
Unscored campaigns.

Unscored campaigns.

-So here you see that in the last row, for example, the **utm\_source** is "**Activate account**", the **utm\_medium** is "**email**" and the **utm\_content** is "**click here to activate your account**". The URL that the visitor used to get to the website looked something like `https://?utm_source=activate account&utm_medium=email&utm_content=click here to activate your account.` +In the last row, for example, the `utm_source` is "**Activate account**", `utm_medium` is "**email**" and `utm_content` is **click here to activate your account**. The URL that the visitor used to get to the website looked something like `https://?utm_source=activate account&utm_medium=email&utm_content=click here to activate your account.` Every unscored campaign can be assigned to a campaign group by clicking on the "**Assign**" button. If you do that a popup will open that allows you to assign the specific campaign to one of your created campaign groups. @@ -78,9 +80,9 @@ Every unscored campaign can be assigned to a campaign group by clicking on the " -By assigning this example to the "**A campaign group for developers**" from now on every visitor that comes to the website with these `utm-parameters` set up will get the points assigned that are set up in the campaign group. In this example, this would be **7 points** for **developers**. +Assigning this to "**A campaign group for developers**" ensures all visitors with these `utm-parameters` will get the points assigned in the campaign group. In this example, this would be **7 points** for **developers**. -#### Scored campaigns +### Scored campaigns On this tab, you will see all the campaigns that are linked already to a campaign group. diff --git a/13/umbraco-engage/marketers-and-editors/profiling/external-profile-data.md b/13/umbraco-engage/marketers-and-editors/profiling/external-profile-data.md index ed2d19093ee..1d40d0a1cd1 100644 --- a/13/umbraco-engage/marketers-and-editors/profiling/external-profile-data.md +++ b/13/umbraco-engage/marketers-and-editors/profiling/external-profile-data.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Umbraco Engage does not provide a built-in way to add additional data to a profile. You can store the data in any format and in any way. diff --git a/13/umbraco-engage/marketers-and-editors/reporting.md b/13/umbraco-engage/marketers-and-editors/reporting.md index 33544b44e73..b6dbe7f0b18 100644 --- a/13/umbraco-engage/marketers-and-editors/reporting.md +++ b/13/umbraco-engage/marketers-and-editors/reporting.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- You should continuously monitor personalization on your website to make adjustments where needed. diff --git a/13/umbraco-engage/marketers-and-editors/settings/ip-filtering.md b/13/umbraco-engage/marketers-and-editors/settings/ip-filtering.md index e0586032f91..d633dc447c8 100644 --- a/13/umbraco-engage/marketers-and-editors/settings/ip-filtering.md +++ b/13/umbraco-engage/marketers-and-editors/settings/ip-filtering.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: You might want to exclude the traffic from specific IP addresses. --- diff --git a/13/umbraco-engage/marketers-and-editors/settings/permissions.md b/13/umbraco-engage/marketers-and-editors/settings/permissions.md index eb5e1486fe2..78659c9c97d 100644 --- a/13/umbraco-engage/marketers-and-editors/settings/permissions.md +++ b/13/umbraco-engage/marketers-and-editors/settings/permissions.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: Manage content apps and access on Document Types. --- diff --git a/13/umbraco-engage/marketers-and-editors/settings/setting-up-goals.md b/13/umbraco-engage/marketers-and-editors/settings/setting-up-goals.md index 6bbf3f6ddef..8270f17b397 100644 --- a/13/umbraco-engage/marketers-and-editors/settings/setting-up-goals.md +++ b/13/umbraco-engage/marketers-and-editors/settings/setting-up-goals.md @@ -8,7 +8,7 @@ description: >- Goals are important in Umbraco Engage. Without goals you cannot determine whether your optimization strategy through [A/B Testing](../ab-testing/) or [Personalization](../personalization/) really works. -A/B Testing and/or Personalization is never the goal; the goal is to increase your goals which can be achieved by personalization or A/B testing. +A/B Testing and/or Personalization is never the goal. The goal is to increase your goals which can be achieved by personalization or A/B testing. In the Goals menu, you can set up goals and specify their value. @@ -39,4 +39,3 @@ You can specify how the goal will be triggered: * Via some custom code

Create a new goal by giving it a name, setting a value and deciding on a set of parameters.

- diff --git a/13/umbraco-engage/marketers-and-editors/settings/the-configuration-file.md b/13/umbraco-engage/marketers-and-editors/settings/the-configuration-file.md index 7508c3c9098..0c15bde5c1b 100644 --- a/13/umbraco-engage/marketers-and-editors/settings/the-configuration-file.md +++ b/13/umbraco-engage/marketers-and-editors/settings/the-configuration-file.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: Here you have an overview of all configured settings of Umbraco Engage. --- diff --git a/13/umbraco-engage/security-and-privacy/gdpr/README.md b/13/umbraco-engage/security-and-privacy/gdpr/README.md index 1c340eecd3a..dd86acabab1 100644 --- a/13/umbraco-engage/security-and-privacy/gdpr/README.md +++ b/13/umbraco-engage/security-and-privacy/gdpr/README.md @@ -1,3 +1,8 @@ +--- +description: >- + Read how Umbraco Engage is designed with GDPR compliance in mind, ensuring data privacy through first-party cookies, data anonymization, and retention controls. +--- + # GDPR & EU regulation **Disclaimer**: Always check you are GDPR compliant with your own privacy office or legal department @@ -41,6 +46,6 @@ Remember to adjust the template to match the configuration on your website. [The Umbraco Engage cookie can be categorized as both an analytical and a personalization cookie.](../../developers/introduction/the-umbraco-engage-cookie/) The cookie is used to analyze website visitor behavior and personalize content based on this behavior. Based on the GDPR and ePrivacy Directive cookie consent is required for gathering analytic and personalization data. -As a customer and the controller of the personal data processed, **it is your responsibility to obtain consent from the website visitor for the use of the Umbraco Engage cookie**. Consent can be obtained using a cookie banner. +As the data controller **it is your responsibility to obtain consent from the website visitor for the use of the Umbraco Engage cookie**. Consent can be obtained using a cookie banner. -You can [control the features ](../../developers/introduction/the-umbraco-engage-cookie/module-permissions.md)and give your visitors total control over which features they wish to enable. +You can [control the features](../../developers/introduction/the-umbraco-engage-cookie/module-permissions.md)and give your visitors total control over which features they wish to enable. diff --git a/13/umbraco-engage/security-and-privacy/how-it-works.md b/13/umbraco-engage/security-and-privacy/how-it-works.md index 8159ef99cb5..4444603e62d 100644 --- a/13/umbraco-engage/security-and-privacy/how-it-works.md +++ b/13/umbraco-engage/security-and-privacy/how-it-works.md @@ -1,3 +1,8 @@ +--- +description: >- + Explore how Umbraco Engage collects browsing behavior data upon cookie acceptance to enable analytics, A/B testing, content personalization, and user profiling, all stored locally. +--- + # How it works When visitors accept the Umbraco Engage cookie on the website, it allows Umbraco Engage to collect and store data about browsing behavior, preferences, and interactions. This data can include pages visited, time spent on each page, actions taken on the site, and more. This data cannot be shared with 3rd parties because the data is stored in the local database of the site. diff --git a/13/umbraco-engage/support.md b/13/umbraco-engage/support.md index b292a8b454b..41e49ea9769 100644 --- a/13/umbraco-engage/support.md +++ b/13/umbraco-engage/support.md @@ -1,6 +1,11 @@ +--- +description: >- + The article explains how to seek support through Umbraco's website to create a support request. +--- + # Support -### Looking for support? +## Looking for support? Seeking support or guidance? Go to [umbraco.com](https://umbraco.com) and look for the friendly speech bubble icon in the bottom right corner of your screen. Click on it, and you can open a new support request. diff --git a/13/umbraco-engage/tutorials/README.md b/13/umbraco-engage/tutorials/README.md index e7fa7837d66..cd398fdd349 100644 --- a/13/umbraco-engage/tutorials/README.md +++ b/13/umbraco-engage/tutorials/README.md @@ -13,4 +13,3 @@ Use the tutorials in this section to learn how Umbraco Engage works and set up s ## [How to set up an A/B Test](set-up-your-first-ab-test.md) ## [Marketing Resources](marketing-resources/) - diff --git a/13/umbraco-engage/tutorials/how-to-get-started-with-personalization.md b/13/umbraco-engage/tutorials/how-to-get-started-with-personalization.md index be4de3b1a13..4537481245d 100644 --- a/13/umbraco-engage/tutorials/how-to-get-started-with-personalization.md +++ b/13/umbraco-engage/tutorials/how-to-get-started-with-personalization.md @@ -45,7 +45,7 @@ With the Persona groups and Personas in place, it is time to evaluate and score 7. Repeat steps 2-5 for each content item you want to score based on your personas. {% hint style="info" %} -Do not score generic content like your main landing page, as this does not add value to identifying the intention of the website visitors. +Avoid scoring generic content, such as the main landing page, as it does not help identify the website visitors intention. {% endhint %} ## Step 3: Build Segments @@ -81,7 +81,7 @@ Repeat steps 3-9 above to create and set up additional segments. ## Step 4: Collect Data -When collecting data you want to know if the segments are becoming active and you will want visitors to fall within the segments you have set up. With the reporting features within Umbraco Engage, you can measure how a certain segment performs. You can measure the following: +When collecting data, it is essential to know if segments are activating and if visitors align with the segments you have set up. With the reporting features within Umbraco Engage, you can measure how a certain segment performs. You can measure the following: * How many sessions a certain segment has had compared to the total number of sessions? * How many page views does a certain segment have? @@ -156,13 +156,13 @@ Find some guides below to make adjustments to your personalized content. ### Edit an existing variant -After setting up a personalized variant of a content item, you can add custom CSS and Javascript. Follow the steps below to learn how. +After setting up a personalized variant of a content item, you can add custom CSS and JavaScript. Follow the steps below to learn how. 1. Navigate to the content item with the variant you want to edit. 2. Open the **Personalization** view. -3. Select **EDIT** on the variant you want to make changes to. +3. Select **Edit** on the variant you want to make changes to. 4. Click on the **Edit variant** button below the Page Title. -5. Add your custom CSS and/or Javascript. +5. Add your custom CSS and/or JavaScript.

Edit the variant to add custom CSS and/or JavaScript to the variant.

@@ -175,7 +175,7 @@ In some cases, you might want to change the status of a variant. Follow the step 1. Navigate to the content item with the variant you want to edit. 2. Open the **Personalization** view. -3. Select **EDIT** on the variant you want to edit. +3. Select **Edit** on the variant you want to edit. 4. Click on the **Edit variant** button below the Page Title. 5. Use the toggle at the bottom of the pop-up to change the variant status. diff --git a/13/umbraco-engage/tutorials/marketing-resources/README.md b/13/umbraco-engage/tutorials/marketing-resources/README.md index 6d878af37de..f6afaec7088 100644 --- a/13/umbraco-engage/tutorials/marketing-resources/README.md +++ b/13/umbraco-engage/tutorials/marketing-resources/README.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- Add extra functionality to your website using the templates detailed in this section. diff --git a/13/umbraco-engage/tutorials/marketing-resources/generic-exit-intent-popup-template.md b/13/umbraco-engage/tutorials/marketing-resources/generic-exit-intent-popup-template.md index 02fa0f6e885..f847e3dd022 100644 --- a/13/umbraco-engage/tutorials/marketing-resources/generic-exit-intent-popup-template.md +++ b/13/umbraco-engage/tutorials/marketing-resources/generic-exit-intent-popup-template.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- To boost the marketing activitites on your website, you can add an exit intent popup to you website. Find a template for the popup in this article. diff --git a/13/umbraco-engage/tutorials/marketing-resources/generic-popup-template.md b/13/umbraco-engage/tutorials/marketing-resources/generic-popup-template.md index f92d1b9a9d2..986ac66320b 100644 --- a/13/umbraco-engage/tutorials/marketing-resources/generic-popup-template.md +++ b/13/umbraco-engage/tutorials/marketing-resources/generic-popup-template.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- To boost the marketing activitites on your website, you can add a Umbraco Engage popup to you website. Find a template for the popup in this article. diff --git a/13/umbraco-engage/tutorials/marketing-resources/generic-topbar-template.md b/13/umbraco-engage/tutorials/marketing-resources/generic-topbar-template.md index 5cf358e40f3..6b5d94edbaf 100644 --- a/13/umbraco-engage/tutorials/marketing-resources/generic-topbar-template.md +++ b/13/umbraco-engage/tutorials/marketing-resources/generic-topbar-template.md @@ -1,5 +1,4 @@ --- -icon: square-exclamation description: >- To boost the marketing activitites on your website, you can add a uMS top bar to you website. Find a template for the top bar in this article. diff --git a/13/umbraco-engage/tutorials/set-up-your-first-ab-test.md b/13/umbraco-engage/tutorials/set-up-your-first-ab-test.md index c810c59d562..44d0da926a7 100644 --- a/13/umbraco-engage/tutorials/set-up-your-first-ab-test.md +++ b/13/umbraco-engage/tutorials/set-up-your-first-ab-test.md @@ -27,10 +27,10 @@ The first step to setting up an A/B test on your website is to define a solid pl This tutorial does not cover defining a plan or what makes a project valid for testing. However, find some general recommendations below. * **Set a Clear Objective:** Start by defining a specific goal for your A/B test. Knowing what you aim to improve or measure allows you to design the test accordingly. For example, do you want more clicks on a button, a higher conversion rate, or something else? -* **Ensure a valid amount of data:** A significant amount of traffic and conversions is important to produce reliable results from A/B tests. Use a tool like the ROAR: Risk, Optimization, Automation, Re-think model to determine whether your website is eligible. +* **Ensure a valid amount of data:** A significant amount of traffic and conversions is important to produce reliable results from A/B tests. Use a tool like the Risk Optimization Automation Rethink (ROAR) model to determine whether your website is eligible. * **Develop a Hypothesis:** Based on your objective, create a clear hypothesis. This should include what change you expect and why. The stronger your hypothesis, the more valuable your test results will be. -When you have ensured that your website is eligible for testing and you have a clear hypothesis and an objective, you are ready to set up the test. +Once you have confirmed your website is eligible for testing and defined a clear hypothesis and objective, you are ready to set up the test. ## Choose test type