> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gameball.co/llms.txt
> Use this file to discover all available pages before exploring further.

# How Do I Set Up a Survey Campaign?

> Collect customer feedback without leaving Gameball, and reward customers in points or coupons for completing it.

| Platform   | Plan          |
| ---------- | ------------- |
| Shopify    | Pro & Guru    |
| Salla      | Pro & Guru    |
| Self Serve | Contact Sales |

Collect customer feedback directly through Gameball and pay for it in points. **Survey** is a reward campaign type with its own question builder, an optional completion reward, and three ways to reach customers: inside the loyalty widget, as a storefront popup, or through a standalone shareable link.

<Note>
  This is a native Gameball campaign type. For the Shopify-Flow-based template that rewards customers for completing a survey on a separate app (e.g. Okendo), see [Fill a Survey (Shopify Flow)](/product-documentation/rewards-campaigns/templates/engagement-gamification/fill-a-survey).
</Note>

<Frame>
  <img src="https://mintcdn.com/gameball/UntNKomW_HHvVPjH/images/product-docs/rewards-campaigns/templates/engagement-gamification/survey-campaign-rules-preview.png?fit=max&auto=format&n=UntNKomW_HHvVPjH&q=85&s=42c02af8c6703709bf666a3c81a04875" alt="Survey campaign rules and preview" width="2500" height="1356" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/survey-campaign-rules-preview.png" />
</Frame>

***

## How to Set Up

<Steps>
  <Step title="Open Gameball">
    Log in to your Gameball dashboard.
  </Step>

  <Step title="Add a Reward Campaign">
    Click **Add Reward Campaign**.
  </Step>

  <Step title="Select the Template">
    Choose the **Survey** template.
  </Step>

  <Step title="Configure the Campaign">
    Edit the campaign's setup to match your goals (see configuration sections below).
  </Step>

  <Step title="Activate">
    Click **Set Live** to activate the campaign.
  </Step>
</Steps>

***

## Campaign Configuration

<AccordionGroup>
  <Accordion title="Audience" icon="users">
    * **All Customers**
    * **Anonymous Customers (Not logged in)**
    * **Specific Customers:** Filter by segment, tag, or customer attributes to limit who can participate.

    As you adjust the audience, Gameball shows how many customers are currently eligible to participate.
  </Accordion>

  <Accordion title="Triggers" icon="bolt">
    * **Customer completes the survey:** The reward is issued once the customer submits all required questions.
    * **Web Popup (URL-based trigger):** Show the survey as a popup on specific storefront pages.
  </Accordion>

  <Accordion title="Repeatability" icon="repeat">
    Choose how many times a customer can earn this campaign:

    * **Unlimited**
    * **Limited to X times overall**
    * **Time-based limit (per period)**
    * **Combined** (overall + per period)

    The completion reward is issued only once per customer per allowed repetition, no matter which channel (widget, popup, or shareable link) they used.
  </Accordion>
</AccordionGroup>

<Info>
  This template uses the standard reward campaign setup. See the [Generic Setup Guide](/product-documentation/rewards-campaigns/start-from-scratch/setup-reward-campaign) for details.
</Info>

***

## Question Builder

Build your survey from seven supported question types:

| Type                | Description                                     |
| ------------------- | ----------------------------------------------- |
| **Single Choice**   | Customer picks one option from a list.          |
| **Multiple Choice** | Customer can select more than one option.       |
| **Short Text**      | A single-line free-text answer.                 |
| **Long Text**       | A multi-line free-text answer.                  |
| **Rating Scale**    | Customer rates on a scale of 1–5 or 1–10.       |
| **NPS**             | Net Promoter Score question, scored 0–10.       |
| **Image Choice**    | Customer picks one option from a set of images. |

Add, reorder, and delete questions freely, and mark any question **Required** or **Optional**.

<Frame>
  <img src="https://mintcdn.com/gameball/UntNKomW_HHvVPjH/images/product-docs/rewards-campaigns/templates/engagement-gamification/survey-campaign-questions-overview.png?fit=max&auto=format&n=UntNKomW_HHvVPjH&q=85&s=55972105db545b7eb315e8cbf1334433" alt="Survey completion reward, no reward option, dates and limits" width="1654" height="1160" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/survey-campaign-questions-overview.png" />
</Frame>

<Note>
  Reward the survey with points or a coupon from your existing redemption rules — or run it with no reward at all. You can also set a start/end date and a total participation limit for the whole campaign, independent of per-customer repeatability.
</Note>

***

## Distribution

Reach customers through three channels, configurable independently:

* **Gameball Widget:** The survey appears inside the loyalty widget.
* **Storefront Popup:** Enable popup mode with a configurable trigger — page load, time delay, or exit intent.
* **Shareable Link:** Copy an auto-generated link that renders the survey on a Gameball-hosted page, no widget required. Useful for emails, SMS, or social posts.

***

## Customization

Customize branding and copy for each stage of the survey — Intro, Question, and Success screens.

<Frame>
  <img src="https://mintcdn.com/gameball/UntNKomW_HHvVPjH/images/product-docs/rewards-campaigns/templates/engagement-gamification/survey-campaign-question-customization.png?fit=max&auto=format&n=UntNKomW_HHvVPjH&q=85&s=7811592ba82f08bce6a2c50d1a4fc95b" alt="Survey question customization with branding and live preview" width="2482" height="1290" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/survey-campaign-question-customization.png" />
</Frame>

* **Branding:** Set the main color and button text color.
* **Content:** Edit button labels and other on-screen copy per screen, with support for both English and Arabic.
* Question transitions and selections are animated, with a confirmation screen shown on submission.

***

## Customer Experience & Data

* **Identified customers** are credited automatically for their responses.
* **Anonymous link visitors** are handled based on your campaign configuration.
* Any survey answer can be stored back on the customer as a **customer attribute**, so responses become segmentation and targeting criteria for future campaigns, automations, and audiences.
* Responses are stored per campaign and exportable as CSV.
* Aggregated results for every published survey are available in **Insights**. See [Survey & Quiz Response Analytics](/product-documentation/rewards-campaigns/reward-campaigns-insights#survey-quiz-response-analytics).

***

## Important Notes

<Note>
  **Customer Eligibility**

  The survey updates dynamically based on customer eligibility, ensuring customers only see surveys they can still participate in. If a customer no longer belongs to the campaign's target segment, the survey is automatically removed from the widget and won't reappear unless eligibility is restored.
</Note>

***

## Related Articles

<CardGroup cols={2}>
  <Card title="Set up a reward campaign" icon="flag" href="/product-documentation/rewards-campaigns/start-from-scratch/setup-reward-campaign">
    Step-by-step guide to configuring any reward campaign.
  </Card>

  <Card title="Understanding Reward Campaigns Insights" icon="chart-bar" href="/product-documentation/rewards-campaigns/reward-campaigns-insights">
    Learn which metrics to track and how to measure campaign performance.
  </Card>

  <Card title="Fill a Survey (Shopify Flow)" icon="list-check" href="/product-documentation/rewards-campaigns/templates/engagement-gamification/fill-a-survey">
    Reward customers for completing a survey on a connected Shopify Flow app.
  </Card>
</CardGroup>
