Documentation

Getting Started
Gleam Updates
Capture
Competitions
Galleries
Rewards
Installation
Advanced
Integrations
Action Types
Guides

Custom Actions

This documentation covers how Custom Actions work.

Apps that support Custom actions:

Custom Actions

Custom Actions allow you to create any sort of action type that doesn't exist natively within the Gleam interface. This option opens up millions of potential combinations for your creative mind.

Admin View

Setting up a custom action is fairly open ended, since you can create whatever you want. In the admin area you must give the action a Title that will be shown on the widget before it's clicked, once you do that you are ready to fill out the bulk of the actual action - this area accepts basic HTML (there's also instructions to add buttons below).

Public View

Format

The format field allows you to verify questions against a specific regex. This is particularly useful for validating an input is the correct length or meets a certain pattern.

This Feature has been replaced by the new Secret Code action.

This greatly enhances things like OrderID as you know your OrderID's follow a specific format. We also have customers that are using this field for things like:

  • Validating codes handed out in-Store
  • Getting users to SMS a number for a code to enter

This is an advanced feature only available to Business customers, contact us if you need help setting this up.

Unique Code Example

Verification Methods

I'll Know

Using this option will simply allow users to continue from the action right away. This option presents the least amount of friction.

Ask a Question

If you need some information to validate if a user actually completed an action then you can ask a question.

  • What was your OrderID?
  • Paste in the URL you shared our post on
  • What email address did you signup with?
  • What name did you post a comment with?


Use Tracking

Tracking allows Business customers to keep an action in a locked state until the user has successfully completed the required conversion.

API Tracking Example

View Custom Tracking Docs

Allow Tracking or Question

Sometimes, the tracking may not work with certain browser combinations, cookies or plugins. You also then have the option to allow a fallback question for those users that can't unlock the action.

Images

You can add images to your Gleam custom action using the img HTML tag. Please note that you must store the images yourself somewhere (i.e. Dropbox).

Colours & Icons

You have the ability to add custom colours as HEX codes to your custom action types, you can also give them custom icons using the icon code from the Font Awesome link provided.

Adding Buttons

One of the great things about our custom actions is that they support HTML, this means you can add a wide variety of buttons & icons.

Large Button

<a href="http://yoursite.com" class="btn btn-large">Large Button</a>

Large Blue Button

<a href="http://yoursite.com" class="btn btn-large btn-info">Large Blue Button</a>

Large Green Button

<a href="http://yoursite.com" class="btn btn-large btn-success">Large Green Button</a>

Large Yellow Button

<a href="http://yoursite.com" class="btn btn-large btn-warning">Large Yellow Button</a>

Large Red Button

<a href="http://yoursite.com" class="btn btn-large btn-danger">Large Red Button</a>

Large Embossed Button

<a href="http://yoursite.com" class="btn btn-large btn-embossed">Large Embossed Button</a>

Adding Icons to Buttons

You are free to use any of the icons from this Font Awesome pack.

Large Blue Button With Twitter Icon

<a href="http://yoursite.com" class="btn btn-large btn-info btn-embossed"><i class="icon-twitter"> </i>Large Blue Button With Twitter Icon</a>

Example Custom Actions

Custom actions allow you to create your own action type from scratch, they are also useful to create an action type that perhaps isn't supported by Gleam yet.

Custom Actions Example

Connect With Us