> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vortexiq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# YouTube audit profile, Vortex IQ

> What the Vortex IQ YouTube health audit checks: YouTube: Referral Traffic, Engagement, Conversion & Social-to-Commerce

**[Nerve Centre KPIs](/nerve-centre/kpi-cards/youtube) · [Audit Profile](/nerve-centre/kpi-cards/youtube/audit) · [Sentiment Settings](/nerve-centre/kpi-cards/youtube/sentiment)**

Organic YouTube matters to a merchant as a customer-acquisition channel: the storefront traffic that flows from video descriptions, end cards, pinned comments and bio links. This audit answers: (1) is the Google/GA4 credential healthy and is the YouTube source/medium filter resolving, (2) is YouTube referral traffic holding and engaged (bounce, pages/session, dwell), (3) is that traffic converting on the storefront, and (4) does the YouTube-attributed conversion rate diverge from the site baseline (the killer cross-channel finding via the analytics/commerce sibling).

## What this audit checks

### Authentication & access

* Google OAuth refresh token valid and analytics.readonly scope granted
* GA4 property id resolves and metadata endpoint returns 200
* YouTube source/medium dimension filter resolves at least one row (else cards degrade to zero)

### Referral traffic & audience

* YouTube referral sessions dropped > 20% vs prior period
* New-user share from YouTube collapsing (discovery slowdown)
* Returning-user share unusually low (channel not building loyalty)
* Real-time YouTube referral users flatlined during an active video push

### Engagement quality

* Bounce rate on YouTube-referred sessions above 60% (mismatch between video promise and landing page)
* Pageviews per session below site baseline (shallow visits)
* Average session duration well below the storefront baseline
* Top landing pages for YouTube traffic are not the intended product/collection pages

### Conversion economics

* Session conversion rate from YouTube referral below 1%
* Cart abandonment on YouTube-referred sessions above 75%
* Goal/key-event completions from YouTube trending down vs prior period

### Cross-channel: social-to-commerce (the killer area)

* YouTube-attributed conversion rate diverges materially from the storefront baseline (sibling analytics/commerce)
* High-traffic YouTube landing pages not converting (link/CTA or offer gap)
* Social-attributed revenue from YouTube down vs prior period (sibling commerce)
* Top converting YouTube referral pages identified - amplify candidates (more end-cards / pinned links)

## Severity thresholds

| Signal                        | Warn | Critical |
| ----------------------------- | ---- | -------- |
| `you_bounce_rate`             | 60   | 80       |
| `you_cart_abandonment_rate`   | 75   | 90       |
| `you_session_conversion_rate` | 1    | 0.5      |
| `you_sessions`                | -20  | -40      |

## Data sources

* `GET https://analyticsdata.googleapis.com/v1beta/properties/{property_id}/metadata` - Auth + property/dimension metadata sanity
* `POST https://analyticsdata.googleapis.com/v1beta/properties/{property_id}:runReport` - Sessions / users / engagement / conversions filtered to YouTube source/medium
* `POST https://analyticsdata.googleapis.com/v1beta/properties/{property_id}:runRealtimeReport` - Real-time YouTube referral users on the storefront