/* * segment-tracking.js — Benzinga APIs docs (docs.benzinga.com) * ------------------------------------------------------------------- * Sends Segment track events: * - button_event → button/link clicks * - content_interaction_event → accordion / code / dropdown interactions * - page_event → page load + client-side route changes * Drop in your Mintlify content directory; auto-injected on every page (Pro). * * Loads Segment (analytics.js) itself — `integrations.segment` is intentionally * removed from docs.json so Mintlify never emits its built-in `docs.*` events * (docs.content.view, docs.navitem.click, …). Only the custom events below * are sent to Segment. * * Payload shape (per the 05/04/2026 event doc): * { type:"track", event:"button_event", * properties:{ action:"click", event_data:{ ...fields } } } * ------------------------------------------------------------------- */ // Segment loader. We bootstrap analytics.js here instead of via docs.json's // `integrations.segment`, which keeps Mintlify from firing its built-in // `docs.*` events. The write key is chosen by environment, so no manual swap // is needed before committing. (function () { // Production docs run on *.benzinga.com; everything else (localhost, preview // tunnels, staging) uses the dev key. var PROD_KEY = "On5BFQAKsT2n0HnL6IWRCiJMusJmf7BY"; var DEV_KEY = "LKtliGWgSpnpFdIYNHF6AlFWtcT1GirV"; var host = (window.location.hostname || "").toLowerCase(); var WRITE_KEY = /(^|\.)benzinga\.com$/.test(host) ? PROD_KEY : DEV_KEY; var analytics = (window.analytics = window.analytics || []); if (analytics.initialize) return; if (analytics.invoked) { window.console && console.error && console.error("Segment snippet included twice."); return; } analytics.invoked = true; analytics.methods = [ "trackSubmit", "trackClick", "trackLink", "trackForm", "pageview", "identify", "reset", "group", "track", "ready", "alias", "debug", "page", "screen", "once", "off", "on", "addSourceMiddleware", "addIntegrationMiddleware", "setAnonymousId", "addDestinationMiddleware", "register", ]; analytics.factory = function (method) { return function () { var args = Array.prototype.slice.call(arguments); args.unshift(method); analytics.push(args); return analytics; }; }; for (var i = 0; i < analytics.methods.length; i++) { var key = analytics.methods[i]; analytics[key] = analytics.factory(key); } analytics.load = function (key, opts) { var script = document.createElement("script"); script.type = "text/javascript"; script.async = true; script.setAttribute("data-global-segment-analytics-key", "analytics"); script.src = "https://cdn.segment.com/analytics.js/v1/" + key + "/analytics.min.js"; var first = document.getElementsByTagName("script")[0]; first.parentNode.insertBefore(script, first); analytics._loadOptions = opts; }; analytics._writeKey = WRITE_KEY; analytics.SNIPPET_VERSION = "5.2.0"; analytics.load(WRITE_KEY); // Intentionally NOT calling analytics.page() — our page_event covers views. })(); (function () { "use strict"; var VERSION = "1.0.0"; // release_version (universal field) var SITE = "docs"; // site (universal field) — docs.benzinga.com // Items in the "Copy page" split-button dropdown (docs.json "contextual": // copy, view, cursor, chatgpt, claude). Used to scope the radix menu, which // is portaled to with no stable id of its own. var PAGE_CONTEXT_LABELS = [ "copy page", "view as markdown", "connect to cursor", "open in chatgpt", "open in claude", ]; function getUrlParams() { var params = {}; try { new URLSearchParams(window.location.search).forEach(function (v, k) { params[k] = v; }); } catch (e) {} return params; } function clean(obj) { return Object.fromEntries( Object.entries(obj).filter(function (e) { var v = e[1]; return v !== undefined && v !== null && v !== ""; }) ); } function text(el) { return (el.textContent || "").replace(/\s+/g, " ").trim(); } // Runs cb once window.analytics exists. Segment's snippet usually creates a // queueing stub synchronously, but guard against a slower async load so the // initial page_event isn't dropped. Polls ~100ms up to ~5s, then gives up. function whenAnalyticsReady(cb, tries) { tries = tries == null ? 50 : tries; if (window.analytics) return cb(); if (tries <= 0) return; setTimeout(function () { whenAnalyticsReady(cb, tries - 1); }, 100); } // Lowercase snake_case slug: "Try it" → "try_it", // "Feedback & Requests" → "feedback_requests". function toSnake(s) { return (s || "") .trim() .toLowerCase() .replace(/[^a-z0-9]+/g, "_") .replace(/^_+|_+$/g, ""); } // Visible text of a link, ignoring .sr-only; falls back to the .sr-only text // (icon-only links like socials/logo expose their label that way). function linkLabel(el) { var clone = el.cloneNode(true); var hidden = clone.querySelectorAll(".sr-only"); for (var i = 0; i < hidden.length; i++) hidden[i].remove(); var visible = (clone.textContent || "").replace(/\s+/g, " ").trim(); if (visible) return visible; var sr = el.querySelector(".sr-only"); return (sr && sr.textContent.replace(/\s+/g, " ").trim()) || el.getAttribute("aria-label") || ""; } /* * Builds a dynamic button_id from the current URL + the button label, e.g. * /ws-reference/data-websocket/get-consensus-ratings-stream + "Connect" * → "consensus_ratings_stream_connect" * Takes the last path segment, drops a leading HTTP-verb prefix * (get|post|put|patch|delete), turns dashes into underscores, and appends * the lowercased label (spaces → underscores). */ function buildButtonId(label) { var path = window.location.pathname.replace(/\/+$/, ""); var last = (path.split("/").pop() || "") .replace(/^(get|post|put|patch|delete)-/i, "") .replace(/-/g, "_") .toLowerCase(); var lbl = (label || "") .trim() .toLowerCase() .replace(/\s+/g, "_"); return [last, lbl].filter(Boolean).join("_"); } /* * Built-in Mintlify elements you can't tag from MDX. * Match by a stable selector and return the event_data for it. * Add more entries here (sidebar nav, copy-page, etc.) the same way. */ var BUILTIN_BUTTONS = [ { // Mintlify reuses the same data-testid="try-it-button" / .tryit-button for // BOTH playground actions: // - REST API playground → aria-label "Try it" // - WebSocket playground → aria-label "Connect" // We don't need to special-case them: button_type and button_id are both // derived from the button's own label + the page URL. selector: '[data-testid="try-it-button"], .tryit-button', data: function (el) { // Everything below is derived from the button's own label, so the same // handler covers both the REST "Try it" and the WebSocket "Connect". // Fall back to a visible sentinel (not "") so a failed label read isn't // silently dropped by clean() — lets us spot it in Segment. var name = (el.getAttribute("aria-label") || text(el) || "").trim() || "unknown"; // The same selector matches the inline hero trigger AND the in-popup // execute button (REST "Send"). Report "modal" when it's inside the // playground popup, otherwise "hero". var inModal = !!el.closest( '[data-testid="api-playground-modal"], [role="dialog"]' ); return { // NOTE: button_type is derived from the label ("Connect" → "connect", // "Try it" → "try_it", "Send" → "send"). Confirm enum w/ Data Science. button_type: toSnake(name), button_id: buildButtonId(name), button_label: name, // NOTE: confirm location enum (header|footer|sidebar|hero|modal|panel| // code_block). button_location: inModal ? "modal" : "hero", opens_form: false, }; }, }, { // The playground modal's action button (opened from "Try it"/"Connect"). // It has no id/testid of its own, so we scope to the modal container // (data-testid="api-playground-modal") and use `match` to fire only for // the connect/disconnect action button — not the other modal buttons // (endpoint dropdown, "Security Schemes" expander, type selector, etc.). selector: '[data-testid="api-playground-modal"] button', match: function (el) { return /^(connect|disconnect)$/i.test(text(el)); }, data: function (el) { var name = (el.getAttribute("aria-label") || text(el) || "").trim() || "unknown"; return { button_type: toSnake(name), // Same button_id as the inline trigger (e.g. "consensus_ratings_stream_connect"); // button_location ("modal" vs "hero") is what distinguishes the two. button_id: buildButtonId(name), button_label: name, button_location: "modal", opens_form: false, }; }, }, { // "Copy page" button in the page header (#page-context-menu-button). // Targets only the main copy action, not the split-button dropdown caret. selector: "#page-context-menu-button", data: function (el) { // Prefer aria-label: the visible text flips to "Copying…" on click. var label = (el.getAttribute("aria-label") || text(el) || "").trim() || "Copy page"; return { button_type: toSnake(label), // "copy_page" button_id: "docs_copy_page", button_label: label, button_location: "hero", opens_form: false, }; }, }, { // "Copy page" split-button dropdown options (View as Markdown, Connect to // Cursor, Open in ChatGPT/Claude, etc.). The radix menu is portaled to // with no stable id, so we match role=menuitem whose title is one // of the known page-context actions (PAGE_CONTEXT_LABELS). selector: '[role="menuitem"]', match: function (el) { var titleEl = el.querySelector(".font-medium"); var t = ((titleEl && titleEl.textContent) || "") .replace(/\s+/g, " ") .trim() .toLowerCase(); return PAGE_CONTEXT_LABELS.indexOf(t) !== -1; }, data: function (el) { var titleEl = el.querySelector(".font-medium"); var label = (text(titleEl) || "").trim() || "unknown"; return { button_type: toSnake(label), button_id: "docs_page_context_" + (toSnake(label) || "unknown"), button_label: label, button_location: "hero", opens_form: false, }; }, }, { // Top navbar links (docs.json navbar.links + the primary CTA). Scoped to // the navbar's

carries the // page path as its id and the human title in data-title. We build the // button_id from the path (unique) rather than the label, since labels // like "Overview" repeat across many groups. selector: "ul.sidebar-group a", data: function (el) { var li = el.closest("li"); var path = (li && li.id) || el.getAttribute("href") || ""; var label = (li && li.getAttribute("data-title")) || text(el) || "unknown"; var slug = toSnake(path.replace(/^\/+|\/+$/g, "").replace(/\//g, "_")) || "unknown"; return { button_type: "navigation", button_id: "docs_sidebar_" + slug, button_label: label, button_location: "sidebar", link_url: el.getAttribute("href") || undefined, opens_form: false, }; }, }, { // "On this page" table-of-contents links (ul.toc / #table-of-contents-content). // These jump to an in-page anchor, so button_type is "page_scroll". selector: "ul.toc a", data: function (el) { var href = el.getAttribute("href") || ""; var anchor = toSnake(href.replace(/^#/, "")) || "unknown"; return { button_type: "page_scroll", button_id: "docs_toc_" + anchor, button_label: text(el) || "unknown", button_location: "sidebar", link_url: href || undefined, opens_form: false, }; }, }, { // Top tab navigation (.nav-tabs) — Documentation, API Reference, // WebSocket Reference, etc. Tab labels are unique, so id is label-based. selector: ".nav-tabs a", data: function (el) { var label = (text(el) || el.getAttribute("aria-label") || "").trim() || "unknown"; return { button_type: "navigation", button_id: "docs_tab_" + toSnake(label), button_label: label, button_location: "header", link_url: el.getAttribute("href") || undefined, opens_form: false, }; }, }, { // Footer links (#footer) — link columns (POPULAR / QUICK LINKS / SUPPORT), // social icons, the logo, and "Powered by". Anchors only, so the theme // toggle