Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents
minLevel1
maxLevel7

Automatically Identifying Players

The integration with Vii Events supports automatic identification of players. When a game is embedded into Vii Events, you can skip the form as we’ll already know who they are. This makes for a better user experience and simpler workflow when awarding prizes or posting points to a leaderboard. To make this work, here’s what you need to do:

When iFraming a game you could dynamically append a Universally unique identifier (UUID) to the "webhook_var[UUID]" query string parameter. This webhook_var parameter will be forwarded back to your inbound webhook endpoint URL.

Here's an example of embedding a game with an attendee that has a UUID of 56:

https://local-play.captello.com/Activations/loader/index.html?game=REARRANGE_WORDS&token=SKMq9wxebZrpwa4U1628010677&is_web_portal=0&webhook_var[UUID]=56

Info

If you need to forward more parameters to the webhook, then it is better to name the parameter as something like webhook_var_parameter. So, you can have different parameters like: webhook_var_param1=x&webhook_var_param2=y&webhook_var_param3=z

Sending Points to Vii Events Leaderboard

...

  1. Use the +/- to add/remove one or more webhooks. Multiple webhooks can trigger simultaneously.

  2. Choose to send our standard payload to your Endpoint URL or select one of our integrations to send a payload formatted for the integration partner.

  3. Enter the Endpoint URL where you want us to send the payload. Make sure you have a script to parse the payload. This would be your inbound webhook URL.

  4. Decide whether or not to include Prospect information (email, name, etc.) to adhere to your company’s privacy policy.

Automatically Identifying Players

The integration with Vii Events supports automatic identification of players. When a game is embedded into Vii Events, you can skip the form as we’ll already know who they are. This makes for a better user experience and simpler workflow when awarding prizes or posting points to a leaderboard. To make this work, here’s what you need to do:

When iFraming a game you could dynamically append a Universally unique identifier (UUID) to the "webhook_var[UUID]" query string parameter. This webhook_var parameter will be forwarded back to your inbound webhook endpoint URL.

Here's an example of embedding a game with an attendee that has a UUID of 56:

...

  1. .

...

Retrieving Captello game URL

...