// First-party ad attribution: writes the `gs_attribution` cookie (shared on // .goldsky.com, read by app.goldsky.com at signup) and forwards tracking params // onto app.goldsky.com links. Plain-JS port of the website's // src/utils/attribution.ts (goldsky-io/website, ANALYTICS.md "Ad attribution // cookie"); the app reader is parseAttributionCookie in the goldsky monorepo // (packages/core/src/analytics/attribution.ts). Keep all three in sync. // Mintlify loads every root-level .js file on every page; it runs once per full // page load, like the website (client-side route changes are not touches). (function () { if (window.__gsAttributionInstalled) return; window.__gsAttributionInstalled = true; var COOKIE = 'gs_attribution'; var VERSION = 1; var MAX_AGE_SECONDS = 90 * 24 * 60 * 60; var MAX_VALUE_LENGTH = 256; var MAX_COOKIE_VALUE_LENGTH = 3800; var SHARED_DOMAIN = 'goldsky.com'; var APP_HOST = 'app.goldsky.com'; var TRACKING_KEYS = [ 'utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'utm_id', 'gclid', 'gbraid', 'wbraid', 'fbclid', 'msclkid', 'li_fat_id', 'twclid' ]; var TOUCH_KEYS = TRACKING_KEYS.concat(['referrer', 'landing_url', 'ts']); function truncate(value) { if (value.length <= MAX_VALUE_LENGTH) return value; var cut = value.slice(0, MAX_VALUE_LENGTH); var last = cut.charCodeAt(cut.length - 1); if (last >= 0xd800 && last <= 0xdbff) cut = cut.slice(0, -1); return cut; } function isGoldskyHost(hostname) { var host = hostname.toLowerCase(); return host === SHARED_DOMAIN || host.slice(-(SHARED_DOMAIN.length + 1)) === '.' + SHARED_DOMAIN; } function parseUrl(value, base) { try { return new URL(value, base); } catch (e) { return null; } } function trackingParamsFromSearch(search) { var params = new URLSearchParams(search); var found = []; for (var i = 0; i < TRACKING_KEYS.length; i++) { var value = params.get(TRACKING_KEYS[i]); if (value) found.push([TRACKING_KEYS[i], truncate(value)]); } return found; } function touchFromPageLoad(href, referrer, now) { var url = parseUrl(href); if (!url) return null; var params = trackingParamsFromSearch(url.search); if (params.length === 0) return null; var touch = {}; for (var i = 0; i < params.length; i++) touch[params[i][0]] = params[i][1]; var referrerUrl = referrer ? parseUrl(referrer) : null; if (referrerUrl && /^https?:$/.test(referrerUrl.protocol) && !isGoldskyHost(referrerUrl.hostname)) { touch.referrer = truncate(referrer); } // Only the tracking params: never carry arbitrary query data into the cookie. var landing = new URL(url.origin + url.pathname); for (var j = 0; j < params.length; j++) landing.searchParams.set(params[j][0], params[j][1]); touch.landing_url = truncate(landing.toString()); touch.ts = now.toISOString(); return touch; } function mergeAttribution(existing, touch) { if (!touch) return null; if (existing && TRACKING_KEYS.every(function (key) { return existing.lt[key] === touch[key]; })) { return null; } return { v: VERSION, ft: existing ? existing.ft : touch, lt: touch }; } function sanitizeTouch(value) { if (typeof value !== 'object' || value === null || Array.isArray(value)) return null; var touch = {}; for (var i = 0; i < TOUCH_KEYS.length; i++) { var field = value[TOUCH_KEYS[i]]; if (typeof field === 'string' && field) touch[TOUCH_KEYS[i]] = truncate(field); } return Object.keys(touch).length ? touch : null; } function parseCookieValue(raw) { try { var parsed = JSON.parse(decodeURIComponent(raw)); if (typeof parsed !== 'object' || parsed === null) return null; if (parsed.v !== VERSION) return null; var ft = sanitizeTouch(parsed.ft); var lt = sanitizeTouch(parsed.lt); if (!ft || !lt) return null; return { v: VERSION, ft: ft, lt: lt }; } catch (e) { return null; } } function readAttribution(cookieString) { var prefix = COOKIE + '='; var parts = cookieString.split(';'); for (var i = 0; i < parts.length; i++) { var entry = parts[i].trim(); if (entry.indexOf(prefix) !== 0) continue; var attribution = parseCookieValue(entry.slice(prefix.length)); if (attribution) return attribution; } return null; } // A cookie written by a newer contract version must not be overwritten. function hasNewerVersion(cookieString) { var prefix = COOKIE + '='; var parts = cookieString.split(';'); for (var i = 0; i < parts.length; i++) { var entry = parts[i].trim(); if (entry.indexOf(prefix) !== 0) continue; try { if (JSON.parse(decodeURIComponent(entry.slice(prefix.length))).v > VERSION) return true; } catch (e) {} } return false; } function encodeAttribution(attribution) { var encoded = encodeURIComponent(JSON.stringify(attribution)); if (encoded.length <= MAX_COOKIE_VALUE_LENGTH) return encoded; // Shed descriptive fields before the click ids attribution depends on. var slim = encodeURIComponent(JSON.stringify(attribution, function (key, value) { return key === 'referrer' || key === 'landing_url' ? undefined : value; })); return slim.length <= MAX_COOKIE_VALUE_LENGTH ? slim : null; } function serializeCookie(attribution, loc) { var value = encodeAttribution(attribution); if (!value) return null; var attributes = [COOKIE + '=' + value, 'Path=/', 'Max-Age=' + MAX_AGE_SECONDS, 'SameSite=Lax']; if (isGoldskyHost(loc.hostname)) attributes.push('Domain=.' + SHARED_DOMAIN); if (loc.protocol === 'https:') attributes.push('Secure'); return attributes.join('; '); } function forwardableTrackingParams(search, cookieString) { var fromUrl = trackingParamsFromSearch(search); if (fromUrl.length > 0) return fromUrl; var attribution = readAttribution(cookieString); if (!attribution) return []; var fromCookie = []; for (var i = 0; i < TRACKING_KEYS.length; i++) { var value = attribution.lt[TRACKING_KEYS[i]]; if (value) fromCookie.push([TRACKING_KEYS[i], value]); } return fromCookie; } function withTrackingParams(href, params) { if (params.length === 0) return href; var url = parseUrl(href); if (!url) return href; if (trackingParamsFromSearch(url.search).length > 0) return href; for (var i = 0; i < params.length; i++) url.searchParams.set(params[i][0], params[i][1]); return url.toString(); } function decorateAppLink(event) { try { var target = event.target; if (!target || typeof target.closest !== 'function') return; var anchor = target.closest('a[href]'); if (!anchor) return; var url = parseUrl(anchor.href); if (!url || url.host !== APP_HOST) return; var decorated = withTrackingParams( anchor.href, forwardableTrackingParams(window.location.search, document.cookie) ); if (decorated !== anchor.href) anchor.href = decorated; } catch (e) { // Never block the navigation over attribution. } } try { var next = hasNewerVersion(document.cookie) ? null : mergeAttribution( readAttribution(document.cookie), touchFromPageLoad(window.location.href, document.referrer, new Date()) ); var cookie = next && serializeCookie(next, window.location); if (cookie) document.cookie = cookie; } catch (e) { // Attribution must never break the page (e.g. cookies disabled). } try { // mousedown precedes middle-click/copy-link, touchstart covers mobile // long-press, click covers keyboard activation. ['mousedown', 'touchstart', 'click'].forEach(function (type) { document.addEventListener(type, decorateAppLink, { capture: true, passive: true }); }); } catch (e) {} })();

Authorizations

Path Parameters

Response