ghost 6.0.6 → 6.0.8

package/core/frontend/src/utils/url-attribution.js

@@ -3,63 +3,76 @@
  */
 
 /**
- * Parses URL parameters to extract attribution information
- * 
- * @param {string} url - The URL to parse
- * @returns {Object} Parsed attribution data
+ * @typedef {Object} AttributionData
+ * @property {string|null} source - Primary attribution source (ref || source || utm_source)
+ * @property {string|null} medium - UTM medium parameter
+ * @property {string|null} url - Browser's document.referrer
+ * @property {string|null} utmSource - UTM source parameter
+ * @property {string|null} utmMedium - UTM medium parameter
+ * @property {string|null} utmTerm - UTM term/keyword parameter
+ * @property {string|null} utmCampaign - UTM campaign parameter
+ * @property {string|null} utmContent - UTM content/variant parameter
  */
-export function parseReferrer(url) {
-    // Extract current URL parameters
-    const currentUrl = new URL(url || window.location.href);
-    
-    // Parse source parameters
-    const refParam = currentUrl.searchParams.get('ref');
-    const sourceParam = currentUrl.searchParams.get('source');
-    const utmSourceParam = currentUrl.searchParams.get('utm_source');
-    const utmMediumParam = currentUrl.searchParams.get('utm_medium');
+
+/**
+ * Extracts attribution parameters from URL search params
+ * @private
+ * @param {URLSearchParams} searchParams - The search params to parse
+ * @returns {AttributionData} Parsed attribution data with all UTM parameters
+ */
+function extractParams(searchParams) {
+    const refParam = searchParams.get('ref');
+    const sourceParam = searchParams.get('source');
+    const utmSourceParam = searchParams.get('utm_source');
+    const utmMediumParam = searchParams.get('utm_medium');
+    const utmTermParam = searchParams.get('utm_term');
+    const utmCampaignParam = searchParams.get('utm_campaign');
+    const utmContentParam = searchParams.get('utm_content');
     
     // Determine primary source
     const referrerSource = refParam || sourceParam || utmSourceParam || null;
     
-    // Check portal hash if needed
-    if (!referrerSource && currentUrl.hash && currentUrl.hash.includes('#/portal')) {
-        return parsePortalHash(currentUrl);
-    }
-    
     return {
         source: referrerSource,
         medium: utmMediumParam || null,
-        url: window.document.referrer || null
+        url: window.document.referrer || null,
+        utmSource: utmSourceParam || null,
+        utmMedium: utmMediumParam || null,
+        utmTerm: utmTermParam || null,
+        utmCampaign: utmCampaignParam || null,
+        utmContent: utmContentParam || null
     };
 }
 
 /**
- * Parses attribution data from portal hash URLs
+ * Parses URL parameters to extract complete referrer/attribution data
  * 
- * @param {URL} url - URL object with a portal hash
- * @returns {Object} Parsed attribution data
+ * @param {string} url - The URL to parse (defaults to current URL)
+ * @returns {AttributionData} Complete attribution data including all UTM parameters
  */
-export function parsePortalHash(url) {
-    const hashUrl = new URL(url.href.replace('/#/portal', ''));
-    const refParam = hashUrl.searchParams.get('ref');
-    const sourceParam = hashUrl.searchParams.get('source');
-    const utmSourceParam = hashUrl.searchParams.get('utm_source');
-    const utmMediumParam = hashUrl.searchParams.get('utm_medium');
+export function parseReferrerData(url) {
+    // Extract current URL parameters
+    const currentUrl = new URL(url || window.location.href);
+    let searchParams = currentUrl.searchParams;
     
-    return {
-        source: refParam || sourceParam || utmSourceParam || null,
-        medium: utmMediumParam || null,
-        url: window.document.referrer || null
-    };
+    // Handle portal hash URLs - extract params from hash instead
+    if (currentUrl.hash && currentUrl.hash.includes('#/portal')) {
+        const hashUrl = new URL(currentUrl.href.replace('/#/portal', ''));
+        searchParams = hashUrl.searchParams;
+    }
+    
+    return extractParams(searchParams);
 }
 
 /**
- * Gets the final referrer value based on parsed data
- * 
- * @param {Object} referrerData - Parsed referrer data
- * @returns {string|null} Final referrer value or null
+ * Selects the primary referrer value from parsed attribution data
+ * Prioritizes: source → medium → url
+ * Filters out same-domain referrers
+ * @private
+ * @param {AttributionData} referrerData - Parsed referrer data
+ * @returns {string|null} Primary referrer value or null
  */
-export function getFinalReferrer(referrerData) {
+function selectPrimaryReferrer(referrerData) {
     const { source, medium, url } = referrerData;
     const finalReferrer = source || medium || url || null;
     
@@ -87,6 +100,6 @@ export function getFinalReferrer(referrerData) {
  * @returns {string|null} Final referrer value
  */
 export function getReferrer(url) {
-    const referrerData = parseReferrer(url);
-    return getFinalReferrer(referrerData);
+    const referrerData = parseReferrerData(url);
+    return selectPrimaryReferrer(referrerData);
 }

package/core/server/api/endpoints/utils/serializers/input/posts.js

@@ -19,10 +19,10 @@ const messages = {
 
 /**
  * Selects all allowed columns for the given frame.
- * 
+ *
  * NOTE: This doesn't stop them from being FETCHED, just returned in the response. This causes
  *   the output serializer to remove them from the data object before returning.
- * 
+ *
  * NOTE: This is only intended for the Content API. We need these fields within Admin API responses.
  *
  * @param {Object} frame - The frame object.
@@ -37,10 +37,10 @@ function removeSourceFormats(frame) {
 
 /**
  * Selects all allowed columns for the given frame.
- * 
+ *
  * This removes the lexical and mobiledoc columns from the query. This is a performance improvement as we never intend
  *  to expose those columns in the content API and they are very large datasets to be passing around and de/serializing.
- * 
+ *
  * NOTE: This is only intended for the Content API. We need these fields within Admin API responses.
  *
  * @param {Object} frame - The frame object.
@@ -97,7 +97,9 @@ function setDefaultOrder(frame) {
     }
 
     if (!frame.options.order && !frame.options.autoOrder) {
-        frame.options.order = 'published_at desc';
+        // use id as fallback to ensure consistent ordering across pages when posts
+        // have the same published_at timestamp
+        frame.options.order = 'published_at desc, id desc';
     }
 }
 

package/core/server/data/tinybird/endpoints/api_top_utm_campaigns.pipe

@@ -0,0 +1,31 @@
+TOKEN "stats_page" READ
+
+NODE top_utm_campaigns
+SQL >
+    %
+    select
+        case 
+            when length(source) % 6 = 0 then 'summer_sale_2024'
+            when length(source) % 6 = 1 then 'newsletter_weekly'
+            when length(source) % 6 = 2 then 'product_launch'
+            when length(source) % 6 = 3 then 'holiday_promo'
+            when length(source) % 6 = 4 then 'brand_awareness'
+            when length(source) % 6 = 5 then 'retention_q4'
+        end as utm_campaign,
+        count() as visits
+    from mv_session_data sd
+      inner join filtered_sessions fs
+         on fs.session_id = sd.session_id
+    where
+        site_uuid = {{ String(site_uuid, 'mock_site_uuid', description="Tenant ID", required=True) }}
+        {% if defined(date_from) and day_diff(date_from, date_to) == 0 %}
+            and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) = {{ Date(date_from) }}
+        {% else %}
+            {% if defined(date_from) %} and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) >= {{ Date(date_from) }} {% else %} and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) >= timestampAdd(today(), interval -7 day) {% end %}
+            {% if defined(date_to) %} and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) <= {{ Date(date_to) }} {% else %} and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) <= today() {% end %}
+        {% end %}
+    group by utm_campaign
+    order by visits desc
+    limit {{ Int32(skip, 0) }},{{ Int32(limit, 50) }}
+
+TYPE ENDPOINT

package/core/server/data/tinybird/endpoints/api_top_utm_contents.pipe

@@ -0,0 +1,31 @@
+TOKEN "stats_page" READ
+
+NODE top_utm_content
+SQL >
+    %
+    select
+        case 
+            when length(source) % 6 = 0 then 'hero-banner'
+            when length(source) % 6 = 1 then 'sidebar-cta'
+            when length(source) % 6 = 2 then 'footer-link'
+            when length(source) % 6 = 3 then 'button-primary'
+            when length(source) % 6 = 4 then 'text-link'
+            when length(source) % 6 = 5 then 'nav-menu'
+        end as utm_content,
+        count() as visits
+    from mv_session_data sd
+      inner join filtered_sessions fs
+         on fs.session_id = sd.session_id
+    where
+        site_uuid = {{ String(site_uuid, 'mock_site_uuid', description="Tenant ID", required=True) }}
+        {% if defined(date_from) and day_diff(date_from, date_to) == 0 %}
+            and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) = {{ Date(date_from) }}
+        {% else %}
+            {% if defined(date_from) %} and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) >= {{ Date(date_from) }} {% else %} and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) >= timestampAdd(today(), interval -7 day) {% end %}
+            {% if defined(date_to) %} and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) <= {{ Date(date_to) }} {% else %} and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) <= today() {% end %}
+        {% end %}
+    group by utm_content
+    order by visits desc
+    limit {{ Int32(skip, 0) }},{{ Int32(limit, 50) }}
+
+TYPE ENDPOINT

package/core/server/data/tinybird/endpoints/api_top_utm_mediums.pipe

@@ -0,0 +1,31 @@
+TOKEN "stats_page" READ
+
+NODE top_utm_mediums
+SQL >
+    %
+    select
+        case 
+            when length(source) % 6 = 0 then 'email'
+            when length(source) % 6 = 1 then 'social'
+            when length(source) % 6 = 2 then 'cpc'
+            when length(source) % 6 = 3 then 'organic'
+            when length(source) % 6 = 4 then 'referral'
+            when length(source) % 6 = 5 then 'display'
+        end as utm_medium,
+        count() as visits
+    from mv_session_data sd
+      inner join filtered_sessions fs
+         on fs.session_id = sd.session_id
+    where
+        site_uuid = {{ String(site_uuid, 'mock_site_uuid', description="Tenant ID", required=True) }}
+        {% if defined(date_from) and day_diff(date_from, date_to) == 0 %}
+            and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) = {{ Date(date_from) }}
+        {% else %}
+            {% if defined(date_from) %} and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) >= {{ Date(date_from) }} {% else %} and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) >= timestampAdd(today(), interval -7 day) {% end %}
+            {% if defined(date_to) %} and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) <= {{ Date(date_to) }} {% else %} and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) <= today() {% end %}
+        {% end %}
+    group by utm_medium
+    order by visits desc
+    limit {{ Int32(skip, 0) }},{{ Int32(limit, 50) }}
+
+TYPE ENDPOINT

package/core/server/data/tinybird/endpoints/api_top_utm_sources.pipe

@@ -0,0 +1,31 @@
+TOKEN "stats_page" READ
+
+NODE top_utm_sources
+SQL >
+    %
+    select
+        case 
+            when length(source) % 6 = 0 then 'google'
+            when length(source) % 6 = 1 then 'facebook'
+            when length(source) % 6 = 2 then 'twitter'
+            when length(source) % 6 = 3 then 'linkedin'
+            when length(source) % 6 = 4 then 'newsletter'
+            when length(source) % 6 = 5 then 'instagram'
+        end as utm_source,
+        count() as visits
+    from mv_session_data sd
+      inner join filtered_sessions fs
+         on fs.session_id = sd.session_id
+    where
+        site_uuid = {{ String(site_uuid, 'mock_site_uuid', description="Tenant ID", required=True) }}
+        {% if defined(date_from) and day_diff(date_from, date_to) == 0 %}
+            and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) = {{ Date(date_from) }}
+        {% else %}
+            {% if defined(date_from) %} and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) >= {{ Date(date_from) }} {% else %} and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) >= timestampAdd(today(), interval -7 day) {% end %}
+            {% if defined(date_to) %} and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) <= {{ Date(date_to) }} {% else %} and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) <= today() {% end %}
+        {% end %}
+    group by utm_source
+    order by visits desc
+    limit {{ Int32(skip, 0) }},{{ Int32(limit, 50) }}
+
+TYPE ENDPOINT

package/core/server/data/tinybird/endpoints/api_top_utm_terms.pipe

@@ -0,0 +1,31 @@
+TOKEN "stats_page" READ
+
+NODE top_utm_terms
+SQL >
+    %
+    select
+        case 
+            when length(source) % 6 = 0 then 'ghost cms'
+            when length(source) % 6 = 1 then 'headless publishing'
+            when length(source) % 6 = 2 then 'content management'
+            when length(source) % 6 = 3 then 'newsletter platform'
+            when length(source) % 6 = 4 then 'blog software'
+            when length(source) % 6 = 5 then 'membership site'
+        end as utm_term,
+        count() as visits
+    from mv_session_data sd
+      inner join filtered_sessions fs
+         on fs.session_id = sd.session_id
+    where
+        site_uuid = {{ String(site_uuid, 'mock_site_uuid', description="Tenant ID", required=True) }}
+        {% if defined(date_from) and day_diff(date_from, date_to) == 0 %}
+            and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) = {{ Date(date_from) }}
+        {% else %}
+            {% if defined(date_from) %} and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) >= {{ Date(date_from) }} {% else %} and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) >= timestampAdd(today(), interval -7 day) {% end %}
+            {% if defined(date_to) %} and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) <= {{ Date(date_to) }} {% else %} and toDate(toTimezone(first_pageview, {{String(timezone, 'Etc/UTC', description="Site timezone", required=True)}})) <= today() {% end %}
+        {% end %}
+    group by utm_term
+    order by visits desc
+    limit {{ Int32(skip, 0) }},{{ Int32(limit, 50) }}
+
+TYPE ENDPOINT

package/core/server/data/tinybird/tests/api_top_utm_campaigns.yaml

@@ -0,0 +1,108 @@
+
+- name: Date range
+  description: All fixture data
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC
+  expected_result: |
+    {"utm_campaign":"summer_sale_2024","visits":6}
+    {"utm_campaign":"brand_awareness","visits":3}
+    {"utm_campaign":"holiday_promo","visits":3}
+    {"utm_campaign":"product_launch","visits":3}
+    {"utm_campaign":"retention_q4","visits":1}
+
+- name: Filtered by browser - Chrome
+  description: Filtered by browser - Chrome
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&browser=chrome
+  expected_result: |
+    {"utm_campaign":"summer_sale_2024","visits":4}
+    {"utm_campaign":"brand_awareness","visits":1}
+    {"utm_campaign":"holiday_promo","visits":1}
+    {"utm_campaign":"product_launch","visits":1}
+
+- name: Filtered by device - desktop
+  description: Filtered by device - desktop
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&device=desktop
+  expected_result: |
+    {"utm_campaign":"summer_sale_2024","visits":6}
+    {"utm_campaign":"brand_awareness","visits":3}
+    {"utm_campaign":"product_launch","visits":3}
+    {"utm_campaign":"holiday_promo","visits":2}
+    {"utm_campaign":"retention_q4","visits":1}
+
+- name: Filtered by location - UK
+  description: Filtered by location - UK
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&location=GB
+  expected_result: |
+    {"utm_campaign":"summer_sale_2024","visits":3}
+    {"utm_campaign":"brand_awareness","visits":2}
+    {"utm_campaign":"holiday_promo","visits":2}
+    {"utm_campaign":"product_launch","visits":1}
+
+- name: Filtered by OS - Windows
+  description: Filtered by OS - Windows
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&os=windows
+  expected_result: |
+    {"utm_campaign":"summer_sale_2024","visits":5}
+    {"utm_campaign":"brand_awareness","visits":3}
+    {"utm_campaign":"product_launch","visits":3}
+    {"utm_campaign":"holiday_promo","visits":2}
+    {"utm_campaign":"retention_q4","visits":1}
+
+- name: Filtered by pathname - /about/
+  description: Filtered by pathname - /about/
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&pathname=%2Fabout%2F
+  expected_result: |
+    {"utm_campaign":"summer_sale_2024","visits":4}
+    {"utm_campaign":"product_launch","visits":2}
+    {"utm_campaign":"brand_awareness","visits":1}
+    {"utm_campaign":"holiday_promo","visits":1}
+
+- name: Filtered by post_uuid - 06b1b0c9-fb53-4a15-a060-3db3fde7b1fc (/about/)
+  description: Filtered by post_uuid - 06b1b0c9-fb53-4a15-a060-3db3fde7b1fc (/about/)
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&post_uuid=06b1b0c9-fb53-4a15-a060-3db3fde7b1fc
+  expected_result: |
+    {"utm_campaign":"summer_sale_2024","visits":4}
+    {"utm_campaign":"product_launch","visits":2}
+    {"utm_campaign":"brand_awareness","visits":1}
+    {"utm_campaign":"holiday_promo","visits":1}
+
+- name: Filtered by source - bing.com
+  description: Filtered by source - bing.com
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&source=bing.com
+  expected_result: |
+    {"utm_campaign":"product_launch","visits":2}
+
+- name: Filtered by member status - paid
+  description: Filtered by member status - paid
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&member_status=paid
+  expected_result: |
+    {"utm_campaign":"brand_awareness","visits":2}
+    {"utm_campaign":"summer_sale_2024","visits":2}
+    {"utm_campaign":"product_launch","visits":1}
+
+- name: Filtered by member status - undefined
+  description: Filtered by member status - undefined
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&member_status=undefined
+  expected_result: |
+    {"utm_campaign":"holiday_promo","visits":3}
+    {"utm_campaign":"brand_awareness","visits":1}
+    {"utm_campaign":"summer_sale_2024","visits":1}
+    {"utm_campaign":"retention_q4","visits":1}
+
+- name: Filtered by timezone - America/Los_Angeles
+  description: Filtered by timezone - America/Los_Angeles
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=America/Los_Angeles
+  expected_result: |
+    {"utm_campaign":"summer_sale_2024","visits":5}
+    {"utm_campaign":"brand_awareness","visits":3}
+    {"utm_campaign":"holiday_promo","visits":2}
+    {"utm_campaign":"product_launch","visits":2}
+    {"utm_campaign":"retention_q4","visits":1}
+
+- name: Test with multiple filters combined
+  description: Test with multiple filters combined
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&device=desktop&browser=firefox
+  expected_result: |
+    {"utm_campaign":"brand_awareness","visits":2}
+    {"utm_campaign":"retention_q4","visits":1}
+    {"utm_campaign":"holiday_promo","visits":1}
+    {"utm_campaign":"product_launch","visits":1}

package/core/server/data/tinybird/tests/api_top_utm_contents.yaml

@@ -0,0 +1,108 @@
+
+- name: Date range
+  description: All fixture data
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC
+  expected_result: |
+    {"utm_content":"hero-banner","visits":6}
+    {"utm_content":"footer-link","visits":3}
+    {"utm_content":"text-link","visits":3}
+    {"utm_content":"button-primary","visits":3}
+    {"utm_content":"nav-menu","visits":1}
+
+- name: Filtered by browser - Chrome
+  description: Filtered by browser - Chrome
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&browser=chrome
+  expected_result: |
+    {"utm_content":"hero-banner","visits":4}
+    {"utm_content":"footer-link","visits":1}
+    {"utm_content":"text-link","visits":1}
+    {"utm_content":"button-primary","visits":1}
+
+- name: Filtered by device - desktop
+  description: Filtered by device - desktop
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&device=desktop
+  expected_result: |
+    {"utm_content":"hero-banner","visits":6}
+    {"utm_content":"footer-link","visits":3}
+    {"utm_content":"text-link","visits":3}
+    {"utm_content":"button-primary","visits":2}
+    {"utm_content":"nav-menu","visits":1}
+
+- name: Filtered by location - UK
+  description: Filtered by location - UK
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&location=GB
+  expected_result: |
+    {"utm_content":"hero-banner","visits":3}
+    {"utm_content":"text-link","visits":2}
+    {"utm_content":"button-primary","visits":2}
+    {"utm_content":"footer-link","visits":1}
+
+- name: Filtered by OS - Windows
+  description: Filtered by OS - Windows
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&os=windows
+  expected_result: |
+    {"utm_content":"hero-banner","visits":5}
+    {"utm_content":"footer-link","visits":3}
+    {"utm_content":"text-link","visits":3}
+    {"utm_content":"button-primary","visits":2}
+    {"utm_content":"nav-menu","visits":1}
+
+- name: Filtered by pathname - /about/
+  description: Filtered by pathname - /about/
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&pathname=%2Fabout%2F
+  expected_result: |
+    {"utm_content":"hero-banner","visits":4}
+    {"utm_content":"footer-link","visits":2}
+    {"utm_content":"text-link","visits":1}
+    {"utm_content":"button-primary","visits":1}
+
+- name: Filtered by post_uuid - 06b1b0c9-fb53-4a15-a060-3db3fde7b1fc (/about/)
+  description: Filtered by post_uuid - 06b1b0c9-fb53-4a15-a060-3db3fde7b1fc (/about/)
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&post_uuid=06b1b0c9-fb53-4a15-a060-3db3fde7b1fc
+  expected_result: |
+    {"utm_content":"hero-banner","visits":4}
+    {"utm_content":"footer-link","visits":2}
+    {"utm_content":"text-link","visits":1}
+    {"utm_content":"button-primary","visits":1}
+
+- name: Filtered by source - bing.com
+  description: Filtered by source - bing.com
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&source=bing.com
+  expected_result: |
+    {"utm_content":"footer-link","visits":2}
+
+- name: Filtered by member status - paid
+  description: Filtered by member status - paid
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&member_status=paid
+  expected_result: |
+    {"utm_content":"text-link","visits":2}
+    {"utm_content":"hero-banner","visits":2}
+    {"utm_content":"footer-link","visits":1}
+
+- name: Filtered by member status - undefined
+  description: Filtered by member status - undefined
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&member_status=undefined
+  expected_result: |
+    {"utm_content":"button-primary","visits":3}
+    {"utm_content":"nav-menu","visits":1}
+    {"utm_content":"text-link","visits":1}
+    {"utm_content":"hero-banner","visits":1}
+
+- name: Filtered by timezone - America/Los_Angeles
+  description: Filtered by timezone - America/Los_Angeles
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=America/Los_Angeles
+  expected_result: |
+    {"utm_content":"hero-banner","visits":5}
+    {"utm_content":"text-link","visits":3}
+    {"utm_content":"footer-link","visits":2}
+    {"utm_content":"button-primary","visits":2}
+    {"utm_content":"nav-menu","visits":1}
+
+- name: Test with multiple filters combined
+  description: Test with multiple filters combined
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&device=desktop&browser=firefox
+  expected_result: |
+    {"utm_content":"text-link","visits":2}
+    {"utm_content":"nav-menu","visits":1}
+    {"utm_content":"footer-link","visits":1}
+    {"utm_content":"button-primary","visits":1}

package/core/server/data/tinybird/tests/api_top_utm_mediums.yaml

@@ -0,0 +1,108 @@
+
+- name: Date range
+  description: All fixture data
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC
+  expected_result: |
+    {"utm_medium":"email","visits":6}
+    {"utm_medium":"cpc","visits":3}
+    {"utm_medium":"organic","visits":3}
+    {"utm_medium":"referral","visits":3}
+    {"utm_medium":"display","visits":1}
+
+- name: Filtered by browser - Chrome
+  description: Filtered by browser - Chrome
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&browser=chrome
+  expected_result: |
+    {"utm_medium":"email","visits":4}
+    {"utm_medium":"cpc","visits":1}
+    {"utm_medium":"organic","visits":1}
+    {"utm_medium":"referral","visits":1}
+
+- name: Filtered by device - desktop
+  description: Filtered by device - desktop
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&device=desktop
+  expected_result: |
+    {"utm_medium":"email","visits":6}
+    {"utm_medium":"cpc","visits":3}
+    {"utm_medium":"referral","visits":3}
+    {"utm_medium":"organic","visits":2}
+    {"utm_medium":"display","visits":1}
+
+- name: Filtered by location - UK
+  description: Filtered by location - UK
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&location=GB
+  expected_result: |
+    {"utm_medium":"email","visits":3}
+    {"utm_medium":"organic","visits":2}
+    {"utm_medium":"referral","visits":2}
+    {"utm_medium":"cpc","visits":1}
+
+- name: Filtered by OS - Windows
+  description: Filtered by OS - Windows
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&os=windows
+  expected_result: |
+    {"utm_medium":"email","visits":5}
+    {"utm_medium":"cpc","visits":3}
+    {"utm_medium":"referral","visits":3}
+    {"utm_medium":"organic","visits":2}
+    {"utm_medium":"display","visits":1}
+
+- name: Filtered by pathname - /about/
+  description: Filtered by pathname - /about/
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&pathname=%2Fabout%2F
+  expected_result: |
+    {"utm_medium":"email","visits":4}
+    {"utm_medium":"cpc","visits":2}
+    {"utm_medium":"organic","visits":1}
+    {"utm_medium":"referral","visits":1}
+
+- name: Filtered by post_uuid - 06b1b0c9-fb53-4a15-a060-3db3fde7b1fc (/about/)
+  description: Filtered by post_uuid - 06b1b0c9-fb53-4a15-a060-3db3fde7b1fc (/about/)
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&post_uuid=06b1b0c9-fb53-4a15-a060-3db3fde7b1fc
+  expected_result: |
+    {"utm_medium":"email","visits":4}
+    {"utm_medium":"cpc","visits":2}
+    {"utm_medium":"organic","visits":1}
+    {"utm_medium":"referral","visits":1}
+
+- name: Filtered by source - bing.com
+  description: Filtered by source - bing.com
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&source=bing.com
+  expected_result: |
+    {"utm_medium":"cpc","visits":2}
+
+- name: Filtered by member status - paid
+  description: Filtered by member status - paid
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&member_status=paid
+  expected_result: |
+    {"utm_medium":"referral","visits":2}
+    {"utm_medium":"email","visits":2}
+    {"utm_medium":"cpc","visits":1}
+
+- name: Filtered by member status - undefined
+  description: Filtered by member status - undefined
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&member_status=undefined
+  expected_result: |
+    {"utm_medium":"organic","visits":3}
+    {"utm_medium":"referral","visits":1}
+    {"utm_medium":"display","visits":1}
+    {"utm_medium":"email","visits":1}
+
+- name: Filtered by timezone - America/Los_Angeles
+  description: Filtered by timezone - America/Los_Angeles
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=America/Los_Angeles
+  expected_result: |
+    {"utm_medium":"email","visits":5}
+    {"utm_medium":"referral","visits":3}
+    {"utm_medium":"cpc","visits":2}
+    {"utm_medium":"organic","visits":2}
+    {"utm_medium":"display","visits":1}
+
+- name: Test with multiple filters combined
+  description: Test with multiple filters combined
+  parameters: site_uuid=mock_site_uuid&date_from=2100-01-01&date_to=2100-01-07&timezone=Etc/UTC&device=desktop&browser=firefox
+  expected_result: |
+    {"utm_medium":"referral","visits":2}
+    {"utm_medium":"cpc","visits":1}
+    {"utm_medium":"organic","visits":1}
+    {"utm_medium":"display","visits":1}