dark-social-attributor

Estimate dark social traffic sources using UTM hygiene and direct traffic decomposition heuristics.

2.5k|345|Updated Dec 18, 2025
One-click install
npx skills add https://github.com/aaron-he-zhu/aaron-marketing-skills --skill dark-social-attributor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dark-social-attributor
Source: https://github.com/aaron-he-zhu/aaron-marketing-skills/tree/main/social/observe/dark-social-attributor
Command: npx skills add https://github.com/aaron-he-zhu/aaron-marketing-skills --skill dark-social-attributor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps users identify and attribute dark social traffic sources, enabling accurate measurement of direct traffic and social ROI.

Core Features & Use Cases

  • Dark Social Identification: Analyze and estimate the source of dark social traffic.
  • Direct Traffic Decomposition: Understand the composition of GA4 direct traffic through various heuristics.
  • UTM Hygiene Spec: Provide a specification for maintaining best practices in share-link/UTM usage.
  • Self-Reported Attribution Field: Design a form field for users to indicate how they heard about the brand.
  • Use Case: A user with an unexplained spike in direct traffic can use this Skill to analyze and understand the sources of their dark social traffic.

Quick Start

Use the dark-social-attributor skill to analyze direct traffic and attribute dark social sources based on GA4 and GSC data.

Frequently Asked Questions about dark-social-attributor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is dark social traffic and how does it affect direct traffic in GA4?

Dark social traffic consists of untrackable shares that GA4 often misattributes as direct traffic. This skill decomposes direct traffic using heuristics to estimate and attribute these hidden dark social sources accurately.

How do I attribute dark social traffic using GA4 and GSC data?

Attribute dark social traffic by applying heuristics like direct traffic decomposition, branded search lift proxy, and self-reported attribution fields to your GA4 and GSC data to estimate hidden social traffic sources lacking click data.

What is the best way to maintain UTM hygiene for share-links?

Maintain UTM hygiene by implementing a strict specification for share-link usage. This skill provides a UTM hygiene spec to ensure accurate tracking and prevent dark social misattribution in your campaigns.

Can I measure social ROI without click data?

Measure social ROI without click data by using self-reported attribution fields and branded search lift proxies. These heuristics estimate dark social traffic sources to calculate your true social return on investment.

Why does my GA4 direct traffic spike unexpectedly?

Unexpected GA4 direct traffic spikes often stem from untracked dark social shares. This skill analyzes direct traffic composition using heuristics like branded search lift to identify and attribute the actual dark social sources.