Learn about Singular's integration with Tapjoy and how to add Tapjoy as a partner for Singular's attribution service.
Integration Summary
(See Partner Integrations Glossary)
Partner | Tapjoy |
Partner Type | Ad Network |
Click Tag | Supported |
View-Through | Supported |
Re-engagement | Not Supported |
S2S | Not Supported |
Creatives | Supported |
Publisher | Supported |
Receiving All Installs | Supported |
Receiving All Events | Supported |
Prerequisites
- Integrate the Singular SDK (see instructions).
- Get your App ID from Tapjoy.
- To set up event postbacks, first talk with your POC about which App ID or Engagement ID you should use and map to the SDK event names.
Setup
See Partner Configuration for general instructions for setting up a partner.
For Tapjoy, you will also have to fill out the following special fields:
Field | Description |
Tapjoy App ID | ID provided by Tapjoy for each app. |
Tapjoy Event Parameters | Values provided by Tapjoy for each postback. (Instructions Below) |
Your Tapjoy POC should provide you with a segment of the postback query string which Tapjoy requires when receiving Event postbacks. Each string will be made up of the following values:
Field | Description | Required For | Field Name |
Tapjoy App ID or Engagement ID | The app_ID or engagement_ID retrieved from Tapjoy. | All events | app_id= |
Event Name | This should be the event name. | All events, for PPE | &event_name= |
Event Value | This should be the value. | All events, for PPE | &event_value= |
Example:
- Tapjoy App ID or Engagement ID = 11a2b333-4444-5ccc-6d77-8e99fffff1g2
- Event Name = purchase
- Event Value = cart_id
Tapjoy App ID Setup
This would need to be:
app_id=11a2b333-4444-5ccc-6d77-8e99fffff1g2
Tapjoy Event Parameters
- This would need to be:
app_id=11a2b333-4444-5ccc-6d77-8e99fffff1g2&event_name=purchase&event_value={EVTATTR:cart_id}
(Note: ensure & is not present at the beginning or end of the query).