42-ai-attribution

AI Attribution — AI-Search Traffic Meetbaar Maken

Purpose

Answer the client's most common AI question: "ik zie AI-verkeer niet in mijn cijfers." Structurally true — discovery and evaluation happen inside AI experiences, AI platforms pass poor referral data, and AI Overview clicks land as regular Google organic. This skill implements every available proxy (Chris Green's six approaches + Aleyda Solis's survey signal) and reports AI traffic with honest blind-spot disclosure.

Quick Reference

Command	What it does
/42-ai-attribution setup <property>	Complete implementatiegids: channel group + BigQuery + GTM + survey
/42-ai-attribution report <property>	Periodiek AI-traffic rapport met kwaliteitsvergelijking
/42-ai-attribution diagnose <domein>	GSC privacy-sampling filter-rate + datavolledigheid

Required Reading (before setup)

Read the maintained referrer list: ${CLAUDE_PLUGIN_ROOT}/skills/42-ai-attribution/data/ai-referrers.md Check the "Laatst gevalideerd" date first — older than one quarter → refresh the list via WebSearch and update the file + date before generating client deliverables.

Setup Deliverable

Generate AI-ATTRIBUTION-SETUP-<property>.md with four components:

1. GA4 "AI Tools" Custom Channel Group

• Regex from the data file, as a rule placed bóven Referral in de channel-group volgorde (anders wint Referral)
• Klik-instructies: Admin → Data display → Channel groups → nieuw kanaal
• Waarschuwing in de gids: custom channel groups werken NIET retroactief in de GA4 UI — historie komt uit BigQuery (component 2)

2. BigQuery-spiegel (historie + rapportage)

Zelfde regex over de export voor retroactieve dekking, bijv.:

SELECT event_date,
  COUNTIF(REGEXP_CONTAINS(
    (SELECT ep.value.string_value FROM UNNEST(event_params) ep
     WHERE ep.key = 'page_referrer'),
    r'chatgpt\.com|chat\.openai\.com|perplexity\.ai|gemini\.google\.com|copilot\.microsoft\.com|claude\.ai')) AS ai_sessions_proxy
FROM `project.analytics_XXXXX.events_*`
WHERE _TABLE_SUFFIX BETWEEN 'YYYYMMDD' AND 'YYYYMMDD'
GROUP BY event_date ORDER BY event_date;

(Pas de regex aan vanuit de data-file; query op daily tables, niet intraday — consent-denied hits verschillen daartussen.)

3. Text-fragment tracking (AI Overview clicks)

GTM custom JavaScript die #:~:text= fragmenten vastlegt — vangt ~50% van de AI Overview-clicks (de rest is niet te onderscheiden van organic). Lever de GTM-tag + trigger-spec, gelabeld als gedeeltelijke dekking.

4. First-party survey-signaal (optionele component)

Aleyda Solis's éne vraag, ná de kernvelden van de signup/demo-flow, optioneel, zonder vervolgvraag (anders stort de completion rate in):

"Kwam je [merk] vóór je aanmelding tegen in een AI-assistent of AI-zoek- ervaring, zoals ChatGPT, Perplexity, Claude, Gemini, Copilot of Google's AI-functies?" — Ja / Nee / Weet ik niet

Duiding: stijgende "Ja" binnen Branded Organic- en Direct-cohorten = sterkste first-party proxy van AI-invloed; "Nee" binnen het AI Tools-kanaal = quality check op misattributie. Raakt de klant-site zelf — altijd expliciet als aparte keuze voorleggen, nooit stilzwijgend meeleveren.

Sluit af met een verificatiestap: na implementatie een test-hit per bron herkennen (realtime rapport) vóór de gids "af" heet.

Report (periodiek)

AI-TRAFFIC-REPORT-<property>.md:

1. Volume & trend — AI Tools-kanaal per bron, plus BigQuery-historie
2. Kwaliteit — conversieratio AI vs organic vs direct; engagement. Benchmarks ter duiding (met jaartal, niet als belofte): AI-referrals converteerden ~2-3× organic (SimilarWeb 2025: 11,4% vs 5,3% e-commerce; Microsoft Clarity: 3×), maar volume is typisch <1% van totaal
3. Direct-herframing — Direct-trend naast AI-zichtbaarheid gelegd ("accumulated intent"); survey-data als die er is
4. Blinde vlekken — AI Overviews als organic, apps zonder referrer, copy-paste → Direct (uit de data-file, verplichte sectie)
5. Omzet in €, notatie 1.000,00

Diagnose (GSC datavolledigheid)

Bereken de privacy-sampling filter-rate: haal totalen op via GSC (aggregate vs per-query som) en rapporteer 1 − (som query-clicks ÷ aggregate clicks) voor clicks en impressies. Context 2026: ~75% van impressies en ~38% van clicks zit niet in de per-query data. Gebruik dit als disclaimer-bijlage bij elke rapportage die op GSC-querydata leunt (o.a. 42-aeo-forecast, 42-striking-distance).

Rules

1. Blinde vlekken zijn onderdeel van het product — elk rapport bevat de beperkingen-sectie; AI-traffic zonder disclaimer is misleidend.
2. Data-file eerst — nooit een regex uit het hoofd genereren; altijd de onderhouden lijst met validatiedatum.
3. Survey is opt-in — site-wijzigingen alleen na expliciete klantkeuze.
4. Benchmarks met bron en jaartal — nooit als garantie presenteren.
5. Logfile bot-analyse hoort bij 42-crawlers — deze skill doet de click/referral-kant; verwijs door in plaats van dubbelen.

Cross-References

• 42-ga4-audit — check 21 (AI-traffic herkenning) constateert het gat; deze skill dicht het. Draai de audit eerst
• 42-topical-presence — zichtbaarheid ↔ verkeer koppelen in kwartaal- rapportage
• 42-aeo-forecast — gebruikt de diagnose als datavolledigheids-disclaimer
• 42-crawlers — server-side AI-bot detectie (logfiles)