All articles

App Store attribution

Affiliate-aware paywalls on iOS: pass referral context without fingerprinting

Show referred users the right offer and still attribute the sale deterministically, using an Apple-issued token and Apple-approved offer codes rather than device fingerprinting.

Published · Last reviewed

Written by Attribloom Engineering · Reviewed by Attribloom Product · Last reviewed

Attribution and paywall optimization are different problems

A paywall's job is to convert: the right price, the right copy, the right offer for this user. Attribution's job is to record which affiliate earned the sale. They are easy to conflate because both care about the referral, but they resolve at different layers. Optimizing a paywall does not attribute a sale, and attributing a sale does not require changing your paywall design.

The clean approach is to let the referral context inform what the paywall shows, while the deterministic attribution key rides the purchase itself. That way a paywall experiment never breaks who gets paid.

Passing referral context safely

When your app binds a referred user, Attribloom returns an appAccountToken and, when a campaign configures one, an optional offer code. The token is the attribution key you set on the StoreKit 2 purchase. The offer code is what you present as the referred-user discount.

Use an Apple-approved subscription offer code for the discount rather than inventing a client-side coupon. Offer codes are Apple's supported mechanism for a discounted introductory price, and they keep the reward attached to a paid action. Under Apple 3.2.2 the reward must attach to subscribing, never to the install itself.

  • Read the bind response: appAccountToken for attribution, offerCode for the offer.
  • Show the offer only to referred users, as a paywall variant.
  • Set the appAccountToken on the purchase regardless of which paywall variant renders.
  • Never fingerprint the device to infer the referral. Since iOS 14.5 that is against Apple's rules.

Why this keeps experiments honest

Because attribution is carried by the token and confirmed by App Store Server Notifications v2, you can restyle, reprice, or A/B test the paywall freely. The affiliate is credited from Apple's signed transaction, not from anything the paywall renders. A refund later reverses the commission through the same notification stream, independent of paywall design.

Sources and verification

Primary documentation last checked on 2026-07-20. Each source below links the exact page and its own last-checked date.

Next steps

Frequently asked

Does an affiliate-aware paywall need device fingerprinting?

No. Referral context comes from the Attribloom bind step, and attribution is carried by the appAccountToken on the purchase. Fingerprinting for attribution has been against Apple's rules since iOS 14.5.

How do I give a referred user a discount?

Use the optional offer code returned at bind as an Apple subscription offer code. It keeps the reward attached to subscribing, which is what Apple 3.2.2 requires.

Will changing my paywall break attribution?

No. Attribution rides the appAccountToken on the purchase and is confirmed server-side, so paywall changes and experiments do not affect who gets credited.

In the glossary

Continue reading

App Store attribution

How to attribute App Store subscriptions to an affiliate

App Store attribution

Why iOS affiliate installs are invisible to web attribution tools

Shopify attribution

How to attribute Shopify sales to affiliates without third-party cookies

Pricing models

Commission-only vs revenue-share affiliate programs

App Store attribution

How to validate App Store attribution before release

Payouts

How commission holds and clawbacks protect an affiliate program

iOS program launch

How to start an affiliate program for an iOS app

Shopify program launch

How to launch a Shopify affiliate program

Program economics

Affiliate commission rates: 2026 benchmarks by industry and how to set yours

Program policy

Affiliate program agreement template (2026): full contract and clause guide

Creator strategy

AI UGC vs human creators for affiliate marketing

Custom attribution

How signed conversion postbacks and refunds work

App Store attribution

How to attribute App Store subscription renewals to an affiliate

App Store attribution

RevenueCat affiliate attribution for iOS subscriptions: a server-side pattern

App Store attribution

iOS affiliate tracking without an SDK: StoreKit 2, appAccountToken, and server notifications

App Store attribution

SKAdNetwork vs affiliate attribution for iOS subscriptions

Shopify attribution

How to run a Shopify affiliate program without editing your theme

Shopify attribution

Shopify affiliate link tracking with cart attributes: a theme.liquid recipe

Compliance

FTC affiliate disclosure: the complete 2026 guide (rules, examples, placement)

Attribution concepts

What is deferred deep linking? A plain-English guide for attribution
Get startedSee pricingMore articles