Data & Analysis

Paid Attribution Reconciler

Deduplicate paid conversions against order-ID truth and read incrementality.

59/ 100
Recommended

Generally reliable with disclosed limitations; trial as directed and keep a rollback path.

See how it was scored ↓
Works as-is in
Codex · Claude Code
Stars
★ 3k
Last updated
12d ago
License
Apache-2.0
paid-advertisingattributionconversion-reconciliationorder-id-matching
+3incrementalityga4roas

What does this skill do, and when should you use it?

This skill reconciles Meta, Google, and other paid-platform conversion reports against a GA4 or ecommerce order-ID truth set. It normalizes attribution windows and currencies, identifies cross-platform duplicate credit, and compares attribution models. When geo or holdout data exists, it reads incremental performance; otherwise, incrementality is marked not applicable. It does not calculate ROAS, CPA, or ROI, and it does not perform the point-in-time ad-account audit.

It reads a GA4 or ecommerce order-ID export, each platform's conversion export, the stated attribution window and currency, and optional geo or holdout data. It normalizes windows and monetary values before matching conversions by order ID, with timestamp-plus-value matching as a fallback. It labels claims as matched, double-counted, or unmatched; reports deduplicated conversions and the double-count rate; compares credit allocation under at least two attribution models; and reads test-versus-control incrementality when a holdout is available. It can save a reconciliation workbook to the specified memory paths only after the user agrees.

Good fit
  • A marketing analyst sees Meta and Google reporting more sales than the Shopify order export and needs to identify duplicated credit.
  • A paid-media lead needs a monthly reconciliation that puts Meta's 7-day click window and Google's 30-day window on a common basis.
  • A growth team has test-region and control-region orders plus platform spend and wants to compare incremental orders with last-click attribution.
  • An ecommerce team wants clean, deduplicated conversion counts before handing the data to an ROI or ROAS analysis.

How do you install this skill?

Before you use it
  • This is a static file review only; the skill, scripts, and reconciliation workflow were not executed against real data.
  • Manually validate timestamp-plus-value fallback matching, exchange-rate selection, attribution-window normalization, and geo/holdout incrementality denominators.
  • Order IDs, values, and exports may contain sensitive commercial or personal data; redaction, retention, and runtime-encryption requirements are not explicit in the skill.
  • Referenced shared materials and downstream skills were not all supplied, so handoff behavior remains unverified.
Before you start
Your agent needs
  • Local filesystem

This skill is located at ad/scale/attribution-reconciler/SKILL.md in the GitHub repository aaron-he-zhu/aaron-marketing-skills. In Claude Code, register the marketplace with “/plugin marketplace add aaron-he-zhu/aaron-marketing-skills” and install the collection with “/plugin install aaron-marketing@aaron”. Agent Skills-compatible hosts can use “npx skills add aaron-he-zhu/aaron-marketing-skills”. The repository can also be obtained with “git clone https://github.com/aaron-he-zhu/aaron-marketing-skills”. The source does not document a repository-level command for installing only this skill.

Generic route: install into Claude Code manually (macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/aaron-he-zhu/aaron-marketing-skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/ad/scale/attribution-reconciler" ~/.claude/skills/
rm -rf "$tmp"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

Try saying

Once installed, send your agent any of these to trigger it:

  • Reconcile my paid conversions for May. Truth set is this GA4 order-ID export. Here are the Meta and Google conversion exports. Find the double-counting.

Provide the GA4 or ecommerce order-ID export, each platform conversion export, the attribution window and currency for each platform, and any available test/control export. A direct trigger is: “Reconcile my paid conversions for May. Truth set is this GA4 order-ID export. Here are the Meta and Google conversion exports. Find the double-counting.” If the order-ID truth set is missing, the skill should return NEEDS_INPUT rather than reconcile against a platform-reported count. Send deduplicated real-order counts to roi-calculator for ROAS, CPA, or ROI math.

What are this skill's strengths and limitations?

Pros
  • Uses GA4 or ecommerce order IDs as the sole truth set instead of trusting reported platform totals.
  • Covers window and currency normalization, order matching, cross-platform deduplication, model comparison, and holdout-based incrementality.
  • Keeps matched, double-counted, and unmatched claims separate, which suits recurring monthly reconciliation.
  • Works from manually exported account data and does not require paid-ad APIs or MCP.
Limitations
  • Cannot reconcile without the order-ID export.
  • Does not calculate ROAS, CPA, ROI, or EMV; those are delegated to roi-calculator.
  • Cannot infer incrementality without a geo or holdout test.
  • The supplied source does not document a dedicated test suite or concrete platform-export examples for this individual skill.

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
Paid Attribution Reconciler this page 59 · Recommended ★ 3k 12d ago Apache-2.0
Paid Ads Account Auditor 59 · Recommended ★ 3k 12d ago Apache-2.0
Ad Experiment Designer 59 · Recommended ★ 3k 12d ago Apache-2.0
Paid Ad Budget Pacing Monitor 61 · Recommended ★ 3k 12d ago Apache-2.0
TAO DAFT Dataset Converter ✓ NVIDIA · Official 54 · Use with care ★ 3.6k 12d ago Apache-2.0

Unlike ad-account-auditor, this skill performs recurring order-level reconciliation and deduplication, while ad-account-auditor owns the point-in-time R2 veto and RQS gate. Unlike roi-calculator, it cleans and standardizes real order counts; roi-calculator owns ROAS, CPA, and ROI calculations. Unlike dark-social-attributor, it covers paid channels only and does not decompose GA4 direct traffic or organic dark-social attribution.

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Recommended
59/ 100 5-point scale 3.0 / 5
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
1Trust18 / 25 · 3.6/5

The skill limits inputs to manually supplied exports from the user's own accounts, avoids required APIs, treats exports as untrusted data, and requires confirmation before saving memory. Points are deducted because sensitive order data, unencrypted runtime memory, deletion/rollback boundaries, and skill-level data-flow disclosure remain incomplete, with no clear skill-specific provenance attribution.

2Reliability9 / 20 · 2.3/5

The procedure, NEEDS_INPUT behavior, reconciliation labels, completion criteria, and abnormal-input feedback are reasonably explicit. Points are deducted because static review cannot reproduce the key paths; timestamp-plus-value fallback matching is ambiguous, incrementality denominators and malformed-data handling are underspecified, and several handoffs depend on referenced skills not supplied here.

3Adaptability10 / 15 · 3.3/5

Triggers, inputs, outputs, exclusions, and the argument hint are clear, with Chinese labeling and a manual-data path. Points are deducted because mainland-China reachability is not evidenced, and use requires multiple platform exports, currency/window metadata, and optionally a valid holdout dataset, limiting applicability.

4Convention10 / 15 · 3.3/5

The skill has layered documentation, Quick Start examples, a shared contract, data-source notes, numbered instructions, handoffs, Apache-2.0 licensing, versioning, and host compatibility. Points are deducted because maintenance ownership, changelog details, and update path are not clear for this skill; the repository security policy supports 17.x while the skill declares 18.0.0, creating governance inconsistency.

5Effectiveness7 / 15 · 2.3/5

The claimed deliverable includes a row-level match table, deduplicated counts, normalized windows and currency, model comparison, and holdout incrementality, which is plausibly actionable. Static calibration limits this to 7 because no executed representative output or third-party result verifies the key paths, and fuzzy matching and incrementality interpretation may require substantial review.

6Verifiability5 / 10 · 2.5/5

The skill points to repository-level ROAS, measurement, security, and handoff materials, while the repository includes CI and test files. Points are deducted because those tests do not cover this skill's core reconciliation workflow, and there is no independent reproduction record, third-party execution evidence, or external-source corroboration; static calibration caps this at 5.

1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Jul 20, 2026 Reviewed revision ebd436747f8f Review evidence[1][2][3][4][5][6][7][8][9]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

See the full review method →

FAQ

Do I need to connect advertising-platform APIs?
No. The skill is designed around user-provided GA4 or ecommerce exports and platform conversion exports; keyed ad-platform APIs are optional conveniences.
What happens if the GA4 order-ID export is missing?
The skill should stop, return NEEDS_INPUT, and request that export. It must not substitute any platform's reported conversion count.
Does it calculate ROAS directly?
No. It produces clean, deduplicated, normalized order and conversion counts and hands ratio calculations to roi-calculator.
Can it prove incrementality without a holdout?
No. Without geo or holdout evidence, incrementality is marked N/A rather than inferred from attribution alone.

More skills from this repository

All from aaron-he-zhu/aaron-marketing-skills

Data & Analysis

Paid Ads Account Auditor

Decide whether a paid-media account is safe to launch or scale using its own evidence.

★ 3k FS 59 Recommended 12d ago
Writing & Content

Paid Ads Conversion Signal QA

Validate conversion events, UTMs, and cross-platform deduplication before paid campaigns launch or scale.

★ 3k FS 56 Use with care 12d ago
Writing & Content

Paid Ads Audience Segment Builder

Turn your customer, CRM, or GA4 exports into seed, exclusion, and funnel-stage audiences for paid media.

★ 3k FS 56 Use with care 12d ago
Data & Analysis

Ad Experiment Designer

Design rigorous paid-ad A/B and incrementality tests, then determine whether results are statistically and practically meaningful.

★ 3k FS 59 Recommended 12d ago
Writing & Content

Paid Measurement Loop

Use a control and a fixed readback window to decide whether a paid-ad change should scale, keep testing, roll back, or remain unproven.

★ 3k FS 54 Use with care 12d ago
Data & Analysis

Paid Ad Budget Pacing Monitor

Measure campaign spend against plan and flag when budget reallocation is warranted.

★ 3k FS 61 Recommended 12d ago
Writing & Content

Ad Fatigue & Frequency Manager

Diagnose creative fatigue or audience saturation from frequency, CTR, and CVR trends, then choose rotate, widen, or hold.

★ 3k FS 58 Recommended 12d ago
Writing & Content

Paid Search Term Miner

Turn search-term reports into converting keywords and spend-saving negatives.

★ 3k FS 54 Use with care 12d ago
Writing & Content

Dark Social Attribution Analyst

Turn untraceable sharing into clearly labeled, auditable attribution estimates.

★ 3k FS 59 Recommended 12d ago
Writing & Content

Paid Ads Bid Strategy Planner

Choose a paid-media bidding model, set a defensible starting target, and protect the campaign’s learning phase.

★ 3k FS 58 Recommended 12d ago
Writing & Content

Paid Ads Campaign Architect

Designs paid account structure and reduces internal bidding and paid-organic overlap.

★ 3k FS 57 Use with care 12d ago
Writing & Content

Paid Conversion Value Mapper

Map ad conversions to profit so tROAS optimizes contribution value instead of raw revenue or order count.

★ 3k FS 57 Use with care 12d ago
Writing & Content

Brand Safety Exclusion Manager

Build placement, network, content, and audience exclusion rules before paid campaigns go live.

★ 3k FS 56 Use with care 12d ago
Writing & Content

Ad Creative Builder

Generate paid-ad variants that stay faithful to the landing page.

★ 3k FS 60 Recommended 12d ago
Writing & Content

Influencer ROI Calculator

Calculate defensible influencer-campaign returns across ROI, ROAS, EMV, attribution, and lifetime value.

★ 3k FS 60 Recommended 12d ago
Writing & Content

Ad Landing Experience Checker

Preflight paid-traffic landing pages for message match, visibility, speed, form friction, and mobile readiness before launch.

★ 3k FS 55 Use with care 12d ago
Writing & Content

Email List Segment Builder

Build reusable email audiences and suppression lists from first-party customer data.

★ 3k FS 61 Recommended 12d ago
Writing & Content

Off-Site & AI Referral Analyzer

Audit backlink quality and measure traffic and conversions from AI assistants.

★ 3k FS 59 Recommended 12d ago
Writing & Content

Product Feed Optimizer

Audit and repair Shopping and Performance Max product feeds for approvals, accurate listings, stronger titles, and feed-based campaign structure.

★ 3k FS 55 Use with care 12d ago
Writing & Content

Influencer Campaign Performance Analyzer

Turn creator campaign data into benchmarked scorecards, attribution findings, and prioritized next actions.

★ 3k FS 49 Use with care 12d ago

Related skills