外掛說明
Ad Unblock 外掛能讓網站管理員輕鬆將 Ad Unblock 服務整合至 WordPress 網站,藉以恢復廣告攔截器造成的廣告收益損失。
主要功能
- 簡單方便的帳號 ID 設定
- 控制指令碼執行位置 (全部頁面、指定網址規則、分類或標籤)
- Sends your site domain with the script source request, so your site keeps working when a filter list blocks the shared script host
- 將要求的指令碼自動插入至網站標頭
- 快取 API 要求以獲得最佳效能
運作方式
- 在 ad-unblock.com 註冊帳號
- 在 Ad Unblock 儀表板中取得帳號 ID
- 在外掛設定頁輸入帳號 ID 以啟用外掛功能
- 在 Ad Unblock 儀表板中新增網站
- 設定指令碼執行位置
- 開始恢復廣告收益
外部服務
這個外掛會連線至 Ad Unblock (https://public.adunblocker.com/api/vendor_scripts) 以取得指令碼來源網址。指令碼來源網址可能會因為伺服器端擷取而產生變更。
資料傳輸
- 這個外掛會從 https://public.adunblocker.com/api/vendor_scripts 擷取指令碼來源網址 (快取保留 5 分鐘)。
- Your site’s own domain is sent with that request as the
domainquery parameter, so the service can answer with a script host reserved for your site. It is taken from your site address and can be changed or left blank in the plugin settings. - 這個外掛不會收集或傳送使用者個人資料。
安裝方式
- 將外掛安裝套件 ZIP 壓縮檔解壓縮所得的
ad-unblock資料夾上傳至網站的/wp-content/plugins/目錄中,或直接在 WordPress 的 [外掛] 選單中安裝外掛。 - 在 WordPress 管理後台的 [外掛] 選單中啟用外掛。
- 前往 [設定]→[Ad Unblock] 以設定外掛
- 輸入在 Ad Unblock 儀表板取得的帳號 ID
- 設定指令碼執行位置
常見問題集
-
使用這個外掛是否需要 Ad Unblock 服務的帳號?
-
是,請前往 ad-unblock.com 註冊帳號以取得帳號 ID。
-
如何取得帳號 ID?
-
在 ad-unblock.com 註冊帳號後,請前往 Ad Unblock 儀表板取得帳號 ID。
-
網站管理員是否能控制外掛提供的指令碼執行於哪個頁面?
-
可以,網站管理員能在全部頁面、指定網址規則、分類或標籤啟用指令碼。
-
What is the Site Domain setting for?
-
Filter lists sometimes block a script host for one publisher’s site specifically,
rather than for every site using it. Sending your domain with the script source
request lets Ad Unblock move just your site onto its own script host when that
happens, instead of rotating every site onto a new one.It is detected automatically from your site address, so there is normally
nothing to change. Left blank, it keeps following your site address, so it stays
correct if you ever move the site. Fill it in only if Ad Unblock asks you to use
a specific domain. -
Does it work with caching and performance plugins?
-
The script tag is printed with
data-cfasync="false"andnowprocket, which
exclude it from Cloudflare Rocket Loader and WP Rocket’s Delay JavaScript
Execution. Ad recovery has to run before your ad code, so the tag must not be
deferred, combined or rewritten.Two options still need a manual exclusion, because neither honours an attribute:
- WP Rocket — Load JavaScript deferred: add your Ad Unblock script URL to
its Excluded JavaScript Files list. - LiteSpeed Cache, Autoptimize, W3 Total Cache, SG Optimizer, Perfmatters:
add the URL to their JS exclusion lists, covering combine, defer and delay.
The script URL is the one in the
<script>tag the plugin prints in your
page’s<head>— view source to copy it. It changes when we rotate script
hosts, so re-check any exclusion list you pasted it into. - WP Rocket — Load JavaScript deferred: add your Ad Unblock script URL to
-
這個外掛是否會降低網站的速度?
-
不會,這個外掛開發方向為輕量化及高效能,它使用快取以降低 API 要求次數,並以非同步載入指令碼的方式避免影響頁面載入時間。
使用者評論
這個外掛目前沒有任何使用者評論。
參與者及開發者
變更記錄
1.1.6
- Added a Site Domain setting, auto-detected from your site address, sent with the script source request so Ad Unblock can serve this site its own script host when a filter list blocks the shared one.
- The cached script sources are now tied to the request that produced them, so changing the domain or API endpoint refreshes them instead of serving the previous list.
1.1.5
- The script tag now carries
data-cfasync="false"andnowprocket, excluding it from Cloudflare Rocket Loader and WP Rocket’s Delay JavaScript Execution. - The tag is printed at the very top of
<head>instead of after the stylesheets, so recovery loads ahead of your ad code. - Fixed the tag loading from the footer on WordPress older than 6.3.
- Tested compatibility with WordPress 7.1
1.1.4
- Fix potential date/time display issue.
- Tested compatibility with WordPress 7.0
1.1.3
- Renamed “Verification Code” to “Account ID” in the settings UI
- Updated onboarding steps: register get Account ID enable plugin add site in dashboard
1.1.2
- Added custom API endpoint option with toggle to use default or custom URL
1.1.1
- Update server side API URL
1.1.0
- Fix an issue that cached resource is not refreshed properly when external cache object is enabled
1.0.6
- Improved cache management
1.0.5
- Fix version issue
1.0.4
- Lazy load categories and tags selection
- Optimize page settings UI
1.0.3
- Updated script back to asynchronous.
1.0.2
- Updated script to be synchronous. It won’t affect site speed since the script itself is behind async functions.
1.0.1
- Remove verification code from script URL query param to improve cache performance
- Add verification code as a meta tag in header
1.0.0
- Initial release
- Added logo and “AdUnblock” text to admin interface
- Improved admin page styling for better user experience
- Added helpful links to support and documentation

