Designed2Use GA Views

Yükleme

1. Upload the designed2use-ga-views folder to /wp-content/plugins/, or install through the Plugins screen.
2. Activate the plugin.
3. In Google Cloud, create or select a project and enable the Google Analytics Data API for it (APIs & Services → Library → search “Google Analytics Data API” → Enable).
4. Create a service account, add a JSON key, and download it.
5. In Google Analytics, open Admin → Property access management and grant the service account’s email the Viewer role on your GA4 property.
6. Go to Settings → GA Views, paste the service-account JSON, enter your numeric GA4 Property ID, choose your options, and save.
7. Add [d2ugav_pageview] to a post/template, or set Automatic display to append it to post content.
8. Optionally click Refresh counts now to queue a batch of posts for an immediate background refresh.

Advanced: keeping the key out of the database

Instead of pasting the JSON into the settings field, define one of these in wp-config.php:

define( 'D2UGAV_CREDENTIALS_JSON', '{ ...service account json... }' );
define( 'D2UGAV_CREDENTIALS_PATH', '/absolute/path/outside/webroot/key.json' );

Diagnosing unexpected counts

If a count is not what you expect, open Settings → GA Views Diagnostics, pick a post, and click Run live test. It runs a live GA4 report and shows the exact URL it matched, the request, the HTTP status, the rows returned, the computed count, and the raw GA4 response — so you can see immediately whether the issue is a URL mismatch, an event-name mismatch, a date range, or credentials.

For a logged trace of every request (including front-end renders and background refreshes), enable Debug logging on the settings page. The trace is written to your PHP error log and never includes credentials or access tokens; turn it off again when finished. The same logging can be forced on site-wide with define( 'D2UGAV_DEBUG', true ); in wp-config.php.