=== Call Bullet by AutoThink ===
Contributors: autothinkgroup
Tags: call tracking, phone tracking, attribution, dynamic number insertion, marketing
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.3.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Show Call Bullet tracking numbers to visitors and see which source made the phone ring, with call logs inside WordPress.

== Description ==

Call Bullet is a call tracking and call attribution service for agencies and businesses. This plugin connects a WordPress site to a Call Bullet account and:

* Replaces your configured business phone number (visible text and tel: links, in common UK formats, including content that loads later) with a Call Bullet tracking number from your website pool.
* Leaves every other number and contact detail on the page untouched.
* Shows calls, answered and missed calls, call sources, attribution evidence and tracking health in native WordPress screens.

= How it works =

1. A visitor arrives on your site and sees a tracking number in place of your business number.
2. The visitor calls that number.
3. Call Bullet forwards the call to your real business number.
4. The call, and the source that led to it (for example Google Ads, organic search or social), appears in Call Bullet and in this plugin.

Agencies can connect a client's website by signing in. The website is linked to one client only and can read that client's call data only.

A Call Bullet account is required. Without an install key or sign-in, the plugin does nothing on the front end.

= Screens =

* Overview: calls, answer rate and top sources for the chosen date range.
* Calls: the call log with source, outcome, length and a link to the full call in Call Bullet.
* Attribution: which sources and landing pages led to calls.
* Numbers: each tracking number with impressions, calls and status.
* Tracking health: a checklist showing whether swapping is working on this site.
* Settings: connection, install key and the Number swapping switch.

== Installation ==

1. Create a Call Bullet account at https://callbullet.com and add the business phone number for the website.
2. In WordPress, install and activate the plugin.
3. Open Call Bullet in the admin menu.
4. Connect in one of two ways: click "Sign in with Call Bullet" and choose the client this website belongs to, or paste the install key from Call Bullet → Integrations → WordPress and click Save.
5. Number swapping switches on automatically when you connect. You can switch it off at any time under Settings.
6. Open your website in a private browser window and check the tracking number is shown in place of your business number.
7. Call the tracking number. The call appears under Calls within a minute.

== External Services ==

This plugin connects to the CallBullet service (https://callbullet.com), operated by CallBullet. Nothing is sent until an administrator saves an install key or clicks "Sign in with CallBullet".

1. Number swapping (visitor browser to callbullet.com/api/public/dni/session), on each page view once an install key is saved and swapping is switched on. Sent: install key, a random visitor session token, referrer, landing page URL, current page URL, UTM parameters (source, medium, campaign, term, content), Google click IDs (gclid, gbraid, wbraid), the Google Analytics browser and session IDs read from the site's own _ga cookies (only with consent, only if Google Analytics is installed), and the visitor's consent flag. When a site sets window.CallBulletConsent = false, only the install key and page are used. Used to choose which tracking number to show and to link a later call to the visit.
2. Connecting (your server to callbullet.com/api/public/plugin/exchange), once when you sign in. Sent: a one-time code, this site's home URL and the plugin version.
3. Reports (your server to callbullet.com/api/public/plugin/data), when an administrator opens a CallBullet screen, cached for five minutes. Sent: the site token, the chosen report and date range, and the plugin version.
4. Update checks for copies downloaded directly from callbullet.com only (not the WordPress.org version), after connecting: a request to callbullet.com/api/public/plugin/update-check with no personal data.

Terms: https://callbullet.com/terms
Privacy: https://callbullet.com/privacy

== Frequently Asked Questions ==

= Which numbers are swapped? =
Only the business number configured for the client in CallBullet. Other numbers are never touched.

= Can the client see other agency data? =
No. A connected website can only read the one client it was linked to.

= What happens without a Call Bullet account? =
Nothing. The plugin only loads the number-swap script after an install key is saved or you sign in.

= Does it work with caching plugins? =
Yes. Saving an install key clears common page caches, and numbers are swapped in the visitor's browser, so cached pages still show tracking numbers.

= How do I switch swapping off? =
Open Call Bullet → Settings and turn off Number swapping. Your original number shows again straight away.

= What happens when I uninstall? =
All plugin settings, keys and cached reports are deleted from your database.

== Changelog ==

= 1.3.5 =
* Clearer description and setup instructions.

= 1.3.4 =
* Google Analytics 4: calls can join the visitor's GA4 session, and number-shown / phone-click events are sent through the site's own GA4 tag (consent respected).

= 1.3.3 =
* Tested with WordPress 7.1.

= 1.3.2 =
* Pasting an install key now starts number swapping straight away, and page caches are cleared.
* New Numbers screen with impressions, calls and status for each tracking number.
* Readable secondary buttons.

= 1.3.1 =
* Call Bullet coral and plum branding across every screen.

= 1.3.0 =
* Renamed to Call Bullet by AutoThink with the coloured Call Bullet menu icon.

= 1.2.0 =
* Redesigned Call Bullet screens: stats band, source bars, source trail, health checklist.
* Bryan call summaries and a Listen link on each call.

= 1.1.0 =
* Sign in with CallBullet and choose the client.
* Calls, attribution and tracking health inside WordPress.
* Swap script bundled with the plugin; settings moved to a CallBullet menu.

= 1.0.0 =
* First release: install key and number swapping.
