User Privacy - tapdaq/cordova-plugin GitHub Wiki
The Tapdaq SDK will forward these settings to each network which is initialised each time they are set (either at initialisation or mid session).
These values should be set when they are known, whether they are True or False, if left in their default Unknown state then each network will handle the user in their own way, therefore it is best to provide as much data as possible.
An AdMob content rating will be forwarded for every ad request to AdMob, to do this, set the value in the config either before Tapdaq has initialised or after like so:
//After Tapdaq initialises
Tapdaq.setAdMobContentRating("MA") //G PG T MA
Tapdaq.setAgeRestrictedUser(Tapdaq.Status.FALSE); //COPPA/GDPR flag
The tag_for_under_age_of_consent flag will be sent to AdMob if the user is subject to GDPR and AgeRestrictedUser is set. The ChildDirectedTreatment COPPA flag will be sent if user is not known to be subject to GDPR and AgeRestrictedUser is set. Read more about AdMob Targeting here.
We will pass the AgeRestrictedUser flag to the following networks:
-
AdColony:
- Passed when UserSubjectToGDPR is FALSE and AgeRestrictedUser is not UNKNOWN
-
AdMob:
- Passed when user is not subject to GDPR
-
AppLovin:
- Android: passed when UserSubjectToGDPR is not UNKNOWN
- iOS: always passed
-
Facebook Audience Network:
- Passed when UserSubjectToGDPR is false and AgeRestrictedUser not UNKNOWN
-
Tapjoy:
- Always passed
-
YouAppi:
- Android: passed when UserSubjectToGDPR is not UNKNOWN
- iOS: always passed
The AgeRestrictedUser flag can be used to help you comply with COPPA and other applicable age restrictions.
var config = {
isAgeRestrictedUser:Tapdaq.Status.TRUE
};
Tapdaq.init(config, opts);
Tapdaq.setAgeRestrictedUser(Tapdaq.Status.FALSE);
For users within California affected by California Consumer Privacy Act
When UserSubjectToUSPrivacy & USPrivacy states are both true networks will be forwarded a doNotSell flag.
var config = {
ios: {},
android: {}
userSubjectToUSPrivacy: Tapdaq.Status.FALSE,
usPrivacy: Tapdaq.Status.FALSE
};
// Setters
Tapdaq.setUserSubjectToUSPrivacy(Tapdaq.Status.TRUE);
Tapdaq.setUSPrivacy(Tapdaq.Status.TRUE);
// Getters
Tapdaq.userSubjectToUSPrivacyStatus(function (status) {
console.log("userSubjectToUSPrivacyStatus: " + status);
});
Tapdaq.usPrivacyStatus(function (status) {
console.log("usPrivacyStatus: " + status);
});
For AdColony & Tapjoy the adapter will send an IAB String in the following scenarios:
if UserSubjectToUSPrivacy == TRUE AND DoNotSell == TRUE
then "1NYN"
if UserSubjectToUSPrivacy == TRUE AND DoNotSell == FALSE
then "1NNN"
else "1---"
Flags are forwarded for the following networks: AdColony, AdMob, Chartboost, Facebook Audience Network, IronSource, Tapjoy & Vungle.
As of Tapdaq 4.3.1 (FAN 6.2.0), for iOS 14+ Facebook Audience Network require permission to serve personalized ads, to do this set the Advertiser Tracking flag to TRUE.
See Facebook Audience Network documentation for further details
var config = {
advertiserTracking:Tapdaq.Status.TRUE
};
Tapdaq.init(config, opts);
Tapdaq.setAdvertiserTracking(Tapdaq.Status.TRUE);
For users within the EU.
var config = {
userSubjectToGDPR:Tapdaq.Status.TRUE,
isConsentGiven:Tapdaq.Status.TRUE
};
Tapdaq.init(config, opts);
Consent can be updated mid session as well as at initialisation, it can be set and unset.
Tapdaq.setUserSubjectToGDPR(Tapdaq.Status.TRUE);
Tapdaq.setConsent(Tapdaq.Status.TRUE);
For all users, Tapdaq's GDPR settings must be set to something other than unknown before initialising for YouAppi to function. For users outside of the EU UserSubjectToGdpr should be set to false For users inside of the EU UserSubjectToGdpr should be set to true, also Consent should be provided for YouAppi to intialise. Note the consent MUST be obtained from the user.
If any other settings are provided, YouAppi will not be initialised and will not display ads.
Developers may set a UserId within Tapdaq, this will be used for Server-side Rewards and can optionally be forwarded to other networks. It should be set on initialisation and can be changed at any point during a session.
var config = {
userId:"Demo User",
forwardUserId:false
};
Tapdaq.init(config, opts);
Tapdaq.SetForwardUserId(true);
Tapdaq.setUserId("Cordova User");
ForwardUserId must be set to true before setting the UserId during a session in order to pass the UserId to networks
If you are having any problems integrating, feel free to contact us on [email protected] and we will be more than happy to help.