Documentation

Support

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 8 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, 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 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
    .
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. 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 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, 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.
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.
AppsFlyer ad revenue values configuration screen