> ## 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 Gameball on Shopify Flow?

> Use Gameball's triggers and actions in your automated workflows with Shopify Flow

| Platform | Plan                |
| -------- | ------------------- |
| Shopify  | Starter, Pro & Guru |

With Gameball's integration into Shopify Flow, you can now automate and enhance your customer loyalty and engagement programs more effectively. This article walks you through the available triggers and actions, how to set them up, and examples of how to use Gameball with Shopify Flow.

***

## Triggers

<AccordionGroup>
  <Accordion title="Customer Tier Changed (Up/Down)" icon="arrow-up-arrow-down">
    This trigger activates when a customer tiers up or down, either manually or automatically.

    *Example: When a customer's tier changes to the Gold tier.*

    <Frame>
      <img src="https://mintcdn.com/gameball/tEm0zYZGDqbMoeMn/images/product-docs/apps-integrations/apps-integrations-97.png?fit=max&auto=format&n=tEm0zYZGDqbMoeMn&q=85&s=3c6477536577f43df4b4c2651277e323" width="566" height="304" data-path="images/product-docs/apps-integrations/apps-integrations-97.png" />
    </Frame>
  </Accordion>

  <Accordion title="Reward Campaign Achieved" icon="trophy">
    This trigger activates when a customer achieves a new Reward Campaign, either manually or automatically.

    *Example: When a customer earns a new reward campaign when they complete their First Order.*

    <Frame>
      <img src="https://mintcdn.com/gameball/tEm0zYZGDqbMoeMn/images/product-docs/apps-integrations/apps-integrations-98.png?fit=max&auto=format&n=tEm0zYZGDqbMoeMn&q=85&s=8de00f86b6b5d5d92cd690044634ffd5" width="566" height="260" data-path="images/product-docs/apps-integrations/apps-integrations-98.png" />
    </Frame>
  </Accordion>

  <Accordion title="Customer Entered a New Segment" icon="users">
    This trigger activates once a customer is added to a new Segment.

    *Example: When a customer is placed in the Inactive segment.*

    <Frame>
      <img src="https://mintcdn.com/gameball/tEm0zYZGDqbMoeMn/images/product-docs/apps-integrations/apps-integrations-99.png?fit=max&auto=format&n=tEm0zYZGDqbMoeMn&q=85&s=b719b229ccc1e5c00f3e49b3ff27ed41" width="566" height="296" data-path="images/product-docs/apps-integrations/apps-integrations-99.png" />
    </Frame>
  </Accordion>

  <Accordion title="Customer Added a Birthday" icon="cake-candles">
    This trigger activates once a customer adds their birthday to Gameball's widget.

    <Frame>
      <img src="https://mintcdn.com/gameball/3xrflxpiDXAq96vF/images/product-docs/apps-integrations/apps-integrations-100.png?fit=max&auto=format&n=3xrflxpiDXAq96vF&q=85&s=5a8c67855eece7cbddff5f8d943d4863" width="1514" height="350" data-path="images/product-docs/apps-integrations/apps-integrations-100.png" />
    </Frame>
  </Accordion>
</AccordionGroup>

***

## Actions

<AccordionGroup>
  <Accordion title="Send an Event" icon="paper-plane">
    This action allows you to send a custom event to Gameball. [Learn how to set it up.](#send-an-event-setup)

    *Example: A customer completed a survey, so we will send this event (Survey\_Completed) to Gameball.*

    <Note>
      This action is only available on the **Guru Plan**.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/gameball/3xrflxpiDXAq96vF/images/product-docs/apps-integrations/apps-integrations-101.png?fit=max&auto=format&n=3xrflxpiDXAq96vF&q=85&s=2072196cf769292cd580059c8b8529bc" width="562" height="254" data-path="images/product-docs/apps-integrations/apps-integrations-101.png" />
    </Frame>
  </Accordion>

  <Accordion title="Reward a Campaign" icon="gift">
    This action rewards a customer with a specified Reward Campaign manually. [Learn how to set it up.](#reward-a-campaign-setup)

    *Example: Rewarding a customer with the 'Completed First Order' Reward Campaign.*

    <Frame>
      <img src="https://mintcdn.com/gameball/3xrflxpiDXAq96vF/images/product-docs/apps-integrations/apps-integrations-102.png?fit=max&auto=format&n=3xrflxpiDXAq96vF&q=85&s=342b0917a26b6f02728593a790829bd2" width="562" height="254" data-path="images/product-docs/apps-integrations/apps-integrations-102.png" />
    </Frame>
  </Accordion>

  <Accordion title="Deduct Points" icon="minus">
    This action deducts a specified number of points from a customer's account for a given reason. [Learn how to set it up.](#deduct-points-setup)

    *Example: Deducting 50 points from a customer's balance for a reward they got in-store.*

    <Frame>
      <img src="https://mintcdn.com/gameball/3xrflxpiDXAq96vF/images/product-docs/apps-integrations/apps-integrations-103.png?fit=max&auto=format&n=3xrflxpiDXAq96vF&q=85&s=9562ac17420716bafc0ba9894df8c4c6" width="566" height="254" data-path="images/product-docs/apps-integrations/apps-integrations-103.png" />
    </Frame>
  </Accordion>

  <Accordion title="Adjust Customer Tier" icon="layer-group">
    This action adjusts a customer's tier to a specified tier name. [Learn how to set it up.](#adjust-customer-tier-setup)

    *Example: Adjusting the customer tier from the Bronze tier to the Gold tier.*

    <Frame>
      <img src="https://mintcdn.com/gameball/3xrflxpiDXAq96vF/images/product-docs/apps-integrations/apps-integrations-104.png?fit=max&auto=format&n=3xrflxpiDXAq96vF&q=85&s=e7b6a2c883078c4a4f36cd0f2aba1e4a" width="566" height="254" data-path="images/product-docs/apps-integrations/apps-integrations-104.png" />
    </Frame>
  </Accordion>

  <Accordion title="Add Points" icon="plus">
    This action adds a specified number of points to a customer's account for a given reason. [Learn how to set it up.](#add-points-setup)

    *Example: Adding 100 points for a customer for adding a review on your product.*

    <Frame>
      <img src="https://mintcdn.com/gameball/3xrflxpiDXAq96vF/images/product-docs/apps-integrations/apps-integrations-105.png?fit=max&auto=format&n=3xrflxpiDXAq96vF&q=85&s=3f65df08b2327e17df0cb6bc3c9c61e0" width="566" height="254" data-path="images/product-docs/apps-integrations/apps-integrations-105.png" />
    </Frame>
  </Accordion>
</AccordionGroup>

***

## Action Setups

### Send an Event Setup

This action allows you to send a custom event to Gameball.

**Attributes:**

* **Customer Email**: Skip the email if the trigger already passes the ID. Select it from "Add a variable".

<Frame>
  <img src="https://mintcdn.com/gameball/3xrflxpiDXAq96vF/images/product-docs/apps-integrations/apps-integrations-106.png?fit=max&auto=format&n=3xrflxpiDXAq96vF&q=85&s=754857323935a8f40f0f9f69d058cc7f" width="8000" height="4500" data-path="images/product-docs/apps-integrations/apps-integrations-106.png" />
</Frame>

* **Event Name**: The event name to be sent to Gameball.
* **Event Attribute Name X**: The event attribute name (up to 5 attributes).
* **Event Attribute Value X**: The event attribute value.

<Note>
  This action is only available on the **Guru Plan**.
</Note>

### Reward a Campaign Setup

This action rewards a customer with a specified Reward Campaign manually.

**Attributes:**

* **Customer Email**: Skip the email if the trigger already passes the ID. Select it from "Add a variable".

<Frame>
  <img src="https://mintcdn.com/gameball/3xrflxpiDXAq96vF/images/product-docs/apps-integrations/apps-integrations-107.png?fit=max&auto=format&n=3xrflxpiDXAq96vF&q=85&s=e81532eed0619db34eb33807072b099e" width="1024" height="650" data-path="images/product-docs/apps-integrations/apps-integrations-107.png" />
</Frame>

* **Campaign ID**: Copy the ID next to the title on the campaign details page in Gameball.

<Frame>
  <img src="https://mintcdn.com/gameball/3xrflxpiDXAq96vF/images/product-docs/apps-integrations/apps-integrations-108.png?fit=max&auto=format&n=3xrflxpiDXAq96vF&q=85&s=2114bff8961a9c071ea3bd0e27085a89" width="8000" height="4500" data-path="images/product-docs/apps-integrations/apps-integrations-108.png" />
</Frame>

### Deduct Points Setup

This action deducts a specified number of points from a customer's account.

**Attributes:**

* **Customer Email**: Skip the email if the trigger already passes the ID.

<Frame>
  <img src="https://mintcdn.com/gameball/3xrflxpiDXAq96vF/images/product-docs/apps-integrations/apps-integrations-109.png?s=0d7364c99bca4870aded2bc9aae36d76" width="1152" height="648" data-path="images/product-docs/apps-integrations/apps-integrations-109.png" />
</Frame>

* **Points to be deducted**: Number of points to deduct.
* **Reason**: Reason for deducting the points.

### Adjust Customer Tier Setup

This action adjusts a customer's tier to a specified level name. You can choose the level behavior (forever, until a specific date, or evaluated normally).

**Attributes:**

* **Customer Email**: Skip the email if the trigger already passes the ID.

<Frame>
  <img src="https://mintcdn.com/gameball/3xrflxpiDXAq96vF/images/product-docs/apps-integrations/apps-integrations-110.png?fit=max&auto=format&n=3xrflxpiDXAq96vF&q=85&s=8542eb778c28f7468b127592e5902d94" width="1107" height="380" data-path="images/product-docs/apps-integrations/apps-integrations-110.png" />
</Frame>

* **Tier Order**: The tier number in Gameball (e.g., 1, 2, 3).
* **Tier Behavior**:
  * **System Evaluate**: Based on Gameball's evaluation according to the chosen tiering-up method.
  * **Forever**: The customer stays on this tier unless manually reassigned.
  * **Temporarily till Specific Date**: The customer stays on the tier until a specific date.
* **Temporarily Specific Date**: If selected, add the date in format `yyyy-MM-dd`.
* **Reason**: The reason for the tier adjustment.

### Add Points Setup

This action adds a specified number of points to a customer's account.

**Attributes:**

* **Customer Email**: Skip the email if the trigger already passes the ID.

<Frame>
  <img src="https://mintcdn.com/gameball/3xrflxpiDXAq96vF/images/product-docs/apps-integrations/apps-integrations-111.png?fit=max&auto=format&n=3xrflxpiDXAq96vF&q=85&s=ca48d68bf2da34e7420b18222b14ea7b" width="1107" height="380" data-path="images/product-docs/apps-integrations/apps-integrations-111.png" />
</Frame>

* **Points to be added**: Number of points to add.
* **Reason**: Reason for adding the points.

***

## Setting Up Gameball Triggers and Actions in Shopify Flow

<Steps>
  <Step title="Access Shopify Flow">
    From your Shopify admin, go to **Apps > Shopify Flow**.
  </Step>

  <Step title="Create a Workflow">
    Click **Create Workflow** and choose a trigger from the Gameball triggers listed above.
  </Step>

  <Step title="Configure the Trigger">
    Set up the trigger by selecting the appropriate variables and conditions.
  </Step>

  <Step title="Add an Action">
    Select an action from the Gameball actions listed above and configure it with the necessary details.
  </Step>

  <Step title="Test and Activate">
    Test your workflow to ensure it works as expected, then activate the workflow.
  </Step>
</Steps>

***

## Use Cases

### 1. Rewarding Customers Who Gave a Review

* **Trigger:** Use an external reviews app like Reviews.io to trigger the action whenever a customer leaves a review.
* **Action:** Use Gameball's **Reward a Campaign** action to reward customers for their feedback.

See a live example: [Reviews.io integration via Shopify Flow](/product-documentation/apps-integrations/shopify-flow/reviews-io-integration).

### 2. Adding Points for Survey Completion

* **Trigger:** Use an external survey app, such as Okendo, to trigger the action when a customer completes a survey.
* **Action:** Gameball will automatically **Add Points** to the customer's account.

### 3. Celebrate Customer's 3-Year Anniversary

* **Trigger:** Set a date trigger to recognize when a customer has been with your store for three years.
* **Action:** Use Gameball's **Send Event** action to trigger a personalized communication campaign.

***

<CardGroup cols={2}>
  <Card title="Reviews.io via Shopify Flow" icon="star" href="/product-documentation/apps-integrations/shopify-flow/reviews-io-integration">
    Reward customers for Reviews.io reviews.
  </Card>

  <Card title="Yotpo via Shopify Flow" icon="star" href="/product-documentation/apps-integrations/shopify-flow/yotpo-integration">
    Reward customers for Yotpo reviews.
  </Card>
</CardGroup>
