English

User rewards

Adjust’s dynamic click label lets you tag your app users with unique IDs to deliver custom rewards. Boost your install rate through invites while invigorating your existing users through customized in-app rewards. Here, you can find out how to set up an invite-reward scheme with Adjust.

Before you begin

Here's what you need to know before getting started.

Requirements

  • A BI system set up to deliver user rewards.
  • App-specific user IDs.
  • An app set up to populate the label placeholder with the user ID and send out the newly populated tracker URL (for example via email) to the invitee.

Terminology

PlaceholderDescription
{label}An Adjust placeholder you can use to send custom data or information. The value is sent on click.

Example: user_id

The label parameter is an Adjust placeholder that can be populated with custom user information. When you add the label parameter to your tracker URLs, Adjust forwards the value via real-time callbacks or in-app attribution callbacks (iOS and Android).

Note:
The label parameter value will not appear anywhere in the Adjust Dashboard and networks cannot receive the value through postbacks.

Send user rewards

You can use Adjust's label parameter to run invite-reward schemes. This lets you provide in-app bonuses to existing users for every new user they successfully drive to install your app.

Here's how it works to send a user reward.

  1. Set up an install callback or attribution callback (iOS / Android) containing the label parameter.
  2. Create a tracker URL with a label parameter appended (and any other parameters you require).
    • For example: https://app.adjust.com/abc123?label={user_id}
  3. Place your tracker URL appropriately.
    • For example, behind an in-app invite button
  4. Instruct your app to populate the label parameter with the user ID before sending the tracker URL to the invited user.
  5. Run your user reward campaign.
  6. When the invited user downloads and opens the app, one of the following scenarios happens:
    • Your server receives an install callback from Adjust containing the label parameter populated with a user ID
    • The Adjust SDK receives an attribution callback containing the label parameter populated with a user ID. Your app collects this and sends it to your server.
  7. You send a user reward to the user ID.

Example invite-reward schemes

We've outlined invite schemes using Adjust’s real-time callbacks and in-app attribution callbacks. Attribution callbacks provide a way to immediately reward new users, as the information is handled within your app. Otherwise, attribution and real-time callbacks provide the same functionality.

Below are two example scenarios for an invite-reward scheme, one using real-time callbacks, the other using attribution callbacks.

With real-time callbacks

  1. Oscar, down to his last life in your game, clicks an in-app button to invite a friend in return for an extra life. This button contains an Adjust tracker URL with a label parameter appended.
  2. Your app populates the label parameter value with Oscar’s user ID
  3. Your app sends the tracker URL, now containing Oscar’s user ID, to Mike’s, e.g., email address.
  4. Mike clicks the link containing Oscar's user ID, which takes him to the relevant app store, where he downloads and installs your app.
  5. Mike’s install is attributed to the tracker link containing Oscar’s user ID as the value in the label parameter.
  6. Adjust fires an install callback—with Oscar’s user ID appended—to your BI system
  7. Your BI system sends an in-app reward (in this case, an extra life) to Oscar for successfully inviting Mike.

With attribution callbacks

  1. Oscar, down to his last life in your game, clicks an in-app button to invite a friend in return for an extra life. This button contains an Adjust tracker URL with a label parameter appended.
  2. Your app populates the label parameter value with Oscar’s user ID
  3. Your app sends the tracker URL, now containing Oscar’s user ID, to Mike's, e.g., email address.
  4. Mike clicks the link containing Oscar's user ID, which takes him to the relevant app store, where he downloads and installs your app
  5. Mike’s install is attributed to the tracker link containing Oscar’s user ID as the value in the label parameter
  6. Adjust fires an attribution callback containing Oscar’s user ID to your app’s Adjust SDK.
  7. Your app collects this information from the Adjust SDK and sends it to your BI system
  8. Your BI system sends an in-app reward (in this case, an extra life) to Oscar for successfully inviting Mike.