Integration with Singular

This guide provides instructions on setting up a new Offerwall campaign in the Singular dashboard.

Additional guidance can be found in the Singular Set-Up Guide for Tapjoy and General Instructions on how to set-up a Partner.

Tapjoy Campaign Configuration

  1. Log in to the Singular dashboard.
  2. Click on Attribution > Partner Configuration on the left hand side.
  3. Search for Tapjoy in the filter box.
  4. Click + Add App Site.
  5. In the dropdown, select the App you want to configure. NOTE: Each app is configured separately.
  6. Input the Tapjoy generated ID under the Tapjoy App ID field.
  7. Under Attribution Postback, check the 'Install' Attribution Event.
  8. To the right, check Send All.
  9. Click Next to continue to add your revenue events as described in the IAP and Ad Revenue Configuration section below.

image_title

IAP and Ad Revenue Configuration for ROAS

Singular IAP Setup


⚠️ NOTE

  • If you are sending both IAP and Ad Revenue data to Tapjoy, we recommend against using the general __ REVENUE__ event name to capture both IAP and Ad Revenue data.
  • This is because the __ REVENUE__ event includes both purchases and ad revenue events, so mapping both types of revenue to the same Tapjoy Engagement ID may cause issues.
  • Instead, we recommend mapping IAP and ad revenue separately. For example, mapping IAP events with __ IAP__, and mapping ad revenue events with __ ADMON_USER_LEVEL_REVENUE__.

  1. Under the In app Event Postback section, add your IAP event. We recommend using the event name __ IAP__.
  2. Add the corresponding Tapjoy Engagement ID in the Tapjoy App ID or Engagement ID column.
  3. Check Send All.
  4. Check the Include Revenue box.
  5. Once all events are added and IDs are mapped, click Save.

See Singular’s in-app events documentation for more details.

image_title

Singular Ad Revenue Setup

  1. Under the In app Event Postback section, add the ad revenue event using the event name __ ADMON_USER_LEVEL_REVENUE__.
  2. Add the corresponding Tapjoy Engagement ID in the Tapjoy App ID or Engagement ID column.
  3. Check Send All.
  4. Check the Include Revenue box.
  5. Once all events are added and IDs are mapped, click Save.

See Singular's Onboarding Guide for Ad Revenue Attribution for more information.