Segment

Configuration guide for ingesting Segment.com events into Recurly Engage via AWS Lambda and using them as usage trackers.

Overview

Required plan

This feature or setting is available to all customers on any Recurly Engage subscription plan.

Prerequisites & limitations

  • An AWS account with permissions to create and configure Lambda functions and roles.
  • Access to your Segment workspace with permission to add destinations.
  • Segment’s Lambda destination requires Node.js 14+ runtime.

Definition

By routing Segment events through an AWS Lambda function, Recurly Engage ingests those events as custom usage traits (e.g., page views, button clicks), enabling you to target prompts based on real user behavior tracked in Segment.

Key benefits

  • No additional instrumentation: Leverage your existing Segment calls—no new SDKs or code changes required.
  • Real-time targeting: Segment events can be available in Recurly Engage within minutes for immediate prompt personalization.
  • Flexible event mapping: Track any Page, Screen, or custom Track call as a usage trait without rebuilding your analytics stack.

Key details

Integrating with Segment.com

Recurly Engage allows you to ingest Segment.com events and target your users according to your existing Page (web), Screen (mobile), and Track calls. This article explains how to add us as a destination via Amazon Lambda.

  1. Login to Segment.

  2. Go to the correct app workspace.

  3. Add a new destination.

  4. Type lambda in the search box and click the found tile.

  5. Click "Configure Amazon Lambda".

  6. Select your app and click "Confirm Source".

  7. Now go to Usage Tracking and locate the credentials to enter.

  8. Copy over the Region, Role Address and Lambda ARN values. Make sure to provide the read-only External ID to your customer success manager as the final step. Note that Client Context and Log Type do not need any special configuration.

Note: Segment data can take up to one hour before it appears in Recurly Engage.

Adding a new tracker

  1. Go to Settings > Usage Tracking > Segment > Add New Tracker.

  2. Select a Segment event.

  3. Click Submit.

  4. Go to Segments > New Segment and choose the Usage tab.

  5. Under Usage, select your newly ingested Segment trait to target prompts based on those events.