Segmentify Integration

Overview

This guide explains how to integrate Hardal analytics with Segmentify using Hardal’s Custom API destination feature. By connecting these platforms, you can use your first-party data collected through Hardal to power Segmentify’s personalization engine for product recommendations, search optimization, and engagement campaigns.

Prerequisites

Before setting up the integration, ensure you have:

An active Hardal account with tracking set up on your website
An active Segmentify account with API access
Your Segmentify API Key and Data Center URL
Basic understanding of both platforms and JSON

Proper integration requires admin access to both platforms. Make sure you have the necessary permissions before beginning.

Understanding Segmentify API Requirements

Segmentify uses a RESTful API that accepts various event types to track user behavior and personalize content. Key concepts to understand:

Segmentify Event Types

Event Name	Description	Segmentify Event Type
Page View	When a user views a page	PAGE_VIEW
Product View	When a user views a product	PRODUCT_VIEW
Basket Operations	Adding/removing products from basket	BASKET_OPERATIONS
Checkout	Various checkout steps	CHECKOUT
User Operations	User login, signup, etc.	USER_OPERATIONS
Custom Event	Any custom user action	CUSTOM_EVENT

Authentication Requirements

Segmentify requires an API key and specific headers for authentication:

API Key (included as a query parameter)
Content-Type: application/json
Accept: application/json
Origin: Your domain

Setting Up Custom API Destination in Hardal

Access Marketing Destinations

Log into your Hardal dashboard
Navigate to Connections
Click “Add Destination”
Select “Custom API” from the template options

Configure Base Settings

Configure the basic destination settings:

{
  "endpoint_label": "Segmentify Integration",
  "endpoint_id": "segmentify-integration",
  "endpoint_url": "https://[YOUR-DATA-CENTER].segmentify.com/add/events/v1.json?apiKey=[YOUR-API-KEY]",
  "request_method": "POST",
  "content_type": "application/json"
}

Replace [YOUR-DATA-CENTER] and [YOUR-API-KEY] with your actual Segmentify data center URL and API key. You can find these values in your Segmentify account under Settings > Integrations.

Add Required Headers

Configure the headers required by Segmentify:

{
  "headers": {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "Origin": "https://yourdomain.com"
  }
}

Replace https://yourdomain.com with your actual website domain.

Mapping Hardal Events to Segmentify Format

The most important part of the integration is correctly mapping Hardal events to the expected Segmentify format. Segmentify expects an array of events in its request body.

Create a separate API destination for each event type you want to track in Segmentify to keep your configuration clean and organized.

Mapping Page View Events

Create Event Mapping

Configure the request format for page view events:

{
  "request_format": [
    {
      "name": "PAGE_VIEW",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "pageUrl": "##page.url##",
      "referrer": "##page.referrer##",
      "category": "##properties.page_category##",
      "subCategory": "##properties.page_subcategory##"
    }
  ]
}

This maps Hardal’s variables (marked with ##variable##) to Segmentify’s expected format.

Set Up Condition

Add a condition to trigger this mapping only for page view events:

In the “Conditions” section, click “Add Condition”
Set “Event Name” equals “page_view”

Make sure your Hardal implementation is sending the appropriate page category values with your page view events. Common values include “Home Page”, “Product Page”, “Category Page”, etc.

Mapping Product View Events

Product views are crucial for Segmentify’s recommendation engine.

Create Event Mapping

Configure the request format for product view events:

{
  "request_format": [
    {
      "name": "PRODUCT_VIEW",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "productId": "##properties.product_id##",
      "title": "##properties.product_name##",
      "url": "##page.url##",
      "image": "##properties.product_image##",
      "category": "##properties.product_category##",
      "brand": "##properties.product_brand##",
      "price": ##properties.product_price##,
      "inStock": "##properties.product_in_stock##"
    }
  ]
}

Set Up Condition

Add a condition where “Event Name” equals “product_view”.

Mapping Add to Cart Events

For basket operations like adding products to cart:

Create Event Mapping

{
  "request_format": [
    {
      "name": "BASKET_OPERATIONS",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "step": "add",
      "productId": "##properties.product_id##",
      "price": ##properties.product_price##,
      "quantity": ##properties.quantity##
    }
  ]
}

Set Up Condition

Add a condition where “Event Name” equals “add_to_cart”.

Mapping Remove from Cart Events

For basket operations like removing products from cart:

Create Event Mapping

{
  "request_format": [
    {
      "name": "BASKET_OPERATIONS",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "step": "remove",
      "productId": "##properties.product_id##",
      "quantity": ##properties.quantity##
    }
  ]
}

Set Up Condition

Add a condition where “Event Name” equals “remove_from_cart”.

Mapping Checkout Events

Checkout events in Segmentify track the conversion funnel with multiple steps.

{
  "request_format": [
    {
      "name": "CHECKOUT",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "step": "view-basket",
      "totalPrice": ##properties.total_price##,
      "currency": "##properties.currency##",
      "cartUrl": "##page.url##",
      "productList": ##properties.product_list##
    }
  ]
}

The product_list should be an array of products in the format:

[
  {
    "productId": "PRODUCT_ID",
    "price": 349.99,
    "currency": "EUR",
    "quantity": 2
  }
]

{
  "request_format": [
    {
      "name": "CHECKOUT",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "step": "customer-info",
      "totalPrice": ##properties.total_price##,
      "currency": "##properties.currency##",
      "cartUrl": "##page.url##",
      "productList": ##properties.product_list##
    }
  ]
}

{
  "request_format": [
    {
      "name": "CHECKOUT",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "step": "payment-info",
      "totalPrice": ##properties.total_price##,
      "currency": "##properties.currency##",
      "cartUrl": "##page.url##",
      "productList": ##properties.product_list##
    }
  ]
}

{
  "request_format": [
    {
      "name": "CHECKOUT",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "step": "purchase",
      "totalPrice": ##properties.total_price##,
      "orderNo": "##properties.order_id##",
      "currency": "##properties.currency##",
      "productList": ##properties.product_list##
    }
  ]
}

The orderNo parameter is mandatory for purchase events and should be unique for each order to avoid duplicate tracking.

Mapping User Operations

User operations help Segmentify personalize experiences based on user identity.

{
  "request_format": [
    {
      "name": "USER_OPERATIONS",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "step": "signup",
      "username": "##properties.username##",
      "fullName": "##properties.full_name##",
      "email": "##properties.email##",
      "phone": "##properties.phone##",
      "gender": "##properties.gender##"
    }
  ]
}

For gender, Segmentify expects ‘M’ for male, ‘F’ for female, or ‘U’ for undefined.

{
  "request_format": [
    {
      "name": "USER_OPERATIONS",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "step": "signin",
      "username": "##properties.username##"
    }
  ]
}

{
  "request_format": [
    {
      "name": "USER_OPERATIONS",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "step": "signout",
      "username": "##properties.username##"
    }
  ]
}

{
  "request_format": [
    {
      "name": "USER_OPERATIONS",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "step": "update",
      "username": "##properties.username##",
      "fullName": "##properties.full_name##",
      "email": "##properties.email##",
      "phone": "##properties.phone##",
      "gender": "##properties.gender##",
      "location": "##properties.location##",
      "segments": ##properties.segments##
    }
  ]
}

The segments parameter should be an array of strings representing user segments, useful for targeting specific customer groups.

Testing the Integration

Validate Configuration

Before activating your integration, validate your configuration:

Wait a while for Hardal to send some events
Check Segmentify for events received

Monitor Events in Segmentify

Log into your Segmentify dashboard
Check the “Real-time Events” section
Verify that events from Hardal are being received correctly

Test Full Conversion Flow

Conduct a complete test from page view through purchase:

Browse your website while monitoring events
View a product
Add it to cart
Complete a test purchase
Verify each step is tracked in Segmentify

Enable the Integration

Once testing is successful:

Return to your Hardal Custom API destination settings
Click “Save Changes”
Monitor the event flow for a few days to ensure stability

Troubleshooting

Best Practices

Data Consistency

Maintain consistent data formats between Hardal and Segmentify:

Use the same product IDs across all platforms
Ensure category hierarchies match between systems
Use consistent naming conventions for user attributes

Performance Optimization

Group related events to minimize API calls
Implement proper error handling
Consider using batch processing for high-volume events

Security Considerations

Never expose your Segmentify API key in client-side code. The Hardal server-side integration ensures your key remains secure.

Regularly rotate your API keys
Implement IP restrictions if possible
Only send necessary data to minimize privacy concerns

Getting Started

Installation

Server-side Hosts

Connections

Analytics

Data Reporting Tools

FAQ

Changelog

Segmentify Integration

Segmentify Integration

Overview

Prerequisites

Understanding Segmentify API Requirements

Segmentify Event Types

Authentication Requirements

Setting Up Custom API Destination in Hardal

Mapping Hardal Events to Segmentify Format

Mapping Page View Events

Mapping Product View Events

Mapping Add to Cart Events

Mapping Remove from Cart Events

Mapping Checkout Events

Mapping User Operations

Testing the Integration

Troubleshooting

Best Practices

Data Consistency

Performance Optimization

Security Considerations

Resources

Getting Started

Installation

Server-side Hosts

Connections

Analytics

Data Reporting Tools

FAQ

Changelog

​Segmentify Integration

​Overview

​Prerequisites

​Understanding Segmentify API Requirements

​Segmentify Event Types

​Authentication Requirements

​Setting Up Custom API Destination in Hardal

​Mapping Hardal Events to Segmentify Format

​Mapping Page View Events

​Mapping Product View Events

​Mapping Add to Cart Events

​Mapping Remove from Cart Events

​Mapping Checkout Events

​Mapping User Operations

​Testing the Integration

​Troubleshooting

​Best Practices

​Data Consistency

​Performance Optimization

​Security Considerations

​Resources

Segmentify Integration

Overview

Prerequisites

Understanding Segmentify API Requirements

Segmentify Event Types

Authentication Requirements

Setting Up Custom API Destination in Hardal

Mapping Hardal Events to Segmentify Format

Mapping Page View Events

Mapping Product View Events

Mapping Add to Cart Events

Mapping Remove from Cart Events

Mapping Checkout Events

Mapping User Operations

Testing the Integration

Troubleshooting

Best Practices

Data Consistency

Performance Optimization

Security Considerations

Resources