Integration with Adjust

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

Tapjoy Campaign Configuration

Step 1: Partner Set-up

  1. Under Campaign Lab, select Partners (previously called Network).
  2. Click the blue + New Partners button.
  3. Search and select Tapjoy.
  4. Click Next.

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


image_title

Step 2: Select App

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

Step 3: Install + Data Sharing


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. Click the ✎ Edit button on the Enable data sharing for Tapjoy section.
  2. Enter your Tapjoy generated string under the app_id field.
  3. Click Enable.

image_title

Step 4: Set your data sharing options

  1. Select Platform-specific settings
  2. For each platform, select the following sharing options
  3. What sources of data do you want to share?
    1. 🔘 Data from all attribution sources
    2. 〇 Only data attributed to Tapjoy
  4. What will be shared by default?
    1. Installs
  5. What other data do you want to share?
    1. ☑️ Sessions
    2. ☑️ In-app revenue (from in-app purchases) You need to map events which generate revenue to share this data.
    3. ☑️ Parameters You usually need to map parameters to share this data.

image_title

  1. Link Structure → Create a link name.
  2. User destinations → Leave as-is and click Next.
  3. Attribution Settings → Leave as-is and click Next.
  4. Setup Review → Leave as-in and click Create Link.
  5. Automatically redirected to the click URL page.

Step 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


image_title

  1. Navigate to the Campaign Lab tab > Partner
  2. Search and Select Tapjoy.
  3. Click on the Data Sharing tab (as shown in the screenshot above).
  4. Select App.
  5. Scroll down to the Map Your Events section.
  6. Click + 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.

image_title

  1. Name → Enter the name of the SDK event.
  2. Engagement ID → Enter the unique Tapjoy {engagement_id} that is generated
  3. Click Apply.
  4. Repeat Steps #6 - #7 until all events are added.

IAP and Ad Revenue Configuration for ROAS

Adjust IAP Setup

In-App Revenue - Adjust Help Center

Mapped Events - Adjust Help Center

Step 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. Click Add event.
  6. Enter your in-app Event name.
    • Note: The setting "This is a unique event" does not apply to IAP events.
  7. Click the Add event button.

image_title

Step 2: Map your IAP events

Once 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. Click the +Map event button 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. Click Apply.
  5. Repeat Steps 1-4 above until all events are added.

Adjust Ad Revenue Setup

Step 1: Map your ad revenue events

  1. Click the +Map event button 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. Click Apply.
  5. Repeat Steps 1-4 above until all events are added.

image_title

Step 2: Enable Ad Revenue

  1. Under Campaign Lab, select Partners.
  2. Search for Tapjoy and click on the Tapjoy hyperlink in the search results under Channel.
  3. Click on 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.
  7. Click on the SAVE button.

image_title