AdPreserve API - basic FAQ / Questions & Answers Free Anti-Adblock API manual
- How to use AdPreserve API?
- How does AdPreserve block AdBlockers?
- Why to use PHP to obtain JS+HTML from API?
- How to test AdPreserve's installation and why its filenames are so long?
-
How to use AdPreserve API? ↑↑↑
To use our API, first sign up for free and after e-mail confirmation, you will be able to log-in into your account. Once there, you can download API script (PHP) for your domain... For each domain, there is a separate script generated, script that connects to our API and obtains individually, dynamically generated code (HTML+JavaScript) that detects + blocks AdBlockers.
-
How does AdPreserve block AdBlockers? ↑↑↑
When adBlocking software is detected the user is asked to disable it (in a lightbox-style dialog displayed over the site contents) and -optionally- the site contents are blocked + blurred-out.
In the current version of AdPreserve these are the measures taken, but more is soon to come. The API-connecting script is coded in a manner, that it will pull from the API all new AdPreserve features, once they are added. -
Why to use PHP to obtain JS+HTML from API? ↑↑↑
Adblocks have numerous lists of blocking rules, that are updated daily. E.g. uBlock Origin has (by default) 46 such lists built-in, with over 672.812 filters used (that's over half a million)! AdBlocks extensions update these lists in their uses browsers.
Since these lists change on daily basis, the effective way to address the issue of blocked ads is code that changes as these list change.
AdPreserve API is a solution that guarantees that code on your site also is up-to-date with methods of adBlock detection & blocking. Also, bits of JS code are randomly changed to prevent adBlocks from blocking the code. -
How to test AdPreserve's installation and why its filenames are so long? ↑↑↑
The AdPreserve installation files you can download from your account panel contain a script designed for - among other things - displaying and reporting any potential errors / issues there may occur with AdPreserve's functioning on your website / server.
The script filename has syntaxadpreserve_test_{YOUR-SITE-TEXTID}.php
and is linked from the forementioned panel. It will display detailed technical reports, many of which can reveal thetextId
of the website or other technical details. TextId is a 30-characters-long alphanumerical string used in AdPreserve filenames, thanks to which the files are not easily available for a third party. It's important for safety.