Skip to main content

​
Insider Integration

Send user events and attributes from Hardal to Insider’s Unified Customer Database (UCD) for personalization and customer engagement.
Make sure to check the partner’s website and API documentation for the most up-to-date information and configurations.

​
Setup

1

Get Insider Credentials

Get your Partner Name (from dropdown next to username) and Request Token from Insider Integration Settings
2

Add Destination

Go to Hardal dashboard → Marketing Destinations → “Add Destination” → Select “Custom API”
3

Configure Endpoint

{
  "endpoint_url": "https://unification.useinsider.com/api/user/v1/upsert",
  "request_method": "POST",
  "content_type": "application/json"
}
4

Add Authentication

{
  "headers": {
    "X-PARTNER-NAME": "your_partner_name",
    "X-REQUEST-TOKEN": "your_api_token"
  }
}
5

Set Request Format

{
  "users": [
    {
      "identifiers": {
        "email": "##user.email##",
        "uuid": "##user_id##",
        "custom": {
          "hardal_id": "##user_id##"
        }
      },
      "attributes": {
        "email_optin": "##user.email_optin##",
        "name": "##user.name##",
        "country": "##user.country##",
        "language": "##user.language##",
        "custom": {
          "source": "hardal_analytics"
        }
      },
      "events": [
        {
          "event_name": "##event_name##",
          "timestamp": "##created_at##",
          "event_params": "##properties##"
        }
      ]
    }
  ]
}

​
Event Examples

Purchase Event: 
{
  "users": [
    {
      "identifiers": {
        "email": "##user.email##",
        "uuid": "##user_id##"
      },
      "events": [
        {
          "event_name": "purchase",
          "timestamp": "##created_at##",
          "event_params": {
            "product_id": "##properties.product_id##",
            "name": "##properties.product_name##",
            "unit_price": "##properties.price##",
            "currency": "##properties.currency##",
            "quantity": "##properties.quantity##"
          }
        }
      ]
    }
  ]
}
Registration Event: 
{
  "users": [
    {
      "identifiers": {
        "email": "##user.email##",
        "uuid": "##user_id##"
      },
      "events": [
        {
          "event_name": "registration",
          "timestamp": "##created_at##",
          "event_params": {
            "method": "##properties.registration_method##"
          }
        }
      ]
    }
  ]
}

​
Available Variables

  • ##user.email## - User email
  • ##user_id## - User identifier
  • ##event_name## - Event name
  • ##created_at## - Event timestamp
  • ##properties## - Event properties
  • ##user.name## - User name
  • ##user.country## - User country
  • ##user.language## - User language