Getting started with GDPR (display using WebView)🔗

// Initialize GDPR
MRGSGDPR.Instance.Setup("<PROJECT_ID>", "<PROJECT_SECRET>");

// Optional if you prefer listeners to callbacks.
MRGSGDPR.Instance.ShowDelegate = this;
// Default value: true
MRGSGDPR.Instance.OnlyEu = true;

// Extra params which you can use later to show agreement
MRGSGDPRShowParams showParams = new MRGSGDPRShowParams
{
    // Default value: false
    WithAdvertising = true,
    // Default value: Color.white
    BackgroundColor = Color.red,
    // Optional if you would like to use default localizations
    Localization = new MRGSGDPRLocalization("en")
    {
        Header = "Terms and Privacy",
        ContinueButton = "OK"
        // ...
        // Use more fields for localization
    }
};

MRGSGDPR.getInstance().Delegate = this;
MRGSGDPR.getInstance().withAdvertising(true); //Default false
MRGSGDPR.getInstance().SetBackgroundColor(255, 0, 0); // Default value is white color
MRGSGDPR.getInstance().onlyForEU(true);//Default true
MRGSGDPR.getInstance().setLocalizationLanguage("en"); //Default en (language identifier in ISO format)

// Initialize GDPR
[[MRGSGDPR sharedInstance] setupWithAppId:<PROJECT_ID> secret:@"<PROJECT_SECRET>"];

// Optional if you prefer listeners to callbacks.
[MRGSGDPR sharedInstance].showDelegate = self;
// Default value: true
[MRGSGDPR sharedInstance].onlyEU = true;

// Extra params which you can use later to show agreement
MRGSGDPRShowParams* showParams = [[MRGSGDPRShowParams alloc] init];
// Default value: false
showParams.withAdvertising = true;
// Default value: white
showParams.backgroundColor = [UIColor redColor];
// Optional if you would like to use default localizations
showParams.localization = [[MRGSGDPRLocalization alloc] initWithLanguage:@"fr"];

showParams.localization.header = @"Terms and Privacy";
showParams.localization.continueButton = @"OK";
// ...
// Use more fields for localization

MRGSGDPR* gdpr = [MRGSGDPR sharedInstance];
gdpr.delegate = self;
gdpr.withAdvertising = YES; //Default NO
gdpr.backgroundColorForWebView = [UIColor redColor]; //Default white color
gdpr.onlyEU = YES; //Default YES
gdpr.localizationLanguage = "en" //Default en (language identifier in ISO format)

import games.my.mrgs.gdpr.MRGSGDPR;
import games.my.mrgs.gdpr.MRGSGDPRLocalization;
import games.my.mrgs.gdpr.MRGSGDPRShowParams;

final MRGSGDPR gdpr = MRGSGDPR.getInstance();
// Initialize GDPR
gdpr.setup(Context, "<PROJECT_ID>", "<PROJECT_SECRET>");

// Optional if you prefer listeners to callbacks.
gdpr.setOnShowListener(this);
// Default value: true
gdpr.onlyEU(true);

// Extra params which you can use later to show agreement
final MRGSGDPRShowParams showParams = new MRGSGDPRShowParams();
// Default value: false
showParams.withAdvertising(true);
// Default value: white
showParams.setBackgroundColor(255, 0, 0);

// Optional if you would like to use default localizations
final MRGSGDPRLocalization localization = new MRGSGDPRLocalization.Builder()
        .setHeader("Terms and Privacy")
        .setContinueButton("OK")
        // ...
        // You can use other setters here.
        .build();
showParams.setLocalization(localization);

import games.my.mrgs.gdpr.MRGSGDPR;

final MRGSGDPR gdpr = MRGSGDPR.getInstance();
gdpr.setDelegate(this);
gdpr.onlyEU(true); //Default true
gdpr.setBackgroundColor(255, 0, 0); //Default white color
gdpr.withAdvertising(true); //Default false
gdpr.setLocalizationLanguage("en"); (language identifier in ISO format)

 // Show default agreement with default settings.
MRGSGDPR.Instance.ShowAgreement();

// Show default agreement with default settings and callback
MRGSGDPR.Instance.ShowAgreement(completion: (result, error) => {
    // Handle result here.
    // One of received params will be null.
});

// Show default agreement with extra settings to change behavior.
MRGSGDPR.Instance.ShowAgreement(param: showParams);

// Show default agreement with extra settings to change behavior and callback.
MRGSGDPR.Instance.ShowAgreement(param: showParams, (result, error) => {
    // Handle result here.
    // One of received params will be null.
});

 //Display standard agreement
MRGSGDPR.getInstance().showDefaultAgreement(APP_ID);

//Display your agreement from the HTML file
MRGSGDPR.getInstance().showAgreementFromFile(string appId, string filePath);

// Show default agreement with default settings.
[[MRGSGDPR sharedInstance] showAgreementAtViewController:self];

// Show default agreement with default settings and callback
[[MRGSGDPR sharedInstance] showAgreementAtViewController:self completionHandler:^(MRGSGDPRShowResult * _Nullable result, NSError * _Nullable error) {
    // Handle result here.
    // One of received params will be nil.
}];

// Show default agreement with extra settings to change behavior.
[[MRGSGDPR sharedInstance] showAgreementAtViewController:self params:showParams];

// Show default agreement with extra settings to change behavior and callback.
[[MRGSGDPR sharedInstance] showAgreementAtViewController:self 
                                                    params:showParams
                                        completionHandler:^(MRGSGDPRShowResult * _Nullable result, NSError * _Nullable error) {
    // Handle result here.
    // One of received params will be nil.
}];

MRGSGDPR* gdpr = [MRGSGDPR sharedInstance];
//Display standard agreement
[gdpr showDefaultAgreementAtViewController:self forAppId:APP_ID];

//Display your agreement from the HTML file
[gdpr showAgreementAtViewController:self forAppId:APP_ID fromFile:FILE_PATH];

import android.app.Activity;

import games.my.mrgs.gdpr.MRGSGDPR;
import games.my.mrgs.gdpr.MRGSGDPRLocalization;
import games.my.mrgs.gdpr.MRGSGDPRShowParams;

// Show default agreement with default settings.
MRGSGDPR.getInstance().showAgreement(Activity);

// Show default agreement with default settings and callback
MRGSGDPR.getInstance().showAgreement(Activity, (result, error) -> {
    // Handle result here.
    // One of received params will be null.
});

// Show default agreement with extra settings to change behavior.
MRGSGDPR.getInstance().showAgreement(Activity, showParams);

// Show default agreement with extra settings to change behavior and callback.
MRGSGDPR.getInstance().showAgreement(Activity, showParams, (result, error) -> {
    // Handle result here.
    // One of received params will be null.
});

import games.my.mrgs.gdpr.MRGSGDPR;

final MRGSGDPR gdpr = MRGSGDPR.getInstance();
//Display standard agreement
gdpr.showDefaultAgreementAtActivity(activity, APP_ID);

//Display your agreement from the HTML file
gdpr.showAgreementAtActivity(activity, APP_ID, filePath);

// Will be shown if user has never accepted any agreements before
showParams.InitialAgreementFile = "your_agreement.html";
// Will be shown if user has accepted agreements and there's a new agreement version 
// on MRGS server
showParams.AgreementUpdateFile = "your_agreement_update.html";
// Will be shown if user has accepted agreements and publisher was changed. 
showParams.PublisherUpdateFile = "your_publisher_update.html";

// Show default agreement with extra settings to change behavior.
MRGSGDPR.Instance.ShowAgreement(param: showParams);

// Show default agreement with extra settings to change behavior and callback.
MRGSGDPR.Instance.ShowAgreement(param: showParams, (result, error) => {
    // Handle result here.
    // One of received params will be null.
});

// Show your own agreement file
MRGSGDPR.getInstance().showAgreementFromFile(string appId, string filePath);

NSURL* bundleUrl = [[NSBundle mainBundle] bundleURL];
// Will be shown if user has never accepted any agreements before
showParams.initialAgreementFilePath =  [bundleUrl URLByAppendingPathComponent:@"your_agreement.html"];
// Will be shown if user has accepted agreements and there's a new agreement version
// on MRGS server
showParams.agreementUpdateFilePath = [bundleUrl URLByAppendingPathComponent:@"your_agreement_update.html"];
// Will be shown if user has accepted agreements and publisher was changed.
showParams.publisherUpdateFilePath =  [bundleUrl URLByAppendingPathComponent:@"your_publisher_update.html"];

// Show default agreement with extra settings to change behavior.
[[MRGSGDPR sharedInstance] showAgreementAtViewController:self params:showParams];

// Show default agreement with extra settings to change behavior and callback.
[[MRGSGDPR sharedInstance] showAgreementAtViewController:self
                                                    params:showParams
                                        completionHandler:^(MRGSGDPRShowResult * _Nullable result, NSError * _Nullable error) {
    // Handle result here.
    // One of received params will be nil.
}];

// Show your own agreement file
NSURL* fileURL = [[NSBundle mainBundle] URLForResource:@"mrgsgdpr_custom" withExtension:@"html"];
[gdpr showAgreementAtViewController:<VC> forAppId:<APP_ID> fromFile:fileURL];

import android.app.Activity;

import games.my.mrgs.gdpr.MRGSGDPR;
import games.my.mrgs.gdpr.MRGSGDPRLocalization;
import games.my.mrgs.gdpr.MRGSGDPRShowParams;

// Will be shown if user has never accepted any agreements before
showParams.setInitialAgreementFile("your_agreement.html");
// Will be shown if user has accepted agreements and there's a new agreement version 
// on MRGS server
showParams.setUpdateAgreementFile("your_agreement_update.html");
// Will be shown if user has accepted agreements and publisher was changed. 
showParams.setPublisherUpdateFile("your_publisher_update.html");

// Show default agreement with extra settings to change behavior.
MRGSGDPR.getInstance().showAgreement(Activity, showParams);

// Show default agreement with extra settings to change behavior and callback.
MRGSGDPR.getInstance().showAgreement(Activity, showParams, (result, error) -> {
    // Handle result here.
    // One of received params will be null.
});

import games.my.mrgs.gdpr.MRGSGDPR;

// Show your own agreement file
gdpr.showAgreementAtActivity(activity, APP_ID, filePath);

// Optional implementation of IOnShowDelegate
// If you prefer listeners to callback
public void OnAgreementAccepted(MRGSGDPRShowResult result)
{
    // User accepted agreement
    // Handle result here.
}

public void OnAgreementError(MRGSError error)
{
    // User rejected agreement or there were an unknown issue
    // Handle result here.
}

// Or you can use callback instead of IOnShowDelegate
MRGSGDPR.Instance.ShowAgreement(completion: (result, error) => {
    // Handle result here.
    // One of received params will be null.
    if (error != null) 
    {
         // User rejected agreement or there were an unknown issue
    }
    if (result != null) 
    {
        // User accepted agreement
    }
});

// Or using await:
var res = await MRGSGDPR.Instance.ShowAgreementAsync();

// Implementation of IShowDelegate
// Successful completion
void OnUserHasAcceptedGDPR(bool withAdvertising) {

}

// User rejected the offer
void OnGDPRError() {

}

// Optional implementation of MRGSGDPRShowDelegate
// If you prefer listeners to callback
- (void)didAcceptAgreement:(MRGSGDPRShowResult*)result {
    // User accepted agreement
    // Handle result here.
}

- (void)didReceiveAgreementError:(NSError*)error {
    // User rejected agreement or there were an unknown issue
    // Handle result here.
}

// Or you can use callback instead of IOnShowDelegate
[[MRGSGDPR sharedInstance] showAgreementAtViewController:self completionHandler:^(MRGSGDPRShowResult * _Nullable result, NSError * _Nullable error) {
    // Handle result here.
    // One of received params will be nil.
    if (error != nil) {
        // User rejected agreement or there were an unknown issue
    }
    if (result != nil) {
        // User accepted agreement
    }
}];

//Successful completion
- (void)userHasAcceptedGDPR:(MRGSGDPR*)gdpr withAdvertising:(BOOL)value {

}

//User rejected the offer
- (void)errorShowingAgreement:(MRGSGDPR*)gdpr {

}

// Optional implementation of MRGSGDPR.OnShowListener
// If you prefer listeners to callback
@Override
public void onAgreementAccepted(@NonNull MRGSGDRPShowResult result) {
    // User accepted agreement
    // Handle result here.
}

@Override
public void onAgreementError(@NonNull MRGSError error) {
    // User rejected agreement or there were an unknown issue
    // Handle result here.
}

// Or you can use callback instead of MRGSGDPR.OnShowListener
MRGSGDPR.getInstance().showAgreement(..., (result, error) -> {
    // Handle result here.
    // One of received params will be null.
    if (error != null) {
         // User rejected agreement or there were an unknown issue
    }
    if (result != null) {
        // User accepted agreement
    }
});

//Successful completion
@Override
public void userHasAcceptedGDPR(boolean withAdvertising) {

}

//User rejected the offer
@Override
public void errorShowingAgreement() {

}

var acceptedAgreement = MRGSGDPR.Instance.AcceptedAgreement;
if (acceptedAgreement == null)
{
    // User has never accepted any agreements yet.
}

var acceptedVersion = MRGSGDPR.getInstance().getAgreedVersion();
if (acceptedVersion == -1)
{
    // User has never accepted any agreements yet.
}

MRGSGDPRAcceptedAgreement* acceptedAgreement = [MRGSGDPR sharedInstance].acceptedAgreement;
if (acceptedAgreement == nil) {
    // User has never accepted any agreements yet.
}

int acceptedVersion = [[MRGSGDPR sharedInstance] getAgreedVersion];
if (acceptedVersion == -1) {
    // User has never accepted any agreements yet.
}

final MRGSGDPRAcceptedAgreement acceptedAgreement = MRGSGDPR.getInstance().getAcceptedAgreement(Context);
if (acceptedAgreement == null) {
    // User has never accepted any agreements yet.
}

final int acceptedVersion = MRGSGDPR.getInstance().getAcceptedAgreement(Context);
if (acceptedVersion == -1) {
    // User has never accepted any agreements yet.
}

void Awake () {
    MRGSGDPR.Instance.Setup("<PROJECT_ID>", "<PROJECT_SECRET>");

    // Optional if you prefer callbacks to listeners.
    // MRGSGDPR.Instance.ShowDelegate = this;
    MRGSGDPR.Instance.OnlyEu = true;

    MRGSGDPRShowParams showParams = new MRGSGDPRShowParams
    {
        WithAdvertising = true,
        BackgroundColor = Color.white,
        // Optional if you would like to use default localizations
        Localization = new MRGSGDPRLocalization("en")
        {
            Header = "Terms and Privacy",
            ContinueButton = "OK"
            // ...
            // Choose more field for localization
        }
    };

    MRGSGDPR.Instance.ShowAgreement(param: showParams, (result, error) => {
        // Handle result here.
        // One of received params will be null.
    });
}

void Awake () {
    MRGSGDPR.getInstance().Delegate = this;
    MRGSGDPR.getInstance().showDefaultAgreement(MRGS_APP_ID);
}

public void OnUserHasAcceptedGDPR(bool withAdvertising)
{
    // Start loading application/game
    // Initialize MRGS
    initMrgs();
}

public void OnGDPRError()
{
    // User declined the agreement. Close the application
    Application.Quit();
}

// Initialize GDPR
[[MRGSGDPR sharedInstance] setupWithAppId:<PROJECT_ID> secret:@"<PROJECT_SECRET>"];

// Optional if you prefer listeners to callbacks.
// [MRGSGDPR sharedInstance].showDelegate = self;
// Default value: true
[MRGSGDPR sharedInstance].onlyEU = true;

// Extra params which you can use later to show agreement
MRGSGDPRShowParams* showParams = [[MRGSGDPRShowParams alloc] init];
// Default value: false
showParams.withAdvertising = true;
// Default value: white
showParams.backgroundColor = [UIColor redColor];
// Optional if you would like to use default localizations
showParams.localization = [[MRGSGDPRLocalization alloc] initWithLanguage:@"fr"];

showParams.localization.header = @"Terms and Privacy";
showParams.localization.continueButton = @"OK";
// ...
// Use more fields for localization

[[MRGSGDPR sharedInstance] showAgreementAtViewController:self
                                                params:showParams
                                    completionHandler:^(MRGSGDPRShowResult * _Nullable result, NSError * _Nullable error) {
    // Handle result here.
    // One of received params will be nil.
}];

- (void)viewDidLoad {
    MRGSGDPR* gdpr = [MRGSGDPR sharedInstance];
    gdpr.delegate = self;
    UIViewController *rootController = [UIApplication sharedApplication].keyWindow.rootViewController;
    [gdpr showDefaultAgreementAtViewController:rootController forAppId:MRGS_APP_ID];
}

- (void)userHasAcceptedGDPR:(MRGSGDPR*)gdpr withAdvertising:(BOOL)flag {
    // Start loading application/game
    // Initialize MRGS
    [self initMRGS];
}

- (void)errorShowingAgreement:(MRGSGDPR*)gdpr {
    // User declined the agreement. Close the application
}

import android.app.Activity;

import androidx.annotation.NonNull;

import games.my.mrgs.MRGSError;
import games.my.mrgs.gdpr.MRGSGDPR;
import games.my.mrgs.gdpr.MRGSGDPRLocalization;
import games.my.mrgs.gdpr.MRGSGDPRShowParams;
import games.my.mrgs.gdpr.MRGSGDRPShowResult;

final MRGSGDPR gdpr = MRGSGDPR.getInstance();
gdpr.setup(Context, "<PROJECT_ID>", "<PROJECT_SECRET>");
// Optional if you prefer listeners to callbacks.
// gdpr.setOnShowListener(this);
gdpr.onlyEU(true);

final MRGSGDPRShowParams showParams = new MRGSGDPRShowParams();
showParams.withAdvertising(true);
showParams.setBackgroundColor(255, 0, 0);

// Optional if you would like to use default localizations
final MRGSGDPRLocalization localization = new MRGSGDPRLocalization.Builder()
        .setHeader("Terms and Privacy")
        .setContinueButton("OK")
        // ...
        // You can other setters here.
        .build();
showParams.setLocalization(localization);

// Show default agreement with extra settings to change behavior and callback.
MRGSGDPR.getInstance().showAgreement(Activity, showParams, (result, error) -> {
    // Handle result here.
    // One of received params will be null.
});

import games.my.mrgs.gdpr.MRGSGDPR;

public class MainActivity implements MRGSGDPR.MRGSGDPRDelegate {
    @Override
    public void onCreate(Bundle savedInstanceState) {
        final MRGSGDPR gdpr = MRGSGDPR.getInstance();
        gdpr.setDelegate(this);
        gdpr.showDefaultAgreementAtActivity(this, MRGS_APP_ID);
    }

    @Override
    public void userHasAcceptedGDPR(boolean withAdvertising) {
        // Start loading application/game
        // Initialize MRGS
        initMRGS();
    }

    @Override
    public void errorShowingAgreement() {
        // User declined the agreement. Close the application
        finish();
    }
}