How are Views, Unique Views, and Clicks counted via API?

Views and Unique Views

When retrieving a post for a specific user using the API, Views and Unique Views are automatically tracked based on the user_id passed in the request. This means that each time a post is fetched for a given user_id, the system counts the view, and if it’s the first time the user is viewing the post, it counts as a unique view.

• No additional endpoint is required for tracking views and unique views. These are automatically recorded when you request the post for a specific user.

Clicks

To track Clicks, an additional step is required. You need to enable click tracking by passing the traceableLinks=true parameter in the API request. This ensures that clicks on links or CTAs within the post are recorded in the analytics.

Note: To track clicks on both the Call to Action (CTA) buttons and Links within the content of your posts, ensure that the links are converted into a traceable format.

When the traceableLinks=true parameter is used in the API request, all links (including CTA and embedded links) will be tracked. If a user clicks on any of these traceable links, the opened URL will be recorded, and a click entry will be logged in your analytics.

We should send the information through the API in JSON format in the request body, as illustrated below:

{ "title": "Title of the post.", 
          "content": "Content of the post.", 
          "contentHtml": "<p>Content of the post.</p>", 
          "language": "EN", "category": "Category", 
          "linkUrl": "https://www.getbeamer.com/", 
          "linkText": "Click here!", 
          "images": [ 
           "https://app.getbeamer.com/pictures?id=123" 
            ] 
         }

Users with Views:

To track users with views, you should initialize the relevant API to record and retrieve this information.

Important Implementation Note:

To ensure that views, unique views, and clicks are correctly tracked, make sure to always pass the user_id parameter in the API request. This allows the system to accurately track and calculate the analytics for each user.