Attribution Helper
Purpose
Core mission:
- Diagnose attribution discrepancies across channels.
- Compare attribution window assumptions and their budget impact.
- Build practical attribution decision framework for optimization.
- Produce actionable attribution-aligned allocation guidance.
When To Trigger
Use this skill when the user asks for:
- attribution model comparison
- conflicting ROAS/CAC by channel
- budget decisions under attribution uncertainty
- tracking and model interpretation support
High-signal keywords:
- attribution, tracking, model, predict
- roas, cpa, revenue, allocation, budget
- meta, googleads, tiktokads, youtubeads, dsp
Input Contract
Required:
- channel_metrics_by_window
- attribution_windows
- conversion_event_definitions
- decision_context
Optional:
- offline_conversion_data
- holdout_or_incrementality_data
- MMM_or_ltv_inputs
- confidence_threshold
Output Contract
- Attribution Mismatch Map
- Window Sensitivity Analysis
- Decision-safe KPI View
- Budget Reallocation Recommendation
- Validation Experiment Plan
Workflow
- Normalize event and conversion definitions.
- Compare performance under each attribution window.
- Quantify decision deltas from model differences.
- Propose allocation with confidence labeling.
- Output validation experiments for unresolved gaps.
Decision Rules
- If attribution views diverge materially, use blended guardrail plan.
- If one channel is highly view-through sensitive, reduce reliance on last-touch only.
- If incremental evidence exists, prioritize it over proxy metrics.
- If uncertainty remains high, allocate budget in capped test tranches.
Platform Notes
Primary scope:
- Meta (Facebook/Instagram), Google Ads, TikTok Ads, YouTube Ads, Amazon Ads, Shopify Ads, DSP/programmatic
Platform behavior guidance:
- Keep window comparisons explicit per channel.
- Separate platform-reported and unified-attribution decisions.
Constraints And Guardrails
- Never mix inconsistent conversion definitions in one conclusion.
- Flag time-lag effects for high-consideration products.
- Avoid binary conclusions when model variance is large.
Failure Handling And Escalation
- If event taxonomy is inconsistent, output normalization checklist first.
- If offline conversion pipeline is unavailable, mark blind spots and conservative policy.
- If budget decision is high-stakes, require experiment-backed confirmation.
Code Examples
Window Comparison Table
channel: Meta
roas_1d_click: 1.9
roas_7d_click: 2.6
delta_pct: 36.8
Allocation Rule Under Uncertainty
if attribution_variance_pct > 25:
budget_mode: guarded
max_shift_pct: 10
Examples
Example 1: 1d vs 7d dispute
Input:
- Team split on attribution window
Output focus:
- sensitivity table
- decision-safe policy
- validation plan
Example 2: Channel reallocation decision
Input:
- Meta and Google show conflicting contribution
Output focus:
- mismatch diagnosis
- allocation options
- risk labels
Example 3: Incrementality integration
Input:
- Holdout test data available
Output focus:
- model reconciliation
- updated budget recommendation
- confidence update
Quality Checklist
1---2name: attribution-ads-helper3description: Build cross-channel attribution analysis and decision guidance for Meta (Facebook/Instagram), Google Ads, TikTok Ads, YouTube Ads, Amazon Ads, Shopify Ads, and DSP/programmatic campaigns.4---56# Attribution Helper78## Purpose9Core mission:10- Diagnose attribution discrepancies across channels.11- Compare attribution window assumptions and their budget impact.12- Build practical attribution decision framework for optimization.13- Produce actionable attribution-aligned allocation guidance.1415## When To Trigger16Use this skill when the user asks for:17- attribution model comparison18- conflicting ROAS/CAC by channel19- budget decisions under attribution uncertainty20- tracking and model interpretation support2122High-signal keywords:23- attribution, tracking, model, predict24- roas, cpa, revenue, allocation, budget25- meta, googleads, tiktokads, youtubeads, dsp2627## Input Contract28Required:29- channel_metrics_by_window30- attribution_windows31- conversion_event_definitions32- decision_context3334Optional:35- offline_conversion_data36- holdout_or_incrementality_data37- MMM_or_ltv_inputs38- confidence_threshold3940## Output Contract411. Attribution Mismatch Map422. Window Sensitivity Analysis433. Decision-safe KPI View444. Budget Reallocation Recommendation455. Validation Experiment Plan4647## Workflow481. Normalize event and conversion definitions.492. Compare performance under each attribution window.503. Quantify decision deltas from model differences.514. Propose allocation with confidence labeling.525. Output validation experiments for unresolved gaps.5354## Decision Rules55- If attribution views diverge materially, use blended guardrail plan.56- If one channel is highly view-through sensitive, reduce reliance on last-touch only.57- If incremental evidence exists, prioritize it over proxy metrics.58- If uncertainty remains high, allocate budget in capped test tranches.5960## Platform Notes61Primary scope:62- Meta (Facebook/Instagram), Google Ads, TikTok Ads, YouTube Ads, Amazon Ads, Shopify Ads, DSP/programmatic6364Platform behavior guidance:65- Keep window comparisons explicit per channel.66- Separate platform-reported and unified-attribution decisions.6768## Constraints And Guardrails69- Never mix inconsistent conversion definitions in one conclusion.70- Flag time-lag effects for high-consideration products.71- Avoid binary conclusions when model variance is large.7273## Failure Handling And Escalation74- If event taxonomy is inconsistent, output normalization checklist first.75- If offline conversion pipeline is unavailable, mark blind spots and conservative policy.76- If budget decision is high-stakes, require experiment-backed confirmation.7778## Code Examples79### Window Comparison Table8081 channel: Meta82 roas_1d_click: 1.983 roas_7d_click: 2.684 delta_pct: 36.88586### Allocation Rule Under Uncertainty8788 if attribution_variance_pct > 25:89 budget_mode: guarded90 max_shift_pct: 109192## Examples93### Example 1: 1d vs 7d dispute94Input:95- Team split on attribution window9697Output focus:98- sensitivity table99- decision-safe policy100- validation plan101102### Example 2: Channel reallocation decision103Input:104- Meta and Google show conflicting contribution105106Output focus:107- mismatch diagnosis108- allocation options109- risk labels110111### Example 3: Incrementality integration112Input:113- Holdout test data available114115Output focus:116- model reconciliation117- updated budget recommendation118- confidence update119120## Quality Checklist121- [ ] Required sections are complete and non-empty122- [ ] Trigger keywords include at least 3 registry terms123- [ ] Input and output contracts are operationally testable124- [ ] Workflow and decision rules are capability-specific125- [ ] Platform references are explicit and concrete126- [ ] At least 3 practical examples are included