# Attribution Setup

When the user wants to set up, debug, or interpret app install attribution, including...

- Repository: https://github.com/appeeky/aso-skills (2243 stars)
- Category: Testing
- License: MIT
- Last updated: 2026-10-06
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add appeeky/aso-skills --skill attribution-setup -g -a claude-code -y`
Codex: `npx skills add appeeky/aso-skills --skill attribution-setup -g -a codex -y`
Cursor: `npx skills add appeeky/aso-skills --skill attribution-setup -g -a cursor -y`
Gemini CLI: `npx skills add appeeky/aso-skills --skill attribution-setup -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add appeeky/aso-skills`

## Description

When the user wants to set up, debug, or interpret app install attribution, including SKAdNetwork (SKAN), Apple's AdAttributionKit, Google Play Install Referrer, MMPs (AppsFlyer, Adjust, Singular, Branch, Kochava), deep links, deferred deep links, conversion values, postback windows, or privacy thresholds. Use when the user mentions "SKAdNetwork", "SKAN", "SKAN 4", "AdAttributionKit", "AAK", "MMP", "AppsFlyer", "Adjust", "Singular", "Branch", "attribution", "conversion value", "postback", "Install Referrer", "deferred deep link", "iOS 14.5", "ATT", "App Tracking Transparency", "IDFA", or "I can't measure my ad campaigns". For paid campaign strategy, see ua-campaign and apple-search-ads. For analytics events, see app-analytics.

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

# Attribution Setup

You are an app attribution specialist. Your goal is to set up, or debug, a measurement stack that tells the user which paid campaigns drove which installs and revenue, while respecting iOS privacy constraints.

## Initial Assessment

1. Check for `app-marketing-context.md`
2. Ask: **iOS, Android, or both?**
3. Ask: **Do you currently use an MMP** (AppsFlyer, Adjust, Singular, Branch, Kochava)? If yes, which.
4. Ask: **Which paid channels** are running or planned? (ASA, Meta, TikTok, Google UAC, etc.)
5. Ask: **What's broken / what's the goal?** (new setup, fix a discrepancy, optimize CV schema, migrate to AdAttributionKit, etc.)

## The iOS Attribution Reality (2024+)

| Mechanism | Status | Use for |
|---|---|---|
| **IDFA** (with ATT opt-in) | Available but ~25% opt-in rate | Deterministic attribution where you have it |
| **SKAdNetwork (SKAN 4.0)** | Apple's privacy-preserving attribution | Default for ad networks |
| **AdAttributionKit (AAK)** | iOS 17.4+, Apple's evolution of SKAN | Use alongside SKAN; required for some networks |
| **MMP probabilistic** | Banned by Apple for fingerprinting; allowed for limited use | Limited, check MMP terms |
| **Apple Search Ads attribution** | Detailed (campaign/keyword) for ASA only | Always on for ASA |

**Default 2025 stack:** ASA Attribution (built-in) + SKAN 4 + AdAttributionKit + an MMP for orchestration + Apple Search Ads API for ASA depth.

## SKAdNetwork 4.0 Essentials

The rest: https://github.com/appeeky/aso-skills/blob/HEAD/skills/attribution-setup/SKILL.md