Connecting an iOS app

To attribute App Store purchases to affiliates, you need to connect your app under iOS Apps. This lets Attribloom receive Apple's App Store Server Notifications and match purchases to the affiliate who drove them.

Fields when connecting an app

Display name. Your label for the app inside the Attribloom dashboard. For your reference only.

Bundle ID. The reverse-DNS identifier from Xcode or App Store Connect (for example, `com.example.myapp`). This must exactly match the bundle ID that Apple includes in purchase notifications — if it doesn't match, purchases will not attribute.

App Store app ID. The numeric Apple ID shown in the App Store URL for your app (for example, `1234567890`).

Environment. Choose Production for live App Store builds, or Sandbox for TestFlight and Xcode test purchases. Sandbox purchases are never billed and never pay commission — they are useful for testing your integration only.

After connecting

After saving, Attribloom gives you a Forwarding URL. Go to App Store Connect, open your app's configuration, and set this URL as the App Store Server Notifications V2 endpoint. Alternatively, if your own server already receives Apple notifications, configure it to forward them to the Forwarding URL.

Attribloom verifies ownership by completing a TEST notification round-trip before it trusts purchases from the app.

How purchases are attributed

Attribution works via the appAccountToken — a UUID your app sets on the StoreKit 2 purchase request at the time of purchase. The token encodes which affiliate referred the user. When Apple's notification arrives, Attribloom reads the token and credits the right affiliate. The token must be set at purchase time; it cannot be added retroactively.