User Privacy

Update SDK from 1.0.0-beta10 and below to 1.0.0-beta11

Beginning with SDK version 1.0.0-beta11, we've enhanced the user signal-gathering process for GDPR and COPPA compliance by consolidating them into a single API. This eliminates the necessity for multiple API calls and offers publishers a centralized solution for comprehensive consent management.

Make sure that you replace the old SDK with the new one.

Old SDK

let gdprConsent = [
  MesonConstant.MESON_GDPR_CONSENT_GDPR_APPLIES : "0", 
  MesonConstant.MESON_GDPR_CONSENT_AVAILABLE : "true", 
  MesonConstant.MESON_GDPR_CONSENT_IAB : "<IAB_GDPR_STRING>"
]
// Set GDPR consent to MesonSdkConfiguration
let config = MesonSdkConfiguration(appId: "appId", consent: gdprConsent) 

// CCPA 
private func setExtras() { 
    var extraData: [String: Any] = [:] // You can notify Meson that restricted data processing is enabled using either of the following parameters. 
    extraData["rdp"] = false 
    extraData["iab_usprivacy_string"] = "1YNN" 

    Meson.setExtras(extraData)          
}

NSDictionary *gdprConsent = @{MesonConstant.MESON_GDPR_CONSENT_GDPR_APPLIES: @"0", 
                                MesonConstant.MESON_GDPR_CONSENT_AVAILABLE: @"true", 
                                MesonConstant.MESON_GDPR_CONSENT_IAB: @"<IAB_GDPR_STRING>" }; 
// Set GDPR consent to MesonSdkConfiguration
MesonSdkConfiguration *config = [[MesonSdkConfiguration alloc] initWithAppId:@"appId" consent:gdprConsent];

//CCPA
- (void)setExtras { 
    NSMutableDictionary *extras = [[NSMutableDictionary alloc] init]; 
    // You can notify Meson that restricted data processing is enabled using either of the following parameters.  
    [extras setValue:false forKey:@"rdp"]; 
    [extras setValue:@"1YNN" forKey:@"iab_usprivacy_string"]; 

    [Meson setExtras:extras]; 
}

New SDK

let consent: [String: Any] = [
    // GDPR - You should send the GDPR consent either in a simple format using MesonConstant.GDPR_CONSENT_AVAILABLE or in IAB format using MesonConstant.GDPR_CONSENT.
    MesonConstant.GDPR: 1,
    MesonConstant.GDPR_CONSENT: "<IAB_GDPR_STRING>",
    MesonConstant.GDPR_CONSENT_AVAILABLE: 1,
    // CCPA - You can notify Meson that restricted data processing in a simple format using MesonConstant.DO_NOT_SELLL or in IAB format using MesonConstant.US_PRIVACY.
    MesonConstant.US_PRIVACY: "<US_PRIVACY>",
    MesonConstant.DO_NOT_SELL: false
]

Meson.setConsent(consent)

NSDictionary *consent = @{
    // GDPR - You should send the GDPR consent either in a simple format using MesonConstant.GDPR_CONSENT_AVAILABLE or in IAB format using MesonConstant.GDPR_CONSENT.
    MesonConstant.GDPR: @1,
    MesonConstant.GDPR_CONSENT: @"<IAB_GDPR_STRING>",
    MesonConstant.GDPR_CONSENT_AVAILABLE: @1,
    
    // CCPA - You can notify Meson that restricted data processing in a simple format using MesonConstant.DO_NOT_SELLL or in IAB format using MesonConstant.US_PRIVACY.
    MesonConstant.US_PRIVACY: @"<US_PRIVACY>",
    MesonConstant.DO_NOT_SELL: @NO
};
[Meson setConsent:consent];

API

• In the aforementioned snippet, the API Meson.updateGDPRConsent(_ consent: [String: Any]?) has been substituted with the new API Meson.setConsent(_ consent: [String: Any]?).
• In versions beta10 and earlier, CCPA user signals were established using the setExtras API. In the updated SDK, this process is modified to utilize the aforementioned setConsent API for transmitting CCPA user signals. Ensure that you remove the outdated method of transmitting CCPA user signals.

Constants

In the above snippet, the old constants have been replaced with new constants, and the data type of a few values has been changed as follows:

Added APIs

• Meson.setConsent(_ consent: [String: Any]?)
• Meson.getConsent() -> [String: Any]?

GDPR

You can agree or deny the GDPR compliance at the account and app level. For more information about the setup at the account level, see Privacy & Compliance, and for the app level, see Select GDPR and COPPA settings.

If you opt to transmit user signals pertaining to GDPR, Meson SDK offers a solution to align with GDPR guidelines. With the help of setConsent API, you can conveniently employ the following keys to transmit the corresponding values, thus ensuring compliance with GDPR regulations.

CCPA

You can choose to restrict data processing at an App level. For more information, see Select GDPR and COPPA settings. If you transmit user signals concerning CCPA, Meson SDK facilitates compliance with the California Consumer Privacy Act (CCPA).

After configuring GDPR and COPPA settings, the final snippet will resemble the example provided below:

let consent: [String: Any] = [
    MesonConstant.GDPR: 1,
    MesonConstant.GDPR_CONSENT: "<IAB_GDPR_STRING>",
    MesonConstant.GDPR_CONSENT_AVAILABLE: 1,
    MesonConstant.US_PRIVACY: "<US_PRIVACY>",
    MesonConstant.DO_NOT_SELL: false
]

Meson.setConsent(consent)

NSDictionary *consent = @{
    MesonConstant.GDPR: @1,
    MesonConstant.GDPR_CONSENT: @"<IAB_GDPR_STRING>",
    MesonConstant.GDPR_CONSENT_AVAILABLE: @1,
    MesonConstant.US_PRIVACY: @"<US_PRIVACY>",
    MesonConstant.DO_NOT_SELL: @NO
};
[Meson setConsent:consent];

Retrieve Consent Signals

To access consent signals at any point in time, employ the following code snippet:

let consent = Meson.getConsent()

NSDictionary *consent = [Meson getConsent];