• Documentation >
• Users >
• User grouping >
• Segment API

Segment API

Segments enable you to profile the content displayed to specific users.

To manage Segments, use the SegmentationService.

Getting Segment information

To load a Segment Group, use SegmentationService::loadSegmentGroupByIdentifier(). Get all Segments assigned to the group with SegmentationService::loadSegmentsAssignedToGroup():

        $segmentGroup = $this->segmentationService->loadSegmentGroupByIdentifier('custom_group');

        $segments = $this->segmentationService->loadSegmentsAssignedToGroup($segmentGroup);

        foreach ($segments as $segment) {
            $output->writeln('Segment ID: ' . $segment->id . ', name: ' . $segment->name);

Similarly, you can load a Segment in a group by using SegmentationService::loadSegmentIdentifier():

        $segment = $this->segmentationService->loadSegmentByIdentifier('segment_1');

Checking assignment

You can check whether a User is assigned to a Segment with SegmentationService::isUserAssignedToSegment():

        $output->writeln((
            $this->segmentationService->isUserAssignedToSegment($user, $segment)
            ? 'The user is assigned to the segment.'

Assigning Users

To assign a User to a Segment, use SegmentationService::assignUserToSegment():

        $this->segmentationService->assignUserToSegment($user, $segment);

Creating Segments

Each Segment must be assigned to a Segment Group.

To create a Segment Group, use SegmentationService::createSegmentGroup() and provide it with a SegmentGroupCreateStruct:

        $segmentGroupCreateStruct = new SegmentGroupCreateStruct([
            'name' => 'Custom Group',
            'identifier' => 'custom_group',
            'createSegments' => [],
        ]);

To add a Segment, use SegmentationService::createSegment() and provide it with a SegmentCreateStruct, which takes an existing group as one of the parameters:

        $segmentCreateStruct = new SegmentCreateStruct([
            'name' => 'Segment 1',
            'identifier' => 'segment_1',
            'group' => $newSegmentGroup,
        ]);

Updating Segments

To update a Segment or a Segment Group, use SegmentationService::updateSegment() or SegmentationService::updateSegmentGroup() and provide it with SegmentUpdateStruct or SegmentGroupUpdateStruct, respectively.

Deleting Segments

To delete a Segment or a Segment Group, use SegmentationService::removeSegment() or SegmentationService::removeSegmentGroup(), respectively:

$this->segmentationService->removeSegmentGroup($group);