Channels

This page is for marketers and campaign managers. A channel is the thing you paste into your site once. Campaigns take turns behind it, so changing the game never needs a code change. For the bigger picture, see Concepts.

Create a channel

1. Choose Channels in the sidebar, then New channel. The same button sits at the top of every page.
2. Enter a Name. Name it after the place on your site, such as “Homepage promo slot”. Only your team sees this name.
3. Choose Create channel.

Your plan sets how many channels you can have. If you reach the limit, the dashboard tells you and suggests deleting a channel you no longer embed. See Plans.

The Channels page shows each channel as a card: what is Running now (or Nothing live), how many campaigns it has, when the live campaign changes or the next one starts, and its status (Active or Disabled). Each card links to Campaigns and Embed.

The Campaigns tab

Open a channel to see its Campaigns tab: what has run on this channel, what is running and what is queued. One campaign can be live on a channel at a time.

Each campaign card shows one of these:

Label	Meaning
Live now	Active and inside its live window. This is what visitors see.
Queued	Its live window has not started yet, or it has not been activated.
Finished	Its live window has ended.

Each card also shows the Live window (for example “From 1 Nov”, or No window set) and a Results link. Use the filter above the list to show one group at a time.

To add a campaign, choose New campaign. See Create a campaign.

The Embed tab

The Embed tab has everything a developer needs to put the channel on your site. Paste the snippet once. It keeps working when the campaign behind the channel changes.

1. 1. Mint a client token, server-side. Your backend asks Keliplay for a short-lived token with your API key and hands it to the page. This is never done in the browser. See Authentication.
2. 2. Embed the game. The code, in four versions: HTML / Script tag, React, Android and iOS, each with this channel’s id filled in. Copy the one you use. See Embed on the web and Mobile apps.

The tab also shows:

• Allowed origins: the web addresses allowed to show your games. Type an address such as https://www.example.com and choose Add. A token for an address that is not on this list is refused. If the list is empty, the tab warns you that every token request will fail. Manage in Settings → opens the full list, where you can also add mobile apps. See Allowed origins.
• Webhooks: how many endpoints are active, with a link to manage them.

The Settings tab

Between campaigns

What the embed shows when nothing is live: before the first campaign, between two, and after the last. Set something here, because a blank space on your page is rarely what you want.

• Heading, for example “Back soon”.
• Message, for example “The next game starts on Monday.”
• Image URL: an https address of an image.

Choose Save message. The message is shown as plain text and an image.

Channel play limits

How often one person may play across everything this channel runs. These sit alongside each campaign’s own limits, and whichever runs out first stops the player.

• Total plays per person
• Plays per person per day
• Day boundary: the time zone that decides when a person’s “today” restarts, for the per-day limit.

Leave a limit empty for unlimited. Choose Save limits.

Channel status

Disable channel stops the embed serving a game. Visitors see your between-campaigns message instead. Every play record is kept, and you can choose Enable channel to turn it back on.

Delete channel removes the channel for good. The snippet on your site stops working.

Caution

You can only delete a channel that has never run a campaign. Once one has run, disable the channel instead. Deleting it would reset the play limits counted against it.