[DOCS] Migrate Behavioral Analytics docs to ES ref (elastic#100704) (elastic#100799)

* [DOCS] Migrate Behavioral Analytics docs to ES ref

* Fix typo

* Fix attributes

* Rename top level heading, fix requirements

* Address review suggestions

Author: leemthompo

docs/reference/redirects.asciidoc

@@ -1953,32 +1953,3 @@ coming::[8.11.0]
 
 coming::[8.11.0]
 
-[role="exclude",id="behavioral-analytics-overview"]
-=== Elastic Behavioral Analytics
-
-coming::[8.11.0]
-
-[role="exclude",id="behavioral-analytics-start"]
-=== Get started with Behavioral Analytics
-
-coming::[8.11.0]
-
-[role="exclude",id="behavioral-analytics-api"]
-=== Behavioral Analytics APIs
-
-coming::[8.11.0]
-
-[role="exclude",id="behavioral-analytics-event"]
-=== View Behavioral Analytics Events
-
-coming::[8.11.0]
-
-[role="exclude",id="behavioral-analytics-event-reference"]
-=== Behavioral Analytics events reference
-
-coming::[8.11.0]
-
-[role="exclude",id="behavioral-analytics-cors"]
-=== Set up CORS for Behavioral Analytics
-
-coming::[8.11.0]

docs/reference/search/search-your-data/behavioral-analytics/behavioral-analytics-api.asciidoc

@@ -0,0 +1,40 @@
+[[behavioral-analytics-api]]
+=== Behavioral Analytics API overview
+++++
+<titleabbrev>API overview</titleabbrev>
+++++
+
+This page outlines all the APIs available for behavioral analytics and links to their documentation.
+
+[discrete]
+[[behavioral-analytics-api-es-rest]]
+==== Behavioral Analytics REST APIs
+
+Behavioral Analytics relies on a number of {es} APIs to manage analytics collections.
+Refer to the <<behavioral-analytics-apis,API documentation>> for the details.
+
+[discrete]
+[[behavioral-analytics-api-clients]]
+==== Behavioral Analytics Clients
+
+Behavioral Analytics integrates onto your website using one of our JavaScript clients:
+
+* *Browser tracker* - integrated into your website using a `<script>` tag.
+** View the https://github.com/elastic/behavioral-analytics-tracker/tree/main/packages/browser-tracker[`README` in GitHub^].
+* *Javascript Tracker* - integrated into your website using a JavaScript module.
+** View the https://github.com/elastic/behavioral-analytics-tracker/tree/main/packages/javascript-tracker[`README` in GitHub^].
+
+[discrete]
+[[behavioral-analytics-api-search-ui]]
+==== Search UI integration
+
+To simplify the integration of Behavioral Analytics into your website, we provide a Search UI integration.
+This integration automatically sends Behavioral Analytics events to your collection as your customer interacts with your search experience.
+
+Refer to the https://docs.elastic.co/search-ui/api/core/plugins/analytics-plugin[Search UI analytics plugin documentation^].
+
+[discrete]
+[[behavioral-analytics-api-searchkit]]
+==== Searchkit integration
+
+Behavioral Analytics also integrates with https://www.searchkit.co[Searchkit^], an open source library for building UIs on top of {es}.

docs/reference/search/search-your-data/behavioral-analytics/behavioral-analytics-cors.asciidoc

@@ -0,0 +1,46 @@
+[[behavioral-analytics-cors]]
+=== Set up CORS for Behavioral Analytics
+++++
+<titleabbrev>Set up CORs</titleabbrev>
+++++
+
+Behavioral Analytics sends events directly to the {es} API.
+This means that the browser makes requests to the {es} API directly.
+{es} supports https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS[Cross-Origin Resource Sharing (CORS)^], but this feature is disabled by default.
+Therefore the browser will block these requests.
+
+There are two workarounds for this:
+
+* <<behavioral-analytics-cors-enable-cors-elasticsearch, Enable CORS on {es}>>
+* <<behavioral-analytics-cors-proxy-request, Proxy the request through a server that supports CORS>>
+
+[discrete]
+[[behavioral-analytics-cors-enable-cors-elasticsearch]]
+==== Enable CORS on {es}
+
+This is the simplest option.
+Enable CORS on {es} by adding the following to your `elasticsearch.yml` file:
+
+[source,yaml]
+----
+http.cors.allow-origin: "*" # Only use unrestricted value for local development
+# Use a specific origin value in production, like `http.cors.allow-origin: "https://<my-website-domain.example>"`
+http.cors.enabled: true
+http.cors.allow-credentials: true
+http.cors.allow-methods: OPTIONS, POST
+http.cors.allow-headers: X-Requested-With, X-Auth-Token, Content-Type, Content-Length, Authorization, Access-Control-Allow-Headers, Accept
+----
+
+On Elastic Cloud, you can do this by {cloud}/ec-add-user-settings.html#ec-add-user-settings[editing your {es} user settings].
+
+. From your deployment menu, go to the *Edit* page.
+. In the *{es}* section, select *Manage user settings and extensions*.
+. Update the user settings with the configuration above.
+. Select *Save changes*.
+
+[discrete]
+[[behavioral-analytics-cors-proxy-request]]
+==== Proxy the request through a server that supports CORS
+
+If you are unable to enable CORS on {es}, you can proxy the request through a server that supports CORS.
+This is more complicated, but is a viable option.