Lytics

Customer data platform specialising in real-time behavioural scoring, audience building, and first-party data activation.

Prerequisites

Complete these steps in Lytics before configuring Signal.

Access your Lytics account

Find your Account ID

Navigate to Account > Account Settings. Your Account ID is displayed on this page. Copy it for use in Signal configuration.

Create a data stream

Navigate to Data > Data Streams and click Create Stream. Give the stream a descriptive name (e.g. “Datafly Signal Events”). Select Server-side as the stream type. After creation, note the Stream Name exactly as displayed — this is case-sensitive.

Generate an API token

Go to Account > API Tokens and click Create Token. Provide a name (e.g. “Datafly Signal”) and assign data write permissions. Copy the token immediately.

Configuration

Field	Type	Required	Description
`api_token`	secret	Yes	Your Lytics API token. Generated in Account > API Tokens.
`account_id`	string	Yes	Your Lytics account ID. Found in Account > Account Settings.
`stream_name`	string	Yes	The Lytics data stream name. Must match an existing stream (case-sensitive).

Signal Setup

Quick Setup

Navigate to Integrations in the sidebar.
Open the Integration Library tab.
Find Lytics or filter by CDP.
Click Install, and fill in the required fields with the credentials gathered above.
Click Install Integration to create the integration with a ready-to-use default configuration.

API Setup

curl -X POST http://localhost:8084/v1/admin/integration-catalog/lytics/install \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Lytics",
    "variant": "default",
    "config": {
      "api_token": "xxxxxxxxxxxxxxxxxxxx",
      "account_id": "1234",
      "stream_name": "datafly_events"
    },
    "delivery_mode": "server_side"
  }'

Event Mapping

Signal events are mapped to Lytics API calls as follows:

Signal Event	Lytics Concept	Notes
`page`	Data stream event	Page view data sent as a stream event with URL, title, and referrer properties
`track`	Data stream event	Event name and properties forwarded to the specified Lytics data stream
`identify`	User profile update	Traits merged into the Lytics user profile for audience segmentation

Lytics builds user profiles from stream data using identity resolution. Include consistent identifiers (email, user ID) for accurate profile stitching and behavioural scoring.

Delivery

Events are delivered server-side from your Datafly Signal infrastructure directly to the Lytics API. No client-side scripts are loaded for this integration.

Testing

After installing the integration, trigger a test event from your website or via the Signal event API.
In Lytics, navigate to Data > Data Streams and select your stream. Check the stream activity to verify events are being ingested.
Search for the test user under Users to verify profile creation and behavioural data.
In Signal, check the Live Events view to confirm the event was delivered with a 200 response status.

Troubleshooting

Symptom	Possible Cause	Resolution
`401 Unauthorized`	Invalid API token	Regenerate the token in Lytics Account > API Tokens and update the integration config
`404 Not Found`	Incorrect stream name	Verify the stream name exactly matches (case-sensitive) the stream in Lytics Data > Data Streams
`400 Bad Request`	Invalid account ID	Verify the account ID in Lytics Account > Account Settings
Events received but user not created	Missing identifiers	Include at least one identifier (email, user ID) in events for Lytics profile stitching
Data not appearing in audiences	Audience rules mismatch	Ensure your audience segment rules match the event properties being sent

Visit Lytics documentation for full API reference and data stream configuration details.

Iterable Movable Ink