This documentation covers the actions that we support via YouTube.
Applications that support YouTube actions:
If a user connects their YouTube account or performs an action that requires authorisation, then they will be required to authenticate with the Gleam Competitions YouTube app.
Please note, these are the default permissions for any app on YouTube. Gleam will not do anything via the API without your explicit click or permission whilst entering a campaign. Verifying Subscriptions and Commenting will ask for extended account permissions.
Commenting on a YouTube video is a common way channels will ask their users to enter into a competition or sweepstakes. Gleam provides the ability to allow users to comment on a video whilst still being inside our widget.
Gleam supports the ability to send users to your channel subscription page as an action type. Please note, we do not incentivize them for actually subscribing, so users are free to not subscribe if they wish.
Using the Verify checkbox allows us to verify the users Subscription via the YouTube API, this is a great way of ensuring that users complete the action - however it will increase the barrier to entry by asking the user to connect their YouTube account to Gleam.
Please note that there can be a delay on Subscriptions appearing in the API sometimes, in which case we'll display a message asking the user to try again in a few minutes.
After clicking the button users will be asked to confirm their subscription:
The YouTube Submit action allows you to ask users to submit any YouTube video as an entry into your contest. It's possible to link these videos to a Gallery (if you wanted to run a video submit competition) and let users view and vote on them.
Gleam supports the ability to watch a YouTube video as an action type.
In order to use this feature you will need the full YouTube video URL, here's an example:
In order to make sure that a user watches all of the video before continuing you will need to add some additional parameters to hide the controls & YouTube branding.
To do this simply add the following to the Player parameters input:
We've created an example competition that you can play with, it contains all of the actions that we've covered in this guide.
We have a number of other resources and guides that can help you get more out of your YouTube contest with Gleam.