Documentation

​
​

Development

User Acquisition

Monetization

Industry

Unity Offerwall

Offerwall Android SDK

Offerwall iOS SDK

Offerwall Unity SDK

Unity Offerwall

Tapjoy Offerwall
​
​
Dashboard
  • CPE campaigns
  • Deferred deeplinks
  • Payment security
ROAS optimization
  • ROAS optimization
  • Introduction to ROAS optimization
  • Get started with ROAS optimization
  • Target ROAS optimizer best practices
APIs
  • API authentication
  • Reporting API advertiser
  • Reporting API best practices
  • Campaign management
  • Audience API overview
MMP integrations
  • MMP integrations
  • Adjust
  • Appsflyer
  • Singular
  1. Grow your game
  2. Unity Offerwall
  3. Offerwall user acquisition

Integration with Appsflyer

Integrate Appsflyer as your mobile measurement partner to share user engagement and campaign data with Tapjoy Offerwall.
Read time 5 minutes
Last updated 2 months ago

This guide provides instructions on setting up a new Offerwall campaign in the Appsflyer dashboard.
For additional guidance, refer to the Set-up Guide for Tapjoy in the Appsflyer documentation.

Tapjoy campaign configuration

Partner activation

  1. From the side menu, select Collaborate > Partner Marketplace.
  2. Search and select for Tapjoy.
  3. On the Tapjoy profile page, select Set Up Integration.
  4. You’re directed to the integration setup page. From the Integration tab, turn on Activate Partner.
Activating Tapjoy as a partner in the AppsFlyer dashboard.
Note
Don't use Activate partner to pause or turn off campaign attribution. Disabling partner integration can cause irreversible damage to active campaigns.

Integration tab (install)

  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
    .
The AppsFlyer dashboard showing all media sources.
  1. Toggle In-app events postback.
  2. Select Add Event.
  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. Select Save Integration or proceed to Step #3 Integration Tab: Events to add more post-install events.
A Tapjoy-generated tracking link in the AppsFlyer dashboard.

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:
  • First Time Installers: Users who’ve never installed or launched the app on their device. Reinstalls are not considered new installs.
  • 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.

Integration tab (events)

  1. Scroll down to the In-app events postback section.
  2. Select Add Event.
  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. Select Save Integration, or proceed to the Daily Rewards section to configure additional post-install events.
Mapping an in-app event to Tapjoy in the AppsFlyer dashboard.
  1. Scroll down to the In-app events postback section.
  2. Select Add Event.
  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
    .
Note
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, refer to tips and limitations.
  1. Input the Tapjoy generated engagement_id under mapped to partner event.
  2. Under Including, select
    Values + No Revenue
    in the dropdown to ensure level data is included in the conversion postback information.
  3. Select Save Integration.
Daily rewards reporting in the AppsFlyer dashboard.

IAP and ad revenue configuration for ROAS

Appsflyer IAP setup

  1. Under the In-app events postback section, select Add Event.
  2. Add your in-app purchase event. We strongly recommend using the event name of
    af_purchase
    for IAP events (refer to Appsflyer's af_purchase event).
  3. Input the Tapjoy generated engagement_id under mapped to partner event.
  4. Choose your preferred sending option under the for users from column. We recommend selecting "All media sources, including organic".
  5. Under Including, select
    Values + Revenue
    to ensure amounts are included in the conversion postback information.
  6. Select Save Integration.
Refer to Appsflyer's predefined events list.
The AppsFlyer revenue values configuration screen.

Appsflyer ad revenue setup

Tapjoy supports two methods for sending ad revenue: Postbacks and the Data Locker. The recommended best practice is the Postback method for improved data quality.
  1. Under the In-app events postback section, select Add Event.
  2. Add your ad revenue event using the event name of
    af_ad_revenue
    . Using the af_ad_revenue event name is required.
  3. Input the Tapjoy generated engagement_id under mapped to partner event.
  4. Choose your preferred sending option under the for users from column. We recommend selecting "All media sources, including organic".
  5. Under Including, select
    Values + Revenue
    to ensure amounts are included in the conversion postback information.
  6. Select Save Integration.
Note
If you are enabling ad revenue through postbacks for an app for the first time, notify your Account Manager to have this data enabled and displayed in the Tapjoy Dashboard. Otherwise, ad revenue in the Tapjoy Dashboard will either not be reflected or will continue to come from your Data Locker data, if the Data Locker has been configured for this app. This must be done for each app individually.
The AppsFlyer ad revenue values configuration screen.
Note
Advertisers must have an ROI360 advanced subscription to use Data Locker for sharing ad revenue.
  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. Select Save.
For more information, refer to Ad revenue signals for UA ad networks in the Appsflyer documentation.
Ad revenue reporting in the AppsFlyer dashboard.

Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page
    • Tapjoy campaign configuration

      • Partner activation

      • Integration tab (install)

        • Dynamic suppression requirements for install

      • Integration tab (events)

    • IAP and ad revenue configuration for ROAS

      • Appsflyer IAP setup

      • Appsflyer ad revenue setup


Report a problem with this page