Add a multi rewards ad set

Create and configure multi rewards ad sets for cost per engagement (CPE) campaigns in the Tapjoy User Acquisition dashboard.

Read time 3 minutes

Last updated 17 days ago

After you create a cost per engagement (CPE) campaign, add the ad sets you want to run. Each ad set that you create is a specific offer shown in the Offerwall.

Note

CPE ad sets are configurable only for Android mobile devices. If your ad set needs to run on iOS mobile devices, contact your account manager for help setting up an iOS-targeted ad set.

For more information about ad sets and single rewards, refer to the Ad sets and Reward types sections of the Introduction to CPE campaign documentation. For more information about CPE campaigns, refer to Introduction to CPE campaigns. To add a new ad set to your CPE campaign, you can also clone an existing ad set to copy over the settings and modify it as needed. Cloning an ad set doesn’t automatically make the new ad set active. The Offerwall team still needs to review the new ad set before you can enable it.

Prerequisites

Before you add an ad set, ensure you meet the following criteria:

Determine the elements to include in your ad sets. For help with planning your ad sets, contact your account manager.
Prepare offer instructions that meet specific requirements. For more information, refer to Requirements for CPE offer text instructions.
Add an app engagement.
Integrate the app engagement with your MMP.
Create a CPE campaign.

Add an ad set to your campaign

Note

If you just saved the CPE campaign, Tapjoy directs you to the Create Ad Set window to create the campaign’s first ad set. In this case, skip this step and go directly to the next step on this page: Enter ad set metadata.

To add an ad set to an existing campaign, follow these steps in the Tapjoy User Acquisition dashboard:

From the left menu, select Campaigns and find the CPE campaign to add ad sets to.
Select + Add New Ad Set.

Enter ad set metadata

Define the ad set metadata with descriptive values to organize, manage, and track it. To enter ad set metadata, follow these steps:

Define the Ad Set Name to identify your ad set in the dashboard.
Keep the default Name Suffix as CPE. This default suffix is the recommended best practice because the Tapjoy Offerwall team uses it for CPE campaign management.

Configure budgeting

In the Budgeting section, set the reward type, event, event bid, and ad set budget. You can adjust your bids at any time. For details, refer to CPE bid management. To configure the ad set budget, follow these steps:

Select Multi rewards as the Reward Type.
To set up the ROAS Target, select the optimization window from the dropdown list and enter the target percentage. For example, a D3 ROAS Target of 90% means you expect to achieve 90% reenable ad spend (ROAS) three days after the user installs the app.
Set up the event bids either manually or through a CSV file upload.
Note
The Per App Bid setup is explained in step 4 of the manual setup.
1. In the Linear events and Non-linear events sections, select Add event to add the first event row. You can use one or both event types.
2. Input the following information in the event table row:
- MMP Event name: The event name exactly as defined in your Mobile Measurement Partner (MMP) integration. The dashboard name and the MMP name must be an exact match.
  - Event type: The type of non-linear event.
  - Event value: The numeric or string value that indicates the goal to achieve in the event. This value is passed with the event through your MMP integration. For example, if the event is to complete level 1, enter
    1
    as the Event value.
  - Bid: The bid amount for this event.
1. To add additional linear or non-linear events for the publisher app, open the More (…) menu and select either Insert 1 above or Insert 1 below.
2. Optional: To set different bids for specific publisher apps, do the following:
  1. Enable the Per App Bid toggle. The Bid Strategy table updates to include the Publisher Apps column. The Default bids you previously entered remain unchanged.
  2. Add your publisher apps using the Find & Add Apps button.
  3. Select each publisher app under the Publisher App column and enter the right Bid amount.
  Default bids apply to publisher apps not included in your list. The following example, Default is set to $5, and MyTapjoy to $10. This setup means that if a user completes your events after encountering them in the MyTapjoy, you pay $10. For all other publisher apps not on the list, you pay $5.
1. Optional: To set different bids for specific publisher apps, enable the Per App Bid toggle.
2. Select Download sample CSV.
3. Edit and fill the CSV file according to your needs.
4. Select Upload CSV to import your bid settings.
In the Daily Budget field, enter how much the campaign can spend each day.
In the Lifetime Budget field, enter how much the campaign can spend overall.
In the Lifetime Conversion Cap field, enter the maximum number of times that users can complete all events in this ad set.

Note

Offerwall stops showing the ad set when it meets the lower value between the Lifetime Budget or the Lifetime Conversion Cap.

Configure targeting

Configure device and user targeting settings to ensure your offer is shown to the appropriate audience on their mobile devices.

Configure device targeting

To configure device targeting, follow these steps:

Select which Device Type to target with your ad set.
Select which OS Versions to target with your ad set.
To show the ad set on devices connected only to Wi‑Fi, turn on the Wi‑Fi Only toggle.
To target specific Android device models, select Show Advanced. From the Device Model dropdown list, select Selected by Model Name and then the models.

Configure user targeting

To configure user targeting, follow these steps:

Select the Location of users who will be shown the ad set.
If you’ve selected a Location option other than All Available Regions, follow the steps based on the selected option. Otherwise, go to step 3.
Select or enter the countries and regions.
Select the Age Rating that matches your app’s rating in its app store.
Select the Language to show the offer only to users whose preferred device language matches your language selection(s).

Configure tracking

Set up how to track clicks for your ad set so the Offerwall and your MMP can record and attribute actions correctly. To configure tracking, follow these steps:

Next to Attribution Tracking Link, do one of the following:
- If the ad set is integrated with an MMP, select Client-side Click.
- If the ad set isn’t integrated with an MMP, or you’re using an SDK to send attribution data directly to Offerwall, select None.
If you select Client-side Click, follow these steps to enter the Override Destination URL.
1. From your MMP dashboard, find and copy the attribution tracking link. All MMPs pre-populate this link with the required parameters and the Offerwall click macros needed to track clicks. For more information on integration and attribution URLs, refer to your specific MMP documentation:
2. Select the Override Destination text box to open the Third Party Attribution (TPAT) Editor dialog.
3. Paste the link. The dialog prompts you with any necessary fixes before you can select Save.
Note
The Pixel URL fields are not relevant to app campaigns and can be left blank.
Optional: Enter the Attribution Window in days.

Configure Offerwall creatives

Configure creatives with clear visuals and instructions so that users understand the offer and the specific event they must complete to receive the reward.

Important

You can configure and add creatives only before the ad set is approved and active. To edit or add creatives after the ad set is active, contact your account manager.

To configure offerwall creatives, select + Add Creative to open the Add Offerwall Creative dialog and follow the instructions outlined in this section.

Enter creative basic information

In the Basic section, do the following:

Add a Name to the creative to label the instructions for this ad set. This name is visible only internally.
Select a Language in which the text content of the creative will be shown to users.

Configure offer appearance on the Offerwall

In the Offer List section, configure the appearance of your offer. The following example shows how a Tapjoy app and its corresponding Offer List appear on the Offerwall.

The Offerwall interface displaying an app offer with an app icon, headline text, and a call-to-action summary.

To configure the appearance of your offer, follow these steps:

To set the App Icon that will be shown in the offerwall, select one of the following options:
- Use Default App Icon: Tapjoy uses the app icon displayed in the Apple Store and Google Play Store.
- Override App Icon: Tapjoy uses the image you upload instead of the icon displayed in the Apple Store and Google Play Store.
Enter an offer title in the Headline field.
Upload a landscape-format Hero Image to optimize offer visibility in recommended modules like PlayTab.
Optional: Show an animated GIF of your app’s gameplay on the Offerwall. To add a GIF, follow these steps:
1. Select Hide Advanced.
2. Enable the Animated GIF App Icon toggle.
3. Upload two GIFs that meet the requirements specified in the UI.

Configure the offer instructions

In the Offer Instruction section, write the instructions that tell users exactly what action they must complete in your offer.

Important

Offer text instructions must meet specific criteria. For more information, refer to Requirements for CPE offer text instructions.

You can preview the instructions on the right panel, exactly as they’ll display to users. To set up your offer instructions, select one of the following Instruction Type options and add your content in the text box.

Instruction Type	Description	Image size	Video size	Video length
Text only	Only the text instructions to display in the offer.
Gallery	The text instructions, accompanied by up to four unique images.	750x750 pixels
Video	The text instructions, accompanied by a video. The video must be an .mp4 file. You can also upload an optional image.	750x422 pixels	100 MB	Maximum 15 s

After you set up the offer instructions, select Save to add the creative to the list in the Offerwall Creative section.

Enter user-friendly event names in the instructions

In the MR Events In Instruction section, enter a short user-friendly Display name for each MMP event name listed in the table. This display name is what users encounter in the offer. Ensure your event name tells users the required action to complete in exchange for the reward. For example, the MMP Event name

level-complete-1

can have the Display name

Complete Level 1

Specify the traffic split

Under the Traffic Split (A/B Testing) column header, enter the percentage of users who will encounter the creative.

Tip

To add a new creative to the ad set to, you can clone an existing creative to copy over the settings and modify it as needed. To clone a and edit the new one, select Controls (…) > Duplicate.

Add notes

You can specify additional information that’s visible only to your team and the Tapjoy Offerwall team. To help the Tapjoy Offerwall team review your ad set more efficiently, upload up to five relevant screenshots of your app and event configuration in your MMP integration. These visuals can help the Tapjoy Offerwall team to review your ad set efficiently. If you want to communicate additional information to the Offerwall internal review teams, you can add that information in the Note text box. Such notes include the following:

Allowlist and blocklist of publisher apps to control where your offer appears. You can either enter the ID or name of an active ad set that uses the same lists, or enter specific publisher app App IDs or Bundle IDs.
A minimum or maximum click-to-conversion time (CTCT).
Estimated time for a user to complete the first event to speed up internal testing.

After you complete the Add internal notes section, select Save All. After you save, the setup is complete, and the Tapjoy Offerwall team will review and approve the ad set. You will receive the approval by email within usually one business day. If the review exceeds three business days, contact your account manager. You can also track the ad set review status in the User Acquisition dashboard campaign list, as shown in the following image:

User Acquisition dashboard showing CPE campaign ad set list with the review status for each ad set.

After you receive the email confirming CPE campaign and ad set approval, enable the CPE campaign and the ad set.

Documentation

Development

User Acquisition

Monetization

Industry

Documentation

Development

User Acquisition

Monetization

Industry

Grow

Unity Ads Android SDK

Unity Ads iOS SDK

LevelPlay SDK

Grow

Add a multi rewards ad set

Prerequisites

Add an ad set to your campaign

Enter ad set metadata

Configure budgeting

Configure targeting

Configure device targeting

Configure user targeting

Configure tracking

Configure Offerwall creatives

Enter creative basic information

Configure offer appearance on the Offerwall

Configure the offer instructions

Instruction Type

Description

Image size

Video size

Video length

Enter user-friendly event names in the instructions

Specify the traffic split

Add notes