From 02ba97ac3182b537df8e0e5a85dc4ff435065aac Mon Sep 17 00:00:00 2001
From: appdevelopsk <app.develop.sk@gmail.com>
Date: Sat, 7 Nov 2026 18:25:49 +0900
Subject: [PATCH 1/6] fix(analytics): include quick-games Play clicks in
 unified download funnel

---
 guides/quick-games/index.html | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/guides/quick-games/index.html b/guides/quick-games/index.html
index f2158b5..6af3fd8 100644
--- a/guides/quick-games/index.html
+++ b/guides/quick-games/index.html
@@ -45,7 +45,17 @@ <h1>Quick mobile games for a short break</h1>
 <p>Already know what you want? <a href="/apps?goal=quick-games">Search all published apps</a> or explore <a href="/guides/daily-habits/">daily habits</a>.</p>
 </main>
 <footer>These are apps by SK Apps. The links open Google Play; availability and features depend on your region and installed version. No ranking or performance claim is implied.</footer>
-<script>document.querySelectorAll('a.store').forEach(a=>a.addEventListener('click',()=>{if(typeof gtag==='function')gtag('event','guide_store_click',{guide:'quick-games',app:a.dataset.app})}));</script>
+<script>
+document.querySelectorAll('a.store').forEach(link => link.addEventListener('click', () => {
+  if (typeof window.gtag !== 'function') return;
+  // Preserve historical event while adding the unified outbound-store funnel.
+  window.gtag('event', 'guide_store_click', { guide: 'quick-games', app: link.dataset.app });
+  window.gtag('event', 'download_click', {
+    store: 'google_play', location: 'guide', placement: 'guide_card',
+    app_slug: link.dataset.app, guide: 'quick-games'
+  });
+}));
+</script>
 
 <script>
 // Reuse the site's app-detail funnel; never send search text or personal data.

From ba026f2b15a776ba55b5f7020e17ea8a489960fa Mon Sep 17 00:00:00 2001
From: appdevelopsk <app.develop.sk@gmail.com>
Date: Sat, 7 Nov 2026 18:25:54 +0900
Subject: [PATCH 2/6] fix(analytics): include daily-habits Play clicks in
 unified download funnel

---
 guides/daily-habits/index.html | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/guides/daily-habits/index.html b/guides/daily-habits/index.html
index 1bf17cc..db49d70 100644
--- a/guides/daily-habits/index.html
+++ b/guides/daily-habits/index.html
@@ -43,7 +43,17 @@ <h1>Daily habit apps for journaling, reflection and routines</h1>
 <p>Already know what you want? <a href="/apps?goal=habits">Search all published apps</a> or explore <a href="/guides/quick-games/">quick games</a>.</p>
 </main>
 <footer>These are apps by SK Apps. The links open Google Play; availability and features depend on your region and installed version. No ranking or performance claim is implied.</footer>
-<script>document.querySelectorAll('a.store').forEach(a=>a.addEventListener('click',()=>{if(typeof gtag==='function')gtag('event','guide_store_click',{guide:'daily-habits',app:a.dataset.app})}));</script>
+<script>
+document.querySelectorAll('a.store').forEach(link => link.addEventListener('click', () => {
+  if (typeof window.gtag !== 'function') return;
+  // Preserve historical event while adding the unified outbound-store funnel.
+  window.gtag('event', 'guide_store_click', { guide: 'daily-habits', app: link.dataset.app });
+  window.gtag('event', 'download_click', {
+    store: 'google_play', location: 'guide', placement: 'guide_card',
+    app_slug: link.dataset.app, guide: 'daily-habits'
+  });
+}));
+</script>
 
 <script>
 // Reuse the site's app-detail funnel; never send search text or personal data.

From f2bfc1f6df6e7436856e7544e748c4529fe281a4 Mon Sep 17 00:00:00 2001
From: appdevelopsk <app.develop.sk@gmail.com>
Date: Sat, 7 Nov 2026 18:25:57 +0900
Subject: [PATCH 3/6] fix(analytics): include decision-helpers Play clicks in
 unified download funnel

---
 guides/decision-helpers/index.html | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/guides/decision-helpers/index.html b/guides/decision-helpers/index.html
index f352e0e..0336903 100644
--- a/guides/decision-helpers/index.html
+++ b/guides/decision-helpers/index.html
@@ -81,8 +81,14 @@ <h2 id="app-choices">Apps to explore</h2>
 </main>
 <footer>Links open Google Play. Features, pricing and availability may change by region and app version. The page does not claim any download or ranking performance.</footer>
 <script>
-document.querySelectorAll('a.play').forEach(a=>a.addEventListener('click',()=>{
- if(typeof window.gtag==='function')window.gtag('event','guide_store_click',{guide:'decision-helpers',app:a.dataset.app});
+document.querySelectorAll('a.play').forEach(link => link.addEventListener('click', () => {
+  if (typeof window.gtag !== 'function') return;
+  // Preserve historical event while adding the unified outbound-store funnel.
+  window.gtag('event', 'guide_store_click', { guide: 'decision-helpers', app: link.dataset.app });
+  window.gtag('event', 'download_click', {
+    store: 'google_play', location: 'guide', placement: 'guide_card',
+    app_slug: link.dataset.app, guide: 'decision-helpers'
+  });
 }));
 </script>
 

From 5e41745069aba95d7587ed791933d0db2bcd5376 Mon Sep 17 00:00:00 2001
From: appdevelopsk <app.develop.sk@gmail.com>
Date: Sat, 7 Nov 2026 18:26:04 +0900
Subject: [PATCH 4/6] fix(analytics): include ai-tools Play clicks in unified
 download funnel

---
 guides/ai-tools/index.html | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/guides/ai-tools/index.html b/guides/ai-tools/index.html
index 8c9d81d..24785f7 100644
--- a/guides/ai-tools/index.html
+++ b/guides/ai-tools/index.html
@@ -81,8 +81,14 @@ <h2 id="app-choices">Apps to explore</h2>
 </main>
 <footer>Links open Google Play. Features, pricing and availability may change by region and app version. The page does not claim any download or ranking performance.</footer>
 <script>
-document.querySelectorAll('a.play').forEach(a=>a.addEventListener('click',()=>{
- if(typeof window.gtag==='function')window.gtag('event','guide_store_click',{guide:'ai-tools',app:a.dataset.app});
+document.querySelectorAll('a.play').forEach(link => link.addEventListener('click', () => {
+  if (typeof window.gtag !== 'function') return;
+  // Preserve historical event while adding the unified outbound-store funnel.
+  window.gtag('event', 'guide_store_click', { guide: 'ai-tools', app: link.dataset.app });
+  window.gtag('event', 'download_click', {
+    store: 'google_play', location: 'guide', placement: 'guide_card',
+    app_slug: link.dataset.app, guide: 'ai-tools'
+  });
 }));
 </script>
 

From 1bae4d735b90dc44d48dcc02736bc6da35d9e37a Mon Sep 17 00:00:00 2001
From: appdevelopsk <app.develop.sk@gmail.com>
Date: Sat, 7 Nov 2026 18:26:36 +0900
Subject: [PATCH 5/6] test(analytics): execute four guide store handlers in
 Node VM

---
 scripts/test_guide_store_events.cjs | 66 +++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)
 create mode 100644 scripts/test_guide_store_events.cjs

diff --git a/scripts/test_guide_store_events.cjs b/scripts/test_guide_store_events.cjs
new file mode 100644
index 0000000..2c68a19
--- /dev/null
+++ b/scripts/test_guide_store_events.cjs
@@ -0,0 +1,66 @@
+'use strict';
+// Run from repository checkout: node --test scripts/test_guide_store_events.cjs
+const test = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+const vm = require('node:vm');
+
+const GUIDES = {
+  'quick-games': 'a.store',
+  'daily-habits': 'a.store',
+  'decision-helpers': 'a.play',
+  'ai-tools': 'a.play',
+};
+
+function exercise(guide, withGtag = true) {
+  const html = fs.readFileSync(
+    path.join(__dirname, '..', 'guides', guide, 'index.html'), 'utf8'
+  );
+  const scripts = [...html.matchAll(/<script>([\s\S]*?)<\/script>/g)]
+    .map(m => m[1]);
+  const handlerSource = scripts.filter(s => s.includes("'guide_store_click'"));
+  assert.equal(handlerSource.length, 1, 'only one store analytics handler');
+  const callbacks = {};
+  const events = [];
+  const anchor = {
+    dataset: { app: 'known-app' },
+    addEventListener(name, fn) { callbacks[name] = fn; },
+  };
+  const document = {
+    querySelectorAll(selector) {
+      assert.equal(selector, GUIDES[guide]);
+      return [anchor];
+    },
+  };
+  const window = {};
+  if (withGtag) window.gtag = (...args) => events.push(args);
+  vm.runInNewContext(handlerSource[0], { document, window });
+  assert.equal(typeof callbacks.click, 'function');
+  callbacks.click();
+  return events;
+}
+
+for (const guide of Object.keys(GUIDES)) {
+  test(guide + ': store click keeps legacy and unified event', () => {
+    const events = exercise(guide);
+    assert.equal(events.length, 2, 'exactly two distinct event names per click');
+    assert.equal(events[0][0], 'event');
+    assert.equal(events[0][1], 'guide_store_click');
+    assert.equal(events[0][2].app, 'known-app');
+    assert.equal(events[0][2].guide, guide);
+    assert.equal(events[1][0], 'event');
+    assert.equal(events[1][1], 'download_click');
+    assert.equal(events[1][2].app_slug, 'known-app');
+    assert.equal(events[1][2].guide, guide);
+    assert.equal(events[1][2].store, 'google_play');
+    assert.equal(events[1][2].location, 'guide');
+    assert.equal(events[1][2].placement, 'guide_card');
+    assert.equal(Object.hasOwn(events[1][2], 'link_url'), false);
+  });
+
+  test(guide + ': no GA4 is a safe no-op', () => {
+    const events = exercise(guide, false);
+    assert.equal(events.length, 0);
+  });
+}

From f5db7a04acd352a491c6532c7ae2ff18c29c6375 Mon Sep 17 00:00:00 2001
From: appdevelopsk <app.develop.sk@gmail.com>
Date: Sat, 7 Nov 2026 18:27:48 +0900
Subject: [PATCH 6/6] docs(qa): include unified guide-store analytics Node
 tests

---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index a62aee1..6bfe0f8 100644
--- a/README.md
+++ b/README.md
@@ -13,6 +13,7 @@ From a clean checkout of the intended production commit:
 ```bash
 python3 -m unittest discover -s scripts -p 'test_*.py' -v
 node --test scripts/test_catalog_search_events.cjs
+node --test scripts/test_guide_store_events.cjs
 python3 scripts/diagnose_growth_deploy.py --root . --output growth-deploy-diagnosis.json
 python3 scripts/diagnose_growth_routes.py --output growth-route-diagnosis.json
 python3 scripts/check_growth_live.py > growth-live-smoke.json