These docs are for v1.2. Click to read the latest docs for v1.3.

Triggers

Triggers initiate the delivery of preconfigured content from the ACTV8me backend.

Overview

The ACTV8me Platform supports the following trigger types:

  • Audio Fingerprints
  • Audio Watermarks
  • Media
  • QR Code
  • Geofence
  • Touch
  • Beacon
  • Hyperlink

📘

Trigger configuration

The trigger configuration, content grouping, and targeting settings are contained in the Delivery Preset. For more information, please refer to Delivery Preset.

Audio

An Audio Watermark is a type of trigger that uses an inaudible unique code embedded within a piece of audio content (this code is undetectable to the ear). This allows for the delivery of specific content upon trigger detection by the ACTV8me SDK.

An Audio Fingerprint is activated by the audio without embedding a code into a specific file. Therefore, a fingerprint can be activated by any copy of the audio as long as it is identical to the original. For example, a commercial or song can be fingerprinted in one place and activated in another without any exchange of files (again, this code is undetectable to the ear).

The following properties are part of an audio trigger:

PropertyDescription
Ad IdIndustry standard for identifying advertising assets (broadcast, print and digital) across all media platforms
BrandA name, term, design, symbol, or any other feature that identifies one seller's goods or services
Media TypeTV commercial, TV In-show, Video clip or Audio Clip
Media SourceResource that serves as a means of communicating to a general audience
NetworkTelecommunications network for distribution of television program content, whereby a central operation provides programming to many television stations or pay television providers

To create an Audio trigger:

  1. Click Triggers in the top navigation bar and select Audio
  2. Select Add Audio Watermark or Add Audio Fingerprint
  3. Enter the name of the trigger
  4. Under Audio Details, click Select Media and insert file. This can be a 15-30 second commercial or a longer show clip.

📘

Ideally, the file should be under 100mb for optimal performance.

  1. If desired, add tags, then click the plus (+) sign.
  2. Enter the Ad Id, Brand, Media Type, Media Source and Network.

Media

A Media trigger can deliver ACTV8me content while the video player is playing video content.

The following properties are part of a Media Trigger:

PropertyDescription
NameTitle of the Media Trigger
Media Ida set of numbers and letters that are specific to a media file
Media TypeTV show, ad or video clip
DescriptionSpecific details of the trigger

To create a Media trigger:

  1. Click Triggers in the top navigation bar and select Media
  2. Click Add Media on the top right
  3. Click the Select Media box and add media
  4. Enter the Name, Media Id, Media Type and Description
  5. For Delivery Preset and Targeting, please refer to Delivery Preset
  6. Add trigger to the selected Campaign and Application
  7. Click Create

QR Code

A QR Code trigger allows an end-user to receive content after scanning the code from a display (i.e. a screen placed in the lobby of a building or mounted on a wall of an elevator, a poster placed in a strategic location within a grocery store).

The following properties are part of a QR Code trigger:

PropertyDescription
NameTitle of the QR Code Trigger.
QR Code URLThis is the URL to redirect to the micro-site. It is disabled and auto generated upon trigger creation.
SizeSize of the QR code image.

To create a QR Code Trigger:

  1. Click Triggers in the top navigation bar and select QR Code.
  2. Click Add QR Code on the top right.
  3. Enter the Name and Size (default is already set to 300).
  4. For Delivery Preset and Targeting, please refer to Delivery Preset.
  5. Add trigger to the selected Campaign and Application.
  6. Click Create.
  7. After successfully completing the QR Code creation, you can download the QR code image in PNG or JPEG format

Example of a QR code trigger:

433

Geofence

A Geofence trigger allows an end-user to receive content after entering a physical location that has been previously "fenced" by an admin user. Examples of locations are: retail stores, museums, venues, landmarks, etc.

PropertyDescription
NameTitle of the geofence trigger.
LocationAddress of the location where the geofence will be placed
RadiusThe radius of the geofence

To create an Geofence trigger:

  1. Click Triggers in the top navigation bar and select Geofences
  2. Click Add Geofence on the top right
  3. Type in the name of the Geofence
  4. Enter the location on the location line or select a spot using the map powered by Google
  5. Use the slider to adjust the radius (in meters) of the Geofence

📘

The system will provide longitude and latitude coordinates for reference

  1. For Delivery Preset and Targeting, please refer to Delivery Preset
  2. Add trigger to the selected Campaign and Application
  3. Click Create

Touch

A Touch trigger allows an end-user to receive content after pressing a button on a screen (i.e. mobile device, touchscreen, etc).

PropertyDescription
NameName of the touch trigger

To create a Touch trigger:

  1. Click Triggers in the top navigation bar and select Touch
  2. Click Add Touch on the top right
  3. Type in the name of the Touch Trigger
  4. For Delivery Preset and Targeting, please refer to Delivery Preset
  5. Add trigger to the selected Application
  6. Click Create

Beacon

A Beacon trigger allows an end-user to receive content after a radio signal from a Bluetooth transmitter (beacon) is detected.

PropertyDescription
NameTitle of the beacon trigger

To create a Beacon trigger:

  1. Click Triggers in the top navigation bar and select Beacon
  2. Click Add Beacon Trigger on the top right
  3. Type in the name of the Beacon
  4. Click + Add Beacon
  5. Click on the desired Beacon and click Add
  6. For Delivery Preset and Targeting, please refer to Delivery Preset
  7. Add trigger to the selected Campaign and Application
  8. Click Create

What’s Next