Documentation

Referral Codes for Mobile Apps

GoMarketMe Referral Codes give affiliates an easy-to-remember way to promote your app when sharing a link is not practical. They are ideal for conversations, podcasts, videos, livestreams, events, presentations, and print.

Affiliate links are optional. Referral codes work even when no affiliate link is used; the user can enter the code directly in your app.

How affiliate links behave depends on your attribution method. With Referral Codes only, affiliate links open a branded download page displaying the affiliate’s referral code and App Store or Google Play buttons. With Links + Referral Codes, link attribution remains enabled and users can also enter a referral code directly in your app.

Set up referral codes in three steps

1. Update to GoMarketMe SDK 6.0.2 or later and add a code-entry experience. Use showReferralCodeTrigger() for GoMarketMe’s built-in UI, or connect your own code-entry interface to the SDK.
2. Choose your attribution method. Open Settings → Attribution → Method. Select Referral Codes to use code-based attribution only, or select both Links and Referral Codes to keep link attribution enabled while also accepting referral codes. Save your changes.
3. Add referral codes to any campaign. Referral codes are available for Public and Private campaigns, whether existing or new. Assign an optional, unique code to each participating affiliate.

Customize the in-app experience

With GoMarketMe’s built-in UI, you control how the referral-code experience looks in your app without building the interface yourself. Open Settings → Attribution → Customize Referral Code UI to configure the trigger as a link or button, then customize its text, alignment, typography, colors, border, and spacing.

The live preview shows the complete referral-code sheet, including the title, message, code field, Skip button, Apply Code button, and success or error states.

Customize Referral Codes in GoMarketMe →

Assign referral codes to affiliates

Referral codes are available for Public and Private campaigns, whether existing or new. Enter a code when inviting a new affiliate or editing an existing affiliate. Codes are optional, but every code must be unique across all campaigns in your GoMarketMe account.

Choose codes that are short, memorable, and easy to spell. A creator name, brand name, or simple campaign phrase usually works well.

What users see in your app

If you use the built-in UI, the SDK displays the trigger and referral-code sheet with the appearance you configured in GoMarketMe. A user can enter the code they received and tap Apply Code.

With Referral Codes as the attribution method, users arriving through an affiliate link see the affiliate’s referral code on the branded download page and enter it after opening your app. If you also enable Links, affiliate links can establish attribution directly while referral codes remain available as an additional attribution method. Users without a code can skip the step and continue.

Best practices

• Keep codes short and avoid characters that are easy to confuse.
• Place code entry where new users will see it during onboarding.
• Use clear trigger text such as “Have a referral code?”
• Give each affiliate a consistent code they can remember and say aloud.
• Test a valid code, an invalid code, and the Skip action before releasing your app.