Skip to content

Conversation

JasonZigelbaum
Copy link

Added documentation for the Zigpoll source.

@JasonZigelbaum JasonZigelbaum requested a review from a team as a code owner August 27, 2025 01:09
@forstisabella forstisabella added the new-integration Added a new source or destination label Sep 2, 2025
Comment on lines +1 to +3
`---
title: Zigpoll Source
---
Copy link
Contributor

@forstisabella forstisabella Sep 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
`---
title: Zigpoll Source
---
---
title: Zigpoll Source
id: h00x3Ep5el
---

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @forstisabella h00x3Ep5el

2. Search for "Zigpoll" in the Sources Catalog, select Zigpoll, and click **Add Source**.
3. On the next screen, give the Source a name and configure any other settings.

- The name is used as a label in the Segment app, and Segment creates a related schema name in your warehouse. The name can be anything, but we recommend using something that reflects the source itself and distinguishes amongst your environments (e.g., Zigpoll_Prod, Zigpoll_Staging, Zigpoll_Dev).
Copy link
Contributor

@forstisabella forstisabella Sep 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- The name is used as a label in the Segment app, and Segment creates a related schema name in your warehouse. The name can be anything, but we recommend using something that reflects the source itself and distinguishes amongst your environments (e.g., Zigpoll_Prod, Zigpoll_Staging, Zigpoll_Dev).
- The name is used as a label in the Segment app, and Segment creates a related schema name in your warehouse. The name can be anything, but Segment recommends using something that reflects the source itself and distinguishes amongst your environments (for example, Zigpoll_Prod, Zigpoll_Staging, or Zigpoll_Dev).


## Stream

Zigpoll uses Segment’s stream Source component to send event data. It uses the `track` and `identify` methods to send data to Segment. These events are then available in any destination that accepts server-side events, and in a schema in your data warehouse, so you can query using SQL.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Zigpoll uses Segment’s stream Source component to send event data. It uses the `track` and `identify` methods to send data to Segment. These events are then available in any destination that accepts server-side events, and in a schema in your data warehouse, so you can query using SQL.
Zigpoll uses Segment’s stream Source component to send event data. It uses the Track and Identify methods to send data to Segment. These events are then available in any destination that accepts server-side events and as a schema in your data warehouse that you can query using SQL.


Zigpoll uses Segment’s stream Source component to send event data. It uses the `track` and `identify` methods to send data to Segment. These events are then available in any destination that accepts server-side events, and in a schema in your data warehouse, so you can query using SQL.

The default behavior is for Zigpoll to pass the survey participant’s unique ID as the `userId`. If a participant’s email is available, Zigpoll also passes it as an identifier. If no `userId` is available, Zigpoll will pass the email as the `anonymousId`.
Copy link
Contributor

@forstisabella forstisabella Sep 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The default behavior is for Zigpoll to pass the survey participant’s unique ID as the `userId`. If a participant’s email is available, Zigpoll also passes it as an identifier. If no `userId` is available, Zigpoll will pass the email as the `anonymousId`.
The default behavior is for Zigpoll to pass the survey participant’s unique ID as the `userId`. If a participant’s email is available, Zigpoll also passes it as an identifier. If no `userId` is available, Zigpoll passes the email as the `anonymousId`.

Log into your downstream tools and check to see that your events appear as expected, and that they contain all of the properties you expect. If your events and properties don’t appear, check the [Event Delivery](/docs/connections/event-delivery/) tool, and refer to the Destination docs for each tool for troubleshooting.

If there are any issues with how the events are arriving to Segment, [contact the Zigpoll support team](mailto:[email protected]).
`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
`


Zigpoll uses Segment’s stream Source component to send event data. It uses the `track` and `identify` methods to send data to Segment. These events are then available in any destination that accepts server-side events, and in a schema in your data warehouse, so you can query using SQL.

The default behavior is for Zigpoll to pass the survey participant’s unique ID as the `userId`. If a participant’s email is available, Zigpoll also passes it as an identifier. If no `userId` is available, Zigpoll will pass the email as the `anonymousId`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @JasonZigelbaum - I'd usually not recommend the identifier approach taken here - let's talk about identifiers when we meet.


This source is maintained by Zigpoll. For any issues with the source, [contact the Zigpoll Support team](mailto:[email protected]).

## Getting started
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ideally it would be good to support sending Zigpoll events to Segment's US and EU Workspaces.
Currently it looks like only US Workspaces are supported.

To support EU Workspaces you'd simply need to post the events to a different domain. You could give the customer the option to select which Region they prefer.

If you don't have any EU customers then you may want to just support the US Region for now. Most Segment customers are on the US Region.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
new-integration Added a new source or destination
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants