Documentation

Support

Integration with Adjust

Integrate Adjust as your mobile measurement partner to share user engagement and campaign data with Tapjoy Offerwall.
Read time 3 minutesLast updated 8 days ago

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

Tapjoy campaign configuration

1

Partner Setup

  1. Under Campaign Lab, select Partners (previously called Network).
  2. Select New Partners.
  3. Search and select Tapjoy.
  4. Select Next.
Note
Don't use Activate partner to pause or turn off campaign attribution. Disabling partner integration can cause irreversible damage to active campaigns.
Selecting Tapjoy as a partner in Adjust dashboard
2

Select App

  1. App Selection: A list of apps will appear. Select the app you want to configure.
  2. Select Next.
3

Install + Data Sharing

Note
Data sharing is only required during the initial setup. If this step has already been completed, it will be bypassed when adding new apps or creating new links.
  1. Select Edit on the Enable data sharing for Tapjoy section.
  2. Enter your Tapjoy generated string under the app_id field.
  3. Select Enable.
Enabling data sharing in Adjust dashboard
4

Set your data sharing options

  1. Select Platform-specific settings
  2. For each platform, select the following sharing options:
    • What sources of data do you want to share?
      • Data from all attribution sources
    • What will be shared by default?
      • Installs
    • What other data do you want to share?
      • Sessions
      • In-app revenue (from in-app purchases) - You need to map events which generate revenue to share this data.
      • Parameters - You usually need to map parameters to share this data.
Configuring sharing parameters in Adjust dashboard
  1. Link Structure: Create a link name.
  2. User destinations: Leave as-is and select Next.
  3. Attribution Settings: Leave as-is and select Next.
  4. Setup Review: Leave as-in and select Create Link.
  5. Automatically redirected to the click URL page.
5

Events

The user path to map events in Adjust’s dashboard: Campaign Lab > Partners > Tapjoy > Data sharing Tab > Select App > Scroll down to Map your events > Click Map event.
Data sharing tab in Adjust dashboard
  1. Navigate to the Campaign Lab tab > Partner
  2. Search and Select Tapjoy.
  3. Select the Data Sharing tab (as shown in the screenshot above).
  4. Select App.
  5. Scroll down to the Map Your Events section.
  6. Select Map event and select the SDK event in the Adjust Event dropdown.
  7. Under Partner event, select platform specific settings mapping. Choosing this will separate Android and iOS into distinct fields. Note that the Tapjoy engagement_id for the same SDK event_name varies between platforms.
Mapping partner event in Adjust dashboard
  1. Name: Enter the name of the SDK event.
  2. Engagement ID: Enter the unique Tapjoy
    {engagement\_id}
    that is generated
  3. Select Apply.
  4. Repeat Steps 6 to 7 until all events are added.

IAP and ad revenue configuration for ROAS

Adjust IAP setup

For more information, refer to the following topics in the Adjust Help Center:
1

Add your purchase events

  1. Login to the Adjust Dashboard.
  2. Under AppView, select All apps.
  3. Select the respective app.
  4. Select the Events tab.
  5. Select Add event.
  6. Enter your in-app Event name.
Note
The setting "This is a unique event" does not apply to IAP events.
  1. Select Add event.
ROAS tracking for in-app purchases in Adjust
2

Map your IAP events

After you’ve added your purchase events, you’ll need to map the events you want to share to Tapjoy. Data for unmapped events will not be shared.
  1. Select Map event and select the SDK event in the Adjust Event dropdown.
  2. Under Name, enter the name of the SDK event.
  3. Under Engagement ID, enter the unique Tapjoy
    {engagement_id}
    that is generated.
  4. Select Apply.
  5. Repeat Steps 1 to 4 above until all events are added.

Adjust ad revenue setup

1

Map your ad revenue events

  1. Select Map event and select the SDK event in the Adjust Event dropdown.
  2. Under Name, enter the name of the SDK event.
  3. Under Engagement ID, enter the unique Tapjoy
    {engagement_id}
    that is generated.
  4. Select Apply.
  5. Repeat Steps 1 to 4 above until all events are added.
Mapping ROAS event in Adjust dashboard
2

Enable Ad Revenue

  1. Under Campaign Lab, select Partners.
  2. Search for Tapjoy and select the Tapjoy hyperlink in the search results under Channel.
  3. Select the Data Sharing tab.
  4. Select the respective app.
  5. Scroll down to Set your data sharing options.
  6. Check the Ad revenue clickbox.
Note
Data from all sources is shared by default. If you specify any sources under the "Filter ad revenue sources" section, you must include Tapjoy in order for us to receive your data.
  1. Select SAVE.
Ad revenue ROAS tracking in Adjust dashboard