> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bright-sdk.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hola VPN Bundle Integration Guide

> This guide is for developers and app owners who want to monetize their applications by offering Bright Data (in this integration guide example: Hola VPN on Windows or Mac operating system) as an additional offer within their app platforms.

Integrating [Hola VPN](https://hola.org/) is the first step toward earning revenue. Once you've released your app with Hola VPN you can start earning per install!

This document provides a step-by-step walkthrough for seamlessly incorporating Bright Data products into your application.

Implementation is simple - there are 3 steps:

1. Register your app in the dashboard.
2. Integrate Hola VPN bundle.
3. Final review.

<Info>
  **Bright Data must review your application before you start distributing your app with a bundle offer.**
</Info>

### Important Notes

* Users must **ALWAYS** decide if they want to **VOLUNTARILY** install Hola VPN after seeing the offer and consent screen. Additionally, users should **ALWAYS** have a straightforward means to opt out of the installation process.
* Take care when implementing the offer screen and the opt-out mechanisms in a way which follows guidelines in this document.
* Follow consent screen implementation guidelines in order to return true value from user interaction. **DO NOT install anything on users' devices if they have not opted-in.**
* Bright Data products do not do any user tracking of any kind. You can read more about Hola VPN and privacy in the [Privacy Policy](https://hola.org/legal/privacy).
* It's important to follow the guidelines in this document to avoid violation of our company's policy which may lead to termination of agreement.

<Steps>
  <Step title="Register Your App in the Dashboard" titleSize="h3">
    1. Go to [Monetized Bundles](https://bright-sdk.com/cp/bundles) → Click on the **(+) Add Bundle** button (top of the page).
    2. In the Bundle Creation popup: Choose the **Product** you would like to promote, the **Operating System** your app is offered in, and the **Offer Type** from the dropdown menu (description of each is available under the offer type box).
    3. Under "URL" enter the current download link of your app for our team to review.
    4. Click **"Create"** button.

    <img src="https://mintcdn.com/brightdata-31a14106/5LBFU4CHN9Xl8VaV/snippets/image/bundles_register_app.png?fit=max&auto=format&n=5LBFU4CHN9Xl8VaV&q=85&s=6bbf0d6a616d1b07bcef830e56881d6f" alt="Alt text" width="400" data-path="snippets/image/bundles_register_app.png" />

    <Note>
      As part of our service to select partners, we include them in the respected [AppEsteem certification program](https://customer.appesteem.com/certified?vendor=BDATA), recognized by major AV vendors. Once implementation is confirmed and installs look good, we'll notify you to begin.
    </Note>

    The process involves app review, addressing any violations, and finally, code signing with a new certificate (handled by the app developer).

    <Check>
      Bright SDK covers the entire certification process and maintenance - at no cost to you!
    </Check>
  </Step>

  <Step title="Choose Your Offer Type" titleSize="h3">
    #### Scenario 1 – Installation Wizard Offer

    Offer your users the benefits of Hola VPN by adding a screen to your install wizard.

    * Promotional offer is shown within product installation wizard (start with offer screen setup and then implement exe file).

    <Note>
      Make sure Hola VPN offer screen does not interrupt the user's expected flow. Ideally it should show AFTER your install wizard process is complete. Otherwise, you need to have the user's permission to view optional offers before showing it.
    </Note>

    * User clicks **Agree.**
    * exe file downloads in the background.
    * Hola VPN setup is launched only after your app installation is complete and presents the Bright SDK consent screen.

    <Tip>
      For offer screen setup and technical integration, continue to [**Set Up Your Offer Screen**](#set-up-your-offer-screen) and [**Technical Integration**](#technical-integration).
    </Tip>

    #### Scenario 2 – Uninstall Webpage Offer

    Earn revenue from users who choose to uninstall your product by presenting a Hola VPN install offer on your product's uninstall page.

    <img src="https://mintcdn.com/brightdata-31a14106/rKXt-nAzRJvAfdSm/integration-guides/image/holavpn_integration_1.png?fit=max&auto=format&n=rKXt-nAzRJvAfdSm&q=85&s=46bc81bcb94582a7bc9a57fe989ae051" alt="Alt text" width="400" data-path="integration-guides/image/holavpn_integration_1.png" />

    * User uninstalls your app and is redirected to an uninstall page on your website.
    * A short message alongside an offer banner is shown. Get your dedicated custom link under "**Bundle Details**" on your dashboard app page and implement it onto CTA. Contact [support@hola.org](mailto:support@hola.org) for further assistance.
    * exe file downloads → Hola VPN is installed.
    * Hola VPN is launched and presents Bright SDK consent screen.

    **Implementation instructions:**

    * Go to [**Monetized Bundles**](https://bright-sdk.com/cp/bundles) → **Add Bundle** → Choose "**Uninstall Page Offer**" → Press "**Create**".
    * In "**Bundle Details**", confirm Offer Type shows "**Uninstall Page Offer**" → copy download URL to implement onto your CTA.
          <img src="https://mintcdn.com/brightdata-31a14106/rKXt-nAzRJvAfdSm/integration-guides/image/holavpn_integration_2.png?fit=max&auto=format&n=rKXt-nAzRJvAfdSm&q=85&s=ee7cb967585a382c872594a1718cb263" alt="Alt text" width="400" data-path="integration-guides/image/holavpn_integration_2.png" />

    #### Scenario 3 – Successful Install Page

    Earn revenue from users who successfully installed your product by presenting a Hola VPN install offer on your product's successful installation page.

    * Once your app is fully installed - direct your user to a welcome/successful install page on your website.
    * A short message alongside an offer banner is shown. Get your dedicated custom link under "**Bundle Details**" on your dashboard app page and implement it onto CTA. Contact [support@hola.org](mailto:support@hola.org) for further assistance.
    * exe file downloads → Hola VPN is installed.
    * Hola VPN is launched and presents Bright SDK consent screen.

    **Implementation instructions:**

    * Go to [**Monetized Bundles**](https://bright-sdk.com/cp/bundles) → **Add Bundle** → Choose "**Successful Installation Page Offer**" → Press "**Create**".
    * In "**Bundle Details**", confirm Offer Type shows "**Successful Installation Page Offer**" → copy download URL to implement onto your CTA.
          <img src="https://mintcdn.com/brightdata-31a14106/rKXt-nAzRJvAfdSm/integration-guides/image/holavpn_integration_3.png?fit=max&auto=format&n=rKXt-nAzRJvAfdSm&q=85&s=28acb8d0b2b99be2d19e96b9ab1368cf" alt="Alt text" width="400" data-path="integration-guides/image/holavpn_integration_3.png" />

    #### Scenario 4 – Ad Campaign

    Create an ad campaign offering to install Hola VPN - get paid for every install you bring!

    * Once your app is fully installed - direct your user to a welcome/successful install page.
    * A short message alongside an offer banner is shown. Get your dedicated custom link under "**Bundle Details**" on your dashboard app page and implement it onto CTA. Contact [support@hola.org](mailto:support@hola.org) for further assistance.
    * exe file downloads → Hola VPN is installed.
    * Hola VPN is launched and presents Bright SDK consent screen.

    **Implementation instructions:**

    * Go to [**Monetized Bundles**](https://bright-sdk.com/cp/bundles) → **Add Bundle** → Choose "**Ad Campaign**" → Press "**Create**".
    * In "**Bundle Details**", confirm Offer Type shows "**AdCampaign**" → copy download URL to implement onto your campaign.
          <img src="https://mintcdn.com/brightdata-31a14106/rKXt-nAzRJvAfdSm/integration-guides/image/holavpn_integration_4.png?fit=max&auto=format&n=rKXt-nAzRJvAfdSm&q=85&s=f67b37eda6c440939df1196bf4040744" alt="Alt text" width="400" data-path="integration-guides/image/holavpn_integration_4.png" />

    #### Scenario 5 – In-App Offer

    Present a Hola VPN install (banner/popup, etc.) within your app.

    * An offer is presented within the app screen.
    * User clicks offer.
    * exe file downloads → Hola VPN is installed.
    * Hola VPN is launched and presents Bright SDK consent screen.

    <Warning>
      **Important!** Four principles to keep in mind when presenting in-app offers:

      1. **No means no:** If the user has already explicitly declined an offer in the app or during its install, the app can't show it again.
      2. **Uninterrupted experience:** The app can't present offers in the middle of any tasks the user has initiated (i.e. starting/stopping the app). You may present offers when the app is idle, or after the app completes a task and the user knows it's complete.
      3. **User is in control:** There needs to be a way in the settings to disable the offers.
      4. **Display:** To avoid detection as Adware by AVs - show offers within the app, not as separate pop-ups.
    </Warning>

    **Implementation instructions:**

    * Go to [**Monetized Bundles**](https://bright-sdk.com/cp/bundles) → **Add Bundle** → Choose "**In-App Offer**" → Press "**Create**".
    * In "**Bundle Details**", confirm Offer Type shows "**In-App Offer**" → copy download URL to implement onto your offer.
          <img src="https://mintcdn.com/brightdata-31a14106/rKXt-nAzRJvAfdSm/integration-guides/image/holavpn_integration_5.png?fit=max&auto=format&n=rKXt-nAzRJvAfdSm&q=85&s=59e1c0f6f6643fd2f2ccbcab63285fa8" alt="Alt text" width="400" data-path="integration-guides/image/holavpn_integration_5.png" />

    #### Scenario 6 – Preinstalled App

    Install Hola VPN on products you distribute (refurbished products, device manufacturers, OEM, etc.).

    * Download the following file: [https://cdn4.hola.org/static/Hola-Setup-Standalone-x64-Latest.exe](https://cdn4.hola.org/static/Hola-Setup-Standalone-x64-Latest.exe)
    * Proceed with one of the following options:

    **Option A - Install manually on each device**

    * Run the installer with the following flags via Windows CMD:
      ```bash theme={null}
      Hola-Setup-Standalone-x64-[version_number].exe --silent --no-run-uis --no-run-svc --affiliate [your_affiliate_id]
      ```
          <Note>
            Affiliate ID value can be found in your bundles page — each bundle configuration has a unique ID value.
          </Note>

    **Option B - Windows image deployment**

    * Open a Windows image in image audit mode.
    * Run the installer with the same flags as Option A via Windows CMD.
    * Place a shortcut to the Hola app in the **Windows Startup folder** so it launches on startup.
    * Install the same image on different devices.

    <Warning>
      In this scenario it is crucial that you do not launch the app after installing it. The end-user should be the one to launch the app for the first time.
    </Warning>

    <Note>
      For the preinstalled app scenario, you can disregard all other instructions that come after this section.
    </Note>
  </Step>

  <Step title="Set Up Your Offer Screen" titleSize="h3">
    <Warning>
      **Important!** Please follow the guidelines below to assure compliance with our policies. If you violate the guidelines, Bright Data reserves the right to terminate your account.
    </Warning>

    <Warning>
      Hola VPN launch will happen only **AFTER** your install wizard process is complete.
    </Warning>

    **Optional:** You may design the opt-in any way you choose (we recommend the design to be as close as possible to your installation wizard). However, the Hola VPN offer screen must always include an opt-in consent screen with the mandatory text below.

    <img src="https://mintcdn.com/brightdata-31a14106/rKXt-nAzRJvAfdSm/integration-guides/image/holavpn_integration_6.png?fit=max&auto=format&n=rKXt-nAzRJvAfdSm&q=85&s=3caf6f65af5156229d6aff07a82f3406" alt="Alt text" width="400" data-path="integration-guides/image/holavpn_integration_6.png" />

    * You may implement the [Hola VPN offer screen](https://drive.google.com/file/d/1UcIGX9I04Ss0U31kFKlP3EGUoGkjIyHv/view) onto your wizard (make sure to include all the links provided below).
    * Available [with buttons](https://drive.google.com/file/d/1k-WBbNTCMmyWu9UGwC95acUtD09bu4iv/view) or [without buttons](https://drive.google.com/file/d/1u891EyM9yPD0XzBsfRchaUuuYjuXLziV/view) (so you can use the ones in your Wizard) - make sure buttons return true value from user interaction.
    * In case you want to design your own Hola VPN offer, please read below.
    * In the [**Assets**](https://hola.org/static/press_kit/press_kit.zip) section you may find all the imagery needed.

    <img src="https://mintcdn.com/brightdata-31a14106/rKXt-nAzRJvAfdSm/integration-guides/image/holavpn_integration_7.png?fit=max&auto=format&n=rKXt-nAzRJvAfdSm&q=85&s=6b8cbdf482c01b1ac838582321a8ecbf" alt="Alt text" width="400" data-path="integration-guides/image/holavpn_integration_7.png" />

    1. **Mandatory Text**
       Optional offer by <a href="https://holavpn.com/"><img src="https://mintcdn.com/brightdata-31a14106/rKXt-nAzRJvAfdSm/integration-guides/image/holavpn_integration_8.png?fit=max&auto=format&n=rKXt-nAzRJvAfdSm&q=85&s=458f6b01fec5f216aa7e209864839e05" alt="Hola" noZoom style={{height: "1em", width: "auto", display: "inline"}} width="212" height="80" data-path="integration-guides/image/holavpn_integration_8.png" /></a>
       **Access worldwide content with Hola VPN!**
       **Install Hola VPN to enjoy:**
       * Unrestricted access to the content you like.
       * +190 locations available 24/7.
       * Ultra-fast and stable connection.
         **Hola VPN provides you with free VPN** in return for allowing Bright SDK to occasionally use your device's free resources and IP address. When you click "Accept", you agree to install "Hola VPN" and consent to its [Privacy Policy](https://hola.org/legal/privacy) and [EULA](https://hola.org/legal/sla).
    2. **Buttons**
       "Decline" / "Accept"
           <Warning>
             Make sure buttons return true value from user interaction ("Decline" = opt-out / "Accept" = opt-in). **DO NOT install anything on users' devices if they have not opted-in.**
           </Warning>
    3. **Required Links**
       | Text           | URL                                                              |
       | -------------- | ---------------------------------------------------------------- |
       | Hola VPN       | [https://holavpn.com/](https://holavpn.com/)                     |
       | EULA           | [https://hola.org/legal/sla](https://hola.org/legal/sla)         |
       | Privacy Policy | [https://hola.org/legal/privacy](https://hola.org/legal/privacy) |
       | Bright Data    | [http://brightdata.com](http://brightdata.com)                   |
    4. **Translations** The offer screen is available in multiple languages. [Follow this link to access translations of the offer](https://docs.google.com/spreadsheets/d/1jYfHXIpKtctj5OjdfkiEpNq9Nn9wclQqe3UOhWTRIPg/edit#gid=2012268662).
  </Step>

  <Step title="AV Guidelines" titleSize="h3">
    As mentioned above, it is vital to us to keep all of our partners' apps certified and cleared from any Anti Virus detection. Based on our experience, and partnership with Appesteem, we will provide some consulting about the implemented flow, to avoid any AV detection.

    For more details, we recommend you visit [this page](https://customer.appesteem.com/home/checklist), and filter the list for "**In-bundle offers**", "**Bundler-made offers**" and "**Ads inside apps**".

    These guidelines were not written specifically for any of Bright Data's applications, and are relevant for any bundler.
  </Step>

  <Step title="Assets" titleSize="h3">
    * Press Kit: [Download the press kit](https://hola.org/static/press_kit/press_kit.zip).
  </Step>

  <Step title="Restricted Countries" titleSize="h3">
    **Important Note before integrating:** Due to local restrictions, Hola VPN should not be offered in the following countries and/or regions. Please make sure you **disable the offer for**:

    * Iran
    * Iraq
    * Syria
    * Lebanon
    * Palestine
    * North Korea
    * Cuba
    * Sudan
    * Crimea region of Russia
    * India
  </Step>

  <Step title="Technical Integration" titleSize="h3">
    1. **Dynamically download** - the app using the link present in your bundle page in the Bright SDK control panel.
           <img src="https://mintcdn.com/brightdata-31a14106/rKXt-nAzRJvAfdSm/integration-guides/image/holavpn_integration_9.png?fit=max&auto=format&n=rKXt-nAzRJvAfdSm&q=85&s=b9e629c7f7fd1d3f8431ac445369f337" alt="Alt text" width="400" data-path="integration-guides/image/holavpn_integration_9.png" />
       **<u>Downloaded filename format:</u>** `Hola-Setup-csa-aid-[AFFILIATE_CODE].exe.`\
       **<u>Example:</u>** `Hola-Setup-csa-aid-a58kz.exe.`
           <Warning>
             **Important:** Keep the original filename as downloaded - the name contains your affiliate code that binds future installations to your account.
           </Warning>
    2. **Save the user's choice** - when the offer is displayed.
    3. Once your installer has finished - if the user clicked **"I agree"** on the offer screen, **run the app executable.**
  </Step>

  <Step title="Send for Final Review" titleSize="h3">
    <Warning>
      **Important!** To get paid for installs you must:

      * Send your app for review and get approved (details below).
      * [Set up your billing details](https://docs.bright-sdk.com/help-center/payment-information#what-is-the-process-to-get-the-monthly-payment).
    </Warning>

    Once you are done implementing, please upload your exe file for review under the **"Review Submission"** section in your dashboard app page:

    <img src="https://mintcdn.com/brightdata-31a14106/rKXt-nAzRJvAfdSm/integration-guides/image/holavpn_integration_10.png?fit=max&auto=format&n=rKXt-nAzRJvAfdSm&q=85&s=e9c5b302becc2c48868623e7007c0833" alt="Alt text" width="400" data-path="integration-guides/image/holavpn_integration_10.png" />

    <Note>
      Each offer type (Wizard, successful/uninstall page, in-app, etc.) requires separate dashboard setup and review.
    </Note>

    We will review the flow, send you feedback and add the right entities in our system and set it to **active** status in order to provide the right stats to start paying you for Hola VPN installs.

    Payments are done automatically according to the system's data - if you find any discrepancies, please let us know.
  </Step>

  <Step title="Get Your App Certified!" titleSize="h3">
    * We will assess the number of installations in the course of a **two-week period** and initiate the **AppEsteem certification process**, for which we will cover the associated costs. [Click here](https://customer.appesteem.com/certified?vendor=BDATA) to see the list of our partners' apps that have been certified.
    * As part of this process, it is necessary to implement a **new signing certificate** (this part is the partner's responsibility).

    <Note>
      When you add an offer (Wizard, successful/uninstall page, in-app offer, etc.), most likely you have a new build version. In that case, please share so we can recertify with AppEsteem.
    </Note>

    * If you have any inquiries, please feel free to contact our [Director of Security Partnerships](mailto:ofirm@brightdata.com).
  </Step>

  <Step title="Report and Payment Details" titleSize="h3">
    * We invite you to check into the [Bright SDK Dashboard](https://bright-sdk.com/cp), where you can manage your partnership activity, monitor your revenue and have access to other partner program assets.
    * In our dashboard, update your billing contact and payment details under **"[Company Profile](https://bright-sdk.com/cp/settings/company_profile)"**. [Learn more about our billing process](https://docs.bright-sdk.com/help-center/payment-information#what-is-the-process-to-get-the-monthly-payment).
    * Our team will notify you once they complete their review and approve your integration - you may then start distributing this build and start monetizing with Hola VPN!
    * Once active, your reports and payment details can be found and managed directly in the [Bright SDK Dashboard](https://bright-sdk.com/cp).
  </Step>
</Steps>