<INSERT YOUR PRODUCT NAME HERE>?
DataUnlocker is a Software-as-a-Service platform helping web applications to work as intended, despite any third-party software intrusion on client devices or network problems. A typical use case for installing DataUnlocker in a web application is unblocking previously blocked browser requests, caused for example by ad blockers, network policies or other types of content blocking software.
Simply put, DataUnlocker is a (smart) reverse proxy service, which proxies blocked network requests from web applications, under the hood. Thus, it makes a target server get previously blocked data, and a web application to receive a desired response, like it wasn't blocked. From the web application perspective, DataUnlocker requires a single-time installation only, with no changes to existing code.
The main benefit that DataUnlocker brings to web applications is the recovery of client-side analytics collection (which, as you may have noticed, we use across our titles). However, because DataUnlocker is an invisible (smart) proxy by its nature, here are other things it can do:
We have briefly explained how DataUnlocker bypasses content blockers on our landing page; let us put it here as well:
Put simply, DataUnlocker asks you to create a new unique "URL prefix", which is either a DNS record or a path prefix at your domain, which is obviously not present in any of the content filtering lists. DataUnlocker will proxy blocked requests using this unique prefix.
Because proxying requests to some third-party services may have unwanted side effects, DataUnlocker proxies only blocked traffic to not to break any existing functionality of your web application or third-party services it is connected to. To achieve this, DataUnlocker's script monkey-patches certain browser APIs, enabling an invisible proxy layer to its proxy servers.
The following diagram demonstrates a sequence of actions for successful and blocked requests, when DataUnlocker script is installed. Please note that by default DataUnlocker tries to proxy all failed requests regardless of their status, including requests returning 4xx or 5xx HTTP statuses in the response. To change this behavior, see configuring what to proxy.
Behind the scenes, DataUnlocker performs many additional "magic" to make it work, which includes, but is not limited to:
In the unlikely event of content blockers becoming smarter to detect DataUnlocker's job, DataUnlocker will notify its customers with the given impact and possible update steps for their configuration. Blocking DataUnlocker is not feasible from the content blockers' perspective, as they may end up either breaking a lot of websites without a reason or blacklisting a good part of the Internet.
The only thing DataUnlocker cannot guarantee is dataunlocker.com domain not ending up in some of the blacklists. This will not impact DataUnlocker's customers in any way (because they all have a unique setup to their own domain names). As for DataUnlocker's website, we expect our customers to be ready for adding an exception for dataunlocker.com in their ad blocker, just like they already are with f.e. Google Analytics.
In DataUnlocker's terms, websites or web applications are called Properties. When adding a new property in DataUnlocker Admin, you will be asked to complete a 3-step property onboarding process. This process takes around 5-10 minutes if you have full access to your website and a domain. You can also watch a video tutorial explaining how to install DataUnlocker.
Note that you will be able to come back to any of the installation steps later.
In the first step, you will be asked to choose a routing option, which can be either:
You may choose a DNS-based option if you have an access to your domain, as it is the easiest option available. The second option requires you to set up a reverse proxy on your side, which will talk to our (smart) proxy. If you wonder what exactly choosing one of these options means, here are some considerations:
After choosing your preferred option, the setup will suggest a DNS configuration (or a reverse proxy configuration if you have chosen a path-based method) for your website. Follow the suggested steps in the UI.
After completing the first setup step, you will be given a script to install in your web application. Note that changing the routing option will require updating a script, as it is based on the chosen routing option. Follow the instructions of the script installation user interface, and note the next:
document.createElement, starts to listen on
<img>"error" events, etc). It also hooks into other scripts already present in the HTML code, so that you don't need to change your original code. Even more than that,
fetchwill proxy failed requests under-the-hood if it is configured in DataUnlocker Admin, so that you won't f.e. receive an "error" event up until the proxy attempt errors.
Despite DataUnlocker has integration tests for many scenarios, before it is generally available, it is recommended to install the script in your development environment first. Just inserting the script's code, even when DataUnlocker is turned off, should be fine to verify that monkey-patching doesn't break your web application. Please report any unexpected behavior, and also make sure you have a debug version of the script installed for us to take a look.
Once the proxy path option is chosen and the script is installed, DataUnlocker will assess your installation and output any problems it may have, if there are any. Follow the instructions to complete the health check. You may need to retry the health check a couple of times before it becomes all-green.
Click on failed health assessments to see why it failed. If the health-check either finds a script matching property or the correct DNS record, your property will become "verified" and you will see more pages available for you in the left navigation menu.
Once your health check passes, you can start to configure what and how will be proxied. This process is optional, however, it is recommended to turn the "Proxy services which are not configured" option off after the initial configuration. Read more below.
By default, DataUnlocker's proxy is turned off. After the successful health check, you need to manually turn it on by using a "DataUnlocker proxy" switch in the Property's settings. You can switch it back off anytime, and DataUnlocker's proxy will stop in 5-15 seconds.
If your health check is green and your web application is receiving some blocked traffic, you will start seeing proxied requests shortly on your property's Dashboard page. You can also visit your web application with ad blocker turned on to generate some blocked traffic.
For instance, if your web application uses Google Analytics and Google Tag Manager, and if you didn't turn off the "proxy all other services" setting, you should get the following services in the proxied services table:
www.googletagmanager.com, the Google Tag Manager serving your configured tags.
www.google-analytics.com, a Google Analytics domain for reporting analytics and downloading the
analytics.jsscript (depending on how Google Analytics was installed).
api.dataunlocker.com, an endpoint serving a tiny piece of data telling synchronous DataUnlocker script which services to proxy and which not.
Note that by default DataUnlocker will attempt to proxy all blocked requests, unless "proxy all other services" is off. Normally, proxying everything that fails is not what you want, as many failed requests will still be failed even after the proxy attempt. Hence, it is recommended to turn off "proxy all other services" once you have configured which services to proxy.
Proxied services have "Enabled" status and a green checkmark in the proxied services table. You can click on a table row to configure each particular service: to enable/disable a proxy for it, manage its settings and see last proxied errors, if there are any.
DataUnlocker's Property can be shared between multiple accounts. You can choose an account to be a viewer or an owner. Viewers can only view the property but cannot change its settings. Viewers are also able to go through the DataUnlocker's installation steps (but they won't be able to change the property's routing option).
You can add as many users as you want, and you can add not yet registered users. Once they log in on DataUnlocker, they will be granted access to the property as configured.
DataUnlocker charges you for the proxied traffic via DataUnlocker's proxy service. Only blocked traffic is proxied, hence you are only charged for requests which were unblocked.
DataUnlocker uses a pay-as-you-go prepaid billing model, meaning that you need to purchase the traffic first in order to use it for the proxy. Initially, you have 512 MB of traffic for testing and verifying that DataUnlocker will work flawlessly with your web application.
You are billed for each consumed byte of the DataUnlocker's proxy. DataUnlocker counts both incoming (upload) and outgoing (download) traffic to its proxy services against your prepaid traffic. To be exact, DataUnlocker sums up a reverse proxy request size (which can also include additional headers and hence be a few bytes more than the original request) with the DataUnlocker's proxy response size (the response your browser gets from DataUnlocker). The size of a request/response is a total number of bytes it takes, which includes both headers and its body.
You can view the current prepaid traffic spending trend on the Property Billing page. The remaining prepaid traffic is displayed either on a chart or in the Usage Summary table. When the prepaid traffic reaches 0, DataUnlocker proxy will stop working.
There are two payment options available: one-time purchase and automatic purchases. Both have the same price for prepaid traffic, which you can see on the corresponding cards.
DataUnlocker works with the secure, PCI DSS-compliant payment provider Fondy, which accepts various card payment methods like Visa, Mastercard, Google/Apple Pay, etc. Because DataUnlocker service currently reside Ukraine, you will be charged in UAH equivalent to the USD amount you are presented in the DataUnlocker Admin. The exact amount charged will be visible in your bank notification, which may also include your bank currency conversion fee.
After each payment, you will receive a confirmation to your email address, as well as you will be able to see the transaction in DataUnlocker Admin: both in your Settings or on the Property's Billing page. In case you abandon the payment page for any reason, you will also receive a follow-up email soon, or you will be able to open the payment page again from either Settings or Property's Billing page.
Please make sure DataUnlocker works for your needs before making a purchase. Purchase refunds are possible for any objective reasons but are also subjects of our terms and conditions.
You can set up automatic charges from your card when Property's prepaid traffic is getting low. It is possible to define two types of automatic purchases:
When selecting one of these options, you will be provided with enough additional information about what, how and when an automatic purchase system will charge. For automatic purchases, you will need to add a new card to your DataUnlocker's account.
To avoid any strange charges, we made a very simple formula for computing automatic purchase amounts. It takes the amount of traffic proxied for the last 1, 3 or 7 days, depending on how long your Property's proxy is running, and assumes that the same amount of traffic per day will be proxied for the next X days, which you specify as the input. For example, if you have just set up your property, and it has already proxied 100 MB of traffic, the formula will pick "last 1 day" (because you have just registered your Property), and hence assume that you spend 100 MB per day. Therefore, if you specify "Purchase enough traffic to cover the next 30 days", the formula will calculate 3000 MB of traffic to purchase (100 MB x 30 = 3000 MB = 2.929688 GB).
<INSERT YOUR PRODUCT NAME HERE>?
DataUnlocker is a product-independent tool, which fixes the underlying common problem (content blocking), instead of "fixing" each blocked third-party product individually. However, there are a few considerations you should be aware of when using DataUnlocker, which effectively means that your third-party product is supported out-of-the-box but it might have a few inconsistencies when proxied. Note that only blocked (proxied) traffic is affected, which means you're always safe installing DataUnlocker.
DataUnlocker is here to take all possible technical and management overhead from you, providing a value of restoring your web application's functionality without any code modifications. While everything is expected to work out-of-the-box and you are always safe to install DataUnlocker regardless of the third-party products or analytics tools you're using, here is a definitive list of considerations you should be aware of when using DataUnlocker:
<script>may not yet support some exceptional cases (for instance, tracked content in iframes or adding blocked elements/scripts via
innerHTML). If you spot a blocked request which was not proxied (unblocked) by DataUnlocker, please, let us know, and we will support it very soon.
We do not store anything more than what you can see in the DataUnlocker Admin. Additionally,
Most likely, yes, in case you did the Property setup correctly, received the all-green health check
result and enabled DataUnlocker in settings. You will still see ad blockers blocked requests count,
as well as
net::ERR_BLOCKED_BY_CLIENT errors in the developer tools, however, if you take a
closer look, you will notice that each blocked request is now followed by an unblocked encoded request.
Unblocked requests are usually not readable, because they are encoded.
However, to ensure that the DataUnlocker's proxy actually delivers an expected result to your data analytics tools (or any other third-party services), you need to check your analytics tool (or third-party service) yourself, because DataUnlocker doesn't store any data to tell what has happened and how exactly.
As also explained in how it works, DataUnlocker should be faster to reach you out before you will see a traffic drop in your analytics tools or third-party services. Changing a prefix URL is as easy as changing IP addresses of our servers, however, some manual work from your side may be required. There is also an opportunity to automate the URL prefix changes (for DNS-based routing method), while it's not yet generally available (let us know if you need it).