-
Let’s break down the task we need to accomplish. The “AnalyticsService” will be receiving the slug of a book and it needs to communicate with Google Analytics to get the view count. For this, you will have to use the Google Analytics Reporting API v4.
When you start creating your AnalyticsService, you will need to first initialize a service object with your credentials which you can store as environment variables. These credentials would be your API key, client id and client secret that you can get from the Google Cloud Console. You will need to ensure you have the reporting API enabled for your project.
After initializing your service object, you would then be calling the ‘batchGet’ function on the service object inside your “receiveDataFromAnalytics” method. You would input a ‘GetReportsRequest’ object where you would set the ‘viewId’, ‘dateRanges’, ‘metrics’, and ‘dimensions’ in a ‘ReportRequest’ object and put that inside a list. The ‘viewId’ would be your Google Analytics view ID, ‘dateRanges’ would determine the range of dates you want the data from (you can set it to ‘allTime’ if you want the total views), and ‘metrics’ and ‘dimensions’ would depend on what you are trying to get. In your case, for ‘metrics’ you would set the ‘expression’ as ‘ga:pageviews’ and in ‘dimensions’, you would set the ‘name’ as ‘ga:pagePath’. This basically means that you are asking for a report of the page views per page path.
Next, you would read the response. This would be in the form of a list of report objects and each object would contain columnHeader and data properties. You can thus loop through the list and get your measurements from the ‘metrics’ array in the ‘rows’ array in the ‘data’ property.
Remember to catch any possible exceptions that may arise due to failure of the API call or in case the slug doesn’t exist in your Google Analytics data. It’s always good to have substantial logging in place so you can understand where things may have gone wrong if they do.
Unfortunately, I don’t have a tutorial to recommend, but I suggest you keep an eye on the Google Analytics API official developers documentation as Google keeps it updated. I understand that it may be typical to grasp at first, but it would get simpler as you explore more. Stack Overflow is also a useful resource for related queries.
