Additional GA4 settings

1. Pass the Parameter to dataLayer: For each event or user property, pass the relevant parameter (e.g., user_id, ip_address, ever_paid, is_first_purchase etc.) to your dataLayer.

2. Send the parameter to Google Analytics via Google Tag Manager (GTM) or gtag.js:
• For GA4 via Tag Manager:
• Tracking user properties:
1. If you don’t already use a Google Tag: Event Settings variable, create one.

2. Under the User Properties section of your Google Tag, add a new row with the Parameter and the corresponding Value (the Data Layer variable you created).
3. Select the created Event Settings Variable in each GA4 configuration and event tag.

• Tracking event parameters:
1. Open your GA4 event tag that tracks conversions.
2. In the Event Parameter section, add a new row with the Parameter and the corresponding Value (the Data Layer variable you created).

• For GA4 using gtag.js: Add the parameter to the appropriate command in your measurement code:
• Tracking user properties:

javascript
gtag('config', '<TAG_ID>', {
  '<parameter_name>': '<parameter_value>'
});

• Tracking event parameters:

javascript
gtag('event', '<event_name>', {
  '<parameter_name>': '<parameter_value>'
});

1. Config parameter - User ID (user_id)
Pass a unique user ID after login to track users across sessions on different devices.
• Example for gtag.js:

javascript
gtag('config', 'STREAM_ID', {
  'user_id': 'USER_ID' 
});

2. User property - IP Address (ip_address)
Collect the user's IP address. Please note that collecting a user's IP address should only be done after obtaining their explicit consent.
• Example for gtag.js:

javascript
gtag('config', 'STREAM_ID', {
  'user_properties': {
    'ip_address': 'IP_ADDRESS'
  }
});

3. User property - Ever Paid (ever_paid)
Track whether a user has ever converted with a true or false flag.
This parameter is necessary freemium subscription based businesses where users can login to the platform on the same website where they can convert, it’s necessary to be able to differentiate all actions of converted customers.
• Example for gtag.js:

javascript
gtag('config', 'STREAM_ID', {
  'user_properties': {
    'ever_paid': '<true or false>'
  }
});

4. Event parameter - First-Time Purchase (is_first_purchase)
Indicate whether the event is a first-time or repeat conversion.
• Example for gtag.js:

javascript
gtag('event', '<event_name>', { 
  'is_first_purchase': '<true or false>'
});

1. Go your GA4 property’s Admin settings.

2. In the Data display section, select Custom definitions.

3. Click on Create custom dimension.

4. Set the Scope to User.

5. Depending on the property you are setting up, use these settings:
• ip_address:
• Dimension name: IP Address
• Description: User’s IP Address
• User property: ip_address
• ever_paid:
• Dimension name: Ever Paid
• Description: Flag indicating if the user has ever paid
• User property: ever_paid
• isBot:
• Dimension name: Is Bot
• Description: Flag indicating if the user is a bot
• User property: isBot

6. Click Save.

1. Inside your Google Tag Manager go to Tags, and click New:

2. Name the tag SegmentStream SDK, and choose the Custom HTML tag type:

3. Enter the following code and choose All Pages in the Firing Triggers option:



html
<script async src="https://cdn.segmentstream.com/js/segmentstream.min.js"></script>

1. Go to Triggers, and click New:

2. Name the trigger as it suits you, for example Event - nonIdle, and choose the Custom Event trigger type:

3. Enter nonIdle in the Event name field, which is the name of the event pushed into the dataLayer by the SDK script. It should look like this:

4. In order to collect the non-idle time, we have to create a new variable. Go to Variables, click New:

5. Name the variable as nonIdleTimeElapsed, and select the Data Layer Variable type:

6. Enter nonIdleTimeElapsed in the Data Layer Variable Name field, your variable should look like this:

7. Go to Tags, click New:

8. Choose GA4 Event tag type.

9. Enter the Measurement ID used by your Google Tag.

10. Set Event - nonIdle as the trigger.

11. Enter the settings:
• Event Name: non_idle
• Event Parameters:
• value - {{nonIdleTimeElapsed}}

1. Go to Triggers, and click New:

2. Name the trigger as it suits you, for example Event - botDetected, and choose the Custom Event trigger type:

3. Enter botDetected in the Event name field, which is the name of the event pushed into the dataLayer by the SDK script. It should look like this:

4. Go to Variables, click New:

5. Name the variable as isBot, and select the Data Layer Variable type:

6. Enter isBot in the Data Layer Variable Name field, your variable should look like this:

7. Go to Tags, click New:

8. Choose GA4 Event tag type.

9. Enter the Measurement ID used by your Google Tag.

10. Set Event - botDetected as the trigger.

11. Enter the settings:
• Event Name: bot_detected
• User Properties:
• isBot - {{isBot}}

12. Optional - Create an isBot user level dimension by following our guide - Additional GA4 settings.

• Enable the collect_activity module (used for sending the non_idle event).

• Disable the click_id_propagation module (used for attributing users browsing via in-app browsers).

• Disable the enable_bot_detection module (used for identifying bots).

html
<script>
  window.segmentstream_sdk_settings = {
    collect_activity: true, // Enable activity event tracking
    click_id_propagation: false, // Disable attribution improvement
    enable_bot_detection: false // Disable bot detection
  };
</script>

<script async src="https://cdn.segmentstream.com/js/segmentstream.min.js">
</script>