> ## 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 to Create an Automation Campaign?

> Learn how to use Gameball Automation Campaigns to create workflows that will increase productivity and efficiency.

Automated workflows streamline customer-business communications and activities. Gameball's automation engine offers a robust solution for creating pre-set actions triggered by specific events. [Learn more about Automation Campaigns](/product-documentation/automation-campaigns/introduction-to-automation-campaigns).

## Creating an Automated Workflow

### Create a New Automation Campaign

<Steps>
  <Step title="Go to Gameball Dashboard">
    Open your Gameball Admin Dashboard.
  </Step>

  <Step title="Navigate to Automation">
    From the left bar, click on **Automation** under **Campaigns**. You will land on the page that displays all previously **configured** and **Live** Automations.
  </Step>

  <Step title="Create Automation">
    Click **Create Automation** from the top right of the Automation section. You will be taken to the **automation engine**, where you can create endless workflows.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/gameball/tEm0zYZGDqbMoeMn/images/product-docs/automation-campaigns/create-automation-button.png?fit=max&auto=format&n=tEm0zYZGDqbMoeMn&q=85&s=242ce56c8b83d57677997f1ce6ad371f" alt="Create Automation button on the Automation section" width="2880" height="1378" data-path="images/product-docs/automation-campaigns/create-automation-button.png" />
</Frame>

***

### Choose Your Audience and Set Entry Frequency and Exit Rule

You can decide which of your customers this automation will apply to. You can also decide when a customer will exit this automation.

<Steps>
  <Step title="Open Settings">
    Click on **Settings**.

    <Frame>
      <img src="https://mintcdn.com/gameball/tEm0zYZGDqbMoeMn/images/product-docs/automation-campaigns/automation-settings-button.png?fit=max&auto=format&n=tEm0zYZGDqbMoeMn&q=85&s=e79fb0d610425a7b4d8cb2c1834641f9" alt="Automation settings button" width="2816" height="1440" data-path="images/product-docs/automation-campaigns/automation-settings-button.png" />
    </Frame>
  </Step>

  <Step title="Choose Audience">
    Under **Audience**, choose between:

    * All Customers
    * Guest Customer
    * Registered Customers
    * Specific Customer (choosing specific Segments, RFM Segments, Tags, or Customer Attributes)

    <Frame>
      <img src="https://mintcdn.com/gameball/tEm0zYZGDqbMoeMn/images/product-docs/automation-campaigns/audience-selection.png?fit=max&auto=format&n=tEm0zYZGDqbMoeMn&q=85&s=df7fee1c1c29bc49e2889d956ab35d9d" alt="Audience selection options" width="1594" height="678" data-path="images/product-docs/automation-campaigns/audience-selection.png" />
    </Frame>
  </Step>

  <Step title="Set Audience Entry Frequency">
    Determine how frequently customers can enter the automation:

    * Once (Default)
    * Every Time the Criteria Met
    * Custom Frequency

    <Frame>
      <img src="https://mintcdn.com/gameball/Ym44GvndYOgHCcbm/images/product-docs/automation-campaigns/entry-frequency-options.png?fit=max&auto=format&n=Ym44GvndYOgHCcbm&q=85&s=b61dde903d3a9208bc47cfab6d67345f" alt="Entry frequency options" width="1380" height="756" data-path="images/product-docs/automation-campaigns/entry-frequency-options.png" />
    </Frame>
  </Step>

  <Step title="Configure Auto-Exit on Audience or Frequency Mismatch">
    * When **OFF**: Customers are evaluated **only once** with each cycle when they enter the flow (at the time the campaign is triggered).
    * When **ON**: Customers are **re-evaluated before each step**. If they **no longer match the audience** criteria or have **exceeded their entry frequency**, they are **automatically exited** from the automation.

    <Frame>
      <img src="https://mintcdn.com/gameball/tEm0zYZGDqbMoeMn/images/product-docs/automation-campaigns/auto-exit-toggle.png?fit=max&auto=format&n=tEm0zYZGDqbMoeMn&q=85&s=39e13941b4e9f0bfed805748a659e0bc" alt="Auto-exit on audience or frequency mismatch toggle" width="1440" height="354" data-path="images/product-docs/automation-campaigns/auto-exit-toggle.png" />
    </Frame>
  </Step>

  <Step title="Set Automation Goal">
    Each automation supports defining **one goal** from any Gameball event (custom or predefined). You can add optional filters (e.g., order value, product category) and set a measurement window such as 7, 14, or 30 days. Goals can be added or edited in draft mode, with changes to published automations applying only to new participants.

    <Frame>
      <img src="https://mintcdn.com/gameball/tEm0zYZGDqbMoeMn/images/product-docs/automation-campaigns/automation-goal-setup.png?fit=max&auto=format&n=tEm0zYZGDqbMoeMn&q=85&s=ff06d7f90a7d53bf516ed2aed3481424" alt="Automation goal setup" width="1342" height="460" data-path="images/product-docs/automation-campaigns/automation-goal-setup.png" />
    </Frame>

    **Automated Goal Tracking for Each Customer:**

    * After a customer completes the automation, Gameball automatically tracks whether they perform the defined goal event within the selected timeframe. Each customer is marked as **Achieved**, **Pending**, or **Not Achieved**, with full visibility inside customer logs.

    **Goal Performance Analytics & Reports:**

    * A new **Goal Performance** tab has been added to automation insights. It displays total participants, completions, goal achievements, and conversion trends over time. All goal results can be exported to CSV for deeper analysis.
  </Step>

  <Step title="Set an Exit Rule">
    Click **Add Rule** under **Exit Automation Rule.**

    **What is an Exit Rule?**

    It is a condition or a set of conditions that, if met by a member of the audience, the automation will no longer be applied. For example, if a guest registers and becomes a registered customer, the automation events will no longer be applied to them.

    <Frame>
      <img src="https://mintcdn.com/gameball/Ym44GvndYOgHCcbm/images/product-docs/automation-campaigns/exit-rule-setup.png?fit=max&auto=format&n=Ym44GvndYOgHCcbm&q=85&s=b23e9bf674b0cba6a13b25d47ac32115" alt="Exit automation rule setup" width="1594" height="390" data-path="images/product-docs/automation-campaigns/exit-rule-setup.png" />
    </Frame>

    From the dropdown list, choose between:

    * **Event:** The customer will exit the automation when they complete a specified action.
    * **Profile Attribute:** The customer will exit the automation when their profile has a specified type of information.
  </Step>
</Steps>

***

## How to Create an Automated Workflow

Before diving into your first automated workflow, here's what you need to understand:

Automated workflows comprise three key elements: Triggers, Actions, and Controls.

<CardGroup cols={3}>
  <Card title="Triggers" icon="bolt">
    A workflow always begins with a trigger initiated by the customer.
  </Card>

  <Card title="Actions" icon="play">
    These are the responses or actions you define when triggers are activated by the customer.
  </Card>

  <Card title="Controls" icon="sliders">
    Optionally, you can incorporate conditions before executing actions using controls.
  </Card>
</CardGroup>

Now, let's walk through the steps to build an automation:

<Steps>
  <Step title="Name Your Workflow">
    Start by giving your automation a distinct name to easily identify it on the dashboard.

    <Frame>
      <img src="https://mintcdn.com/gameball/Ym44GvndYOgHCcbm/images/product-docs/automation-campaigns/name-workflow.png?fit=max&auto=format&n=Ym44GvndYOgHCcbm&q=85&s=4607532deca1e86a27e7eb8ae54bbb66" alt="Naming your automation workflow" width="2992" height="1494" data-path="images/product-docs/automation-campaigns/name-workflow.png" />
    </Frame>
  </Step>

  <Step title="Choose a Trigger">
    Select a trigger event to kickstart your automation. Simply drag and drop your preferred trigger from the list. Available triggers include:

    * **Account Created**
    * **Receive Event**
    * **Level Changed**
    * **Challenge Achieved**
    * **Segment Entered**
    * **Segment Exited**
    * **Tag Added**
    * **Tag Removed**
    * **Webhook Trigger**
    * **OnDate Trigger**
    * **Automation Completed**
    * **Expiring Points**

    <Frame>
      <img src="https://mintcdn.com/gameball/Ym44GvndYOgHCcbm/images/product-docs/automation-campaigns/trigger-selection.png?fit=max&auto=format&n=Ym44GvndYOgHCcbm&q=85&s=939c1b912829a3bf4f7be29b46858543" alt="Trigger selection panel" width="2992" height="1498" data-path="images/product-docs/automation-campaigns/trigger-selection.png" />
    </Frame>
  </Step>

  <Step title="Add Trigger Criteria">
    Define specific criteria for the chosen trigger event. Click on the selected trigger and choose criteria from the dropdown list. Remember to save your selections. [Learn more about Triggers and their criteria](/product-documentation/automation-campaigns/automation-triggers).
  </Step>

  <Step title="Implement Control (Optional)">
    At this stage, you have two choices:

    * **Direct Action**: Add an action to be executed immediately after the trigger is activated.
    * **Control Mechanisms**: Alternatively, you can use control mechanisms to manage the workflow before executing actions. Choose from:
      1. **Wait for Event**: Delay the next action until a specific event is completed by the customer.
      2. **Time Delay**: Introduce a waiting period before the next action is triggered.
      3. **Conditional Split**: Create divergent paths within the workflow based on different conditions.
      4. **A/B Test:** Split audiences into groups (A & B) with a fully customizable ratio (e.g., 50/50, 70/30).

    [Learn how each of the controls works.](/product-documentation/automation-campaigns/automation-controls)
  </Step>

  <Step title="Take Action">
    Actions are commands executed by Gameball when specific conditions are met within the workflow. These actions can be triggered when the workflow is initiated or when predetermined criteria are fulfilled.

    Available actions include:

    * **Send Email**
    * **Send Mobile Push**
    * **Send Web Message**
    * **Reward a Coupon**
    * **Reward a Challenge**
    * **Add Points**
    * **Deduct Points**
    * **Add Tag**
    * **Remove Tag**
    * **Send Webhook**

    [Learn more about the actions and how you can set them up.](/product-documentation/automation-campaigns/automation-actions)

    <Note>
      You can send a test email to yourself when using the "**Send Email**" as an action to a trigger in an automation.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/gameball/Ym44GvndYOgHCcbm/images/product-docs/automation-campaigns/send-test-email.png?fit=max&auto=format&n=Ym44GvndYOgHCcbm&q=85&s=0f72949a2b12c154624df3a6e629c50b" alt="Send test email option in automation" width="2722" height="1360" data-path="images/product-docs/automation-campaigns/send-test-email.png" />
    </Frame>
  </Step>

  <Step title="Add More to Your Workflow if Needed">
    You can expand your automation as necessary, as long as it maintains coherence, streamlines manual tasks, saves time, and serves its intended purpose. Below is an illustrative example of an interconnected workflow.

    <Frame>
      <img src="https://mintcdn.com/gameball/tEm0zYZGDqbMoeMn/images/product-docs/automation-campaigns/complete-workflow-example.png?fit=max&auto=format&n=tEm0zYZGDqbMoeMn&q=85&s=76ae3f44ec435082fce4c1572fcd01a1" alt="Example of a complete interconnected automation workflow" width="1358" height="396" data-path="images/product-docs/automation-campaigns/complete-workflow-example.png" />
    </Frame>
  </Step>
</Steps>

***

## Using Attributes in Automation

You can use attributes to set your own rules for each trigger, action, or control. Here is how attributes work in automations.

By clicking the **Plus Icon** inside any trigger or actions, a small pop-up will appear giving you a list of attributes under 3 different tabs:

* **Previous Steps:** Dynamic attributes passed by previously chosen Event, Condition, or API (such as Order ID, Points Earned, or Friend Name) from one node to another inside your automations. Variables here will be dependant on attributes used in the previous trigger or action.
* **Customer Variables:** All customer-related variables such as name, ID, number, referral link, etc.
* **Global Variables:** Variables that have to do with your general configurations, like chosen currency, points name, score name, etc.

<Frame>
  <img src="https://mintcdn.com/gameball/tEm0zYZGDqbMoeMn/images/product-docs/automation-campaigns/attributes-popup.png?fit=max&auto=format&n=tEm0zYZGDqbMoeMn&q=85&s=28e9acdbf60fb4ea0fda987a61e60d1d" alt="Attributes popup showing Previous Steps, Customer Variables, and Global Variables tabs" width="1292" height="972" data-path="images/product-docs/automation-campaigns/attributes-popup.png" />
</Frame>

Here is a list of attributes you will find while creating your automation:

| Previous Steps                                                                                                                                                                       | Customer Variables                                                                                                                                                                                                                                                                                                                         | Global Variables                                                                             |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
| Depends on the previously used variables in the former step. ([Check this article for more details](/product-documentation/automation-campaigns/attributes-across-automation-nodes)) | Unique ID, First Name, Last Name, Display Name, Customer's Mobile, Referral Link, Mobile Referral Link, Points, Tier Up total progress, Score Name, Points, Coupon Code, Coupon Value, Reward Campaign Reward, Tier Entry Reward, Tier Lifetime Reward, location, membershipLevel, graduationDate, isMarried, occupation, company, hobbies | Equivalent value of total points, Currency, Points Name, Referral Link, Mobile Referral Link |

***

## Email Customization with Block Variables

Now, you have the ability to incorporate block variables directly into your email variables, enabling the creation of highly personalized and contextually relevant email content.

Each block within the automation is assigned a unique identifier in the form of a 4-digit ID, displayed in uppercase. For instance, if a block rewards a coupon, users can easily reference the coupon code variable under the email variables section, denoted by its ID, such as \[CP02] Reward a coupon.

<Frame>
  <img src="https://mintcdn.com/gameball/Ym44GvndYOgHCcbm/images/product-docs/automation-campaigns/email-block-variables.png?fit=max&auto=format&n=Ym44GvndYOgHCcbm&q=85&s=c0d0b71e47fc5a985f81bbb6e29b9d67" alt="Email block variables showing coupon code reference" width="610" height="406" data-path="images/product-docs/automation-campaigns/email-block-variables.png" />
</Frame>

Moreover, if there are multiple instances of the "Reward a coupon" block within the automation, all relevant coupon code variables are conveniently listed under the email variables, allowing for comprehensive customization.

<Note>
  These variables will only appear in the email variables list if they precede the block being edited.
</Note>

***

## Tracking Customers' Progress in Automation

### On the Main Automation Page

<Frame>
  <img src="https://mintcdn.com/gameball/tEm0zYZGDqbMoeMn/images/product-docs/automation-campaigns/automation-main-page-tracking.png?fit=max&auto=format&n=tEm0zYZGDqbMoeMn&q=85&s=a246ff64601ae0345fd2290cfa38555a" alt="Automation main page showing customer progress data" width="2940" height="1428" data-path="images/product-docs/automation-campaigns/automation-main-page-tracking.png" />
</Frame>

Check the data list beside each automation. This bar displays:

* The targeted audience chosen under **Audience**.
* The number of customers who started or had the automation applied to them under **Customers Started**.
* Information about which stage of the automation the customers have reached under **Customers Currently in**.
* The count of customers who have completed all automation stages under **Customers Completed**.

### Detailed View

To check a detailed view, select an **automation** and click **Show More Details**.

<Frame>
  <img src="https://mintcdn.com/gameball/tEm0zYZGDqbMoeMn/images/product-docs/automation-campaigns/automation-detailed-view.png?fit=max&auto=format&n=tEm0zYZGDqbMoeMn&q=85&s=5859bb44ef14c631098742de875f5d10" alt="Detailed view of customer progress in automation" width="2398" height="1486" data-path="images/product-docs/automation-campaigns/automation-detailed-view.png" />
</Frame>

You'll be directed to a page showing details of all customers who entered the automation flow and their current stage.

***

## Where to Find the Inactive Automation

<Steps>
  <Step title="Open the Automation Main Page">
    Navigate to the Automation main page from the left sidebar.
  </Step>

  <Step title="Click Draft">
    Click **Draft** to filter to inactive automations.
  </Step>

  <Step title="View Draft Automations">
    You will find a list of all your saved inactive automations.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/gameball/Ym44GvndYOgHCcbm/images/product-docs/automation-campaigns/draft-automation-list.png?fit=max&auto=format&n=Ym44GvndYOgHCcbm&q=85&s=bb11884e73224c7d89efcb41d6c8575b" alt="Draft automation list" width="2940" height="1426" data-path="images/product-docs/automation-campaigns/draft-automation-list.png" />
</Frame>

### Managing Existing Automation

For Automation **Deactivation, Duplication, Editing, or Deletion**:

<Steps>
  <Step title="Open the Options Menu">
    Hover over the **3 dots icon** next to any existing automation.
  </Step>

  <Step title="Choose an Action">
    Choose from the **menu** the action that you want to do:

    * Deactivate
    * Duplicate
    * Edit
    * Delete
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/gameball/Ym44GvndYOgHCcbm/images/product-docs/automation-campaigns/manage-automation-menu.png?fit=max&auto=format&n=Ym44GvndYOgHCcbm&q=85&s=cfc1da071dac62d77d7b5e059dc5d61e" alt="Automation management menu with deactivate, duplicate, edit, and delete options" width="2938" height="1432" data-path="images/product-docs/automation-campaigns/manage-automation-menu.png" />
</Frame>

By following these steps, you can efficiently create, track, and manage automated workflows using Gameball's Automation Campaigns.

***

## Export Customers from All Automation Action & Control Nodes

You can now export customers who reach any **Action** or **Control** node inside an automation flow.

This enhancement allows teams to run deeper analysis, build external segments, integrate with other tools, or take manual actions outside Gameball.

<Frame>
  <img src="https://mintcdn.com/gameball/Ym44GvndYOgHCcbm/images/product-docs/automation-campaigns/export-customers-node.png?fit=max&auto=format&n=Ym44GvndYOgHCcbm&q=85&s=c436016cc22e020692f02f40224b4f85" alt="Export customers from automation nodes" width="1883" height="844" data-path="images/product-docs/automation-campaigns/export-customers-node.png" />
</Frame>

### Export Availability

All **Action** and **Control** nodes now include a new option: **Export Customers**. Supported node types:

<CardGroup cols={2}>
  <Card title="Action Nodes" icon="play">
    Send Email, Send Web Message, Grant Reward, and others.
  </Card>

  <Card title="Control Nodes" icon="sliders">
    Wait, Time Delay, Condition, A/B Test.
  </Card>
</CardGroup>

### Export Behavior

* Selecting **Export Customers** initiates a CSV file export of all customers who have **successfully reached** the selected node.
* The export includes **full historical data**, not just recent activity.
* Once prepared, the system sends the CSV file to you via **email**.
