Introduction and integration guide.
Every platform for affiliate marketing for mobile apps requires some kind of code integration. Even most web-based platforms require some kind of code integration. But we believed it could be better and simpler, and searched for a solution for a very long time. Finally, we have a solution that we believe can be a game changer for affiliate marketing in the mobile app space.
We are still in the process of testing and refining this feature. There are some limitations and uncertainties, and we want to ensure that it is stable and secure before making it public.
We are testing the feature with a limited selection of apps to ensure close collaboration and feedback.
For now, please keep this spec to yourself.
This feature works only for apps distributed via the App Store.
A similar setup for Google Play Store apps is currently not possible, and might not be possible at all. For Android apps, consider using our standard integration approach.
The app must have Offer Code support enabled.
This might be the only code change needed, but it involves adding integration of Apple’s native feature, not a third party.
When using RevenueCat, Superwall, or similar tools, the necessary support is most likely already in place. Check the documentation for your chosen SDK.
For RevenueCat paywalls, you might want to configure the redeem button as part of the paywall.
The integration must be established via the WinWinKit dashboard.
The required access roles are Marketing and Sales. You might need to update an existing integration with the new permissions.
Previously, the integration required the App Manager access role, but this has been revised and now lower-level access roles are sufficient.
Current limitations apply only to the Offer Code configurations.
These limitations exist mainly due to uncertainty about the data structure and quality received from App Store Connect.
These limitations will be partially, but hopefully fully, lifted when proper handling of currently unsupported cases is possible and is implemented.
The Offer Code configuration must be available to new users. This is configured in App Store Connect when creating a new offer.
Since iOS 18, Offer Codes work with in-app purchases (lifetime) too. While Apple only recently released an API to interact with the new Offer Codes, they still don’t provide analytical data about them. Support for in-app purchases will be added as soon as there is a way to get data from App Store Connect.
When creating a custom Offer Code on an app’s behalf in App Store Connect, WinWinKit sets a minimum configurable limit of 500. This means that up to 500 users can claim the code until the usage is extended.
WinWinKit tracks and extends the usage & limits of Offer Codes automatically on a daily basis. Currently this means that up to 500 users can claim the code per day.
Latest tracked usage & limits are displayed in the dashboard for each code. Values are updated daily.
Tracking of renewals and refunds is partially verified, but currently not attributed to affiliates at all. Analyzing a larger set of data should help improve this.
Steps to set up an Offer Code for no-code integration:
The first step is to add or update your integration with App Store Connect. This enables interaction with and tracking of Offer Codes.
1.1. Go to Settings → Integrations → App Store Connect → Connect and follow the instructions.
The next step is to create a new reward with an Offer Code.
2.1. Go to Rewards → New Reward
2.2. Select Type → Offer Code
2.3. Select Offer Code from the dropdown
The Offer Code configuration is displayed once loaded. Have a look at the Native Integration item, which indicates whether the currently selected Offer Code is compatible with the current limitations.
If needed, create a different Offer Code in App Store Connect that meets the limitation criteria described above.
Save when done.
Remember, the selected Offer Code should be compatible with the no-code integration.
3.1. Go to Affiliates → Groups → Default Group
3.2. Set Affiliate Rewards
Update Commission Rate if needed.
Update Commission Duration to be 1 month (equals the user’s first tracked transaction). This is best kept at 1 month until support for tracking renewals is in place.
Update Amount per User and Amount per Conversion if needed.
Save when done.
3.3. Set User Rewards
In App Store Offer Code Reward section, select the Offer Code reward created in step 2.
Save when done.
Copy invite link to the group by going to Affiliates → Invite Affiliates → Copy Link.
Share the invite link with your affiliates.
You will receive an email notification when a new affiliate request is submitted.
Once there are affiliates on board, they can create the first referral code themselves. Alternatively, you can create up to three codes for each affiliate.
When a code is created from the WinWinKit dashboard, it will also be created on App Store Connect as a custom Offer Code. Immediately after, users can use this code to redeem a discount on your app.
WinWinKit validates that the code does not already exist on App Store Connect before creating it.
Note that it is currently not possible to edit or delete any custom offer codes in App Store Connect. They can only be deactivated, and support for this is coming later.
Apple Documentation:
Please share your questions, concerns, and ideas.
Thank you in advance!
— Oleh from WinWinKit