@oddin-gg/havik-player 2.8.0 → 2.9.0

package/README.md

@@ -207,6 +207,29 @@ A ready-to-host template lives in the repo at [`embed/index.html`](embed/index.h
 > which is what havik-streams matches against; there is no `Origin` header on a
 > top-level iframe nav.
 
+The injected config also takes `analytics`, forwarded to the managed player.
+Set it when `baseUrl` is not a `feed` host, or QoE beacons stay off. See
+[Analytics](#analytics-qoe-beacons).
+
+```js
+window.HAVIK_EMBED_CONFIG = {
+  baseUrl: 'https://cdn.example.com',
+  matchUrn: 'od:match:1234',
+  apiKey: 'pk_test_…',
+  parentOrigin: 'https://your-site.example',
+  analytics: { endpoint: 'https://beacons.oddin-video.gg' },
+};
+```
+
+`analytics` is read from the injected config only. It names a telemetry sink,
+so the query string is not allowed to set one.
+
+That has a consequence worth knowing before you pick a Mode C path.
+`mountEmbed` passes its config to the embed page as query parameters, so it
+cannot carry `analytics` either. If your `baseUrl` is not a `feed` host and
+you need beacons, host the embed page yourself and inject the config. A
+`mountEmbed` integration on a non-feed base has no way to turn analytics on.
+
 ---
 
 ## Live pickup (`waitForLive`)