> ## 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 Streak Campaign?

> Make your consistent customers feel special using the streak reward campaign template.

## Plan Availability

<Tabs>
  <Tab title="Shopify & Salla">
    | Plan       | Available |
    | ---------- | --------- |
    | Starter    | Yes       |
    | Pro & Guru | Yes       |
  </Tab>

  <Tab title="Non-Platform">
    | Plan | Available |
    | ---- | --------- |
    | All  | Yes       |
  </Tab>
</Tabs>

Streak campaigns help you increase customer engagement by rewarding consecutive actions over time. You can configure streaks based on any customer action, such as purchases, reviews, or visits, and reward customers with points, coupons, or badges as they maintain their streak. This habit-forming campaign keeps your brand top-of-mind and encourages regular interaction.

***

## How to Create a Streak Campaign

<Steps>
  <Step title="Navigate to Reward Campaigns">
    From the left bar, choose **Reward** under **Campaigns**. Click **Create New Reward Campaign**.

    <Frame>
      <img src="https://mintcdn.com/gameball/xysbvpvMWJQz49rc/images/product-docs/rewards-campaigns/templates/engagement-gamification/streak-create.png?fit=max&auto=format&n=xysbvpvMWJQz49rc&q=85&s=c5f964c5e9aecfacfd7c7e7f01584b71" alt="Create streak campaign" width="2802" height="1426" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/streak-create.png" />
    </Frame>
  </Step>

  <Step title="Select the Template">
    Scroll to choose the **Streak** under **Engagement & Gamification**.

    <Frame>
      <img src="https://mintcdn.com/gameball/xysbvpvMWJQz49rc/images/product-docs/rewards-campaigns/templates/engagement-gamification/streak-select-template.png?fit=max&auto=format&n=xysbvpvMWJQz49rc&q=85&s=e095a93aedbbe17f7f85e02104fa655f" alt="Select streak template" width="2480" height="1164" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/streak-select-template.png" />
    </Frame>
  </Step>

  <Step title="Configure General Settings">
    You may follow the steps in this article to configure the general settings of this campaign. [Learn more about setting up a Reward Campaign.](/product-documentation/rewards-campaigns/start-from-scratch/create-action-based-reward-campaign)
  </Step>

  <Step title="Select Streak Actions">
    Select the actions that will count toward the streak. Examples:

    * Purchases
    * Reviews
    * Website visits
  </Step>

  <Step title="Set Up the Rewards">
    In the **Rewards** section, set up the streak rewarding system. For example, you might want customers to get 10 points every day they purchase until the 5th day, then 20 points daily until the 10th day, then 50 points thereafter.

    <Warning>
      If the customer misses a day, they start over. The streak resets, but milestone badges already earned remain with the customer.
    </Warning>

    <Frame>
      <img src="https://mintcdn.com/gameball/xysbvpvMWJQz49rc/images/product-docs/rewards-campaigns/templates/engagement-gamification/streak-rewards.png?fit=max&auto=format&n=xysbvpvMWJQz49rc&q=85&s=605c931dab6906991d7140e83f95ad55" alt="Streak rewards configuration" width="2772" height="1462" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/streak-rewards.png" />
    </Frame>
  </Step>

  <Step title="Add Daily Rewards and Badges">
    You can add up to **10 Daily Rewards**. Rewards should increase with longer streaks to encourage continued engagement.

    Add the Badges of each streak. Badges are awarded when customers reach a milestone and remain permanently, even if the streak resets.

    <Frame>
      <img src="https://mintcdn.com/gameball/xysbvpvMWJQz49rc/images/product-docs/rewards-campaigns/templates/engagement-gamification/streak-badges.png?fit=max&auto=format&n=xysbvpvMWJQz49rc&q=85&s=c69c905510f6b5bc936fc063b2401f66" alt="Streak badges configuration" width="2812" height="1548" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/streak-badges.png" />
    </Frame>
  </Step>
</Steps>

***

## How Gameball Tracks Daily Visits

If the trigger chosen is **Daily Visits**, here is how Gameball records customer check-ins:

A **daily visit (check-in)** is recorded when a registered customer interacts with your platform after **midnight (00:00 AM)** in their local time.

<Tabs>
  <Tab title="Web Visits">
    A customer visit is counted as a daily check-in in any of the following cases:

    * The customer is **logged in** and loads any page that includes the **Gameball widget** (typically added via a JavaScript snippet).
    * If the customer is **logged out**, they must **log in** for the visit to count.
    * The platform sends **any event** on behalf of the customer (e.g., a purchase or tier-up event).
    * You **retrieve customer details via the Gameball API** (e.g., calling `Get Customer` endpoint).

    <Note>
      If you're not using a built-in Gameball plugin like **Shopify** or **Salla**, make sure the widget is integrated using our JavaScript SDK [guide](https://developer.gameball.co/installing-gameball/web) to ensure proper tracking.
    </Note>
  </Tab>

  <Tab title="Mobile App Visits">
    On mobile, a check-in is registered under the following conditions:

    * The customer **clicks on the loyalty program button** to launch the Gameball widget.
    * The app **initializes the Gameball SDK**, even in the background, when the customer opens the app.
    * The app sends **any event** related to the customer through Gameball's event tracking.
    * You **retrieve customer details via the API** (same as on web).

    <Note>
      Simply opening the app without triggering the widget or an event **will not** count as a check-in.
    </Note>
  </Tab>
</Tabs>

***

## Streak Achievement Events

Every time a customer progresses in a streak, Gameball fires a `streak_progression` event. You can use this event to trigger automations, send personalized messages, or build custom segmentation logic.

### Event Fired on Every Streak Progression

The `streak_progression` event fires automatically whenever a customer advances their streak — regardless of whether a reward milestone was reached.

### Using Streak Events for Automation and Personalization

You can reference this event in:

* **Automation campaigns** — trigger a flow when a customer reaches a specific streak length
* **Communication campaigns** — send a congratulatory message at key milestones
* **Segmentation** — group customers based on their current or longest streak

### Event Metadata

| Field                     | Description                                                       |
| ------------------------- | ----------------------------------------------------------------- |
| `campaign_id`             | The ID of the streak campaign                                     |
| `campaign_name`           | The name of the streak campaign                                   |
| `current_streak_duration` | The customer's current consecutive streak count                   |
| `longest_streak_duration` | The highest streak the customer has ever reached in this campaign |

<Note>
  * The `streak_progression` event fires on every progression, not just on reward milestones.
  * If the streak resets, `current_streak_duration` resets to 0, but `longest_streak_duration` retains the historical maximum.
  * Milestone badges earned remain with the customer even after a reset.
</Note>

***

## Related Articles

<CardGroup cols={2}>
  <Card title="Set Up a Reward Campaign" icon="gift" href="/product-documentation/rewards-campaigns/start-from-scratch/setup-reward-campaign">
    Learn the full setup process for creating and activating reward campaigns.
  </Card>

  <Card title="Reward Types in Gameball" icon="tag" href="/product-documentation/rewards-campaigns/start-from-scratch/setup-reward-campaign">
    Explore all reward types available and how to configure each one.
  </Card>

  <Card title="Notification After Earning a Reward" icon="bell" href="/product-documentation/rewards-campaigns/start-from-scratch/setup-reward-campaign">
    Configure in-app and email notifications triggered when customers earn rewards.
  </Card>
</CardGroup>
