Skip to content

Membership Custom Segmentation Attributes

Custom Segmentation Attributes allow retailers to bring their own customer metadata into the Lobyco platform and use it directly in the Segment Builder — without requiring any Lobyco engineering involvement.

Overview

Retailers operating on the Lobyco platform collect a wide range of customer data specific to their business — loyalty segments, store preferences, employee types, join dates, and more. The Membership Properties and Segmentation Attributes feature provides a generic, scalable way to bring this data into Lobyco so marketers can act on it. Retailers can send member custom properties Lobyco, which will validate, store, and expose them across the platform. Marketers can then use these attributes directly in the Segment Builder to build precise customer segments and orchestrate personalized marketing journeys.

  • Supported data types: String, Number, Date, Boolean (true/false)

  • Limit: Up to 30 custom attributes per retailer

Note: The custom attributes available depend on what has been defined and imported through the integration endpoints. Not all retailers will have the same custom attributes, and some retailers may have none. Contact your Lobyco integration team for more details.

Setup Guide

Step 1 — Define Custom Property Definitions

Before importing any custom properties, you must define the property definitions using the following endpoint:

POST member/v1/custom-properties/definitions

This step is mandatory. Custom properties cannot be imported until their definitions have been created.

Step 2 — Import Custom Properties

Once definitions are in place, populate custom properties for your members using any of the following methods:

Method Endpoint Description
Bulk import POST member/v1/members/import Import custom properties for multiple members at once
Update existing member PATCH /member/v1/members/{memberId} Update custom properties for a specific member
Create new member POST /member/v1/members Create a new member with custom properties included

Viewing Custom Properties in the Admin Tool

Once custom properties have been imported for a member, they are visible in the Member Admin page in the admin tool. Navigate to the member's profile and open the Overview tab — a Custom Properties section will appear listing all imported attributes and their current values for that member.

Data Availability After Import

Newly imported custom properties do not become available in the Segment Builder immediately. They are exposed after the data platform refresh is executed.

The time between refreshes depends on the client configuration and can be up to one day. Plan imports accordingly to ensure data is available when needed for segmentation.

Using Custom Attributes in Segment Builder

Once the setup is complete, custom attributes are available to marketeers in the Segment Builder under the Membership – Custom category.

  1. Open the Segment Builder

  2. Expand the Membership – Custom category in the attributes panel — or use the search field to find a specific attribute

  3. Select the desired attribute and apply your filter conditions

  4. Custom attributes support the following operators depending on their data type:

Data Type Supported operators
String Equal, Not equal, Contains, In, Not in
Number Less than, Less or equal, Equal, Greater than, Greater or equal, Between
Date Less than, Less or equal, Equal, Greater than, Greater or equal, Between
Boolean Yes, No

Enriching Member Segments with Custom Attributes

Custom attributes can also be used to enrich member segments in an orchestration journey. When adding an Enrich block, custom attributes are available as data elements under the Membership – Custom source, alongside standard membership attributes.

This allows marketers to include custom attribute values — such as a member's nickname, loyalty tier, or any other imported property — as part of the data exported or passed downstream in a journey (e.g. to a Feed, Email).