More Apps Cross Promotion

The More Apps unit presents a list of your promoted applications to your users in the form of a popup.

Each position in the more apps template has it’s own custom placement tag. This enables you to control exactly which apps are shown in each position within the unit.

To learn how to set up the more apps popup on the Tapdaq dashboard, visit the following guide.

NEW: SDK version 7.0.0 supports zones. Please note, this release does not currently support cross promotion ad serving. To access our cross promotion features, please use SDK version 6.4.1

1. Register the placement tags

To begin preparations for displaying an interstitial, go to Window > Tapdaq > Edit Settings, which will open a panel in the Unity Editor. Make sure TDAdType1x1Medium has registered the tray-position-1,tray-position-2,tray-position-3,tray-position-4,tray-position-5 tags:

Adding a backfill tag will populate the bottom of your list with backfill items setup in the dashboard, to use this add tray-position-backfill to your registered placements.

More Apps - Register Placement

2. Load the content

Make sure you add the Tapdaq namespace to the top of your script:

using Tapdaq;

Before displaying the more apps popup to the user, please load the content as shown below:

AdManager.LoadMoreApps();

If you would like to load the more apps content when the application starts, use the TapdaqConfigLoaded listener to guarantee the ad is loaded.

private void OnEnable() {
	TDCallbacks.TapdaqConfigLoaded += OnTapdaqConfigLoaded;
}

private void OnDisable() {
	TDCallbacks.TapdaqConfigLoaded -= OnTapdaqConfigLoaded;
}

private void OnTapdaqConfigLoaded() {
	AdManager.LoadMoreApps();
}

3. Display the more apps popup

Navigate to the location in your code where you would like to display the more apps popup (e.g. after a button is tapped) and implement the following:

if (AdManager.IsMoreAppsReady()) {
  AdManager.ShowMoreApps();
}

It's also possible to check when the content for the more apps popup has loaded, this is useful if you want to make a "More Apps" button visible on the screen. You can check when the content for the popup has loaded by implementing the following:

private void OnEnable() {
  TDCallbacks.AdAvailable += OnAdAvailable;
}

private void OnDisable() {
  TDCallbacks.AdAvailable -= OnAdAvailable;
}

private void OnAdAvailable (TDAdEvent e) {
  if (e.adType == "MORE_APPS") {
    // Ready to display the more apps popup
  }
}

For a full list of more apps callbacks we support, see our Callbacks page.

4. Load more content on close

If you wish to refresh the more apps data after you have shown one, implement the following:

private void OnEnable() {
	TDCallbacks.AdClosed += OnAdClosed;
}

private void OnDisable() {
	TDCallbacks.AdClosed -= OnAdClosed;
}

private void OnAdClosed(TDAdEvent e) {
	if (e.adType == "MORE_APPS") {
    AdManager.LoadMoreApps();
	} 
}

Build and run your application to test the advert displays correctly.

5. Customise the look and feel

Colours and text can be customised to make the design fit into your app. When loading the More Apps popup, you must pass in a TDMoreAppsConfig object with the settings you wish to change. Here's an example:

TDMoreAppsConfig config = new TDMoreAppsConfig();

config.headerText = "More Games";
config.installedAppButtonText = "Play";

config.SetHeaderTextColor(Color.white);
config.SetHeaderColor(Color.black);
config.SetHeaderCloseButtonColor(Color.white);
config.SetBackgroundColor(Color.gray);

config.SetAppNameColor(Color.blue);
config.SetAppButtonColor(Color.black);
config.SetAppButtonTextColor(Color.white);
config.SetInstalledAppButtonColor(Color.green);
config.SetInstalledAppButtonTextColor(Color.black);

AdManager.LoadMoreAppsWithConfig(config);

Need help?

If you are having any problems integrating, feel free to contact us on [email protected] and we will be more than happy to help.

What's next?

Now that you have successfully integrated more apps into your app, what would you like to do next?