Google Analytics

You can integrate with Google Analytics to create custom segments based on bot and human traffic, then share data enrichment for further analysis. You can then use this to filter bot segments out of your Google Analytics dashboards, allowing your organization to make better decisions without data contamination.

You can learn how to integrate with Google Analytics with this article.

Prerequisites

• Google Tag Manager (gtag.js) deployed on your application
• Appropriate access in Google Analytics to update your website client-side code
• Score reporting enabled and set to binary with a threshold of 100

Google Analytics configuration

To send data to GA4, you need to create custom dimensions, which let you collect and analyze custom data within Google Analytics.

1. Follow Google’s steps to Create user-scoped custom dimensions.
2. While completing the fields to create the custom dimension, use the following:
   • Dimension name: Enter a name you want to use for this dimension.
   • Scope: Select User.
   • Description: Provide a description if desired.
   • User property: Enter a user property. You will use this value later in Client-side JavaScript integration.
3. Repeat the steps for any additional custom dimensions you need.
4. Follow Google’s steps to Create a custom segment using the custom dimensions you created above. We recommend creating a user segments type of segment.

Client-side JavaScript integration

HUMAN will send an asynchronous event to the client-side environment, containing the result of the bot-or-not decision, as well as any other configured enrichment data. To share this data with Google Analytics, you need to add a new function to the client-side code that receives each of these events, then passes it along to GA4 as an event with custom dimensions.

Below is an example for an implementation for:

• A custom dimension named bot_flag, and
• A data enrichment data point named f_id

1
window.<APPID>_asyncInit = function(px) { // Replace with your application ID
2
  // Event listener for 'score' events
3
  px.Events.on('score', function(score) {
4
    try {
5
      // Send a custom event to GA4 when a 'score' is received
6
      // 'bot_defender_score' is a custom event name you define
7
      // 'score_value' is a custom parameter for this event
8
      gtag('event', 'bot_defender_score', {
9
        'score_value': score,
10
        'event_category': 'Bot_Defender', // Optional: You can categorize events
11
        'event_label': 'Score_Received' // Optional: Label for more detail
12
      });
13
14
      // Also set a user property based on the score
15
      gtag('set', 'user_properties', {
16
        'bot_flag': score // 'bot_flag' is the name of your user-scoped custom dimension in GA4
17
      });
18
19
    } catch (err) {
20
      // Remove if you do not want to log errors in production
21
      console.log("error: " + err);
22
    }
23
  });
24
25
  // Event listener for 'enrich' events
26
  px.Events.on('enrich', function (value) {
27
    try {
28
      const base64Data = value.split(":")[1]; // split value to get the base64 encoded data
29
      const dataStr = atob(base64Data); // base64 decode the enrichment data
30
      const data = JSON.parse(dataStr); // get the data as JSON
31
32
      // Send a custom event to GA4 for enrichment data
33
      // 'bot_defender_enrichment' is a custom event name
34
      gtag('event', 'bot_defender_enrichment', {
35
        'f_id': data['f_id'],
36
        'event_category': 'Bot_Defender',
37
        'event_label': 'Enrichment_Data'
38
      });
39
40
    } catch (err) {
41
      // Remove if you do not want to log errors in production
42
      console.log("error: " + err);
43
    }
44
  });
45
};