Feature: Track Views via JS

[cballenar]

Problem

When working with a page that alternates content and ads, caching the content in the page leads to the ads being rendered once. Since the counting of the views occurs at rendering, views of the cached content are not counted.

Solution

• Provide users a way to track views via JS.
• This should disable ad view counts on render

Details of PR

• Since we don't yet have a global settings panel for AdWizard, I'm tracking this setting via an ENV variable, AW_TRACK_VIA_JS. It'd be great to have this more easily accessible. If this is set to false, the current behavior of AdWizard is used; otherwise it disables view tracking on render and adds an onload attribute to the ad configuration that will trigger the view tracking.
• actionView controller was added accepting an ID and returning the equivalent response as actionClick
• view method is added to the js to send view requests to the controller. This method allows passing a boolean to define if ad views are tracked oncePerPage. This started as a way to prevent accidental double tracking of views in a single page but can also be used the other way around (say if an ad enters the viewport multiple times?). It is configured to track once by default.
• Documentation was added detailing the default and alternate way of tracking views.

[cballenar]

@lindseydiloreto I'd be happy to get your thoughts on this or help with further changes to bring it more in line with the product if needed.

[lindseydiloreto]

This is a great idea, thanks for submitting it! I'll take a look and merge everything shortly. 👍

[lindseydiloreto]

This is now available in v3.4.0 (for Craft 4) and v4.1.0 (for Craft 5). Thanks again for this awesome contribution! 🍺