Surveys

Surveys allow you to gather feedback from your players through multiple distribution channels. You can create sophisticated surveys with various question types and distribute them via web, Discord, or directly within your game.

Creating a Survey

To create a new survey, navigate to the ‘Surveys’ tab and click the ‘Create Survey’ button. The survey editor provides a simple user interface for building and previewing your surveys.

Adding Questions

1. Click “Add Question” to see all available question types organized by category
2. Select a question type to add it to your current page
3. Configure the question settings in the edit panel
4. Add additional pages

Question Types

Surveys offer a comprehensive set of question types including free text, multiple choice, single choice, opinion scales, rating scales, NPS surveys, and static content (text, video, and images). Each question type can be configured with various options such as required fields, multiple selections, and custom styling.

Each question type has a symbol above it which highlights which distribution channel it works with. Full list of question types

Previewing Your Survey

See what your survey will look like as you build it.

Web Surveys

Discord Surveys

Survey Configuration

When you have finished building out your survey and you’re ready to publish, click ‘Continue’. From here you’ll be able to choose the channels you want to distribute through and configure general survey settings.

You can turn surveys on or off at anytime by selecting ‘Accepting Responses’

Distribution Channels

FirstLook supports multiple distribution channels, allowing you to reach players wherever they are:

Email

Web surveys are published to a dedicated webpage that you can share via email or a custom URL. Using email will utilise our Announcement feature, which gives you the ability to send surveys to specific cohorts within your player base. Web surveys offer the widest variety of question types and provide the most comprehensive survey experience.

• Anonymous Responses – Allow participants to respond without creating an account or logging in
• Full Question Support – Access to all question types and advanced features
• Custom Branding – Match your survey’s appearance to your game’s visual style

Discord Surveys

Share surveys directly in your Discord server channels. Discord surveys integrate seamlessly with your channels for quick and easy feedback gathering.

• Channel Integration – Surveys appear as interactive messages in your Discord channels
• Limited Question Types – Some advanced question types are not available for Discord due to platform limitations
• Real-time Responses – See responses as they come in through Discord

In-game Surveys

Use the FirstLook SDK to distribute surveys directly within your game client for the most seamless player experience.

• Native Game UI – Surveys render using native in-game UI for the best player experience
  • Customizable Interface – Fully themeable and customizable to match your game’s look and feel
• Steam Web Overlay – Surveys appear in the Steam web overlay, supporting more question types

Managing Responses

Once your survey is published, you can monitor and analyze responses in real-time.

Viewing Survey Results

The survey results page provides comprehensive analytics including response counts, question statistics, and individual response data with real-time charts and filtering options. You can also export all responses for analysis in other tools.

Editing Surveys

Once a survey is published you may need to make some edits. To do this, click on Edit which will take you back to the survey builder.

Deleting Responses

There may be instances where data is incorrectly added and you need to delete certain responses. This can be done by clicking the three little dots at the end of the chosen response and selecting Delete

In-game Survey Integration

FirstLook provides a powerful SDK for seamlessly integrating surveys directly into your game. The SDK includes a pre-built UI that can be fully customized to match your game’s visual style and theme.

Key features of in-game surveys:

• Easy Integration – Simple SDK implementation with minimal code required
• Customizable UI – Adapt the survey interface to match your game’s look and feel
• Native Feel – Surveys appear as a natural part of your game experience
• Full Controller Support – Built for controller or mouse and keyboard navigation

Survey Triggers

For in-game surveys, you can set up event-based triggers to automatically show surveys to players at specific moments in your game’s user flow. This requires the FirstLook SDK to be integrated into your game.

Survey triggers are based on custom events that your game sends to the FirstLook SDK. When a player triggers an event the specified number of times (threshold), the survey will be shown to them.

Setting Up Triggers

From the “Publish Settings” page under the “In-game” header, add one or more survey triggers.

1. Event Name – The name of the event your game sends to the SDK (e.g., “MatchEnd”, “LevelComplete”, “PurchaseMade”)
2. Threshold – How many times the event must occur before showing the survey (e.g., 3 means the survey shows after the 3rd occurrence)

Trigger Behavior

• Each survey is shown only once per player, even if the event is triggered multiple times
• Triggers are evaluated independently for each player
• You can set multiple triggers for the same survey to cover different scenarios

Feedback

The FirstLook SDK includes a streamlined feedback survey designed to quickly capture player sentiment directly from your game.

Setting Up

Configure your feedback survey:

1. Navigate to your feedback survey settings
2. Select your preferred display mode: Native UI or Web Overlay
3. Customize the question and description shown to players
4. Toggle the survey on
5. Save your changes

Client Integration

The FirstLook SDK provides two approaches for integrating the feedback survey into your game:

• Native UI Use the SDK’s pre-built survey components for a quick, out-of-the-box setup with minimal code.
• Web Overlay Opens a web browser with the survey.

For SDK setup and implementation details, see the SDK documentation.

Viewing Responses

Survey responses are available in the dashboard where you can monitor incoming feedback, filter results, and export response data.

If you have Sentiment enabled, feedback survey responses are automatically processed alongside your other player signals. This means survey feedback will surface in your sentiment tags, topics, and reports, giving you a unified view of how players feel across all your feedback channels.

Best Practices

• Keep surveys short and focused to increase completion rates
• Use clear, concise language in your questions
• Test your survey before publishing to ensure it works as expected
• Consider the timing of in-game surveys to avoid interrupting gameplay

Exporting Responses

Survey responses can be exported as a CSV.

• Survey Results Page – Click the export button in the upper right corner
• External API – Use the survey export endpoint and an API key

CSV Format

• UTF-8 encoded, follows RFC 4180 — values containing commas or newlines are quoted
• Response dates (Created At, Updated At) use space-separated format: 2026-05-08 14:30:45.123456789 +00:00
• Player dates use RFC 3339 format: 2026-05-08T14:30:45+00:00

CSV Schema

The export contains response metadata, one column per survey question, and player data. Columns are listed in order but only the index of the first five columns are guaranteed.

Column Header	Type	Notes
Response ID	UUID
External Player ID	String	e.g. discord:12345, empty if none
Source	String	Survey response source: discord, web, client
Created At	datetime	Survey response created at
Updated At	datetime	Survey response updated at
Survey questions	String	One column per question. Header is the question’s title, falling back to the question UUID if untitled. Ordered by position in the survey (page order, then question order within each page). Cell value is the raw string from the response JSON data field. Multi-select answers are comma-separated (e.g. option1,option2,option3). Empty if the respondent skipped the question.
Player ID	UUID
Email	String	empty if none
First Name	String	empty if none
Last Name	String	empty if none
Role	String	role name, or Role #ID
State	String	pending, waiting, invited, accepted, onboarded, deleted, unlinked, merged
Source	String	Player recruitment source: import, invite-email, invite-code, friend-invite, signup, referral, playtester-network, creator-network, in-game, discord, external; empty if none
Source Data	JSON string	Serialized JSON object containing referer (URL) and params (UTM parameters: utm_source, utm_medium, utm_campaign, utm_content, utm_term)
Country	String	empty if none
Steam ID	String	empty if none
Steam Name	String	empty if none
Discord ID	String	empty if none
Discord Name	String	empty if none
Confirmed At	RFC3339 datetime	Player email confirmed at; empty if none
Onboarded At	RFC3339 datetime	Player onboarded at; empty if none
NDA Accepted At	RFC3339 datetime	Player NDA accepted at; empty if none
Discord Joined At	RFC3339 datetime	Player discord joined at; empty if none
Invited At	RFC3339 datetime	Player invited at; empty if none
Updated At	RFC3339 datetime	Player updated at; always present
Created At	RFC3339 datetime	Player created at; always present
Playtime	Integer (minutes)	Total playtime across all apps; empty if no steam data
Playtime (AppName - SteamID)	Integer (minutes)	one per steam app, empty if no data
Wishlist Status	String	not_checked, unknown, wishlisted, not_wishlisted
Is Owned	Boolean	true/false, empty if unknown
Invited Count	Integer
Invited 2nd Degree Count	Integer
Referred Count	Integer
Referred 2nd Degree Count	Integer
Email Bounced At	RFC3339 datetime	empty if none
Custom player attributes	Mixed	Data from onboarding and signup questions as well as any other player metadata. String, Number, Boolean, or comma-separated array

Anonymous responses

For anonymous survey responses, Player ID is empty and all player columns (Email through Custom player attributes) are empty strings.