Skip to content

Latest commit

 

History

History
92 lines (79 loc) · 8.24 KB

README.md

File metadata and controls

92 lines (79 loc) · 8.24 KB
Raw

ReportsWebApp

Allows users to report a problem with AdGuard filters.

https://reports.adguard.com/new_issue.html

Pre-filling the app with query parameters

Parameter Explanation
product_type One among Win, Mac, And, iOS, Ext, Saf, Con.
product_version A string representing the version number. Example: 6.2
license_type Can be free and paid.
system_version A string representing the system version. Example: macOS 13.5
manifest_version A string representing the manifest version — 2 or 3, can only be used when product_type is Ext.
browser Can be one among Chrome, Safari, Firefox, Opera, Edge, IE, Other. If the browser does not fall into this categories, the value should be set as Other and the string representing the browser name should be attached as a value of a browser_detail parameter.
browser_detail A string representing a browser's name. When this parameter value is specified, the value of browser parameter should be Other.
user_agent A url-encoded string containing user agent information. If this value is set, browser and browser_detail query parameters will be ignored and set to Other and the value of user_agent parameter, respectively.
url A string representing a url where the problem in which the report is trying to report takes place.
filters A period-separated list of filterIds, as specified in https://filters.adtidy.org/windows/filters.json.
custom_filters An url-encoded string that includes URLs (or paths to local files) of custom filters, separated by commas.
userscripts An url-encoded string that includes URLs (or paths to local files) of installed userscripts, separated by commas.
https.filtering Can be true or false.
win.wfp Can be true or false, indicates whether WFP driver in AG for Win is enabled or not.
browsing_security.enabled Can be true or false.
browsing_security.statictics_enabled Can be true or false (needed if browsing_security.enabled is true).
parental_control.enabled Can be true or false.
parental_control.sensitivity Can be one among Early, Young, Teen or Disabled.
parental_control.safe_search Can be true or false.
parental_control.block_exe Can be true or false.
stealth.enabled Can be true or false.
stealth.hide_search_queries Can be true or false.
stealth.DNT Can be true or false.
stealth.x_client Can be true or false.
stealth.strip_url Can be true or false.
stealth.block_third_party_auth Can be true or false.
stealth.first_party_cookies A string representing a decimal number that is specified in the stealth module indicating a time during which first-party cookies to be kept in minutes. If this query parameter does not exist, it is treated as not enabled.
stealth.third_party_cookies A string representing a decimal number that is specified in the stealth module indicating a time during which third-party cookies to be kept in minutes. If this query parameter does not exist, it is treated as not enabled.
stealth.disable_third_party_cache Can be true or false.
stealth.webrtc Can be true or false.
stealth.push Can be true or false.
stealth.location Can be true or false.
stealth.flash Can be true or false.
stealth.java Can be true or false.
stealth.referrer A string representing a URL that is used by the stealth module as a referrer value. If this query parameter does not exist, it is treated as not enabled.
stealth.user_agent A string representing a user agent that is used by the stealth module as a user agent value. It can be an empty string. If this query parameter does not exist, it is treated as not enabled.
stealth.ip A string representing a IP address that is used by the stealth module as a ip address. If this query parameter does not exist, it is treated as not enabled.
stealth.dpi Can be true or false.
stealth.block_trackers Can be true or false.
stealth.disable_wap_push_message_routing_service Can be true of false.
stealth.disable_windows_defender Can be true of false.
stealth.disable_windows_telemetry Can be true of false.
stealth.turn_off_advertising_id Can be true of false.
stealth.ext_hide_referrer Can be true of false. Only for AdGuard Browser Extension.
dns.enabled Can be true or false.
dns.servers System OR an url-encoded string that includes URLs of set DNS-servers, separated by commas.
dns.filters_enabled Can be true or false.
dns.filters An url-encoded string that includes filters' URLs or paths to local files, separated by commas. DnsUserRules should be included if DNS User Rules enabled.
dns.timeout Timeout number value in milliseconds.
dns.fallback_enabled Can be true or false.
android.system_root Can be true or false.
android.mode Can be VPN or proxy.
android.proxy_mode Can be auto or manual.
android.proxy_port Local proxy port number value.
android.method Can be High-quality, High-speed, or Simplified.
android.apps_filtering Can be true or false.
advanced_protection_enabled Can be true or false, indicates whether Advanced Protection in the iOS app is enabled or not.

Obsolete parameters

Parameter Explanation
android.dns Can be true or false.
ios.systemwide Can be true or false, indicates whether system-wide filtering is enabled on Adguard iOS or not.
ios.simplified Can be true or false, indicates whether simplified filtering is enabled on Adguard iOS or not.
ios.DNS Can be Default, Family, None.
ios.CustomDNS Can be any url-encoded string that indicates the custom DNS setting that is being used. If this value is set, the value of ios.DNS will be Other regardless of the value of ios.DNS.
referrer An url-encoded string containing referrer value with which the page was visited.

Examples

AdGuard for Windows

https://reports.adguard.com/new_issue.html?product_type=Win&product_version=6.2&system_version=Windows%2010&browser=Other&browser_detail=Midori&url=http%3A%2F%2Fgoogle.com&filters=2.3.4.5&custom_filters=https%3A%2F%2Fraw.githubusercontent.com%2Fhoshsadiq%2Fadblock-nocoin-list%2Fmaster%2Fnocoin.txt%2Chttps%3A%2F%2Feasylist-downloads.adblockplus.org%2Fbitblock.txt&win.wfp=false&stealth.enabled=true&stealth.hide_search_queries=true&stealth.DNT=true&stealth.x_client=false&stealth.first_party_cookies=30&stealth.third_party_cookies=2880&stealth.disable_third_party_cache=true&stealth.webrtc=true&stealth.push=false&stealth.location=true&stealth.referrer=http%3A%2F%2Fadguard.com&stealth.user_agent=Mozilla%2F5.0%20(Linux%3B%20Android%206.0.1%3B%20SM-G920I%20Build%2FMMB29K)%20AppleWebKit%2F537.36%20(KHTML%2C%20like%20Gecko)%20Chrome%2F58.0.3029.83%20Mobile%20Safari%2F537.36&stealth.ip=127.0.0.1&dns.enabled=true&dns.servers=https%3A%2F%2Fdns-family.adguard.com%2Fdns-query&dns.filters_enabled=false&referrer=AdGuard%20For%20Windows&userscripts=http%3A%2F%2Fadsbypasser.github.io%2Freleases%2Fadsbypasser.full.es7.user.js%2Chttps%3A%2F%2Fcdn.adguard.com%2Fpublic%2FUserscripts%2FBeta%2FAdguardPopupBlocker%2F2.1%2Fpopupblocker.user.js

AdGuard for Android

https://reports.adguard.com/en/new_issue.html?product_type=And&product_version=4.0%20nightly%209%20(48)&system_version=Android%209&filters=14.2.1.3.11.4&android.mode=VPN&android.method=High-quality&android.apps_filtering=true&https.filtering=true&dns.enabled=true&dns.servers=tls%3A%2F%2Fdns.adguard.com&dns.filters_enabled=true&dns.filters=https%3A%2F%2Ffilters.adtidy.org%2Fandroid%2Ffilters%2F15_optimized.txt,DnsUserRules&&stealth.enabled=false&userscripts=https://userscripts.adtidy.org/release/disable-amp/1.0/disable-amp.meta.js,https://userscripts.adtidy.org/release/adguard-extra/1.0/adguard-extra.meta.js

AdGuard for iOS

https://reports.adguard.com/new_issue.html?product_type=iOS&product_version=4.1.1&license_type=paid&system_version=iOS%2016.6&browser=Safari&filters=1.2.3.4.11.14&dns.enabled=true&dns.servers=https:%2F%2Fdns.google%2Fdns-query&dns.filters_enabled=true&dns.filters=https:%2F%2Fraw.githubusercontent.com%2FAdguardTeam%2FFiltersRegistry%2Fmaster%2Ffilters%2Ffilter_15_DnsFilter%2Ffilter.txt&advanced_protection_enabled=false