# Attribloom

> Attribloom is an affiliate marketing and conversion-attribution platform. Its introductory platform fee is 0.5% of affiliate commission, paid by the merchant on top so affiliates keep 100%. Shopify, iOS App Store, and custom signed-postback attribution are live. AI Studio creates synthetic creator personas and promotional videos with FTC disclosure available. Customers review and post generated content themselves.

Attribloom has no base fee, seat pricing, or minimum. The 0.5% introductory platform fee is based on affiliate commission, not sale value. It continues until Attribloom announces a change, with notice. Human affiliates keep everything they earn. AI video generation is separate and paid from a prepaid credit balance: a standard 15 second video costs $7.35, charged per second. AI personas get a tracking link for measurement but earn no commission.

Last reviewed: 2026-08-30.

API base URL: https://api.attribloom.com. Runtime authentication: conversion and refund requests use x-ea-surface, x-ea-timestamp, and x-ea-signature; ASSN forwards use the timestamp and signature headers; first-launch bind endpoints do not require HMAC.

## API reference
- [OpenAPI 3.1 public runtime contract](https://api.attribloom.com/openapi.json): live conversion, refund, App Store bind, deferred bind, and signed ASSN operations.
- [Integration examples (GitHub)](https://github.com/new-usemame/attribloom-examples): copy-paste HMAC-signed conversion postbacks (Node, Python, curl), Shopify ref preservation, and StoreKit 2 purchase binding.

## Free tools (no account, no upload, run in the browser)
- [ASSN v2 decoder](https://attribloom.com/tools/assn-decoder): paste an App Store Server Notifications v2 signedPayload and read it, including the nested signedTransactionInfo and signedRenewalInfo. Decodes locally and does not verify Apple's signature, which must happen server-side.
- [ASSN v2 notification types reference](https://attribloom.com/tools/assn-notification-types): all 23 notificationType values and their subtypes in plain language, with the commission effect of each (SUBSCRIBED, DID_RENEW, and OFFER_REDEEMED accrue; REFUND claws back; REFUND_REVERSED re-accrues; REVOKE claws back only on an actual refund).
- [Commission calculator](https://attribloom.com/tools/commission-calculator): affiliate commission on an App Store subscription after Apple's 15 or 30 percent cut, using the same arithmetic Attribloom accrues with.
- [Shopify order attribution checker](https://attribloom.com/tools/shopify-order-attribution): paste a Shopify order webhook payload and see which affiliate ref it carries (validated discount code wins over the client-settable ref note attribute), whether the two conflict, and the post-discount merchandise subtotal in integer minor units scaled by the currency's real ISO exponent. Runs in the browser; the payload is not uploaded.
- [Postback signature generator and verifier](https://attribloom.com/tools/postback-signature): build or check the x-ea-signature HMAC header for a signed conversion postback. Shows the exact signed string (HMAC-SHA256 over `<timestamp>.<rawBody>`), the 300 second clock-skew window the API enforces, and a copy-paste curl. Computed in the browser with Web Crypto, so the postback secret is never transmitted.

## SDKs and tools
- [AttribloomKit (Swift package)](https://github.com/attribloom/AttribloomKit): StoreKit 2 attribution client for iOS. Binds a referral click on first launch, mints and persists the appAccountToken in the Keychain, and provides the StoreKit purchase option you attach to each purchase. It does not wrap StoreKit itself. MIT licensed. Add with Swift Package Manager: https://github.com/attribloom/AttribloomKit.git
- [@attribloom/mcp (npm)](https://www.npmjs.com/package/@attribloom/mcp): Model Context Protocol server. Lets Claude Code, Cursor, and other MCP clients read campaigns, conversions, matured commissions, and payout eligibility with a read-only tenant API key. Run with: npx -y @attribloom/mcp
- [MCP server source (GitHub)](https://github.com/attribloom/attribloom-mcp): seven read-only tools. Two of them need no credential, so an agent can learn the integration before an account exists.
- Official MCP Registry entry: com.attribloom/mcp at https://registry.modelcontextprotocol.io/v0.1/servers?search=attribloom

## Agent onboarding
- [Agent onboarding for merchants](https://attribloom.com/agent-onboarding): human authorization boundaries and Shopify, iOS, and custom-postback checklists. Markdown: https://attribloom.com/agent-onboarding.md
- [Add iOS affiliate attribution with StoreKit 2](https://attribloom.com/agents/ios-affiliate-attribution): zero-auth integration brief to paste into Claude Code, Cursor, or Codex. Compile-ready StoreKit 2 bind, purchase, and ASSN v2 forwarder shapes. Markdown: https://attribloom.com/agents/ios-affiliate-attribution.md
- [AGENTS.md](https://attribloom.com/AGENTS.md): when to use Attribloom and the iOS integration paste-prompt for coding agents.

## Guides
- [Live: iOS App Store attribution setup](https://attribloom.com/guides/ios): attribute App Store installs and subscriptions with StoreKit 2 and App Store Server Notifications v2. Markdown: https://attribloom.com/guides/ios.md
- [Live: Test iOS attribution](https://attribloom.com/guides/ios-testing): run a sandbox test then a safe production test, with exact requests and expected responses. Markdown: https://attribloom.com/guides/ios-testing.md
- [Live: Server postback / webhook setup](https://attribloom.com/guides/webhook): create and refund conversions through signed server postbacks. Markdown: https://attribloom.com/guides/webhook.md
- [Live: Shopify attribution setup](https://attribloom.com/guides/shopify): connect a canonical .myshopify.com store and attribute paid orders through validated discounts or a preserved ref cart attribute. Markdown: https://attribloom.com/guides/shopify.md
- [Live: iOS attribution error codes](https://attribloom.com/guides/ios-errors): every ASV setup and ingest error, what it means, and how to fix it. Markdown: https://attribloom.com/guides/ios-errors.md

## Glossary
- [Conversion attribution](https://attribloom.com/wiki/conversion-attribution): Conversion attribution is the practice of crediting a sale, install, or subscription to the marketing touchpoint that caused it, so you know which affiliate or channel actually drove revenue.
- [Affiliate attribution](https://attribloom.com/wiki/affiliate-attribution): Affiliate attribution is conversion attribution scoped to affiliates: it credits each sale or install to the specific affiliate whose link drove it, which is what a commission is calculated from.
- [Commission-only affiliate program](https://attribloom.com/wiki/commission-only-affiliate-program): A commission-only affiliate program charges no base fee, no seat pricing, and no minimums. The platform earns only a commission on the conversions its affiliates actually drive.
- [App Store conversion tracking](https://attribloom.com/wiki/app-store-conversion-tracking): App Store conversion tracking is the practice of tying an iOS app install or in-app purchase back to the marketing that drove it, using Apple's own server-side signals rather than device fingerprinting.
- [StoreKit 2 appAccountToken](https://attribloom.com/wiki/storekit-appaccounttoken): The appAccountToken is a UUID your app attaches to a StoreKit 2 purchase. It appears in the signed transaction and in App Store Server Notifications, letting your server tie a purchase to a known user or affiliate without fingerprinting.
- [App Store Server Notifications v2](https://attribloom.com/wiki/app-store-server-notifications-v2): App Store Server Notifications v2 (ASSN v2) are signed, server-to-server messages from Apple about purchase and subscription lifecycle events. Each is a JWS payload delivered to a URL you configure in App Store Connect.
- [Server-to-server postback](https://attribloom.com/wiki/server-to-server-postback): A server-to-server postback is a signed HTTP request your backend sends to an attribution platform when a conversion happens, instead of relying on a browser pixel. It is tamper-resistant and works where cookies do not.
- [Deferred deep link](https://attribloom.com/wiki/deferred-deep-link): A deferred deep link carries context, such as which affiliate referred a user, across an app install so the app can read it on first launch. It bridges the gap between a tap on a link and a fresh install.
- [SKAdNetwork](https://attribloom.com/wiki/skadnetwork): SKAdNetwork is Apple's privacy-preserving framework for attributing app installs to ad campaigns. It reports aggregated, delayed conversions with no user-level or device-level data.
- [Shopify conversion attribution](https://attribloom.com/wiki/shopify-conversion-attribution): Shopify conversion attribution ties a paid store order back to a validated affiliate discount code or the referral preserved in Shopify note attributes. Signed order webhooks confirm the conversion without third-party cookies.
- [App Store Server Notification forwarding](https://attribloom.com/wiki/app-store-server-notification-forwarding): Notification forwarding is how an App Store Server Notification v2 reaches Attribloom: your server relays Apple's signed payload to your Attribloom forwarding URL, HMAC-signed, so attribution can be confirmed from Apple's own event.
- [Commission hold period](https://attribloom.com/wiki/commission-hold-period): A commission hold period is the time a confirmed commission waits before it becomes payable, so refunds and chargebacks can be caught before any money is paid out.
- [Commission clawback](https://attribloom.com/wiki/commission-clawback): A commission clawback reverses a previously credited commission when the underlying conversion is refunded, cancelled, or charged back, so an affiliate is only ever paid on sales that stick.
- [Double-entry ledger](https://attribloom.com/wiki/double-entry-ledger): A double-entry ledger records every commission, hold, payout, and clawback as balanced entries in integer minor units, so balances always reconcile and no money is created or lost by a rounding or duplicate error.
- [Subscription offer code](https://attribloom.com/wiki/subscription-offer-code): A subscription offer code is an Apple mechanism for giving a referred user a discounted introductory price, used as the redeemer reward while keeping the reward attached to subscribing rather than installing.
- [StoreKit sandbox vs production](https://attribloom.com/wiki/storekit-sandbox-vs-production): StoreKit sandbox and production are Apple's two purchase environments. Sandbox and TestFlight purchases are always sandbox; a real App Store purchase is production. Attribution behaves differently in each, so tests must match the environment an app is registered for.
- [FTC affiliate disclosure](https://attribloom.com/wiki/ftc-affiliate-disclosure): FTC affiliate disclosure is the legal requirement that a material connection between an endorser and a brand, including affiliate commissions and AI-generated endorsements, be disclosed clearly to the audience.
- [Apple guideline 3.2.2](https://attribloom.com/wiki/apple-3-2-2): Apple App Review guideline 3.2.2 governs incentivized behavior. For referrals it means a reward may attach to a post-install action such as subscribing, but never to the install itself.
- [Tracking link](https://attribloom.com/wiki/tracking-link): A tracking link is the unique, signed URL Attribloom mints for each affiliate. When a prospect clicks it, Attribloom records a tamper-proof click and routes them to the App Store or store, carrying the attribution that later ties a conversion back to that affiliate.
- [Referral code](https://attribloom.com/wiki/referral-code): A referral code is a short, human-typable code tied to an affiliate's campaign. When a user enters it in an app, Attribloom resolves it to the affiliate and mints the appAccountToken, giving a deterministic attribution path when a click cannot be matched.
- [App Store Server API](https://attribloom.com/wiki/app-store-server-api): The App Store Server API is Apple's pull API: your server queries Apple for transaction history, subscription status, or requests a test notification. It complements App Store Server Notifications v2 (push), and Attribloom uses it to reconcile events that a push notification missed.
- [appAccountToken best practices](https://attribloom.com/wiki/appaccounttoken-best-practices): appAccountToken best practices govern how an app sources and sets the StoreKit 2 token: use the Attribloom-issued UUID, never invent your own, and reuse the same token across an account's purchases.
- [App Store Server Notification types for commissions](https://attribloom.com/wiki/app-store-server-notification-types-for-commissions): App Store Server Notification types are the notificationType values Apple sends for subscription lifecycle events. Attribloom maps them to commission actions: confirm, hold, renew, or reverse.
- [Affiliate discount code conflict](https://attribloom.com/wiki/affiliate-discount-code-conflict): An affiliate discount code conflict is when a Shopify order's discount code and its preserved ref parameter identify different affiliates. Attribloom fails closed and credits neither, protecting merchant and partner.
- [Commissionable subtotal](https://attribloom.com/wiki/commissionable-subtotal): The commissionable subtotal is the order amount a commission is calculated on: the post-discount merchandise subtotal in the store's currency, excluding tax and shipping, and reduced by refunds.

## Articles
- [How to attribute App Store subscriptions to an affiliate](https://attribloom.com/learn/attribute-app-store-subscriptions-to-an-affiliate): Tie an iOS subscription back to the affiliate who drove it using StoreKit 2 and App Store Server Notifications, with no receipt-validation SDK. Markdown: https://attribloom.com/learn/attribute-app-store-subscriptions-to-an-affiliate.md
- [Why iOS affiliate installs are invisible to web attribution tools](https://attribloom.com/learn/why-ios-affiliate-installs-are-invisible): Web affiliate tools rely on cookies and pixels at checkout. App Store purchases happen inside Apple's system, so those signals never fire. Markdown: https://attribloom.com/learn/why-ios-affiliate-installs-are-invisible.md
- [How to attribute Shopify sales to affiliates without third-party cookies](https://attribloom.com/learn/attribute-shopify-sales-without-cookies): Key attribution to the affiliate link and confirm the order from Shopify's server-side webhooks, so it does not depend on third-party cookies. Markdown: https://attribloom.com/learn/attribute-shopify-sales-without-cookies.md
- [Commission-only vs revenue-share affiliate programs](https://attribloom.com/learn/commission-only-vs-revenue-share): Both pay on results, but commission-only means no fixed fee at all, so cost tracks revenue instead of a subscription plus a share. Markdown: https://attribloom.com/learn/commission-only-vs-revenue-share.md
- [How to validate App Store attribution before release](https://attribloom.com/learn/test-app-store-attribution-before-you-ship): Validate the iOS attribution pipeline in sandbox before release, then confirm a real production purchase after the instrumented build is live. Markdown: https://attribloom.com/learn/test-app-store-attribution-before-you-ship.md
- [How commission holds and clawbacks protect an affiliate program](https://attribloom.com/learn/how-commission-holds-and-clawbacks-protect-a-program): Refunds and chargebacks are normal. Holds and clawbacks are what stop them from turning into money you paid out and cannot get back. Markdown: https://attribloom.com/learn/how-commission-holds-and-clawbacks-protect-a-program.md
- [How to start an affiliate program for an iOS app](https://attribloom.com/learn/start-affiliate-program-ios-app): Start with a commission-only offer, then connect each referred account to StoreKit 2 so subscriptions and refunds can be attributed server-side. Markdown: https://attribloom.com/learn/start-affiliate-program-ios-app.md
- [How to launch a Shopify affiliate program](https://attribloom.com/learn/launch-shopify-affiliate-program): Launch with commission-only software, a precise offer, and native paid-order attribution that reconciles refunds before payout. Markdown: https://attribloom.com/learn/launch-shopify-affiliate-program.md
- [Affiliate commission rates: 2026 benchmarks by industry and how to set yours](https://attribloom.com/learn/affiliate-commission-rate-framework): Commonly reported commission ranges by category, the models to choose from, and a margin-first method to set a rate you can actually afford. Includes iOS app subscription rates most guides omit. Markdown: https://attribloom.com/learn/affiliate-commission-rate-framework.md
- [Affiliate program agreement template (2026): full contract and clause guide](https://attribloom.com/learn/affiliate-program-agreement-template): A complete, copy-and-adapt affiliate agreement with every standard clause, plus a clause-by-clause guide, commission and cookie benchmarks, FTC and AI-content rules, and a compliance checklist. Educational, not legal advice. Markdown: https://attribloom.com/learn/affiliate-program-agreement-template.md
- [AI UGC vs human creators for affiliate marketing](https://attribloom.com/learn/ai-ugc-vs-human-creators): Use AI UGC for controlled creative variants and human creators for lived experience and audience trust. Attribloom generates; you review and post. Markdown: https://attribloom.com/learn/ai-ugc-vs-human-creators.md
- [How signed conversion postbacks and refunds work](https://attribloom.com/learn/signed-postbacks-and-refunds): Sign the exact request bytes, reuse a stable external conversion ID, and send refunds to the refund endpoint so commission reverses idempotently. Markdown: https://attribloom.com/learn/signed-postbacks-and-refunds.md
- [How to attribute App Store subscription renewals to an affiliate](https://attribloom.com/learn/attribute-app-store-subscription-renewals-to-an-affiliate): Map the first paid transaction, every renewal, refunds, and cancellations to a single commission state using an appAccountToken and App Store Server Notifications v2. Markdown: https://attribloom.com/learn/attribute-app-store-subscription-renewals-to-an-affiliate.md
- [RevenueCat affiliate attribution for iOS subscriptions: a server-side pattern](https://attribloom.com/learn/revenuecat-affiliate-attribution-ios): A server-side attribution layer can credit affiliates for RevenueCat-powered subscriptions while RevenueCat stays the source of truth for entitlements. Markdown: https://attribloom.com/learn/revenuecat-affiliate-attribution-ios.md
- [Affiliate-aware paywalls on iOS: pass referral context without fingerprinting](https://attribloom.com/learn/affiliate-aware-paywalls-ios): 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. Markdown: https://attribloom.com/learn/affiliate-aware-paywalls-ios.md
- [iOS affiliate tracking without an SDK: StoreKit 2, appAccountToken, and server notifications](https://attribloom.com/learn/ios-affiliate-tracking-without-sdk): Attribute iOS subscriptions to affiliates deterministically using only Apple APIs, with no third-party receipt SDK and no device fingerprinting. Markdown: https://attribloom.com/learn/ios-affiliate-tracking-without-sdk.md
- [SKAdNetwork vs affiliate attribution for iOS subscriptions](https://attribloom.com/learn/skadnetwork-vs-affiliate-attribution): SKAdNetwork measures ad campaigns in aggregate. Affiliate attribution credits a specific partner for a specific subscription. Neither one replaces the other. Markdown: https://attribloom.com/learn/skadnetwork-vs-affiliate-attribution.md
- [How to run a Shopify affiliate program without editing your theme](https://attribloom.com/learn/shopify-affiliate-program-without-editing-theme): Start with affiliate discount codes and native paid-order webhooks. No theme.liquid change is needed until you want link attribution. Markdown: https://attribloom.com/learn/shopify-affiliate-program-without-editing-theme.md
- [Shopify affiliate link tracking with cart attributes: a theme.liquid recipe](https://attribloom.com/learn/shopify-affiliate-link-tracking-cart-attributes): Read a ?ref parameter, save it as a Cart AJAX attribute, and let Shopify preserve it to the order so link visits attribute without a discount code. Markdown: https://attribloom.com/learn/shopify-affiliate-link-tracking-cart-attributes.md
- [FTC affiliate disclosure: the complete 2026 guide (rules, examples, placement)](https://attribloom.com/learn/ftc-affiliate-disclosure-guide): What the FTC requires, the exact sentences you can use, where to put a disclosure on each platform, the penalty for getting it wrong, and the rules for AI and synthetic endorsers. Educational, not legal advice. Markdown: https://attribloom.com/learn/ftc-affiliate-disclosure-guide.md
- [What is deferred deep linking? A plain-English guide for attribution](https://attribloom.com/learn/what-is-deferred-deep-linking): Deferred deep linking sends a new user to a specific place inside an app even when the app is not installed yet, and preserves who referred them. Here is how it works and why it matters for attribution. Markdown: https://attribloom.com/learn/what-is-deferred-deep-linking.md

## Comparisons
- [Affiliate software comparison hub](https://attribloom.com/compare): sourced comparison of Attribloom, UpPromote, Refersion, GoAffPro, Social Snowball, and GoMarketMe.
- [GoMarketMe alternative](https://attribloom.com/compare/gomarketme-alternative): documented fit for iOS and cross-platform app affiliate programs.
- [Insert Affiliate alternative](https://attribloom.com/compare/insertaffiliate-alternative): documented fit versus SDK-and-provider-based app affiliate tracking.
- [UpPromote alternative](https://attribloom.com/compare/uppromote-alternative): documented fit for native attribution versus Shopify program management.

## About
- [Editorial policy](https://attribloom.com/about/editorial-policy): how Attribloom researches, tests, and updates its documentation, including source selection, update cadence, and corrections.
- [Attribution methodology](https://attribloom.com/about/attribution-methodology): what Attribloom observes directly versus what it derives from Apple and Shopify documentation, and the no-fingerprinting boundary.

## Help
- [What is Attribloom?](https://attribloom.com/help/01-what-is-attribloom). Markdown: https://attribloom.com/help/01-what-is-attribloom.md
- [Getting started](https://attribloom.com/help/02-getting-started). Markdown: https://attribloom.com/help/02-getting-started.md
- [Campaigns](https://attribloom.com/help/03-campaigns). Markdown: https://attribloom.com/help/03-campaigns.md
- [Affiliates](https://attribloom.com/help/04-affiliates). Markdown: https://attribloom.com/help/04-affiliates.md
- [Connecting an iOS app](https://attribloom.com/help/05-ios-app-store). Markdown: https://attribloom.com/help/05-ios-app-store.md
- [Integrations & postbacks](https://attribloom.com/help/06-integrations-postbacks). Markdown: https://attribloom.com/help/06-integrations-postbacks.md
- [How attribution works](https://attribloom.com/help/07-attribution). Markdown: https://attribloom.com/help/07-attribution.md
- [Commissions & payouts](https://attribloom.com/help/08-commissions-payouts). Markdown: https://attribloom.com/help/08-commissions-payouts.md
- [FAQ](https://attribloom.com/help/09-faq). Markdown: https://attribloom.com/help/09-faq.md
- [Shopify attribution](https://attribloom.com/help/10-shopify). Markdown: https://attribloom.com/help/10-shopify.md
- [iOS redeemer offer codes](https://attribloom.com/help/11-ios-offer-codes). Markdown: https://attribloom.com/help/11-ios-offer-codes.md
- [Testing attribution](https://attribloom.com/help/12-testing-attribution). Markdown: https://attribloom.com/help/12-testing-attribution.md
- [AI affiliates](https://attribloom.com/help/13-ai-affiliates). Markdown: https://attribloom.com/help/13-ai-affiliates.md

## Agent setup prompts
- [Setup step prompt index](https://attribloom.com/agent): public, tenant-free context for external AI agents helping with Attribloom setup.
- Full autonomous tenant management is not exposed. Account, campaign, affiliate, connection-state, balance, and payout management remain human-attended dashboard workflows.

## Start
- [Home](https://attribloom.com/): what Attribloom is and who it is for.
- [Pricing](https://attribloom.com/pricing): 0.5% introductory platform fee on affiliate commission, no base fee or seats; affiliates keep 100%.
- [Sign up](https://attribloom.com/signup): create a program.
- [Affiliate sign-in](https://attribloom.com/portal/login): passwordless email sign-in for affiliates.