# Attribution Reconciler

Use when platform-reported conversions disagree with GA4/ecommerce, when you suspect...

- Repository: https://github.com/aaron-he-zhu/aaron-marketing-skills (3046 stars)
- Category: Testing
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add aaron-he-zhu/aaron-marketing-skills --skill attribution-reconciler -g -a claude-code -y`
Codex: `npx skills add aaron-he-zhu/aaron-marketing-skills --skill attribution-reconciler -g -a codex -y`
Cursor: `npx skills add aaron-he-zhu/aaron-marketing-skills --skill attribution-reconciler -g -a cursor -y`
Gemini CLI: `npx skills add aaron-he-zhu/aaron-marketing-skills --skill attribution-reconciler -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add aaron-he-zhu/aaron-marketing-skills`

## Description

Use when platform-reported conversions disagree with GA4/ecommerce, when you suspect Meta and Google are double-counting the same sales, or for a standing (monthly) reconciliation workbook that de-dups stacked credit against an order-ID truth set, normalizes attribution windows and currency, compares attribution models, and reads incrementality from a geo/holdout test. Not for the point-in-time R2 veto or RQS gate, use ad-account-auditor; not for the ROI/ROAS ratio math itself, use roi-calculator; not for organic dark-social share attribution or GA4 direct-traffic decomposition, use dark-social-attributor. 付费广告归因对账/去重/增量

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Attribution Reconciler

> Based on the ROAS dimension **R** (attribution integrity) in the [ROAS Benchmark](../../../references/roas-benchmark.md). This is the **standing de-dup / incrementality workbook**: it reconciles platform-reported conversions against the GA4/ecommerce order-ID truth set on a recurring cadence. It delegates **all** ratio/ROAS math to [roi-calculator](../../../influencer/report/roi-calculator/SKILL.md) and does **not** re-run the R2 veto, [ad-account-auditor](../../activate/ad-account-auditor/SKILL.md) judges R2 once, point-in-time. This workbook just keeps the truth set clean between audits. Upstream, [conversion-signal-qa](../../activate/conversion-signal-qa/SKILL.md) is the **pre-launch** instrumentation pass that makes the signal trustworthy and only *gates* that a dedup rule exists; this skill is the recurring reconciliation that runs **on** that signal, match, de-dup, quantify, read incrementality.

The single rule: the truth set is the **order IDs** from GA4/ecommerce, **never** any platform's reported-conversion count. This workbook reconciles **paid** channels only, decomposing GA4 direct traffic and estimating organic dark-social share attribution belongs to [dark-social-attributor](../../../social/observe/dark-social-attributor/SKILL.md).

## Quick Start

```
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.
```

```
Build the monthly attribution workbook: normalize Meta's 7-day-click window and Google's 30-day window to a common window, convert currencies, then show de-duped conversions per platform against my Shopify order export.
```

```
I ran a geo holdout for two weeks. Here's the test-region and control-region order export plus the platform spend. Read the incrementality and compare it to last-click.
```

## Skill Contract

The rest: https://github.com/aaron-he-zhu/aaron-marketing-skills/blob/HEAD/ad/scale/attribution-reconciler/SKILL.md