# ROIBest 帮助中心

## Product Guide

- [Welcome to ROIBest PWA](/en/guide/introduction.md): Official website of ROIBest PWA ：https://roibest.com/ In the fast-paced world of digital marketing, efficiency and user experience are paramount. This is where ROIBest steps in – a cutting-edge solution revolutionizing the Android app advertising and installation process. Built on Progressive Web App (PWA) technology, ROIBest offers a seamless end-to-end solution for advertisers and users alike. PWA-Based Access ROIBest leverages the power of PWA for a superior app downloading experience on Android devices. With PWA, users can access and install apps directly from their browsers, eliminating the need for traditional app stores. Thousands of Paid Users With thousands of satisfied paid users already onboard, ROIBest boasts a proven track record of success. Every day, millions of app downloads are facilitated through our platform, showcasing its effectiveness and popularity among users. Optimal PWA Experience PWA stands as the pinnacle of Android app installation experience. ROIBest further enhances this excellence by providing the best PWA installation experience. Our platform not only harnesses the full potential of PWA technology but also enhances it with innovative features and seamless integration.PWA is the best Android app installation experience. ROIBest is the best PWA installation experience. Expert Development Team Backed by a team of seasoned developers with experience from top-tier companies like Google, ROIBest stands at the forefront of innovation. Our expertise and dedication drive continuous improvement and refinement of our product offerings. Regular Updates and Optimization We understand the importance of staying ahead of the curve. That’s why ROIBest releases weekly updates and optimizations to maintain our competitive edge. By staying agile and responsive, we ensure our product continues to deliver exceptional results for our clients. No Need for App Store Listings One of the standout features of PWA is its independence from traditional app stores like Google Play. With ROIBest, users enjoy the same seamless downloading experience without the hassle of app store listings. This freedom empowers developers and advertisers while providing users with a hassle-free experience. Open Ecosystem PWA’s open ecosystem means developers are not constrained by the stringent approval processes typical of traditional app stores. With ROIBest, developers can deploy their apps with confidence, knowing they have full control over the distribution process. In conclusion, ROIBest is not just a solution; it’s a game-changer in the world of Android app advertising and installation. With its advanced PWA technology, expert development team, and commitment to continuous improvement, ROIBest sets the standard for excellence in digital marketing. Join us on the forefront of innovation and unlock the full potential of your app advertising campaigns with ROIBest. Media Reports "PWA is the best Android app installation experience. ROIBest is the best PWA installation experience." ---Guardian  (《Guardian》  ranked 7th media organization in the world) Original link ：https://guardian.ng/news/roibest-revolutionizing-android-app-advertising-and-installation/ "ROIBest is the inventor and leader in Android PWA non-removable App"---apnews Original link：https://apnews.com/press-release/kisspr/mobile-apps-software-2d463ea6ff6902da9808381ea5d968b1 "PWA stands as the pinnacle of the Android app installation experience. ROIBest further enhances this excellence by providing the best PWA installation experience."---yahoo Original link：https://finance.yahoo.com/news/roibest-inventor-leader-android-pwa-224800013.html "With ROIBest, users enjoy the same seamless downloading experience without the hassle of app store listings. This freedom empowers developers and advertisers while providing users with a hassle-free experience."---vanguard Original link：https://www.vanguardngr.com/2024/06/roibest-is-the-pioneer-and-leader-in-android-pwa-non-removable-app/
- [Domain](/en/guide/domain.md): The settings in this section are mainly used for Packaging Domain Name and Domain for Landing Page
- [AD Pixel](/en/guide/pixel.md): Pixel configuration is mainly used for reporting advertising events. Currently, the ROIBest platform only returns the "Add to Wishlist" event. Other events are returned through parameters. Please go to the advertising or website backend to inquire;
- [Apps](/en/guide/app.md): Mainly used to set the UI of the APP, store page information, etc.
- [Links](/en/guide/links.md): Mainly used to set promotion links for advertising platforms
- [Attribution Platform](/en/guide/attribution.md): Third-party attribution platform: Adjust ① Before using this feature, make sure your product or white-label platform already supports the Adjust platform; ② If your product supports Adjust, provide your product domain and app token to the Adjust team to enable web attribution; ③ If your product has integrated Adjust but the media platform you plan to advertise on does not support Adjust, click the Adjust callback link configuration tutorial; Step 1 - Create an App Log in to the Adjust dashboard: https://www.adjust.com/ Go to AppView and find All Apps, then select + New App Customize the app name, select the currency and relevant legal settings, then click Add App Step 2 - Set Up the App Token After creation, copy the app token on the page Go to the ROIBest dashboard and navigate to Attribution Platform, click + ADJUST App, and paste the app token you copied into the App Token field Step 3 - Set Up the API Token Go back to the Adjust page, scroll down to S2S Security under the Protection section, and click Enable S2S Security Click + New Token Customize the token name and select all scopes Click Copy Token and Close Toggle on S2S Security at ① and copy the token at ② Go back to the ROIBest dashboard's Adjust configuration page and paste the token into the API Token field Step 4 - Set Up Landing Page Visit / Install Event Reporting Go back to the Adjust page, find the Events section, and click + Add Event Enter install as the event name and click Add Event Find the install event you just created on the Events page and copy its event token Paste the event token into the Install field on the ROIBest dashboard Go back to the Adjust dashboard and add another event with the name webview, then click Add Event Find the webview event you just created on the Events page and copy its event token Paste the event token into the Landing Page Visit field on the ROIBest dashboard After filling in all the fields on the ROIBest dashboard following the steps above, click Save to complete the configuration Step 5 - Enable Adjust Web Attribution Provide your white-label / self-developed product domain (not the ROIBest domain) and the app token to the Adjust support team to enable web attribution. Contact the Adjust support team for detailed instructions. Step 6 - Configure Adjust Attribution Method 1: Integrate via Adjust Partner Platforms (Use this method for FB, OKspin, etc.) In Campaign Lab, select Partner Deals and click + New Partner Select the media platform (e.g., FB, OKspin), then click Next Select the app you want to advertise, then click Next Customize the link name, then click Next Configure the page content as needed, then click Next Configure the attribution settings as needed, then click Next Verify that all information is correct, then click Create Link Click Copy URL and paste it into the ROIBest dashboard When creating a promotion link in the ROIBest dashboard, paste the URL you copied in the previous step into the white-label link address field Method 2: Integrate via Adjust Custom Links (Use this method for xiaobu, etc.)
- [Subscription Push](/en/guide/push.md): Push customized message content to users who have agreed to subscribe to message notifications;
- [Referral & Viral Sharing](/en/guide/referral.md): Encourage existing users to share content with friends through referral campaigns, driving organic growth via word-of-mouth virality. Step 1 - Enable the Feature This feature is currently exclusive to enterprise clients at no additional cost. To enable it, please contact your Customer Success Manager. Step 2 - Enable / Pause Referral Status Navigate to Referral & Viral Sharing from the sidebar. Under Referral Links, use filters such as Link Name or Referral Status to locate the link you want to enable or pause. To activate the feature, toggle the referral status to Active. Step 3 - Configure Share Message Click the edit button ① to open the share message settings page. Fill in the Share Title and Share Copy as needed, then click Save. Share copy preview: Share interface preview: Users can submit their email via ① and share content via ② to trigger viral distribution. Step 4 - View Sharing Data Click Referral Data and search by App Name or App ID to view the corresponding sharing metrics.
- [Smart Cloak](/en/guide/smart-cloak.md): A flexible cloaking tool that controls page display states to help your ads pass review smoothly. Step 1 - Create a Cloak Link Once activated, the Smart Cloak feature will appear under the ROI Enhancement section. Click to enter, then select + New Cloak. Step 2 - Link Configuration Real Link: The actual PWA promotion link used for ad delivery. Select a pre-configured PWA promotion link from the dropdown list (the dropdown displays the link name and link ID — you can copy the link name or ID from Promotion Links and search for it in the search box). Note: Only standard links and clean short links support cloaking. Shield links do not support cloaking. Landing Page Template: Select the landing page template for the real link. Domain: This is the domain for the cloak link. Select a domain already configured in the backend, or manually type to search for a domain. Note: Domains labeled as Shield or Short Link cannot be used as cloak domains. Rule Configuration Choose a routing mode and strategy based on your actual ad review and conversion requirements: Real-time Behavior Detection: Intelligently identifies and routes traffic — no manual review rules needed. Full Review: All traffic is directed to the review link. Full Open: All traffic is directed to the real link. Review Mode: Traffic is routed to either the review link or the real link based on configured rules. Target Countries: Traffic from selected countries/regions is directed to the real link; traffic from unselected countries/regions goes to the review link. Green Mode: Designate specific countries to see the review link. Target Countries: Traffic from selected countries/regions is directed to the review link; traffic from unselected countries/regions goes to the real link. Additional settings for Review Mode and Green Mode (not applicable to Full Review, Full Open, or Real-time Behavior Detection): Browser Language: Traffic matching the selected browser language will see the review link; other languages will see the real link. Device: The type of device used to access the link. Checked device types will see the review link; unchecked types will see the real link. Operating System: Checked operating systems will see the review link; unchecked ones will see the real link. Client: Checked clients will see the review link; unchecked clients will see the real link. Engine: Refers to the underlying browser rendering engine. The cloak uses the visitor's browser engine to identify traffic characteristics. Checked engines will see the review link; unchecked engines will see the real link. Spider Whitelist: Manually configure spider identifiers. Whitelisted spiders will see the real link. IP Blacklist: Manually configure blacklisted IPs. Blacklisted IPs will see the review link. ISP Blacklist: Blacklisted ISPs will see the review link. You can select ISPs based on the ad platform you are using. Block Proxy: When enabled, traffic using VPN/proxy will see the review link. Block Empty Language: When enabled, traffic with no language identifier will see the review link. Step 3 - Basic Information Configure the cloak link name and notes to complete the cloak link setup. Step 4 - Copy the Cloak Link Click to copy the cloak link. You can now test and launch your campaign — this is the final link to use in your ads. Step 5 - View Data Access Data (UTC+8) displays the visit counts for both the real link and the review link. Step 6 - View Logs Click View Logs to inspect detailed access logs for the cloak link. Select the Date Range for the logs to retrieve traffic details including basic info, access info, network status, routing destination, and device information.
- [Backup Link](/en/guide/backup-link.md): Comprehensive protection to keep your ad delivery links running smoothly, preventing traffic loss caused by domain bans, DNS resolution failures, domain expiration, and more. Step 1 - Find the Domain You Want to Configure in the Domain List, Click the "Configure" Button, and a Configuration Panel Will Appear on the Right Two backup link strategies are currently supported: redirect to a custom URL, and guide the user to copy a new link for installation. Strategy 1: Redirect to a Custom URL When this strategy is selected, users will be automatically redirected to the URL you specify if the domain is banned. Note: PWA links are not supported here! Steps: Select Redirect to a Custom URL in the configuration panelEnter a backup URL (e.g., https://roibest.com)Click Save to complete the configuration Strategy 2: Guide the User to Copy a New Link for Installation When the domain is banned, users will see a landing page containing a PWA promotion link on a different domain. They can copy the link and open it in Chrome to reinstall. Steps: Select Guide the User to Copy a New Link for Installation in the configuration panelChoose a promotion link that uses a different domain from the dropdown listClick Save to complete the configuration Setting Up Individual Link Overrides If specific links need their own backup strategy, use the Per-Link Configuration feature. Steps: Find the "Need to configure individual links separately?" section at the bottom of the configuration panelClick the + Per-Link Configuration buttonIn the configuration card that appears, first select the promotion link you want to configure separately from the dropdown listThen choose a backup strategy for that link (Redirect to a Custom URL or Guide to Copy & Install)Repeat the steps above to add more individual configurations (up to 10)Click Save to complete all configurations
- [Custom Install Page](/en/guide/install-page.md): Design a branded download and installation page that visually highlights your product's features based on your brand and product characteristics. Step 1 - Create a Custom Install Page Go to Custom Install Page → Add Install Page → Select a deployed App → Choose the landing page language → Upload custom install page images (you can crop the images if needed) → Enter the button text. Note: Do not upload images with an aspect ratio smaller than 16:9 or a width resolution below 375 px. Up to three images can be stitched together. GIF uploads are supported. Click Add Install Page, then click Add. Associate the page with a deployed App, set the install page language, upload the background image, and configure the floating install button. Step 2 - Link the Custom Install Page to a Promotion Link Go to Promotion Links, click Copy URL, select Custom Install, and Copy the Link.
- [Complaint Bin](/en/guide/complaint-bin.md): A self-built complaint channel that helps intercept user complaints. Through precise audience identification, it enables centralized handling of complaints across platforms and accounts. Step 1 - Enable the Entry Point When adding, duplicating, or editing an App, locate the Complaint Entry settings and toggle it on. Step 2 - Configure the Target Audience Turn on the switch and configure the audience whose complaints should be redirected: create a new template, enter a template name, select the target complaint audience, choose the template, and save. Step 3 - User-Side Complaint Entry Display Users in the configured audience will see the self-built complaint entry when they visit the landing page (e.g. "Installed / Uninstalled" audience). When an installed or uninstalled user revisits the landing page, the self-built complaint entry pops up. Step 4 - Complaints Submitted on the User Side Appear in the Complaint Bin After a user submits a complaint on the client side, the complaint content is sent back to the Complaint Bin in the admin panel.
- [Audience Cloud](/en/guide/audience-cloud.md): Back up ad pixel data to reduce the impact of ad account bans, deduplicate conversions on the media side, and enable precise retargeting campaigns. Step 1 - Enable the Feature Step 2 - Go to the Audience Cloud Entry, Click Enable, Then Click Edit. Search for the App Name or App ID, Click Enable, and the App Will Start Reporting Step 3 - Backup Pixel Is Off by Default — Click Pause to Stop Reporting for All Apps Under That Pixel Audience export tutorial: https://mis.roibest.com/#/word-viewer?type=audience-cloud
- [SMS Marketing](/en/guide/sms.md): Integrate with the EngageLab SMS platform to cover key scenarios such as registration verification, campaign push notifications, and promotional alerts — enabling multi-channel conversion. Step 1 - Create an SMS Promotion Code • Go to Promotion Links → + Promotion Link → Ad Settings → SMS Platform → EngageLab Step 2 - Copy the PWA Code Step 3 - Create a Template in the EngageLab Console (by Jiguang) EngageLab tutorial: https://www.engagelab.com/zh_CN/docs/otp/faq/how-to-send-pwa-with-sms • Set the sending strategy to SMS → select Custom Template → choose Marketing → insert the variable pwa url → paste the PWA Code Step 4 - View SMS Installation Data in the PWA Dashboard Installation data from EngageLab SMS campaigns can be viewed in the SMS Marketing panel of the PWA dashboard.
- [Collaborator Center](/en/guide/collaborators.md): The primary account can assign permissions to customize what sub-accounts are allowed to do. Sub-accounts can independently view full-funnel data for their promotion links (clicks, install rate). Step 1 - Collaborator Management Click Invite Collaborator and assign Collaborator Permissions. Enter the Collaborator Name, input the Collaborator Email, and assign the corresponding permissions to the collaborator (App, Pixel, Domain, Package URL). Step 2 - Collaborator Review Review collaborator applications — view the review details and approve or reject each request. Step 3 - Sub-Account Login Once a sub-account is created, the corresponding user will receive an account activation email. Follow the link in the email to open the login page, enter the email address, and request a verification code to log in. After logging in, create a promotion link — select the assigned permissions and click Save. View link conversion data — filter by the target promotion link to see detailed statistics.

## Ad Platform FAQ

- [Facebook FAQ](/en/faq/facebook.md): How to obtain PixelCode/Test Event Code/Access Token from Facebook?
- [Kwai FAQ](/en/faq/kwai.md): What are the conditions for launching Kwai? ①Kwai's advertising account and delivery link need to be added to the whitelist. For details, please consult the delivery media. If you need assistance, please consult the ROIBest PWA customer success manager. ②Do not use Kwai's built-in browser for testing. You need to set Chrome as the default. Package Network Integration ：Kwai How to get PixelCode/test feedback?
- [Google FAQ](/en/faq/google.md)
- [TikTok FAQ](/en/faq/tiktok.md): Please check here for possible problems you may encounter when configuring TikTok distribution channels.
- [Bigo FAQ](/en/faq/bigo.md)
- [Traffic Stars FAQ](/en/faq/traffic-stars.md): Step 1 - Log in to TrafficStars Log in to trafficstars.com and click Sign In to access the dashboard; Choose the appropriate account type to log in based on your needs; Step 2 - Create a New S2S Postback In [Tracking Tools], find S2S Tracking and click [Generate New Postback] Select the postback type and tracking system as shown below, then click Save; Find the configured S2S link, click Copy, and paste it into the ROIBest dashboard; Step 3 - Fill in ROIBest Dashboard Information In [Pixel Configuration], select [Traffic Stars], then click [+S2S Tracking] Enter the S2S tracking information from the Traffic Stars dashboard into the corresponding fields. Paste the S2S link generated earlier into the Postback URL field; Note: The CPA price must match the price set in the Traffic Stars dashboard; Step 4 - Create a Dedicated Traffic Stars Promotion Link Go to [Promotion Links] in the left sidebar. Set up the promotion app info as needed, select [Traffic Stars] as the target platform under [Ad Settings], generate the Traffic Stars promotion link, and enter it in the Traffic Stars dashboard for promotion; Step 5 - Create an Ad Campaign in Traffic Stars In [Create Campaign], configure the campaign name, ad format, target audience, etc. based on your needs, then click [Next]; Select the websites or audience for ad delivery based on your needs. Options ① and ② support CPA; option ③ supports CPM only; Important: ① Select CPA mode; ② The CPA price must match the CPA price in the ROIBest dashboard; For the creative, select [Image]. Paste the dedicated promotion link generated from the ROIBest dashboard into the [URL] field, then click Publish;

## Developer Docs

- [Usage Instructions](/en/developer/introduction.md)
- [Data Open API](/en/developer/open-api.md): Use an API Key to query visits and installs by promotion link or app from your own server, either as a total for a date range or broken down by day. This makes it easy to feed ROIBest data into your own BI, reporting or campaign systems.
- [front-integrate](/en/developer/front-integrate.md)
- [Ad Event Reporting](/en/developer/event-report.md): ROIBest supports event reporting for multiple advertising platforms including Facebook, TikTok, Kwai, MgskyAds, and more. The caller does not need to distinguish which ad platform the link belongs to — ROIBest automatically routes events to the correct platform. Promotion links cannot be cross-posted between channels. For instance, a TikTok promotion link obtained from the MIS system cannot be placed on the Kwai platform. This will cause incorrect source identification, resulting in event feedback failures. Before calling this API, ad configuration must be completed. Additionally, the link_id passed in the API call must be an ID generated from the ad platform.
- [Retrieve Query Parameters from Landing Page using link_id](/en/developer/query-link-info.md): API Name: https://sdk-report.roibestopenapi.com/fbclid/get?link_id={$linkId}Description: Retrieve query parameter details from the link specified by link_id.Request Method: GETRequest Body: NoneResponse Body:
- [Query Successful Install Events](/en/developer/search-event.md): API Name: https://pwa-backend-prod.roibest.com/search/event?project_id=&invite_code=Description: Retrieve query parameter details from the link specified by link_id.Request Method: GETRequest Parameters: Response Example:
- [Integrating Your Service Worker](/en/developer/service-worker.md): Custom Service Worker: Inject the path of your custom service worker file (e.g. "./**/your-service-worker-filename" or "./your-service-worker-filename") into the global variable window.__rb_app.swUrl. After injecting, output the variable to check if the path is correct. Then, in your service worker file, insert the line importScripts("./notification-sw.js"). Integration Code Example index.html service-worker.js Important Notes The injection of window.__rb_app.swUrl must occur before the closing of the <head> tag in index.html.Only self-developed integrations are supported; packaged integrations can be ignored.For any integration issues, please contact customer support for assistance.