Overview 

General 

Step 1: Updating your Terms of Service 

Step 2: Integrate Bright SDK in your application 

Prerequisites

Step 2.1: Add SDK files to your solution

Build-time dependencies

Run-time dependencies

Step 2.2: Add SDK initialization to your code

Step 2.3: Add opt-in/out settings option

Step 2.4: Update your application installer

Install

Uninstall

Update

Step 2.5: Add SDK service status notifications and recovery (optional)

Step 2.6: Customizing the consent screen

Step 3: Submit your integration 

Testing 

How to update SDK in your project 

Code Example 

API documentation 

brd_config.json:

.NET

Overview

You can integrate Bright SDK in 2 ways:

1. Using a full SDK implemented into your app.
2. Using Bright’s “Wrapper installer” which installs a standalone Bright SDK application. This is easier but usually gives lower conversion rates and revenue.

This guide is about the full implementation (#1). For #2, contact us for details.

General

This guide is for developers who want to monetize Windows applications with Bright SDK.

Integrating the Bright SDK into an application is the first step toward earning revenue. Once you've integrated the SDK, you will start seeing revenue in Bright SDK Dashboard in 24 hours.

This document will walk you through the steps needed to be taken in order to properly integrate Bright SDK into your application.

Step 1: Updating your Terms of Service

Bright Data works tirelessly to make sure users are fully aware of what it means to become a peer in Bright Data’s network. Please follow the terms of service additions that need to be done below.

• Add the following text to your Terms of Service Web page (such as: TOS, EULA, or Privacy Policy):

In return for some of the premium features of ‘[name of Partner Solution]’, you may choose to be a peer on the Bright Data network. By doing so you agree to have read and

accepted the Terms of Service of the Bright SDK EULA: https://bright-sdk.com/eula and Bright Data’s Privacy Policy https://bright-sdk.com/privacy-policy.

You may opt out of the Bright Data network by clicking [add clear description for how to opt-out].

• Add the following text to your Frequently Asked Questions Web page:

You will get <value: ads free version/free feature> in exchange for safely using some of your device’s resources, and only in a manner that will not substantially affect the device's operation (you can see exactly how on https://bright-sdk.com/users#learn-more-about-bright-sdk-web-indexing). You may turn this off from the settings menu. Please see our TOS [Link to TOS] and the SDK Privacy Policy at https://bright-sdk.com/privacy-policy for further information.

Please note: the text above must be added in full to your ToS, including the links. In case you wish to add any addition text that is related to Bright SDK, please share with us as part of the app review process.


 

Step 2: Integrate Bright SDK in your application

Prerequisites

Make sure you have the assigned APPID for this specific app from your SDK manager. It uniquely identifies your application and associates the peers, provided by your application, with you in the Bright Data network.

Step 2.1: Add SDK files to your solution

Download the latest Bright SDK from Bright SDK Dashboard or by clicking the link provided in the latest release email.

Once you unzip the SDK, the following contents are of interest:

Build-time dependencies

1. Copy the following files to any location inside your repository

• lum_sdk.dll
• lum_sdk.xml

2. Add them to your source control
3. Add reference from your main project to lum_sdk.dll 

• (Copy Local = true)

Run-time dependencies

1. Copy the following files to the root of your main project
   • net_updater32.exe
   • brd_config.json
2. Add them to your source control
3. Add them to your project as Content
   • Set them to be copied to the output folder

Step 2.2: Add SDK initialization to your code

1. Instantiate BrightData.Api
2. Initialize it during your application’s startup initialization
   • Set required fields now and you can customize the consent screen later.

3. Write your handler code for the user choice changed event
   • for example, enable/disable ads or premium features
4. Close the SDK when your application is exiting

Step 2.3: Add opt-in/out settings option

⚠️ Read and implement this section carefully. The user must always be able to opt-out of Bright SDK after giving their initial consent. 

Your app will usually first show the consent screen to the user on first run (or after a short “trial” period), the user will make a choice and SDK will act according to that choice.

Regardless of the user’s choice you must add an option for the user to opt-in/out of using SDK at any time. The user must always be able to opt-out of Bright SDK after giving their initial consent. 

This means that you must add an opt-out option in your app - this is usually placed in the settings menu

1. Add a switch with the label “Web Indexing”. The switch should clearly reflect the current status (is the user opted-in or not?).
2. Below “Web Indexing” add your own text to emphasize the value users get when opting in.
3. Include a way to give more information to the user (“Learn more”). The hyperlink should open a browser window with the following URL: https://bright-sdk.com/users#learn-more-about-bright-sdk-web-indexing.
4. In general, you are free to choose the UX (radio button, switch, etc) but the opt-out option must be clearly labeled so users can freely opt-out.
5. FYI: You are free to add a pop up / confirmation dialog box to discourage the user from opting out (for example: “if you disable Web Indexing, you will start seeing ads. Do you want to see ads?”). You are responsible for the text and design for this implementation and it will be reviewed before publishing.

See the examples below, illustrating both opted-in and opted-out scenarios:

Some ideas for value text:

• Refrain from using the technical term “opt in” / “opt out”. We always prefer speaking value to users.

Add a checkbox/toggle button to your app menu/settings window, following these guidelines:

• Should be checked if BrightData.Api.ConsentChoice  is true
• Unchecking it should call BrightData.Api.OptOut()
• Checking it should call BrightData.Api.ShowConsent()

FYI: You are free to add a pop up / confirmation dialog box to discourage the user from opting out (for example: “if you disable Web Indexing, you will start seeing ads. Do you want to see ads?”), as well as a confirmation message that shows after opting out (for example: “You have successfully disabled Web Indexing. !you may enable it again anytime from settings menu”)

You are responsible for the text and design for this implementation and it will be reviewed before publishing. Please refrain from using the technical term “opt in” / “opt out” here as well. 

Examples for common mistakes with opt-out settings screens:

Web Indexing Switch

Example	Comments
	The label should be Web Indexing, and not Bright/Bright SDK. Missing text to emphasize the value users get when opting in. The switch should clearly reflect the current status (is the user opted-in or not?).
	Missing text to emphasize the value users get when opting in.
	Missing “Learn more”, which opens a browser window with the following URL: https://bright-sdk.com/users#learn-more-about-bright-sdk-web-indexing. Missing text to emphasize the value users get when opting in.

Opt-Out Messages (Optional but highly recommended)

Example	Comments
	Correct messaging, correct default choice
	Dialog box to validate the user’s choice, reminding them how to opt back in.

Step 2.4: Update your application installer

Install

1. Add the following text to your installation wizard under “License agreement” part:

2. Add step to deploy lum_sdk.dll, net_updater32.exe and brd_config.json to your install directory
3. Add step to execute Bright Data service installer during your app installation (recommended, optional)

• Process to start: net_updater32.exe --install-ui APPID.
  It will show the consent screen and if agreed, install the service

• Wait for the process to finish before proceeding

Uninstall

Add the following to your application’s uninstall script:

1. Make sure no process uses lum_sdk.dll (terminate your application)
2. Uninstall Bright Data service and remove all Bright SDK files by executing net_updater32.exe --uninstall APPID
3. Wait for uninstall to finish before proceeding

Update

Add the following to your application’s update script:

1. Stop your application (which is using lum_sdk.dll)
2. Stop Bright Data service luminati_net_updater_APPID where APPID is your assigned APPID with `.` (dot) replaced with ‘_’ (underscore) (e.g.. win_abc.myapp.com -> luminati_net_updater_win_abc_myapp_com)
3. Deploy new net_updater32.exe, lum_sdk.dll and brd_config.json
4. You should

• Either install new net_updater: net_updater32.exe --install-ui APPID

• Or restart service if it exists

Step 2.5: Add SDK service status notifications and recovery (optional)

Notifications

You can register your app for notifications about the status of the SDK service, this will allow you to know if the SDK is in a valid usable state, you can also prevent the user from receiving the benefit until they restore the SDK service status to working condition.

Add delegate for the BrightData.Api.ServiceStatusChanged event, the handler for the event is an EventHandler that receives the BrightData.Api.ServiceStatusChangedEventArgs as event data.

See ServiceStatus enum for more information on the different status.

Recovery

If the ServiceStatus is in the NotInstalled, Installed or NotRunning status you can use the FixServiceStatus api to trigger automatic recovery, you can also have this api trigger on user action (e.g. "Click here to fix Bright Data SDK and regain benefit")

Step 2.6: Customizing the consent screen

Subject to Bright SDK approval, you can create and use your own consent screen with Bright SDK. Please follow the following guidelines.

1. Your screen must include the mandatory text below (marked in red), as well as links to our terms and privacy policies.
2. If you wish to translate your screen into other languages, please find the most common ones here. If there is a language you miss here, contact your partnership manager and ask for it. Make sure you only use these translations precisely, without additions or omissions.

This is what it looks like on the default Bright SDK screen: 

Mandatory text: “To [Benefit to user], please allow Web Indexing by Bright Data to use your device's free resources and IP address to download public web data from the Internet. Bright Data values your trust and takes every measure possible to protect your privacy and personal data. Bright Data understands the security matters at stake in sharing your IP address and monitors all of its network traffic to ensure your safety. Bright Data will only use your IP address for approved business-related use cases and never for unauthorized cases. None of your personal information is accessed or collected except your IP address."

"Learn more about web indexing by Bright Data
Learn more about Bright Data’s Privacy Policy
Bright Data runs in the background even after closing the application.
Updates will be automatically downloaded by your device from time to time and will be subject to the EULA (End User Level Agreement)"

- The link to "Bright Data” leads to "https://brightdata.com/"

- The link to "learn more" leads to "https://bright-sdk.com/users#learn-more-about-bright-sdk-web-indexing"

- The link to "Privacy Policy” leads to "https://bright-sdk.com/privacy-policy"

- The link to "End User License Agreement" leads to "https://bright-sdk.com/eula"

- Clicking on "will only use" -> opens a popup with the following info:

"Your IP address WILL be used for cases such as:

Support academic research
Help brands track sites selling fake products
Collect public web data like product prices and reviews
Aggregate travel information like flights and hotel prices "

 - Clicking on "never" ->opens a popup with the following info:

"Your IP address will NEVER be misused:

Never to steal, encrypt, or delete sensitive data
Never to alter or hijack core computing functions
Never to monitor users' computer activity
Never to access illegal sites (dark web, porn, etc.)
Never to perform DDOS attacks "

Integration code

- You should pass `SkipConsent = true` in SDK's initialization method to prevent showing the default consent screen.

- The opt-in button (e.g. "I Agree”) should call `ExternalOptIn()` method.

- The opt-out button (e.g. "I Disagree”) should call `OptOut()` method.

In case you show your custom consent dialog you also should call the `NotifyShowConsent()` method.

See below some examples of a possible custom consent screens:

Please contact Bright SDK before implementing in order to get pre-approved.

Step 3: Submit your integration

• Important: Bright SDK compliance team will verify the UX and functionality of the SDK integration, including consent screen, opt-out, value added to user, etc. Please do some internal QA prior to submitting the app for review.
• When you are ready to submit the app, the first step is running a self-check, which takes a few minutes and can save you precious time by identifying implementation issues. Details here.
• Submit the app for review by uploading the package (zip/exe format) through the Bright SDK Dashboard :click the relevant appID and “Submit for Review” button.
• As part of the submission process you will go through our checklist questions, to help you validate your app compliance to some of our main guidelines. Paying attention to this checklist, as well as to our quality standards will lead to faster approval.
• We also welcome you to watch our guided tour video prior to submission. It highlights critical elements to pay attention to, ensuring a faster review process and transparent communication with your users.
• Please note that we will review each app up to 3 times. 3 review rejections, or failure to meet our minimum quality standards may lead to a final rejection of your app.

Testing

You may set BrightData.Api.Settings.TestMode = true while developing. This way BrightData service will not be installed when you accept the consent screen, making it easier to develop.

While testing, you can remove Bright Data service by opting out through your application settings.Then removing the luminati folder (or simply deleting your entire output folder) will reset your previous consent choice and the consent screen will be displayed next time you run the application.

Or you can execute net_updater32.exe --uninstall APPID in your output folder, which will delete all SDK files as well.

How to update SDK in your project

Download the latest SDK from our website and follow these simple steps:

• replace net_updater(32|64).exe, lum_sdk(32|64).dll and lum_sdk.dll with a newer version
• clean and rebuild your project

Code Example

public partial class ExampleAppMainForm : Form

{

  private BrightData.Api _brightSdk = new BrightData.Api();

w

      BrightData.Api.ConsentChoiceChangedEventArgs e)

  {

    if (choice == true)

    {

      // user agreed to Bright Data consent

      // you can disable ads here, for example

    }

    else

    {

      // user disagreed to the consent or opted out

      // you can enable ads here, for example

    }

  }

  private void BrightSdk_ServiceStatusChanged(object sender,

      BrightData.Api.ServiceStatusChangedEventArgs e)

  {

    if (!_brightSdk.ConsentChoice)

      return;

    if (e.Status==BrightData.Api.ServiceStatus.NotInstalled)

    {

      // optional: notify user about SDK service not installed and offer to recover

      // optional: automatically try and recover (might cause bad UX)

      if (userWantsToRecover || autoRecoverIsEnabled)

        _brightSdk.FixServiceStatus();

    }

    else if (e.Status==BrightData.Api.ServiceStatus.Installed ||

      e.Status==BrightData.Api.ServiceStatus.NotRunning)

    {

      // optional: notify user about SDK service not running and offer to recover

      // optional: automatically try and recover (might cause bad UX)

      if (userWantsToRecover || autoRecoverIsEnabled)

        _brightSdk.FixServiceStatus();

    }

  }

  protected override void OnFormClosing(FormClosingEventArgs e) {

      _brightSdk.Close();

      base.OnFormClosing(e);

  }

  private void SettingsToolStripMenuItem_Click(object sender, EventArgs e)

  {

    new SettingsForm(_brightSdk).ShowDialog();

  }

}

public partial class SettingsForm : Form

{

  private readonly BrightData.Api _brightSdk;

  public SettingsForm(BrightData.Api brightSdk)

  {

    InitializeComponent();

    _brightSdk = brightSdk;

    _brightSdk.ConsentChoiceChanged += BrightSdk_ConsentChoiceChanged;

    _chkBrightData.AutoCheck = false;

    _chkBrightData.Checked = _brightSdk.ConsentChoice ?? false;

    _chkBrightData.Click += ChkBrightData_Click;

  }

  protected override void OnClosing(CancelEventArgs e)

  {

    // make sure to avoid event handler leak

    _brightSdk.ConsentChoiceChanged -= BrightSdk_ConsentChoiceChanged;

    base.OnClosing(e);

  }

  private void ChkBrightData_Click(object sender, EventArgs e)

  {

    if (_brightSdk.ConsentChoice == true)

      _brightSdk.OptOut();

    else

      _brightSdk.ShowConsent();

  }

  private void BrightSdk_ConsentChoiceChanged(object sender,

    BrightData.Api.ConsentChoiceChangedEventArgs e)

  {

    _chkBrightData.Checked = e.Choice ?? false;

  }

}

API documentation