Consider the use case where the content of your subscription website is free to paying subscribers, and you would like to give non-subscribers a taste of what is in there. To implement this you will have to keep track of the pages that visitors see, how many they have already seen and in what timeframe.
Content Meter listening to the rescue! The Content Meter listener is very flexible in metering visitors and can fire events that will trigger dialogues, e.g. to warn or block visitors when they reach configured limits.
Configuring the listener
Set the "Expire At" number to the number of metered views that should trigger the "views exceeded" dialogue. E.g., setting it to 9 will allow the visitor 8 metered views and the 9th view will trigger a "views exceeded" dialogue. Activate "Meter unique pages only" to increase the view count only for each unique page viewed, viewing the same page twice will not increase the view count. Deactivate the option if you want to have the view count increased even when reloading a page already viewed.
"Reset after" provides two options: "Rolling window" of the number of days you specify, or "Calendar Month".
Activate the "Throw events once per meter reset" to only get events thrown once until the next reset, as opposed to having them thrown every time they occur.
Typically, not all content on a website should be metered. The include and exclude rules allow you to define which content should and which content shouldn't be increasing the metered view count.
Exclude rules define when counting views should be skipped - either for all following views, or the first X views when the rule is matched. Exclude rules take precedence over include rules.
In the example above metered views aren't counted for visitors coming from Google or Facebook.
Dialogues can display profile property values. The Content Meter can store view numbers in profile properties so they can be used in the text of a dialogue, e.g. in a sentence like "You have X free articles left".
Assign the profile properties you want to contain the view metering values.
The Content Meter will throw specific events so your dialogues can trigger on them. Three extra events "Bottom Range", "Middle Range" and "Top Range" will be thrown as well, based on the number of views you set.
Events on the Dialogue When Tab
With Content Meter listening active, dialogues will have lots of Content Meter options available on the "When" tab:
For example, the event activated above will make sure the dialogue appears on the last allowed metered view, just before the "Views Exceeded" event kicks in on the next metered view. Below an overview of the events:
|Content Meter View Count Events|
|First View||This event will be thrown on the visitor's first view of a metered article, either for a first visit, or after a reset on a repeat visit.|
|View 2, ..., View 9||This event will be thrown on the second, third, etc. view of a metered article, taking into account whether or not only unique pages should be metered. Note that the last allowed view event will not be thrown as "View X", but as "Last View" described below.|
|Last View||This event will be thrown on the last allowed view (i.e. view count is lower than the "Expire at" setting) of a metered article, taking into account whether or not only unique pages should be metered.|
|Views Exceeded||This event will be thrown when the view count of metered articles is equal to or higher than the "Expire at" setting.|
|Content Meter Status Events|
|Already Viewed Article||This event is thrown when an article has already been metered and viewed.|
|Excluded Article||This event is thrown when an article is being excluded from metering.|
|Content Meter Extra Events|
|Bottom Range||This event is thrown when the view count is in the Bottom Range Event numeric range. E.g. "Between 1 and 3 views" encompasses view counts of 1, 2 and 3.|
|Middle Range||This event is thrown when the view count is in the Middle Range Event numeric range. E.g. "Between 4 and 6 views" encompasses view counts of 4, 5 and 6.|
|Top Range||This event is thrown when the view count is in the Top Range Event numeric range. E.g. "Between 7 and 9 views" encompasses view counts of 7, 8 and 9.|
Events may be thrown simultaneously, e.g. it is possible that the events "View 2", "Already Viewed Article" and "Bottom Range" are all thrown at the same time.
The Content Meter Listener is a custom plugin.