Tapjoy Campaign Configuration

This guide provides instructions on setting up a new Offerwall campaign in the Appsflyer dashboard.
Additional guidance can be found in the Appflyer Set-up Guide for Tapjoy

Step #1 Partner Activation

1. From the side menu, select 🔄Collaborate > Partner Marketplace.
2. Search and select for Tapjoy.
3. On the Tapjoy profile page, click the ⚙ Set Up Integration button, upper right hand side.
4. You’re directed to the integration setup page. From the Integration tab, turn on Activate Partner.

---

⚠️ Important ⚠️
Don't use Activate partner to pause or turn off campaign attribution. Disabling partner integration can cause irreversible damage to active campaigns.

---

Step #2 Integration Tab: Install

First Time Installers

1. Toggle Activate Partner.
2. Input the Tapjoy generated string under the app_id field.
3. Toggle OFF the Install view-through attribution option.
4. Under the Default Postback section, next to install, select All media sources, including organic.

Existing Users

1. Toggle In-app events postback.
2. Click the + Add Event button.
3. Under Appsflyer event, search for or add af_app_opened.
4. Use the same Tapjoy-generated string entered in the app_id field from Step #2.2.
5. In the for users from dropdown, select All media sources, including organic.
6. Click Save Integration or proceed to Step #3 Integration Tab: Events to add more post-install events.

---

⚠️ IMPORTANT ⚠️
Dynamic Suppression Requirements for Install:
To comply with our Dynamic Suppression Policy and ensure optimal performance, the following configurations are required as of Apr 1, 2022:

1. First Time Installers - Users who’ve never installed or launched the app on their device. Reinstalls are not considered new installs.
2. Existing Users - Users who previously installed and launched the app on their device at any point, including those who have reinstalled the app after uninstalling it.

---

Step #3 Integration Tab: Events

Single + Multi-Reward CPE

1. Scroll down to the In-app events postback section.
2. Click the + Add Event button.
3. Under Appsflyer event, select the event from the dropdown.
4. Input the Tapjoy generated engagement_id under mapped to partner event field.
5. Repeat steps 2 - 4 until all events are configured and point to a unique engagement_id.
6. Click Save Integration, or proceed to the Daily Rewards section to configure additional post-install events.

Daily Rewards CPE

1. Scroll down to the In-app events postback section.
2. Click the + Add Event button.
3. Add the SDK event associated with in-game leveling up. Supported event names include both custom events and Appsflyer’s predefined ones, such as af_level or af_level_achieved.

---

Appsflyer recommends integrating the following predefined events for in-game leveling up: af_level for in-app purchases, af_level_achieved for user generated ad revenue events. Custom events are also supported. Learn how to define an event and use the event generator. For more information, please visit tips and limitations.

---

4. Input the Tapjoy generated engagement_id under mapped to partner event.
5. Under Including, select Values + No Revenue in the dropdown to ensure level data is included in the conversion postback information.
6. Click Save Integration.

ROAS: IAP + Ad Revenue Configuration

---

⚠️ IMPORTANT ⚠️ Adrevenue is exclusively available for ROI360 customers with the Advanced package. To learn more, visit here.

---

ROAS Step #1 Add your purchase events

1. Scroll down to the In-app events postback section.
2. Click on + Add Event button to map the purchase and revenue events.
3. Under the Appsflyer’s Event column, select the respective post-install event from the dropdown.

---

Appsflyer recommends integrating the following predefined events: af_purchase for in-app purchases, af_ad_revenue for user generated ad revenue events

---

4. Input the Tapjoy generated engagement_id under mapped to partner event.
5. Select your preferred sending option.
6. Under Including, select Values + Revenue to ensure amounts are included in the conversion postback information.
7. Click Save Integration.

ROAS Step #2 Enable Ad Revenue Permissions

---

In order for the Tapjoy to collect adrevenue reports via Data Locker, the Adrevenue permission must be toggled to ON.

---

1. From the side menu, select Collaborate > Active Integrations.
2. Use the search bar to find and select Tapjoy.
3. Navigate to the Permissions tab.
4. Turn on Ad Network Permissions.
5. Turn on the permission Access ad revenue raw data (UA signals).
6. Click Save.