{"id":384535,"date":"2026-10-16T21:11:52","date_gmt":"2026-10-16T21:11:52","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/arbling-beacon\/"},"modified":"2026-10-17T13:27:04","modified_gmt":"2026-10-17T13:27:04","slug":"arbling-beacon","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/arbling-beacon\/","author":23583536,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.3.2","stable_tag":"0.3.2","tested":"7.1.3","requires":"6.3","requires_php":"7.4","requires_plugins":null,"header_name":"Arbling Beacon","header_author":"Arbling","header_description":"Adds the Arbling AI-arrival beacon to any WordPress site, bound by its site key and gated by consent. On a WooCommerce store, product pages also report the product. With a connector key it reports AI crawlers and counts visits server-side, with no personal data.","assets_banners_color":"e0ddd7","last_updated":"2026-10-17 13:27:04","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/arbling.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":73,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.3.1":{"tag":"0.3.1","author":"arbling","date":"2026-10-16 21:11:15","revision":3751139},"0.3.2":{"tag":"0.3.2","author":"arbling","date":"2026-10-17 13:27:04","revision":3751958}},"upgrade_notice":{"0.3.2":"<p>Updates the settings screen&#039;s directions; nothing else changes.<\/p>","0.3.1":"<p>The first release on WordPress.org. It adds server-side visit counts: save a crawler reporting key to turn them on.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3751958,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3751958,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3751958,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3751958,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.3.1","0.3.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3751958,"resolution":"1","location":"assets","locale":"","width":1568,"height":523}},"screenshots":{"1":"The settings page before any key is saved: the site key, and the optional crawler reporting key."}},"plugin_section":[],"plugin_tags":[2353,232,216196,12928,286],"plugin_category":[36,45],"plugin_contributors":[287169],"plugin_business_model":[],"class_list":["post-384535","plugin","type-plugin","status-publish","hentry","plugin_tags-ai","plugin_tags-analytics","plugin_tags-chatgpt","plugin_tags-crawlers","plugin_tags-woocommerce","plugin_category-analytics","plugin_category-ecommerce","plugin_contributors-arbling","plugin_committers-arbling"],"banners":{"banner":"https:\/\/ps.w.org\/arbling-beacon\/assets\/banner-772x250.png?rev=3751958","banner_2x":"https:\/\/ps.w.org\/arbling-beacon\/assets\/banner-1544x500.png?rev=3751958","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/arbling-beacon\/assets\/icon-128x128.png?rev=3751958","icon_2x":"https:\/\/ps.w.org\/arbling-beacon\/assets\/icon-256x256.png?rev=3751958","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/arbling-beacon\/assets\/screenshot-1.png?rev=3751958","caption":"The settings page before any key is saved: the site key, and the optional crawler reporting key."}],"raw_content":"<!--section=description-->\n<p>People now find stores and services by asking ChatGPT, Perplexity, Gemini, Claude and Copilot. Arbling Beacon shows you that traffic in your Arbling dashboard:<\/p>\n\n<ul>\n<li><strong>Visits from AI assistants.<\/strong> You see which assistant sent each visit and which pages they landed on.<\/li>\n<li><strong>AI crawlers.<\/strong> You see which AI crawlers read your pages and which pages they read. Add the crawler reporting key to turn this on.<\/li>\n<li><strong>WooCommerce products.<\/strong> On a WooCommerce store, product pages also tell Arbling which product was viewed. WooCommerce is optional: the plugin works on any WordPress site.<\/li>\n<\/ul>\n\n<p>The plugin respects your visitors' privacy choices:<\/p>\n\n<ul>\n<li>Nothing loads until you save your Arbling site key.<\/li>\n<li>It follows the visitor's consent through the WP Consent API when your consent banner supports it.<\/li>\n<li>Visit counts made on your server carry no personal data.<\/li>\n<\/ul>\n\n<p>You need an Arbling account to see the numbers. You copy the site key from your Arbling dashboard; the crawler reporting key is optional (see Installation).<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin connects your site to Arbling (https:\/\/arbling.com), the service that shows you the numbers. It sends nothing until you save a key on its settings page (Settings \u2192 Arbling Beacon).<\/p>\n\n<p><strong>1. The Arbling beacon script, once a site key is saved.<\/strong><\/p>\n\n<ul>\n<li><strong>What loads:<\/strong> your pages load <code>https:\/\/api.arbling.com\/ati-beacon.js<\/code>, tagged with your public site key.<\/li>\n<li><strong>What it sends for every page view:<\/strong> the page's path, the host name of the site the visitor came from, and whether that site is an AI assistant. This carries no identifier.<\/li>\n<li><strong>What it adds only when the visitor's consent allows it and your Arbling account has this turned on:<\/strong> for a visit that arrives from an AI assistant, it sends that visit with a random identifier kept in the browser's local storage. Arbling uses the identifier to connect the visit to what the visitor does next. With a WP Consent API banner, the visitor must allow both statistics and marketing.<\/li>\n<li><strong>What it never does:<\/strong> set a cookie.<\/li>\n<li><strong>Where:<\/strong> <code>https:\/\/api.arbling.com\/api\/ati\/visits<\/code>.<\/li>\n<\/ul>\n\n<p><strong>2. Visit counts, once a crawler reporting key is saved.<\/strong><\/p>\n\n<ul>\n<li><strong>What it sends:<\/strong> once a minute, your server sends how many requests each kind of page received in each closed minute. The kinds are home, product, collection and other. Each count says whether the visit came from a browser or something else, and which AI assistant referred it, if any.<\/li>\n<li><strong>What it never sends:<\/strong> IP addresses, browser strings or page addresses.<\/li>\n<li><strong>Where:<\/strong> <code>https:\/\/api.arbling.com\/api\/ati\/v1\/crawl-events<\/code>.<\/li>\n<\/ul>\n\n<p><strong>3. AI crawler reports, once a crawler reporting key is saved.<\/strong><\/p>\n\n<ul>\n<li><strong>When:<\/strong> only when a request comes from a known AI crawler, such as GPTBot or ClaudeBot.<\/li>\n<li><strong>What it sends:<\/strong> the crawler's user agent, its IP address (Arbling uses it to verify the crawler is genuine) and the kind of page. Requests from people are never reported this way.<\/li>\n<li><strong>Where:<\/strong> <code>https:\/\/api.arbling.com\/api\/ati\/v1\/crawl-events<\/code>.<\/li>\n<\/ul>\n\n<p>Arbling's terms of service: https:\/\/arbling.com\/terms\nArbling's privacy policy: https:\/\/arbling.com\/privacy<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install the plugin from Plugins \u2192 Add New, or upload the zip, and activate it.<\/li>\n<li>In your Arbling dashboard, open Settings \u2192 Integrations \u2192 AI Visibility tracking code and copy \"Your site key\".<\/li>\n<li>In WordPress, open Settings \u2192 Arbling Beacon, paste the site key and save.<\/li>\n<li>Optional: AI crawler reports and server-side visit counts need a WordPress connector key from Arbling. If your dashboard does not offer one, ask us at hi@arbling.com. Paste it into \"Crawler reporting key\" on the same page and save.<\/li>\n<li>Open one of your pages, then check your Arbling dashboard. If your Arbling account limits which site addresses may send visits, visits from an address that is not on that list are refused. If no visits appear, write to hi@arbling.com with your site's address.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20woocommerce%3F\"><h3>Do I need WooCommerce?<\/h3><\/dt>\n<dd><p>No. The plugin works on any WordPress site. On a WooCommerce store it also reports which product a visitor viewed.<\/p><\/dd>\n<dt id=\"does%20it%20store%20personal%20data%3F\"><h3>Does it store personal data?<\/h3><\/dt>\n<dd><p>The plugin stores your two keys and per-minute visit counts in your WordPress database. The counts carry no IP address, browser string or page address. Each closed minute's counts are deleted from your database when they are sent to Arbling.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20my%20consent%20banner%3F\"><h3>Does it work with my consent banner?<\/h3><\/dt>\n<dd><p>If your banner supports the WP Consent API, the beacon follows the visitor's choice. The page-view count carries no identifier and is sent for every visit. The identifier that connects a visit from an AI assistant to what happens next is kept only when your Arbling account has it turned on and, with a WP Consent API banner, only when the visitor allows both statistics and marketing.<\/p><\/dd>\n<dt id=\"i%20don%27t%20see%20any%20visits%20in%20arbling\"><h3>I don't see any visits in Arbling<\/h3><\/dt>\n<dd><p>Check that the site key is saved under Settings \u2192 Arbling Beacon. If your Arbling account limits which site addresses may send visits, visits from an address that is not on the list are refused; write to hi@arbling.com with this site's address.<\/p><\/dd>\n<dt id=\"will%20it%20slow%20my%20site%20down%3F\"><h3>Will it slow my site down?<\/h3><\/dt>\n<dd><p>No. The beacon script loads with <code>defer<\/code>, and the server-side calls do not wait for an answer.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.3.2<\/h4>\n\n<ul>\n<li>The settings screen names the current Arbling dashboard paths.<\/li>\n<\/ul>\n\n<h4>0.3.1<\/h4>\n\n<ul>\n<li>WordPress now prints the beacon tag itself, deferred.<\/li>\n<li>Request headers are sanitized before use, and addresses are parsed with WordPress's own function.<\/li>\n<\/ul>\n\n<h4>0.3.0<\/h4>\n\n<ul>\n<li>Counts visits on your server: browser and other requests, with the AI assistant that referred them, sent once a minute with no personal data.<\/li>\n<li>The list of AI assistants is updated.<\/li>\n<\/ul>\n\n<h4>0.2.0<\/h4>\n\n<ul>\n<li>Works on any WordPress site; WooCommerce is optional.<\/li>\n<li>Reports AI crawlers when a crawler reporting key is saved.<\/li>\n<\/ul>\n\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>First release: the Arbling beacon on WooCommerce stores, with consent support.<\/li>\n<\/ul>","raw_excerpt":"See which AI assistants send visitors to your site, and which AI crawlers read it, in your Arbling dashboard.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/384535","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=384535"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/arbling"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=384535"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=384535"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=384535"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=384535"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=384535"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=384535"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}