Setup

1. Install and activate Open Web Analytics from Plugins > Add New.
2. Go to OWA > Settings.
3. Choose the OWA Server Version.
4. Enter the OWA Endpoint: your OWA server's URL (its OWA_PUBLIC_URL). Saving checks that OWA answers there and stores the URL it answers at, after any redirect, with a trailing /. Without https:// or http://, https is tried first, then http. If OWA does not answer, nothing is saved.
5. Enter the credentials:
   • 1.x: the API Key (OWA: Settings > Users > Edit) and the Secret Auth Key (OWA_AUTH_KEY in the server's owa-config.php).
   • 2.x: an Application Password (OWA: My Preferences > Application Passwords). A read-only password is enough.
6. Save. The Observation Profile list appears once OWA accepts the credentials. If OWA refuses them, the page shows OWA's error instead.
7. Select the Observation Profile to track and save again. The plugin stores its site ID; in 1.x the field is labeled Website ID.

The tag is added once Enable OWA is on and the endpoint and Observation Profile are saved. Notices at the top of the settings page list what is still missing.

With 2.x, Configure this Observation Profile's tracking tag in OWA opens the Observation Profile's tracker options on the OWA server.

Requirements

• WordPress 5.2+, PHP 8.2+.

• The theme calls wp_head().

• 2.x over http: application passwords are sent only over https. To use an http OWA server, turn off Application Passwords Need HTTPS on the server and add this to a must-use plugin or the theme:

  add_filter( 'owa_wp_sdk_config', fn( $config ) => [ 'allow_insecure_app_password' => true ] + $config );