Zeotap

Customer intelligence platform for identity resolution, audience segmentation, and data activation with a privacy-first approach.

Prerequisites

Complete these steps in Zeotap before configuring Signal.

Access your Zeotap account

Log in to the Zeotap Unity platform at unity.zeotap.com. If you do not have an account, contact your Zeotap representative.

Determine your region

Zeotap operates in multiple regions. Your region was assigned during account setup and determines the API endpoint:

Region	API URL	Value for Signal
EU	`https://api.zeotap.com`	`eu`
US	`https://api-us.zeotap.com`	`us`

Check with your Zeotap account manager if you are unsure of your region.

Create an integration

Navigate to Integrations (or Data Sources) in the Zeotap Unity dashboard. Click Create Integration and select Server-Side API as the type. Give it a name (e.g. “Datafly Signal Events”) and configure the event types you want to receive.

Get your Write Key

After creating the integration, Zeotap will display a Write Key. This key authenticates events sent to this specific integration. Copy it immediately.

Note your API URL

The API URL for your integration is displayed on the integration detail page. This may include your region-specific base URL plus integration-specific path components. Copy the full URL.

Configure Event Types

In the integration settings, specify which event types you want to accept. Common choices include:

Track — for custom behavioural events
Identify — for identity and profile data
Page — for page view events

Configuration

Field	Type	Required	Description
`api_url`	string	Yes	The Zeotap API URL for your integration. Found on the integration detail page.
`region`	select	Yes	Your Zeotap region (`eu` or `us`). Determines the base API endpoint.
`write_key`	secret	Yes	The write key for your Zeotap integration. Generated when creating an integration.
`event_type`	string	Yes	The default event type for ingested events (e.g. `track`, `identify`).

Signal Setup

Quick Setup

Navigate to Integrations in the sidebar.
Open the Integration Library tab.
Find Zeotap 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/zeotap/install \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Zeotap",
    "variant": "default",
    "config": {
      "api_url": "https://api.zeotap.com/v1/ingest",
      "region": "eu",
      "write_key": "xxxxxxxxxxxxxxxxxxxx",
      "event_type": "track"
    },
    "delivery_mode": "server_side"
  }'

Event Mapping

Signal events are mapped to Zeotap API calls as follows:

Signal Event	Zeotap Concept	Notes
`page`	Page event	URL, title, and referrer sent as page event properties for audience analytics
`track`	Track event	Event name and properties forwarded as Zeotap track events for segmentation
`identify`	Identify event	User identifiers and traits sent for identity resolution and profile enrichment

Zeotap performs privacy-first identity resolution across events. Include deterministic identifiers (hashed email, phone, customer ID) for accurate identity graph building.

Delivery

Events are delivered server-side from your Datafly Signal infrastructure directly to the Zeotap 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 the Zeotap Unity dashboard, navigate to your integration and check the Activity or Event Log for recently received events.
Navigate to Audiences and verify the test user’s profile was created or updated with the expected attributes.
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 write key	Verify the write key on the integration detail page in Zeotap Unity and update the config
`404 Not Found`	Incorrect API URL	Verify the API URL on the integration detail page. Ensure it includes the correct region base URL
`400 Bad Request`	Invalid event type	Ensure the `event_type` matches one of the types configured in your Zeotap integration
Wrong region	Region mismatch	Check with your Zeotap account manager and ensure the `region` config matches
Identity not resolved	Missing identifiers	Include at least one deterministic identifier (hashed email, phone) for Zeotap identity resolution

Visit Zeotap documentation for full API reference and integration setup details.

Treasure Data Data Warehouses (Overview)