EarnApp Bundle Integration Guide

Overview

Step1: Register your app in the dashboard

Step 2: Choose integration offer(s)

Step 2.1: Offer screen setup

Assets

Step 2.2: Technical bundler integration

Step 3: Send for final review

Step 3.1: Get your app certified!

Step 3.2: Report and payment details

Overview

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

Integrating EarnApp is the first step toward earning revenue. Once you've released your app bundle 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:
Step 1: Register your app in the dashboard
Step 2: Integrate EarnApp bundle
Step 3: Final review

 

Important notes

• Users must ALWAYS decide if they want to VOLUNTARILY install EarnApp 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 EarnApp and privacy in its FAQ.
• 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.

Step 1: Register in the dashboard

If you are not registered as a partner yet, Welcome! Please go to our dashboard and signup.
You are now ready to start with registering the app bundle:

1. Click on "Monetized Bundles" (left menu) > Click on the  "(+) Add Bundle" button (top of the page).

2. In the Bundle Creation pop up: Choose the Product you would like to promote (in this case: EarnApp), Operating System your app is offered in and the Offer Type from the drop down 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.
 

 Note: As part of our service to select partners, we include them in the respected AppEsteem certification program, recognized by major AV vendors. Once implementation is confirmed and installs look good, we’ll notify you to begin.

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

Bright SDK covers the entire certification process and maintenance—at no cost to you!

Step 2: Choose integration offer(s) - more offers coming soon

> Installation Wizard offer 

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

1. Promotional offer is shown within product installation wizard (start with offer screen set up and then implement exe file, instructions here).
⚠️Make sure EarnApp 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.
2. User clicks Agree
3. exe file downloads in the background.
4. EarnApp setup is launched and presents the Bright SDK consent screen only after your app installation is complete.

---

For your Installation Wizard offer setup, follow these instructions:

Step 2.1: Offer screen setup

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

- You may implement the offer screen onto your wizard (make sure to include all the links provided below).
- In case you want to design your own EarnApp offer, please read below.
In the 'Assets' section you may find all the imagery needed. 

- Choose the message that most suits your audience: 
 

  


When setting up the offer make sure to include the following text, buttons and links:

1. Mandatory Text:

   - Optional offer by     <link to: earnapp.com >

    - When you click “Accept”, you agree to install  “EarnApp” and consent to its Privacy Policy and EULA.
 

2. Buttons: “Decline” / “Accept”
   ⚠️ 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.
   
    
3. Links:

- The link to EarnApp EULA leads to https://earnapp.com/user-agreement
- The link to EarnApp Privacy Policy leads to https://earnapp.com/privacy

AV  Guidelines

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, 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.

Assets

Drive folder link 
 

Step 2.2: Technical bundler integration

1. Dynamically download the bundler using the link that is present in your bundle page in bright-sdk control panel 

The download will look like this: ttps://cdn.bright-sdk.com/static/BrightSDK-Bundler.exe?filename=earnapp-bundler-[your_bundle_code].exe

⚠️ Important: make sure that the bundler executable file has you bundle code in its filename, if it isnt present it will fail. the filename must end with -XXXXX.exe, where XXXXX is your unique bundle code. e.g: earnapp-bundle-zx76b.exe

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 bundler executable.

Troubleshooting: If you encounter any issues during the installation of the Bundler application, you can access debug logs by executing it through the Windows Command Prompt (CMD). This will assist you in identifying the underlying problem.
 

To validate app launch complete this checklist:

Launch your app’s install wizard
 

Offer is displayed within the wizard (non-intrusive, with product description)

Privacy Policy and EULA links are visible and clickable:
    Privacy Policy: https://earnapp.com/privacy 
    EULA: https://earnapp.com/user-agreement

Click “Install” / “Accept” to proceed

Your app’s install wizard completes successfully

EarnApp installer launches automatically

Main Screen of EarnApp is successfully launched

Step 3: Send for final review

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

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

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 EarnApp installs.

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

Step 3.1: Get your app certified!

- 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 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 under 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.

- If you have any inquiries, please feel free to contact our Director of Security Partnerships.

Step 3.2: Report and payment details

- We invite you to check into Bright SDK dashboard, 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”. Learn more about our billing process.

- 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 !

- Once active, you will be receiving a monthly report in CSV format along the total of the payment for this month.

***********************************************************************************************************
We are glad to have you aboard! For any questions please do not hesitate to contact us!