# FAQ Monitoring Verification Guide

**Last Updated:** 2026-01-13

Step-by-step guide for verifying FAQ tracking and monitoring setup.

## Overview

This guide provides detailed instructions for verifying that FAQ tracking is working correctly and setting up monitoring dashboards.

## Phase 1: Verify FAQ Tracking Script

### Step 1: Check Script Integration

**File:** `v2/pages/blog/post.php`

Verify the script is loaded on blog post pages:

```php
<?php
// Load FAQ tracking script if FAQs are present
if (!empty($post_faqs)) {
    $faq_tracking_script_path = __DIR__ . '/../../js/faq-tracking.js';
    if (file_exists($faq_tracking_script_path)) {
        echo '<script src="/v2/js/faq-tracking.js?v=' . filemtime($faq_tracking_script_path) . '" defer></script>' . "\n";
    }
}
?>
```

**Verification Steps:**

1. Open a blog post with FAQs (e.g., `/insights/lexikon/minijob/`)
2. View page source (Ctrl+U / Cmd+U)
3. Search for `faq-tracking.js`
4. Verify script tag is present
5. Check script URL is correct (`/v2/js/faq-tracking.js`)

### Step 2: Verify Script Loading

**Browser DevTools Method:**

1. Open blog post page
2. Open DevTools (F12)
3. Go to **Network** tab
4. Filter by `faq-tracking.js`
5. Reload page
6. Verify:
   - Script loads successfully (Status 200)
   - Script is not blocked
   - Script loads before page interaction

**Console Method:**

1. Open DevTools Console
2. Check for JavaScript errors
3. Type: `typeof gtag`
4. Should return `"function"` (GA4 is loaded)
5. Type: `document.querySelector('.schema-faq')`
6. Should return FAQ element (not null)

### Step 3: Test FAQ Section View Event

**Manual Test:**

1. Open blog post with FAQs
2. Open DevTools → **Network** tab
3. Filter by `collect` (GA4 endpoint)
4. Scroll to FAQ section
5. Check Network tab for request with:
   - Event name: `faq_section_viewed`
   - Parameters: `page_title`, `page_path`

**Expected Behavior:**

- Event fires when FAQ section becomes visible (50% threshold)
- Event fires only once per page load
- Event includes correct page information

**Debug Method:**

Add temporary console logging to `v2/js/faq-tracking.js`:

```javascript
console.log('FAQ section viewed:', {
    page_title: document.title,
    page_path: window.location.pathname
});
```

### Step 4: Test FAQ Question Click Event

**Manual Test:**

1. Open blog post with FAQs
2. Open DevTools → **Network** tab
3. Filter by `collect`
4. Click on an FAQ question (expand/collapse)
5. Check Network tab for request with:
   - Event name: `faq_question_clicked`
   - Parameters: `question_text`, `page_title`, `page_path`

**Expected Behavior:**

- Event fires on each FAQ question click
- Event includes question text
- Event includes page information

**Debug Method:**

Add temporary console logging:

```javascript
console.log('FAQ question clicked:', {
    question_text: questionElement.textContent.trim(),
    page_title: document.title,
    page_path: window.location.pathname
});
```

### Step 5: Test Scroll Depth Event

**Manual Test:**

1. Open blog post with FAQs
2. Open DevTools → **Network** tab
3. Filter by `collect`
4. Scroll to FAQ section
5. Check Network tab for `faq_scroll_depth` event

**Expected Behavior:**

- Event fires when FAQ section enters viewport
- Event includes scroll depth percentage

## Phase 2: GA4 Event Verification

### Step 1: Access GA4 DebugView

1. Go to [Google Analytics](https://analytics.google.com)
2. Select property: `ordio.com`
3. Go to **Admin** → **DebugView**
4. Enable debug mode:
   - Install Google Analytics Debugger extension
   - Or add `?debug_mode=true` to URL

### Step 2: Verify Events in DebugView

1. Open blog post with FAQs in new tab
2. In GA4 DebugView, watch for events:
   - `faq_section_viewed`
   - `faq_question_clicked`
   - `faq_scroll_depth`
3. Verify event parameters are correct
4. Check event timestamps match user actions

### Step 3: Create Custom Events (if not auto-detected)

1. Go to **Admin** → **Events**
2. Click **"Create event"**
3. Create events:
   - `faq_section_viewed`
   - `faq_question_clicked`
   - `faq_scroll_depth`
4. Mark `faq_question_clicked` as conversion (optional)

### Step 4: Verify Events in Real-Time Report

1. Go to **Reports** → **Real-time**
2. Open blog post with FAQs
3. Interact with FAQs (scroll, click)
4. Check Real-time report for events
5. Verify events appear within 30 seconds

## Phase 3: Google Search Console Setup

### Step 1: Access Search Console

1. Navigate to [Google Search Console](https://search.google.com/search-console)
2. Select property: `ordio.com`
3. Verify property is verified and active

### Step 2: Filter for FAQ Pages

1. Go to **Performance** report
2. Click **"Pages"** tab
3. Filter by URL pattern: `/insights/`
4. Export data for analysis
5. Save filter for future use

### Step 3: Check SERP Features

1. In Performance report, click **"Search results"** tab
2. Filter by **"Featured Snippet"**
3. Note which FAQ pages appear as Featured Snippets
4. Export Featured Snippet data
5. Document in tracking spreadsheet

### Step 4: Set Up Alerts

1. Go to **Settings** → **Users and permissions**
2. Set up email alerts for:
   - New Featured Snippet appearances
   - Significant ranking changes
   - Coverage issues
3. Configure alert frequency (weekly/monthly)

### Step 5: Track FAQ-Related Keywords

1. Extract keywords from FAQ questions (top 20 posts)
2. Use GSC Query report to track:
   - Average position
   - CTR
   - Impressions
3. Create custom report for FAQ keywords
4. Set baseline metrics for comparison

## Phase 4: GA4 Custom Reports Setup

### Step 1: Create FAQ Engagement Report

1. Go to **Explore** → **Free form**
2. Create report with:
   - **Dimensions:** Page title, FAQ question
   - **Metrics:** Event count, Users
   - **Filters:** Event name = `faq_question_clicked`
3. Save report as "FAQ Engagement"
4. Set up scheduled email reports (monthly)

### Step 2: Create FAQ Performance Report

1. Create report with:
   - **Dimensions:** Page title, Page path
   - **Metrics:** FAQ section views, FAQ question clicks
   - **Filters:** Event name contains `faq_`
2. Calculate engagement rate
3. Save report as "FAQ Performance"

### Step 3: Create Conversion Funnel

1. Go to **Admin** → **Events**
2. Mark `faq_question_clicked` as conversion
3. Create funnel:
   - Step 1: Page view
   - Step 2: FAQ section viewed
   - Step 3: FAQ question clicked
4. Save funnel as "FAQ Engagement Funnel"

## Phase 5: Troubleshooting

### FAQ Tracking Not Working

**Check Script Loading:**
- Verify `faq-tracking.js` is loaded on blog post pages
- Check browser console for errors
- Verify GA4 gtag.js is loaded

**Check Event Firing:**
- Use GA4 DebugView to verify events
- Check event parameters are correct
- Verify page path matches expected format

**Check FAQ Structure:**
- Verify `.schema-faq` class exists
- Check FAQ questions have `.schema-faq-question` class
- Ensure FAQ section is visible on page

### GSC Data Not Showing

**Verify Property Setup:**
- Check property is verified
- Verify sitemap includes blog posts
- Check URL inspection tool

**Check Data Freshness:**
- GSC data can take 2-3 days to appear
- Featured Snippets may take longer
- Use historical data for trends

### GA4 Events Not Appearing

**Verify Events Firing:**
- Check Network tab for `collect` requests
- Verify event parameters are correct
- Check GA4 DebugView

**Check Data Processing:**
- Events may take 24-48 hours to appear in reports
- Use Real-time report for immediate verification
- Check DebugView for event validation

## Success Criteria

- [ ] FAQ tracking script loads on all blog posts with FAQs
- [ ] FAQ section view events fire correctly
- [ ] FAQ question click events fire correctly
- [ ] GA4 events appear in DebugView
- [ ] GA4 events appear in Real-time report
- [ ] GSC Featured Snippet tracking active
- [ ] Custom reports showing data
- [ ] Alerts configured and working

## Next Steps

After verification is complete:

1. Monitor events for 1 week
2. Review data quality
3. Adjust tracking if needed
4. Set up monthly reporting schedule
5. Establish quarterly review process

---

**Verification Date:** 2026-01-13
**Last Updated:** 2026-01-13