Village Product and Developer Docs
  • 📘Welcome to Village Labs
    • Welcome to Village Labs
    • Self Service Onboarding
    • Help Pages
      • Adding and Deleting Users
      • Mapping Users to Source tool IDs
      • How to follow or unfollow other users
      • Configuring & Removing Daily Slack Notification Whitelist
      • Changing the Reporting Lines & Teams
      • Following Custom Reports
      • Google Drive Privacy: When will my documents appear in Village Reports?
    • Custom Reports
      • Creating Team Reports
      • Creating Custom Reports & Custom Prompt Library
    • Meetings
      • Connecting your Calendar
      • Configuring your Meetings
      • Meeting Summary Reports
    • Village Assistant
      • Github PR Review Tool
    • Security & Compliance
    • Data Privacy & Permissions
  • 🔌Data Connections
    • Airtable
    • Ashby
    • Clickup
      • Finding ClickUp User IDs
    • Figma
    • Github
      • Finding GitHub User IDs
    • Gitlab
    • Google - OAuth (Recommended)
    • Google - Manual Connection
    • Hubspot
    • Jira
      • Finding Jira User IDs
    • Confluence
      • Finding Confluence / Jira User IDs
    • Linear
    • Asana
    • Monday
    • Notion
    • Pipedrive
    • Slack
    • Basecamp
    • Zoom
  • 👩‍💻Legacy Developer Docs
    • Developer Quickstart
    • Village APIs: Introduction
      • Activity API
      • User Status API
      • Patch User API
      • Segments API
      • Redemption API
      • Master Award Controls
      • Connections (Referrals) APIs
      • GET APIs
    • 3rd Party Payments Integrations
    • Embedding Village Dashboards
  • 🕵️LEGACY Knowledge Base
    • Admin Quickstart
    • Referrals Support
    • The Basics of Village in 15 Minutes
    • Programs & Rules
      • Triggers
        • Activities
        • Goals
      • Conditions
        • Segment Conditions
        • Time Conditions
        • Max Budget Conditions
        • Conditional Multipliers
    • Awards
      • Monetary (Cash) Awards
      • Non-Monetary Awards
        • Funding
          • In-depth use cases for funding pools
      • Badges & Statuses
      • Award Expiration
    • Segments
      • Segmentation Use Cases
    • Rule Evaluation Logic Deep-dive
    • The Village Dashboards
      • Admin Account Creation
      • User Access Management
      • Network Settings
      • User Dashboard
    • BigQuery
    • Managing Payment Integrations
    • Referrals (Connections)
      • Pre-populating Users' Unique Referral Codes In Signup Flows & Forms
  • No and Low Code Solutions
    • No and Low Code Solutions
      • No & Low Code Solutions
  • Feedback
    • Village Docs Feedback Form
    • Feature Requests
    • Talk to our Team
Powered by GitBook
On this page
  • Triggers Overview
  • Types of Triggers in Village
  • Activity Triggers
  • Goals Triggers

Was this helpful?

  1. LEGACY Knowledge Base
  2. Programs & Rules

Triggers

Things that cause rules to be evaluated

PreviousPrograms & RulesNextActivities

Last updated 1 year ago

Was this helpful?

Triggers Overview

Triggers are what kick off a rule’s evaluation process. Each rule must have a trigger, and if the evaluation of the rule is successful, the rule will be executed. Triggers can cause a rule to be evaluated in one of two ways: based on some specific activity that has occurred, or based on a schedule.

  • 1. Activity: Any real-world or app-based action, like onboarding, completing a transaction, or making a delivery, can trigger a rule evaluation. These activities are configured and passed to Village through our secure rest API or through a third-party data connection.

  • 2. Schedule: Some rules have specified evaluation schedules, for example "daily at 9pm GMT", and will be triggered at the scheduled dates and times. Specifically, Goal-based Triggers can be evaluated on a schedule.

When you create an activity-based trigger, you are effectively telling the API or data connection to listen for any events that trigger the rule. When it hears these events, the rule will be evaluated. If the evaluation is successful, it’ll execute the rule. This is the same for scheduled evaluations, except that a date and time sets off the rule evaluation, rather than an event.

Types of Triggers in Village

Please see the (Actions and Sales), and for a detailed breakdown of each.

Here's a quick summary of the types of triggers that can be created in Village: Activities and Goals.

Activity Triggers

Action Triggers

Action triggers are the simplest type of trigger. They correspond to events that occur on your platform, such as user sign-up, document upload, or delivery completion. These triggers are straightforward to set up and can be used in any rule, or as a component of a goal trigger.

When a corresponding event or activity happens on your platform, Village detects the event and triggers the evaluation of the associated rule.

Sales Triggers

Sales triggers function similarly to action triggers. When using a Sales trigger, you likely don't just care that the sale occurred, but also the total GMV or the value of a specific sale and trigger a rule evaluation accordingly. Examples include providing an additional promo on top of every sale corresponding to basket-size, offering a 5% cashback on every sale, or modifying commission rates for transactions of a certain size.

Note that although we distinguish between Action and Sales Triggers on a functional level, they both use the Activity API.

Goals Triggers

Goals trigger a rule only when that goal’s evaluation criteria has been satisfied. This means they introduce the concept of logic into a trigger, and allow you to set specified thresholds or conditions that you want a trigger to pass before a rule is evaluated.

Here's a very simple example of how to think about using an Action trigger versus a Goal Trigger. Let's say I want to award $5 every time a user completes a trip. I would use a simple Action trigger "Trip Complete" to award $5 every-time a trip completes.

Now let's say I only want to award a user the first time they complete a trip. I need logic to evaluate this. I'd use a Goal trigger, with logic "Trip Complete" = 1. Similarly I could award $5 only when the user completes 5 trips, where "Trip Complete" = $5.

When you set up Goal triggers, you can choose whether you want to consider activities, or awards and segments, as part of the evaluation:

  • Activity-based goals: these can be as simple as the number of actions meeting some specified threshold, or more nuanced, like multiple separate actions meeting specified thresholds as defined by the logic implemented when creating the goal.

    • Example: a goal could specify that a user must fulfill ten deliveries within a given time period for the goal evaluation criteria to be passed.

  • Award & segment-based goals: these function similarly to activity-based goals except they require a user to be in a segment, or have some defined number of awards. These types of goals can be set to run off scheduled evaluation frequencies to ascertain whether a meets the qualification criteria.

    • Example: a user must have over 10,000 points to pass the goal evaluation.

🕵️
Activity Triggers
Goal Triggers