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