BAIZE Extension
This document serves as the official guide for a Google Chrome extension designed to scrape data from websites. It explains how the extension is to be used and details the requirements for its operation.
Introduction
This Chrome extension allows you to scrape Ads data from websites with ease. It offers distinct functionalities, detailed below:
Functionality
Button Injection:
Operating automatically once the extension is installed, this feature quickly identifies if the user is viewing the Facebook Ads Library, Titkok creative center or AdSpy page. If so, it discreetly injects a ‘drop-down’ and a ‘Save to Yuri’ button into every ad card displayed. The selected ad’s data is then ready to be scraped.
- Drop-Down: This menu includes a search bar and a list of folder names, allowing you to search for and select a folder to save the ad data. Once a folder is chosen for the first ad card, it will be auto-selected for all other ads on the page, although users can select different folders for individual ads if desired.
- Save to Yuri: Situated next to the drop-down, this button facilitates the transmission of scraped ad data. Upon sending the data, a confirmation message is displayed to inform you that the data has been successfully sent.
Requirements
In order to use the extension, the requirements are as follow.
- The web browser must be Google Chrome.
- Users need to install the extension from the Google Chrome Web Store by writing BAIZE"or using this link: BAIZE extension link
- A token is required to log in to the extension in order to use it.
| Category | Detail |
|---|---|
| Web Browser | Google Chrome |
| Installation | Chrome App store |
| Login | Token Authorization |
Note : Generate the token by login to Yuri
Installation
To install a extension in the Google Chrome web browser, follow these steps:
-
Open your Google Chrome browser.
-
Go to the Chrome Web Store by visiting: chrome.google.com/webstore
-
Use the search bar and write ‘BAIZE’ to find the extension and install it.
-
Once you find the extension, click on the “Add to Chrome” button.
-
A confirmation dialogue will appear, detailing the data permissions required by the extension. If you agree, click “Add extension.”
-
After installation, you will see a overview or a welcome message explaining how to use the extension.
7.Chrome will now install the extension, and you should see it appear on the Extensions page. -
Once successfully installed, you can see your extension’s icon in the extensions tray next to the address bar, where you can also pin it for easy access.
-
You can interact with your extension as needed, including clicking on the icon to activate any pop-ups or browser action functionality your extension uses.
Getting Started
Extension UI
Installing the Extension
-
Go to the Chrome Web Store by visiting: chrome.google.com/webstore or click the puzzle icon in the top right corner and then select “Manage extensions.”
-
After clicking the manage extension, click on the Chrome Web Store icon located in the top-left corner to navigate to the web store.
-
Type “BAIZE” in the search bar located in the top-right corner and hit enter.
-
Click on the blue button “Add to Chrome”, A confirmation dialogue will appear, If you agree, click “Add extension.”
-
Upon successful installation, the extension will appear in your list of extensions and can be accessed by clicking the puzzle icon in the top right corner of the browser.
Token Generation
A token is required to log in to the extension. Please follow the steps below to generate one:
-
Navigate to https://feiranmedia.com/panel/login and log in with your credentials.
-
Click on the circular profile icon located in the top right corner, then select “Profile” from the drop-down menu.
-
Scroll to the bottom of the page and find the section for token generation. Create the token, which you will later use to log in to the extension.
Login
- Click on the puzzle icon located in the top right corner of your browser to view your installed extensions.
- Select the newly installed extension to open it. Upon the initial launch of the extension, it will prompt you for token authorization.
- Enter the token when prompted. If the token is correct, it will direct you to the user input form. If the token is incorrect, an error message will be displayed.
- Once the token is authorized, you will gain access to the extension’s menu.
( Note: After the first successful token authorization, the token will be saved in local storage, and you will not be required to enter the token again for future uses.)
Features and Usage
Theme: Extension is designed with your comfort in mind, featuring both light and dark mode settings to suit your preference. You can easily switch between light and dark modes by following these simple steps:
-
Click on the extension icon in your browser’s toolbar to open the extension’s popup window.
-
In the top right corner of the popup, you’ll find a toggle button.
-
Click on this button to switch between light and dark mode; the icon will change to indicate which mode is currently active.
- The sun icon represents light mode for a brighter interface, ideal for well-lit environments.
- The moon icon represents dark mode for a softer display, reducing eye strain in low-light conditions.
The extension is designed to scrape data from websites. Once the data is scraped, it is sent to the server through an API call. The ways to utilize this extension are as follows:
Button Injection: Operating automatically once the extension is installed, this feature quickly identifies if the user is viewing the “Facebook Ads Library” , “AdSpy” or “Tiktok Creative Center” page. If so, it discreetly injects a ‘drop-down’ and a ‘save to Yuri’ button into every ad card displayed. The selected ad’s data is then ready to be scraped.
The scraping procedure for obtaining data from an Ad card consists of the following steps:
- A. Visual of buttons addition in the Facebook ad card:
- Detailed information about what specific data gets scraped from an Facebook Ad library card is provided in image below:
- B. Visual of buttons addition in the Tiktok Creative Center:
- Detailed information about what specific data gets scraped from Tiktok creative center is provided in image below:
- C. Visual of buttons addition in the AdSpy:
- Detailed information about what specific data gets scraped from an AdSpy is provided in image below:
Initially, it is crucial to choose a folder from a drop-down menu to ensure the scraped data has a designated location for storage.
How to create folder:
Follow these steps to create a new folder in our system, which in this context is referred to as a ‘project’:
- Go to the redirect icon in the top right corner to access the Yuri website.
- Log in with your credentials to proceed.
- Once logged in, navigate to the navbar and click on ‘Campaigns’ followed by ‘Projects’.
- Here, you will have the option to create a new project. Click on the appropriate button or link to initiate the creation process.
- Follow the prompts to set up your new project. Once the project is created, its name will appear in the ‘Inject button’ folder selection drop-down menu.
Once a folder is selected for one Ad, the extension will apply the same folder selection automatically to all subsequent Ad cards, simplifying the process. However, the user retains the option to change the folder selection on individual Ad cards if necessary.