Gamification ideas for events

Driving interactivity and engagement in an event can be a challenge, but it can be made easier through gamification with Pigeonhole Live. Using Pigeonhole Live’s API, you can track attendees participation to design custom leaderboards or create rules to drive traffic to conference booths. You can even integrate Pigeonhole Live analytics with other 3rd party event platforms.

Prerequisites

API Key (this will be assigned to the variable $API_KEY in this guide)

Objectives

Event-wide leaderboard
Participation in conference booths
Exports interaction data in Pigeonhole Live to 3rd party event platform analytics

1. Event-wide leaderboard

NOTE

The event-wide leaderboard cannot be set-up natively in Pigeonhole Live currently, and our team is evaluating the possibility of this feature on our platform. We recognize customer’s needs in this area, and hence we are sharing some API to support this functionality. Should the event-wide leaderboard be built, please note that you will still have to integrate with your platform for a holistic end to end leaderboard.

Encourage active participation from attendees throughout the event by designing an event-wide leaderboard. The custom leaderboard can be based on a points system, where attendees are ranked by the amount of points accumulated from engaging in different touchpoints during the event.

You can increase the opportunities for attendees to earn points by leveraging Pigeonhole Live’s platform. They can receive points for submitting questions during Q&A, and even responding to polls or surveys through our platform. Award bonus points to those who submit questions that are answered by speakers.

The attendee’s participation data on Pigeonhole Live can then be retrieved through Pigeonhole Live’s API. This can be done every few minutes, and a roll out summary will be shown on your end to refresh the leaderboard regularly.

To retrieve the list of attendees that had joined Pigeonhole, you can call the List Attendee endpoint.

curl -X GET https://api.pigeonholelive.com/v2/pigeonholes/$PIGEONHOLE_ID/attendees \ 
  -H "X-API-KEY: $API_KEY" \ 
  -H "Content-Type: application/json"

An example response:

{
    "data": [
        {
            "id": 1,
            "content": "When was Pigeonhole Live founded?",
            "status": "allowed",
            "createdAt": "2022-09-29T09:42:05Z",
            "attendee": {
                "id": 1,
                "attendeeCode": "ABC12",
                "anonymous": false
            },
            "session": {
                "id": 1,
                "name": "This is a session name"
            }
        }
    ],
    "links": {
        "next": null
    },
    "meta": {
        "perPage": 30,
        "nextCursor": null,
        "hasMore": false
    }
}

This will allow you to create the initial leaderboard list. Next is to retrieve the interactions by the users in each session. There are different types of interactions data that are available for each session type. For example, to get the list of all the votes in an MCQ session, you can call the List Poll Multiple Choice votes endpoint

curl -X GET https://api.pigeonholelive.com/v2/pigeonholes/$PIGEONHOLE_ID/poll-mcq-votes \ 
  -H "X-API-KEY: $API_KEY" \ 
  -H "Content-Type: application/json"

This will return a response like this.

{
    "data": [
        {
            "id": 1,
            "createdAt": "2022-09-29T09:42:05Z",
            "attendee": {
                "id": 1,
                "anonymous": false
            },
            "session": {
                "id": 1,
                "name": "This is a session name"
            },
            "question": {
                "id": 1,
                "content": "When was Pigeonhole Live founded?"
            },
            "option": {
                "id": 1,
                "content": "Example option"
            }
        }
    ],
    "links": {
        "next": null
    },
    "meta": {
        "perPage": 30,
        "nextCursor": null,
        "hasMore": false
    }
}

Each interaction entry is tied to an Attendee ID which can be mapped back to the Attendee list retrieved earlier.

For other types of interactions, see the available endpoints under Interactions.

Completed objective

Event-wide leaderboard

2. Participation in conference booths

NOTE

Tracking of individual participant’s activities cannot be set-up natively in Pigeonhole Live, and our team is evaluating the possibility of this feature on our platform. We recognize customer’s needs in this area, and hence we are sharing some API to support this functionality. Should this feature be built, please note that you will still have to integrate with your platform for a holistic end to end leaderboard.

Events with booth activities can make use of the API to encourage participants to participate in each booth. Booth owners can utilize Pigeonhole Live’s quiz or poll question types to engage participants and award points for each correct answer or completed quiz. Participants will answer the questions through the ‘Audience Web App’ platform and event organizers can retrieve their participation data via Pigeonhole Live’s API. The points could be used to boost their ranking on the custom leaderboard or even redeem for gifts provided by event sponsors.

The organizers of each booth could extract the analytics by collecting the participation rate and this could allow them to better plan their future activities.

To get a list of votes for a particular session and attendee, the List Poll Quiz votes endpoint can be used.

curl -X GET https://api.pigeonholelive.com/v2/pigeonholes/$PIGEONHOLE_ID/poll-quiz-votes?filter[attendeeId]=$ATTENDEE_ID&filter[sessionId]=$SESSION_ID \ 
  -H "X-API-KEY: $API_KEY" \ 
  -H "Content-Type: application/json"

This will return the following response:

{
    "data": [
        {
            "id": 1,
            "timeTaken": 10,
            "createdAt": "2022-10-04T09:49:17Z",
            "attendee": {
                "id": 1,
                "attendeeCode": "ABC12",
                "anonymous": false
            },
            "session": {
                "id": 1,
                "name": "This is a session name"
            },
            "question": {
                "id": 1,
                "content": "When was Pigeonhole Live founded?"
            },
            "option": {
                "id": 1,
                "content": "2010"
            }
        }
    ],
    "links": {
        "next": null
    },
    "meta": {
        "perPage": 30,
        "nextCursor": null,
        "hasMore": false
    }
}

Completed objective

Participation in conference booths

3. Export interaction data in Pigeonhole Live to 3rd party event platform analytics

Have a holistic overview of your event’s performance by augmenting existing Pigeonhole Live analytics with your own platform. This can be done through Pigeonhole Live’s API and you can see all your event data from one platform conveniently.

Some of the interaction analytics available for export from Pigeonhole Live are:

Questions submitted by attendees
Answers given for each poll

You can also obtain interaction data on an attendee level to gather more granular and comprehensive insights.

To retrieve all the Q&A questions posted by a particular attendee, you can make use of List Q&A questions and filter by the Attendee ID.

curl -X GET https://api.pigeonholelive.com/v2/pigeonholes/$PIGEONHOLE_ID/qna-questions?filter[attendeeId]=$ATTENDEE_ID \ 
  -H "X-API-KEY: $API_KEY" \ 
  -H "Content-Type: application/json"

The result:

{
  "data": [
        {
            "id": 1,
            "content": "When was Pigeonhole Live founded?",
            "status": "allowed",
            "createdAt": "2022-09-29T09:42:05Z",
            "attendee": {
                "id": 1,
                "attendeeCode": "ABC12",
                "anonymous": false
            },
            "session": {
                "id": 1,
                "name": "This is a session name"
            }
        }
    ],
    "links": {
        "next": null
    },
    "meta": {
        "perPage": 30,
        "nextCursor": null,
        "hasMore": false
    }
}

Completed objective

Export interaction data in Pigeonhole Live to 3rd party event platform analytics

Prerequisites

Objectives

1. Event-wide leaderboard​

NOTE

Completed objective

2. Participation in conference booths​

NOTE

Completed objective

3. Export interaction data in Pigeonhole Live to 3rd party event platform analytics​

Completed objective

1. Event-wide leaderboard

2. Participation in conference booths

3. Export interaction data in Pigeonhole Live to 3rd party event platform analytics