Reengagement Campaigns

Last Update:

So you used Chartboost to acquire a user – but now what?

Enter reengagement campaigns: These promotions let you target existing users and send them back to your game for the latest in-app purchase, promotion, or other content.


Overview

Chartboost reengagement campaigns work the same as cross-promotions and direct deals, with one key difference: Instead of ignoring users who've installed your game, reengagement campaigns target them exclusively.

As a result, you can showcase in-game promotions to current players, and send former players to the App Store for your latest update.

For information about reengagement campaigns for network advertising, see this page.

You'll need to do a bit of configuration to your code and campaign before your game is ready to be promoted like this, but the process is quick and painless:

  1. Set up deep links in your code
  2. Add deep links to your game via the Chartboost dashboard
  3. Enable reengagement campaign logic via the dashboard

Set Up Deep Links in Your Game

iOS
If your game is targeting only iOS 9.x and above, add universal links in the Creative Deeplink or Creative URL fields.
Deeplinks and universal links are not compatible. You will need to separate deeplinks and universal links into separate campaigns with separate creatives.

First off, you'll need to define a custom URL scheme for your game via its info.plist. When users with your game installed click a link beginning with yourgame://, they'll be taken directly to the app – instead of the App Store. For a detailed walkthrough, check out this excellent tutorial from iOS Developer Tips.

The second step is to decide where within your game you want users to end up. Any link using your URL scheme will take users directly to your game, but you can use the UIApplicationDelegate method to handle URLs like examplegame://home/store/ or examplegame://news/ to send users to an in-game store, news page or other location.

Android

Deep link setup on the Android side works similarly; you'll need to specify intent filters in your app manifest that define how to reach specific content or locations in your game.

Here's how (instructions taken from Google Developers documentation here):

  1. In your Android manifest file, add one or more <intent-filter> elements for the activities that should be launchable from Chartboost ad clicks
  2. Add an <action> tag that specifies the ACTION_VIEW intent action
  3. Add a <data> tag for each data URI format the activity accepts. This is the primary mechanism to declare the format for your deep links.
  4. Add a <category> for both BROWSABLE and DEFAULT intent categories
    • BROWSABLE is required in order for the intent to be executable from a web browser. Without it, clicking a link in a browser cannot resolve to your app and only the current web browser will respond to the URL.
    • DEFAULT is not required if your only interest is providing deep links to your app from Google search results. However, the DEFAULT category is required if you want your Android app to respond when users click links from any other web page that points to your web site. The distinction is that the intent used from Google search results includes the identity of your app, so the intent explicitly points to your app as the recipient – other links to your site do not know your app identity, so the DEFAULT category declares your app can accept an implicit intent.

For examples, see this page.


Add Deep Links to Your Game via the Dashboard

After you've configured your code to handle deep links, you'll need to connect individual creative sets to those locations so players arrive at the deep link instead of your game's app store listing.

Add or edit a creative set in your advertising campaign.

In the Upload creatives pop-up that appears, add your deep link to the Creative Deeplink field.

When a player clicks the ad, our system will first try sending them to your game via the deep link. But if your game has been uninstalled from their device, we'll send them to the regular URL instead, if it's present.

Creative-level URLs will always take precedence over these app-level URLs, but in the event that a creative-level deep link fails and no creative-level regular link exists, we'll use the game's app level URL, which takes users to the game's App Store listing.


Enable Reengagement Campaign Logic

The last step is to head to the reengagement campaign's Campaign Edit page and flip a switch that allows the campaign to target existing/former users. The reengagement option is available for cross-promotions and direct deals (for information about reengagement campaigns for network advertising, see this page).

You'll find the switch on the Advanced Settings tab; just check the box in the Reengagement Campaign section:

Note that you can further refine reengagement targeting with device lists – our system starts with a set of users who have installed your game, but can use a device list to pinpoint or exclude specific devices from the initial group.

After you enable reengagement logic and configure the rest of the campaign, hit Save, and you're done!


Other Use Cases

If you'd like to send existing and former users to the App Store for an update – instead of to an in-game location – there's no need to set up deep links; just enable reengagement logic, and we'll send users to the regular URL you specify at the app or creative level.