What information is sent to Tapjoy?

If you are a Tapjoy user, you can find a more "plain English" explanation of what Tapjoy does and does not collect on our Privacy Policy page. The following information is intended for software engineers so they can understand how the Tapjoy SDK communicates to the Tapjoy Servers.

If you integrate the Tapjoy SDK into your app, the following information will be sent to Tapjoy when using Tapjoy SDK 12.9.0 (Updated Jan 2022).

Parameters passed in by the developer via the SDK (common on both iOS and Android)

app_id – Tapjoy internal identifier for partner app
publisher_user_id – Publisher’s user ID
user_level – the level of the user in this app/game, defined by Tapjoy SDK setUserLevel API
friend_count – the number of friends this user has (per Tapjoy SDK setUserFriendCount API)
uv1-uv5 – user’s custom cohort variables, defined by Tapjoy SDK setUserCohortVariable API
tags – user’s custom tags, defined by Tapjoy SDK setUserTags API
pushOptout – user’s preference, defined by Tapjoy SDK setPushNotificationDisabled API
events – Custom Event information for analytics

In App Purchase Parameters (these are only passed when when the developer uses the API to inform the SDK of in-app purchases made by the user)

purchase_currency – Currency used for in-app purchases
purchase_total_count – Total number of in-app purchases
purchase_total_price – Total price of all in-app purchases
purchase_last_price – Price of last in-app purchase
purchase_last_at – Timestamp of last in-app purchase

Parameters set via the SDK automatically

User Level Parameters (common on both iOS and Android)

country_code – Country code
language_code – Language setting
connection_type – Connection type (e.g., wifi)
connection_subtype – Connection subtype when on mobile (CDMA, etc.)

Mobile connections (common on both iOS and Android)

display_multiplier – Display multiplier (if developer wants to inflate currency values)
carrier_name – Carrier name (e.g., AT&T)
carrier_country_code – ISO country code for user’s cellular service provider
mobile_country_code – Mobile country code (MCC) for user’s cellular service provider
mobile_network_code – Mobile network code (MNC) for user’s cellular service provider
country_sim – The ISO country code equivalent for the SIM provider’s country code

Device-related (common on both iOS and Android)

device_type – Device type (mobile phone, tablet)
os_version – the device system version.
platform – Device platform (e.g., Android)
device_name – Device model (This is the model of the device, not the specific name the user gives their device i.e. iPhone6, GalaxyS9, SM-G975F, etc).
volume - Device volume
brightness - The current brightness of the device
theme - The current theme of the device ("light" / "dark")
avail_disk - The available diskspace in Megabytes
total_disk - The total diskspace in Megabytes

Analytics parameters (common on both iOS and Android)

analytics_id – Tapjoy internal identifier for analytics
session_total_count – Total number of sessions this user has had
session_total_length – Total time in minutes of all sessions
session_last_at – Timestamp of last session
session_last_length – Length of last session
fq7 – User visits frequency (last 7 days)
fq30 – User visits frequency (last 30 days)
pushes.received – Push messages received
pushes.clicked – Push messages clicked
analytics_api_key – the 5rocks analytics api key

Additional parameters (common on both iOS and Android)

ad_tracking_enabled – Whether "limit ad tracking" is enabled
adapter_version – Mediation adapter version (if app has mediated advertising)
mediation_agent – If this is a mediation adapter, who the mediation partner is
mediation_id – If this pub that uses a mediation ID, this is it
advertising_id – Device advertising identifier [IDFA (iOS) // Google Advertising ID (Android)] *IDFA is not collected on iOS 14.5+ unless permission is granted.
app_version – Partner app version number
store_view – Whether in-app store view is available
library_version – Tapjoy SDK version
library_revision – Tapjoy internal reference relating to SDK versioning (git sha of last commit of Tapjoy SDK)
bridge_version – Which version of Javascript library is used by this sdk
plugin – Which plugin is being used, if any (Unity, Phonegap, Air; if none, then native)
sdk_type – Tapjoy SDK type (events, for >9.1)
install_id – Tapjoy-specific app identifier
session_id – session id (generated globally unique id on app launch, resume, and between long periods of activity)
timestamp – Timestamp (in seconds) of when a connect call and each subsequent request occurs
verifier – Tapjoy-generated hash used to sign requests to prevent fraud
tjdebug – Indicates whether Tapjoy logging is turned on
event_preload – Indicates whether the Event being fired was preloaded
app_group_id – The internal Tapjoy group id that this app belongs to, based on publisher’s dashboard grouping (e.g., grouping together iOS + Android versions of their app)
managed_device_id – Internal Tapjoy identifier for the device. This is a Tapjoy identifier used to combine different signals from different versions of Tapjoy or vendor SDKs into single entity. The SDK does not create this but sends it to the server in calls if it was received from the server in different cases. This is not captured data from the device.
pkg_id – App’s platform app ID – bundleIdentifier (iOS) or package id (Android)
pkg_ver – App’s platform package version (CFBundleShortVersionString (iOS) or package version name (Android)) – from Android settings for that app; version tracking
pkg_rev – App’s platform ____ (CFBundleShortVersionString (iOS) or package version name (Android)) (another way for pub to track version)
display_d – Device screen density (in dpi)
display_w – Device display width
display_h – Device display height
timezone – Time zone
system_placement – Whether this particular event is generated by default system placements (~default events) or by pub-identified events
event_name – This is the event name that is being requested (publisher names them via Dashboard)
auction_id – If this request was part of a programmatic mediation auction, the id of that auction
auction_ext_data – If this request was part of a programmatic mediation auction, metadata associated with that auction
below_consent_age – User is below minimum age for online consent under applicable law (GDPR (13-16), COPPA (13), CCPA (16), etc.), defined by Tapjoy SDK TJPrivacyPolicy setBelowConsentAge API
us_privacy – privacy consent string value based on IAB framework, defined by Tapjoy SDK TJPrivacyPolicy setUSPrivacy API
gdpr – A true/false value for whether the user is located in a country/geo that is subject to GDPR (as determined by the publisher), defined by Tapjoy SDK TJPrivacyPolicy setSubjectToGDPR API
cgdpr – Consent value that can be "0″ (User has not provided consent), "1″ (User has provided consent), or a daisybit string as suggested in IAB’s Transparency and Consent Framework. If publisher sends a cgdpr value unaccompanied by "gdpr=true", then the Tapjoy server will infer whether User is in a country/geo subject to GDPR based on IP address, defined by Tapjoy SDK TJPrivacyPolicy setUserConsent API
omidpv - OMSDK version

Parameters and information not explicitly sent, but known to Tapjoy servers indirectly

IP Address – This is not an explicit parameter sent by the SDK, but Tapjoy’s servers get the device’s IP address as part of the communication between the device and Tapjoy’s servers.
user_agent – Mobile browser type, version, OS
List of device IDs to target/suppress for a specific ad campaign
Ads viewed
Ads clicked
Ad category (e.g. games)
Ad type (e.g. video)
Ad inventory location (e.g. offerwall)
Ad interactions (e.g., viewed to complete; clicked through to advertiser’s site)
Tapjoy-driven install history
Risk flag for rejected user (IDFA/GAAID), and (sometimes) the reason (e.g., blocklist on the TPAT side, unacceptable click-to-install time)
All installs across all networks (via MMP)
All opens across all networks (via MMP)

iOS Only Parameters

data_ver – Data version of the application, set by Tapjoy SDK setAppDataVersion API
store – App store this app is associated with
vendor_id - identifier for Vendors
atts - the app's AppTrackingTransparency status
pub_build_ver - the iOS version used to build the app
skadnhsh - used for SKAdNetwork
skadnetids - used for SKAdNetwork
kb_lang - The current language of the device keyboard.

Android Only Parameters

android_id – Device’s Android ID by publisher opt-in only. As of SDK 12.2.1, Tapjoy’s SDK no longer passes Android ID for advertising purposes, even if the Advertising ID is unavailable. If publishers wish to receive this ID, they must explicitly opt-in via an SDK call. See 12.2.1 Android release notes for more details.
mac_address – As of SDK 12.9.0 this option has been removed and it is no longer possible to collect the MAC address via the SDK. For SDK 12.2.1 - 12.8.1 Tapjoy’s SDK no longer passes the MAC address, even if the Advertising ID is unavailable. If publishers wish to receive this ID, they must explicitly opt-in via an SDK call and by adding the ACCESS_WIFI_STATE permission.
device_gps_version – Google Play Services version of device
device_manufacturer – The device’s manufacturer (e.g. samsung)
screen_density – device screen density in dpi
screen_layout_size – Dimensions of the device’s screen
store_name – Which app store is being used
packaged_gps_version – Google Play Services version of app
pkg_data_version – The data version of the application, set by the Tapjoy SDK’s setAppDataVersion API
pkg_sign – App’s package signature – validates the app
installer – Referrer and installer allow the pub to measure campaign effectiveness via parameters set on the pub’s Google Play Store account
referrer – Referrer and installer allow the pub to measure campaign effectiveness via parameters set on the pub’s Google Play Store account