Documentation

Support

Offerwall

Get started with Monetization

Get started with User Acquisition

Unity SDK integration

Offerwall

Integration with Appsflyer

Integrate Appsflyer as your mobile measurement partner to share user engagement and campaign data with Tapjoy Offerwall.
Read time 4 minutesLast updated 24 days 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, 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.
Activating Tapjoy as a partner in AppsFlyer dashboard

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
    .
AppsFlyer dashboard showing all media sources

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. 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.
Mapping in-app event to Tapjoy in AppsFlyer

IAP and Ad Revenue Configuration for ROAS

Appsflyer IAP Setup

  1. Under the In-app events postback section, click the Add Event button.
  2. Add your in-app purchase event. We strongly recommend using the event name of 
    af_purchase
    for IAP events (see 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. Click Save Integration.
See Appsflyer's predefined events list.
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, click the + Add Event button.
  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. Click Save Integration.
AppsFlyer ad revenue values configuration screen