codymaster 4.1.0

package/skills/cm-ads-tracker/evals/evals.json

@@ -0,0 +1,55 @@
+{
+  "skill_name": "cm-ads-tracker",
+  "test_data_only": true,
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "Tôi cần setup tracking cho shop bán quần áo online của tôi. Tôi đang chạy quảng cáo Facebook và TikTok, website dùng WordPress + WooCommerce. Pixel Facebook của tôi là 1234567890123456, TikTok Pixel ID là C8ABC12345DEF, GTM container là GTM-XWQR456. Tôi muốn track: mua hàng (purchase), thêm vào giỏ (add to cart), xem sản phẩm, và điền form liên hệ. Mục tiêu là biết kênh nào đem về doanh thu nhiều nhất, và xử lý được trường hợp khách click cả 2 kênh trước khi mua.",
+      "expected_output": "Complete tracking strategy document with: GTM tags/triggers/variables for Facebook + TikTok, event mapping table for all 4 conversion events, first-touch + last-touch attribution setup, cross-channel deduplication via order_id, UTM naming convention for both platforms, WooCommerce dataLayer push specifications, implementation checklist",
+      "files": [],
+      "expectations": [
+        "Document includes Facebook Pixel ID 1234567890123456 and TikTok Pixel ID C8ABC12345DEF",
+        "Document includes GTM container configuration with at least 4 conversion tags (Purchase, AddToCart, ViewContent, Lead)",
+        "Document explains first-touch cookie storage mechanism",
+        "Document addresses cross-channel attribution deduplication using order_id or event_id",
+        "Document includes UTM naming convention table for Facebook and TikTok",
+        "Document includes WooCommerce-specific dataLayer.push specifications",
+        "Document includes a QA/implementation checklist",
+        "Document is saved as a file (docx or md) in the workspace"
+      ]
+    },
+    {
+      "id": 2,
+      "prompt": "Help me set up Google Ads and Facebook tracking for my lead generation website. It's a custom HTML site for a real estate company. I have: Google Ads Conversion ID = AW-9876543210 with label = AbCdEfGhIj, Facebook Pixel = 9988776655443322, no GTM yet. Main conversions: phone call clicks, contact form submissions, and 'schedule a tour' button clicks. I want to understand which campaigns bring the most qualified leads and handle the case where the same lead converts through both Google and Facebook campaigns.",
+      "expected_output": "Full tracking strategy with GTM setup from scratch, Google Ads + Facebook event configuration, phone call click tracking setup, form submission tracking, cross-platform lead deduplication strategy, attribution comparison between Google and Facebook for lead gen, UTM conventions",
+      "files": [],
+      "expectations": [
+        "Document includes Google Ads Conversion ID AW-9876543210 and Facebook Pixel ID 9988776655443322",
+        "Document covers GTM installation from scratch (container snippet placement)",
+        "Document includes phone call click tracking setup (click trigger on tel: links)",
+        "Document includes form submission tracking for contact form and schedule tour button",
+        "Document addresses lead deduplication across Google and Facebook",
+        "Document includes lead gen specific attribution window recommendations",
+        "Document includes UTM naming conventions for Google Search and Facebook campaigns",
+        "Document is saved as a file in the workspace"
+      ]
+    },
+    {
+      "id": 3,
+      "prompt": "Tôi đang chạy quảng cáo trên Facebook, TikTok, Google Ads và cả Zalo Ads cho website landing page bán khóa học online (Shopify). GTM: GTM-KLP987, Facebook Pixel: 1122334455667788, TikTok: BCP98765QWER, Google Ads: AW-1122334455/XyZabc123, GA4: G-ABCD1234. Tôi muốn biết: kênh nào khách biết đến đầu tiên (first touch), kênh nào chốt sale (last touch), và cách xử lý khi khách click quảng cáo từ nhiều kênh trước khi mua. Conversion chính: mua khóa học, đăng ký trial, và xem trang pricing.",
+      "expected_output": "Multi-platform tracking strategy with all 5 platforms (FB, TikTok, Google Ads, Zalo, GA4), full attribution model including first-touch cookie, last-touch standard, cross-channel deduplication, Shopify-specific implementation notes, event taxonomy for course business (Purchase, Trial Signup, ViewContent for pricing), UTM conventions for all 4 ad platforms",
+      "files": [],
+      "expectations": [
+        "Document includes all provided tracking IDs: GTM-KLP987, Facebook Pixel 1122334455667788, TikTok BCP98765QWER, Google Ads AW-1122334455, GA4 G-ABCD1234",
+        "Document covers first-touch attribution via first-party cookie mechanism",
+        "Document covers last-touch attribution approach",
+        "Document addresses multi-platform overlap/deduplication scenario",
+        "Document mentions Shopify-specific implementation considerations",
+        "Document includes UTM naming conventions for all 4 ad platforms including Zalo Ads",
+        "Document includes event taxonomy for online course business (Purchase, Trial, ViewContent)",
+        "Document addresses GA4 integration alongside paid platform tracking",
+        "Document is saved as a file in the workspace"
+      ]
+    }
+  ]
+}

package/skills/cm-ads-tracker/references/gtm-architecture.md

@@ -0,0 +1,321 @@
+# GTM Architecture Reference — Full Container Build Spec
+
+## Core Design Principle: Channel-Agnostic DataLayer
+
+The website never knows which ad platforms are active. It only fires standardized `dataLayer.push()` calls. GTM reads these and routes them to the appropriate platform tags. This architecture means:
+- Adding/removing an ad platform = zero developer work
+- All platforms receive identical, consistent data
+- One source of truth for all conversion parameters
+
+---
+
+## GTM Container Structure
+
+```
+GTM Container
+├── Variables (19 standard + custom)
+│   ├── DataLayer Variables (event data)
+│   ├── URL Variables (UTM + click IDs)
+│   ├── Cookie Variables (first-touch data)
+│   └── Constant Variables (Pixel IDs)
+│
+├── Triggers (2 base + N conversion triggers)
+│   ├── All Pages (PageView)
+│   ├── Custom Event: cro_purchase
+│   ├── Custom Event: cro_lead
+│   ├── Custom Event: cro_view_content
+│   ├── Custom Event: cro_add_to_cart
+│   ├── Custom Event: cro_initiate_checkout
+│   ├── Custom Event: cro_registration
+│   ├── Click Trigger: tel: links (phone calls)
+│   └── [additional custom event triggers as needed]
+│
+└── Tags (base + conversion per platform)
+    ├── SYSTEM: First-Touch Cookie Capture (All Pages, once)
+    ├── [Platform] Base Pixel (All Pages)
+    ├── [Platform] [Event] Conversion (per conversion trigger)
+    └── GA4 Configuration + Events
+```
+
+---
+
+## Variables — Complete Specification
+
+### DataLayer Variables
+These read values from `dataLayer.push()` calls made by the website.
+
+| Variable Name | Variable Type | DataLayer Variable Name | Default Value |
+|---|---|---|---|
+| DL - event | Data Layer Variable | event | undefined |
+| DL - event_id | Data Layer Variable | event_id | undefined |
+| DL - transaction_id | Data Layer Variable | transaction_id | undefined |
+| DL - value | Data Layer Variable | value | 0 |
+| DL - currency | Data Layer Variable | currency | VND |
+| DL - content_ids | Data Layer Variable | content_ids | undefined |
+| DL - content_type | Data Layer Variable | content_type | product |
+| DL - content_name | Data Layer Variable | content_name | undefined |
+| DL - contents | Data Layer Variable | contents | undefined |
+| DL - num_items | Data Layer Variable | num_items | 1 |
+| DL - email_hashed | Data Layer Variable | email_hashed | undefined |
+| DL - phone_hashed | Data Layer Variable | phone_hashed | undefined |
+| DL - lead_id | Data Layer Variable | lead_id | undefined |
+| DL - search_string | Data Layer Variable | search_string | undefined |
+
+### URL Variables
+These read from the current page URL query string.
+
+| Variable Name | Variable Type | Query Variable |
+|---|---|---|
+| URL - utm_source | URL | utm_source |
+| URL - utm_medium | URL | utm_medium |
+| URL - utm_campaign | URL | utm_campaign |
+| URL - utm_content | URL | utm_content |
+| URL - utm_term | URL | utm_term |
+| URL - fbclid | URL | fbclid |
+| URL - ttclid | URL | ttclid |
+| URL - gclid | URL | gclid |
+
+### Cookie Variables
+These read from first-party cookies stored in the user's browser.
+
+| Variable Name | Variable Type | Cookie Name |
+|---|---|---|
+| Cookie - ftc_raw | 1st-Party Cookie | _ftc |
+| Cookie - fbp | 1st-Party Cookie | _fbp |
+| Cookie - fbc | 1st-Party Cookie | _fbc |
+
+### JavaScript Variables
+These compute values dynamically.
+
+| Variable Name | Code Logic |
+|---|---|
+| JS - ftc_source | Read _ftc cookie, parse JSON, return .src |
+| JS - ftc_medium | Read _ftc cookie, parse JSON, return .med |
+| JS - ftc_campaign | Read _ftc cookie, parse JSON, return .cmp |
+| JS - page_path | return window.location.pathname |
+| JS - page_title | return document.title |
+
+### Constant Variables
+
+| Variable Name | Value |
+|---|---|
+| CONST - FB Pixel ID | [user's Facebook Pixel ID] |
+| CONST - TikTok Pixel ID | [user's TikTok Pixel ID] |
+| CONST - GTM Container ID | [user's GTM Container ID] |
+
+---
+
+## Triggers — Complete Specification
+
+### Base Triggers
+
+**Trigger: All Pages**
+- Type: Page View
+- Fires on: All Pages
+- Used by: Base pixels, GA4 config, First-Touch Cookie capture
+
+**Trigger: DOM Ready — All Pages**
+- Type: DOM Ready
+- Fires on: All Pages
+- Used by: Scripts that need DOM to be loaded
+
+### Custom Event Triggers (Conversion)
+
+For each conversion event, create one Custom Event trigger:
+
+| Trigger Name | Type | Event Name (exact match) |
+|---|---|---|
+| CE - cro_purchase | Custom Event | cro_purchase |
+| CE - cro_lead | Custom Event | cro_lead |
+| CE - cro_view_content | Custom Event | cro_view_content |
+| CE - cro_add_to_cart | Custom Event | cro_add_to_cart |
+| CE - cro_initiate_checkout | Custom Event | cro_initiate_checkout |
+| CE - cro_add_payment_info | Custom Event | cro_add_payment_info |
+| CE - cro_registration | Custom Event | cro_registration |
+| CE - cro_search | Custom Event | cro_search |
+| CE - cro_phone_call | Custom Event | cro_phone_call |
+| CE - cro_click_button | Custom Event | cro_click_button |
+| CE - cro_download | Custom Event | cro_download |
+| CE - cro_subscribe | Custom Event | cro_subscribe |
+
+### Click Triggers (for Phone Call tracking)
+
+**Trigger: Click - Phone Number**
+- Type: Click — Just Links
+- Fires on: Click URL — starts with — tel:
+- Used by: Phone call conversion tags
+
+---
+
+## Tags — Complete Specification
+
+### Tag 1: First-Touch Cookie Capture (CRITICAL — fires first)
+
+- Name: SYSTEM - First Touch Cookie Capture
+- Type: Custom HTML
+- Trigger: All Pages (with firing priority 999, fires before other tags)
+- Logic:
+  1. Check if _ftc cookie already exists → if yes, exit (do nothing)
+  2. If no cookie: read UTM params, click IDs, referrer from current URL
+  3. Build _ftc JSON object with src, med, cmp, cnt, trm, fbclid, ttclid, gclid, ref, ts
+  4. Write cookie: document.cookie = "_ftc=" + JSON.stringify(data) + "; max-age=7776000; path=/; SameSite=Lax"
+  5. (7776000 seconds = 90 days)
+
+This tag must fire BEFORE any conversion tags. Use Tag Sequencing in GTM if needed.
+
+### Tags 2-3: Facebook Base Pixel
+
+- Name: FB - Base Pixel - All Pages
+- Type: Custom HTML (or Facebook official GTM template if available)
+- Pixel ID: {{CONST - FB Pixel ID}}
+- Standard event: PageView
+- Trigger: All Pages
+
+### Tags 4-N: Facebook Conversion Events
+
+One tag per conversion event:
+
+**FB - Purchase Event**
+- Type: Custom HTML
+- Content: fbq('track', 'Purchase', { value: {{DL - value}}, currency: {{DL - currency}}, content_ids: {{DL - content_ids}}, content_type: {{DL - content_type}}, contents: {{DL - contents}}, num_items: {{DL - num_items}} }, { eventID: {{DL - event_id}} })
+- Trigger: CE - cro_purchase
+
+**FB - Lead Event**
+- fbq('track', 'Lead', { content_name: {{DL - content_name}}, value: {{DL - value}}, currency: {{DL - currency}} }, { eventID: {{DL - event_id}} })
+- Trigger: CE - cro_lead
+
+**FB - AddToCart Event**
+- fbq('track', 'AddToCart', { content_ids: {{DL - content_ids}}, content_type: {{DL - content_type}}, value: {{DL - value}}, currency: {{DL - currency}}, content_name: {{DL - content_name}} }, { eventID: {{DL - event_id}} })
+- Trigger: CE - cro_add_to_cart
+
+**FB - ViewContent Event**
+- fbq('track', 'ViewContent', { content_ids: {{DL - content_ids}}, content_type: {{DL - content_type}}, value: {{DL - value}}, currency: {{DL - currency}}, content_name: {{DL - content_name}} }, { eventID: {{DL - event_id}} })
+- Trigger: CE - cro_view_content
+
+**FB - InitiateCheckout Event**
+- fbq('track', 'InitiateCheckout', { value: {{DL - value}}, currency: {{DL - currency}}, num_items: {{DL - num_items}} }, { eventID: {{DL - event_id}} })
+- Trigger: CE - cro_initiate_checkout
+
+### TikTok Tags
+
+**TikTok - Base Pixel - All Pages**
+- Type: Custom HTML
+- Content: ttq.load('[PIXEL_ID]'); ttq.page();
+- Trigger: All Pages
+
+**TikTok - Purchase Event**
+- ttq.identify({'sha256_email': {{DL - email_hashed}}, 'sha256_phone_number': {{DL - phone_hashed}}});
+- ttq.track('CompletePayment', { content_ids: {{DL - content_ids}}, content_type: {{DL - content_type}}, value: {{DL - value}}, currency: {{DL - currency}}, contents: {{DL - contents}} }, { event_id: {{DL - event_id}} });
+- Trigger: CE - cro_purchase
+
+**TikTok - SubmitForm Event** (for lead gen)
+- ttq.track('SubmitForm', {}, { event_id: {{DL - event_id}} });
+- Trigger: CE - cro_lead
+
+**TikTok - AddToCart Event**
+- ttq.track('AddToCart', { content_id: {{DL - content_ids}}[0], content_type: {{DL - content_type}}, content_name: {{DL - content_name}}, value: {{DL - value}}, currency: {{DL - currency}} }, { event_id: {{DL - event_id}} });
+- Trigger: CE - cro_add_to_cart
+
+**TikTok - ViewContent Event**
+- ttq.track('ViewContent', { content_id: {{DL - content_ids}}[0], content_type: {{DL - content_type}}, content_name: {{DL - content_name}} }, { event_id: {{DL - event_id}} });
+- Trigger: CE - cro_view_content
+
+### Google Ads Tags
+
+**Google Ads - Purchase Conversion**
+- Type: Google Ads Conversion Tracking
+- Conversion ID: AW-[CONVERSION_ID]
+- Conversion Label: [LABEL]
+- Conversion Value: {{DL - value}}
+- Order ID: {{DL - transaction_id}}
+- Enable Enhanced Conversions: YES
+- user_data: { email_address: [raw email from DL], phone_number: [raw phone from DL] }
+- Trigger: CE - cro_purchase
+
+**Google Ads - Lead Conversion**
+- Type: Google Ads Conversion Tracking
+- Conversion ID: AW-[CONVERSION_ID]
+- Conversion Label: [LEAD_LABEL]
+- Conversion Value: [fixed lead value]
+- Enable Enhanced Conversions: YES
+- Trigger: CE - cro_lead
+
+**Google Ads - Phone Call Conversion**
+- Type: Google Ads Conversion Tracking
+- Conversion Label: [CALL_LABEL]
+- Conversion Value: [fixed call value]
+- Trigger: Click - Phone Number
+
+### GA4 Tags
+
+**GA4 - Configuration**
+- Type: Google Tag (GA4)
+- Measurement ID: G-XXXXXXXXXX
+- Trigger: All Pages
+
+**GA4 - purchase event**
+- Type: Google Tag — GA4 Event
+- Event Name: purchase
+- Parameters: transaction_id, value, currency, items
+- Trigger: CE - cro_purchase
+
+**GA4 - generate_lead event**
+- Type: GA4 Event
+- Event Name: generate_lead
+- Parameters: value, currency, content_name
+- Trigger: CE - cro_lead
+
+---
+
+## Tag Firing Order (Priority Settings)
+
+To ensure data is ready before tags fire:
+
+| Priority | Tag | Reason |
+|---|---|---|
+| 999 | First-Touch Cookie Capture | Must run first to capture UTM before other tags |
+| 10 | All Base Pixels | Fire early on page load |
+| 5 | All Conversion Tags | Fire after dataLayer data is populated |
+| 1 | GA4 Events | Can fire last |
+
+Set tag priority in GTM tag settings > Advanced Settings > Tag firing priority.
+
+---
+
+## QA Testing Protocol
+
+### GTM Preview Mode Testing Steps
+
+1. Open GTM Preview → enter your website URL
+2. Perform each conversion action (or simulate dataLayer.push in console)
+3. Verify in the preview panel:
+   - Correct trigger fired (left panel shows event name)
+   - Correct tags fired (center panel shows tag names in green)
+   - Variables populated correctly (right panel shows variable values)
+4. Check no tags fired when they shouldn't (no conversion tags on non-conversion pages)
+
+### Console Test for dataLayer.push
+
+In browser DevTools console, test a purchase push manually:
+dataLayer.push({
+  event: 'cro_purchase',
+  event_id: 'test-uuid-12345',
+  transaction_id: 'TEST-ORDER-001',
+  value: 500000,
+  currency: 'VND',
+  content_ids: ['PROD-123'],
+  content_type: 'product',
+  content_name: 'Test Product',
+  contents: [{content_id: 'PROD-123', content_name: 'Test Product', content_type: 'product', quantity: 1, price: 500000}],
+  num_items: 1,
+  email_hashed: 'test-hash-email',
+  phone_hashed: 'test-hash-phone'
+});
+
+Then verify all platform tags fired in GTM Preview.
+
+### Platform Pixel Verification Tools
+- Facebook: Facebook Pixel Helper Chrome extension → check Events tab
+- TikTok: TikTok Pixel Helper Chrome extension
+- Google Ads: Google Tag Assistant Chrome extension
+- GA4: GA4 DebugView in Google Analytics → enable by running ?gtm_debug=x

package/skills/cm-ads-tracker/references/industry-events.md

@@ -0,0 +1,294 @@
+# Industry Event Taxonomy — Complete Reference
+
+This file maps every major industry to the correct standard events across Meta, TikTok, and Google Ads, with exact parameter requirements and priority ranking.
+
+## How to Use This Reference
+
+1. Identify the user's industry (or the closest match)
+2. Use the Priority Events to configure the algorithm-training conversion actions
+3. Use the Supporting Events for audience building and funnel visibility
+4. Map each event to the DataLayer Event Name and Platform Event Names
+
+---
+
+## Event Priority Scoring
+
+- P1 (Must Have): Trains ad algorithm directly, highest ROI impact
+- P2 (Should Have): Audience building, middle-funnel, retargeting signal
+- P3 (Nice to Have): Funnel visibility, micro-conversion data
+
+---
+
+## 1. E-COMMERCE — Fashion / Apparel
+
+### Industry Signals
+- High purchase frequency, low AOV
+- Strong visual creative performance (video > image)
+- Key platform: TikTok Shop integration, Facebook Catalog Ads
+
+### Event Stack
+
+| Priority | Action | DL Event | Meta Event | TikTok Event | GA4 Event |
+|---|---|---|---|---|---|
+| P1 | Purchase | cro_purchase | Purchase | CompletePayment | purchase |
+| P1 | Add to Cart | cro_add_to_cart | AddToCart | AddToCart | add_to_cart |
+| P2 | Initiate Checkout | cro_initiate_checkout | InitiateCheckout | InitiateCheckout | begin_checkout |
+| P2 | View Product | cro_view_content | ViewContent | ViewContent | view_item |
+| P3 | Search | cro_search | Search | Search | search |
+| P3 | Add to Wishlist | cro_add_to_wishlist | AddToWishlist | AddToWishlist | add_to_wishlist |
+| P3 | Add Payment Info | cro_add_payment_info | AddPaymentInfo | AddPaymentInfo | add_payment_info |
+
+### Required Parameters for Each Event
+
+**cro_purchase (P1)**
+- value: numeric (order total)
+- currency: VND or USD
+- content_ids: array of product IDs
+- content_type: "product"
+- contents: [{content_id, content_name, quantity, price}]
+- num_items: total quantity
+- transaction_id / order_id: unique order ID
+- event_id: UUID (for CAPI dedup)
+- email_hashed, phone_hashed
+
+**cro_add_to_cart (P1)**
+- value: item price
+- currency: VND
+- content_ids: [product_id]
+- content_type: "product"
+- content_name: product name
+- quantity: 1 or selected quantity
+
+**cro_view_content (P2)**
+- content_ids: [product_id]
+- content_type: "product"
+- content_name: product name
+- value: product price
+- currency: VND
+
+### Algorithm Optimization Note
+For Purchase campaign optimization: Meta needs 50+ Purchase events/week to exit learning phase. If traffic is low, start with AddToCart as the optimization event, then switch to Purchase after volume builds.
+
+---
+
+## 2. E-COMMERCE — Electronics / High-AOV
+
+### Industry Signals
+- Low purchase frequency, high AOV (3-50M VND)
+- Long consideration phase (7-30 days)
+- Key platform: Google Shopping + Search (intent-based), Facebook Retargeting
+
+### Event Stack
+
+Same as fashion e-commerce, but additional:
+- ViewContent is critical (longer consideration = more product page views)
+- AddToWishlist is more meaningful (save-for-later behavior)
+- InitiateCheckout is a strong intent signal
+
+### Attribution Window Adjustment
+Extend Facebook window to 7-day click + 1-day view.
+Google window 30-day for search.
+Customer typically researches 3-7 days before buying.
+
+---
+
+## 3. LEAD GENERATION — Real Estate
+
+### Industry Signals
+- Very high lead value (qualified leads = 500K-5M VND)
+- Long sales cycle (weeks to months)
+- Multiple touchpoints before conversion
+- Key conversions: phone call, appointment booking, contact form
+
+### Event Stack
+
+| Priority | Action | DL Event | Meta Event | TikTok Event | GA4 Event |
+|---|---|---|---|---|---|
+| P1 | Form Submit (contact) | cro_lead | Lead | SubmitForm | generate_lead |
+| P1 | Phone Call Click | cro_phone_call | Contact | Contact | phone_call_click |
+| P1 | Schedule Appointment | cro_schedule | Lead | SubmitForm | generate_lead |
+| P2 | View Project Page | cro_view_content | ViewContent | ViewContent | view_item |
+| P2 | Download Brochure | cro_download | Lead | Download | file_download |
+| P3 | Floor Plan View | cro_view_content | ViewContent | ViewContent | view_item |
+| P3 | 360 Tour Start | cro_click_button | — | ClickButton | — |
+
+### Required Parameters
+
+**cro_lead (P1)**
+- event_id: UUID (for CAPI dedup)
+- lead_id: unique generated lead identifier
+- content_name: form type ("contact-form" or "appointment-booking" or "download-brochure")
+- value: estimated lead value (e.g., 500000 for 500K VND per qualified lead)
+- currency: VND
+- email_hashed, phone_hashed (critical for CAPI match rate)
+
+**cro_phone_call (P1)**
+- event_id: UUID
+- content_name: "phone-call"
+- phone_number: which number was clicked (for tracking by listing/project)
+
+### Lead Gen Attribution Note
+Use SHORTER attribution windows: 1-day click for Facebook (real estate buyers search Google, then see Facebook retargeting, then call — so the Facebook touch is typically last-same-day).
+For Google Search: 30-day window (search intent is direct).
+
+---
+
+## 4. LEAD GENERATION — Finance / Insurance / B2B
+
+### Industry Signals
+- High lead quality requirement (only qualified forms matter)
+- Strict data privacy (hash ALL personal data)
+- Multiple form steps (use step-specific events)
+
+### Event Stack
+
+| Priority | Action | DL Event | Meta Event | TikTok Event | GA4 Event |
+|---|---|---|---|---|---|
+| P1 | Final Form Submit | cro_lead | Lead | SubmitForm | generate_lead |
+| P2 | Form Step 1 Started | cro_form_start | — | ClickButton | form_start |
+| P2 | Download Report/Guide | cro_download | Lead | Download | file_download |
+| P2 | View Pricing/Plans | cro_view_content | ViewContent | ViewContent | view_item |
+| P3 | Request Demo | cro_lead | Lead | SubmitForm | generate_lead |
+| P3 | Calculator Used | cro_click_button | — | ClickButton | — |
+
+### Multi-Step Form Tracking
+For forms with 3+ steps, fire a unique event at each step:
+- cro_form_step_1: basic info submitted (email, phone)
+- cro_form_step_2: financial/qualification info
+- cro_lead: final form completed
+
+This gives visibility into where leads drop off in the funnel.
+
+---
+
+## 5. EDUCATION — Online Courses / Edtech
+
+### Industry Signals
+- Two-stage funnel: Free signup → Paid enrollment
+- Content marketing heavy (free resources as lead magnets)
+- Key conversions: trial signup, webinar registration, course purchase
+
+### Event Stack
+
+| Priority | Action | DL Event | Meta Event | TikTok Event | GA4 Event |
+|---|---|---|---|---|---|
+| P1 | Course Purchase | cro_purchase | Purchase | CompletePayment | purchase |
+| P1 | Trial / Free Signup | cro_registration | CompleteRegistration | CompleteRegistration | sign_up |
+| P2 | Initiate Checkout | cro_initiate_checkout | InitiateCheckout | InitiateCheckout | begin_checkout |
+| P2 | Webinar Registration | cro_lead | Lead | SubmitForm | generate_lead |
+| P2 | View Course Page | cro_view_content | ViewContent | ViewContent | view_item |
+| P3 | Download Syllabus | cro_download | Lead | Download | file_download |
+| P3 | Newsletter Subscribe | cro_subscribe | — | Subscribe | — |
+
+### Required Parameters
+
+**cro_registration (Trial/Signup) — P1**
+- event_id: UUID
+- content_name: "trial-signup" or "free-account"
+- value: 0 (free signup) or lead value estimate
+- currency: VND
+- email_hashed, phone_hashed
+
+**cro_purchase (Enrollment) — P1**
+- All standard purchase parameters
+- content_name: course name
+- content_ids: [course_id]
+- value: course price
+
+---
+
+## 6. SaaS / SOFTWARE
+
+### Industry Signals
+- Freemium to paid conversion is the key event
+- Trial quality matters more than trial volume
+- Key metric: free-to-paid conversion rate
+
+### Event Stack
+
+| Priority | Action | DL Event | Meta Event | TikTok Event | GA4 Event |
+|---|---|---|---|---|---|
+| P1 | Free Trial Signup | cro_registration | CompleteRegistration | CompleteRegistration | sign_up |
+| P1 | Paid Plan Purchase | cro_purchase | Purchase | CompletePayment | purchase |
+| P2 | View Pricing Page | cro_view_content | ViewContent | ViewContent | view_item |
+| P2 | Demo Request | cro_lead | Lead | SubmitForm | generate_lead |
+| P3 | Feature Used (key) | cro_click_button | — | ClickButton | select_content |
+| P3 | Newsletter Subscribe | cro_subscribe | — | Subscribe | — |
+
+---
+
+## 7. F&B — RESTAURANT / FOOD DELIVERY
+
+### Industry Signals
+- High frequency, low AOV
+- Local targeting critical
+- Phone calls and online orders are primary conversions
+
+### Event Stack
+
+| Priority | Action | DL Event | Meta Event | TikTok Event | GA4 Event |
+|---|---|---|---|---|---|
+| P1 | Online Order | cro_purchase | Purchase | CompletePayment | purchase |
+| P1 | Phone Call | cro_phone_call | Contact | Contact | phone_call |
+| P1 | Table Reservation Form | cro_lead | Lead | SubmitForm | generate_lead |
+| P2 | View Menu Page | cro_view_content | ViewContent | ViewContent | view_item |
+| P2 | View Location Page | cro_view_content | ViewContent | ViewContent | view_item |
+| P3 | Loyalty Signup | cro_registration | CompleteRegistration | CompleteRegistration | sign_up |
+
+---
+
+## 8. TRAVEL / HOTEL / TOURISM
+
+### Industry Signals
+- High AOV, long consideration phase
+- Search-based intent (dates, destination)
+- Booking funnel has multiple steps
+
+### Event Stack
+
+| Priority | Action | DL Event | Meta Event | TikTok Event | GA4 Event |
+|---|---|---|---|---|---|
+| P1 | Booking Complete | cro_purchase | Purchase | CompletePayment | purchase |
+| P1 | Search (date+dest) | cro_search | Search | Search | search |
+| P2 | Initiate Booking | cro_initiate_checkout | InitiateCheckout | InitiateCheckout | begin_checkout |
+| P2 | View Property/Tour | cro_view_content | ViewContent | ViewContent | view_item |
+| P3 | Save to Wishlist | cro_add_to_wishlist | AddToWishlist | AddToWishlist | add_to_wishlist |
+| P3 | Inquiry / Contact | cro_lead | Lead | Contact | generate_lead |
+
+### Travel-Specific Parameters for ViewContent
+Add destination, check_in_date, check_out_date, num_adults to contents object.
+
+---
+
+## Universal Event Parameters Reference
+
+### Meta / Facebook
+All events support these shared parameters:
+- value (float): monetary value
+- currency (string): ISO 4217 e.g. "VND", "USD"
+- content_name (string): human-readable description
+- content_ids (array): product/content IDs
+- content_type (string): "product" or "product_group"
+- contents (array): [{id, quantity, item_price}]
+
+### TikTok
+All 14 standard events support:
+- value (float): total monetary value
+- currency (string): e.g. "VND" — supported by TikTok
+- content_id (string): single product ID
+- content_ids (array): multiple product IDs
+- content_type (string): "product" or "product_group"
+- content_name (string): name of product/content
+- quantity (int): number of items
+- price (float): per-item price
+- description (string): optional description
+- search_string (string): for Search events only
+- status (string): for CompleteRegistration — "registered"
+
+### Google Ads Enhanced Conversions
+Pass user_data with:
+- email_address: raw email (Google hashes it)
+- phone_number: raw phone with country code
+- address.first_name, address.last_name, address.country, address.postal_code
+
+Note: Google hashes this data server-side with SHA256. Do NOT pre-hash for Enhanced Conversions (unlike Meta where you pre-hash).