Integration with Singular

Integrate Singular as your mobile measurement partner to share user engagement and campaign data with Tapjoy Offerwall.

Read time 2 minutes

Last updated 9 days ago

This guide provides instructions on setting up a new Offerwall campaign in the Singular dashboard. For additional guidance, refer to the Set-Up Guide for Tapjoy and General Instructions on how to set-up a Partner in the Singular documentation.

Tapjoy campaign configuration

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

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__
```
.

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

For more information, refer to In-app events in the Singular documentation.

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

For more information, refer to the Onboarding Guide for Ad Revenue Attribution in the Singular documentation.