Rewarded ads
people choose to watch.

// Illustrative: ZurlaSDK, its API and the placement are
// placeholders until engineering confirms them.
import UIKit
import ZurlaSDK
final class LevelViewController: UIViewController {
    private let extraLife = ZurlaRewarded(placement: "extra_life")
    private let player = "player-1234"  // your own player ID
    private var lives = 0
    override func viewDidLoad() {
        super.viewDidLoad()
        extraLife.load()  // load ahead, ready for the offer
    }
    // Show your offer while an ad is ready (offline, it stays hidden).
    var canOfferLife: Bool { extraLife.isReady }
    // The player tapped "Watch ad" on your offer.
    func playerChoseToWatch() {
        guard extraLife.isReady else { return }
        // playerID comes back in Zurla's signed callback to your server.
        extraLife.show(from: self, playerID: player) { [weak self] reward in
            // Runs when the ad ends: fine for a life or a hint.
            // Grant coins from the server-side callback instead.
            self?.lives += reward.amount
        }
    }
}

// Illustrative: com.zurla.sdk, its API and the placement are
// placeholders until engineering confirms them.
package com.sorrelby.brindleblocks
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import com.zurla.sdk.ZurlaRewarded
class LevelActivity : AppCompatActivity() {
    private val extraLife = ZurlaRewarded("extra_life")
    private val playerId = "player-1234"  // your own player ID
    private var lives = 0
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        extraLife.load()  // load ahead, ready for the offer
    }
    // Show your offer while an ad is ready (offline, it stays hidden).
    fun canOfferLife() = extraLife.isReady
    // The player tapped "Watch ad" on your offer.
    fun playerChoseToWatch() {
        if (!extraLife.isReady) return
        // playerId comes back in Zurla's signed callback to your server.
        extraLife.show(this, playerId) { reward ->
            // Runs when the ad ends: fine for a life or a hint.
            // Grant coins from the server-side callback instead.
            lives += reward.amount
        }
    }
}

// Illustrative: the Zurla Unity package, its API and the placement
// are placeholders until engineering confirms them.
using UnityEngine;
using Zurla;
public class LevelAds : MonoBehaviour
{
    private ZurlaRewarded extraLife;
    private const string PlayerId = "player-1234";  // your own player ID
    private int lives;
    private void Start()
    {
        extraLife = new ZurlaRewarded("extra_life");
        extraLife.Opened += PauseGame;   // the game holds still
        extraLife.Closed += ResumeGame;  // while the ad is open
        extraLife.Load();  // load ahead, ready for the offer
    }
    // Show your offer while an ad is ready (offline, it stays hidden).
    public bool CanOfferLife => extraLife.IsReady;
    // The player tapped "Watch ad" on your offer.
    public void OnPlayerChoseToWatch()
    {
        if (!extraLife.IsReady) return;
        // PlayerId comes back in Zurla's signed callback to your server.
        extraLife.Show(PlayerId, reward =>
        {
            // Runs when the ad ends: fine for a life or a hint.
            // Grant coins from the server-side callback instead.
            lives += reward.Amount;
        });
    }
    private void PauseGame() { Time.timeScale = 0f; }
    private void ResumeGame() { Time.timeScale = 1f; }
}

// Illustrative: the zurla_ads plugin, its API and the placement
// are placeholders until engineering confirms them.
import 'package:flutter/material.dart';
import 'package:zurla_ads/zurla_ads.dart';
class LevelScreen extends StatefulWidget {
  const LevelScreen({super.key});
  @override
  State<LevelScreen> createState() => _LevelScreenState();
}
class _LevelScreenState extends State<LevelScreen> {
  final extraLife = ZurlaRewarded('extra_life');
  final playerId = 'player-1234';  // your own player ID
  int lives = 0;
  @override
  void initState() {
    super.initState();
    extraLife.load();  // load ahead, ready for the offer
  }
  // Show your offer while an ad is ready (offline, it stays hidden).
  bool get canOfferLife => extraLife.isReady;
  // The player tapped "Watch ad" on your offer.
  void onPlayerChoseToWatch() {
    if (!extraLife.isReady) return;
    // playerId comes back in Zurla's signed callback to your server.
    extraLife.show(playerId: playerId, onReward: (reward) {
      // Runs when the ad ends: fine for a life or a hint.
      // Grant coins from the server-side callback instead.
      if (mounted) setState(() => lives += reward.amount);
    });
  }
  @override
  Widget build(BuildContext context) => Text('Lives: $lives');
}

// Illustrative: @zurla/react-native-ads, its API and the placement
// are placeholders until engineering confirms them.
import React, { useEffect, useState } from 'react';
import { Button, Text, View } from 'react-native';
import { ZurlaRewarded } from '@zurla/react-native-ads';
const extraLife = new ZurlaRewarded('extra_life');
const playerId = 'player-1234';  // your own player ID
export default function LevelScreen() {
  const [lives, setLives] = useState(0);
  useEffect(() => {
    extraLife.load();  // load ahead, ready for the offer
  }, []);
  // The player tapped "Watch ad" on your offer.
  const onPlayerChoseToWatch = () => {
    if (!extraLife.isReady) return;
    // playerId comes back in Zurla's signed callback to your server.
    extraLife.show({
      playerId,
      // Runs when the ad ends: fine for a life or a hint.
      // Grant coins from the server-side callback instead.
      onReward: (reward) => setLives((n) => n + reward.amount),
    });
  };
  return (
    <View>
      <Text>Lives: {lives}</Text>
      {/* Show your offer while an ad is ready (offline, it stays hidden). */}
      {extraLife.isReady && (
        <Button title="Watch ad for one more life" onPress={onPlayerChoseToWatch} />
      )}
    </View>
  );
}

// Illustrative: the callback's fields, its signature and the key are
// placeholders until engineering confirms them. Zurla calls the URL
// you set in your account each time a rewarded ad ends.
import crypto from 'node:crypto';
import express from 'express';
import { grantOnce } from './rewards.js';  // your own store
const app = express();
const KEY = process.env.ZURLA_CALLBACK_KEY;  // from your Zurla account
app.get('/zurla/reward', async (req, res) => {
  const { player_id, reward, amount, transaction_id, signature } = req.query;
  // 1. Check that the callback comes from Zurla.
  const payload = [transaction_id, player_id, reward, amount].join(':');
  const expected = crypto.createHmac('sha256', KEY).update(payload).digest('hex');
  const signed = typeof signature === 'string' && signature.length === expected.length
    && crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
  if (!signed) return res.sendStatus(403);
  // 2. Grant each reward once, even when a callback arrives twice.
  await grantOnce(transaction_id, player_id, reward, Number(amount));
  res.sendStatus(200);
});
app.listen(8080);

{
  "app": {
    "bundle": "<App Store ID>",
    "publisher": { "id": "ZRL-000000" }
  },
  "imp": [{
    "id": "1",
    "tagid": "extra_life",
    "instl": 1,
    "rwdd": 1,
    "secure": 1,
    "video": {
      "mimes": ["video/mp4"],
      "w": 390,
      "h": 844,
      "maxduration": 30
    }
  }],
  "source": {
    "schain": {
      "ver": "1.0",
      "complete": 1,
      "nodes": [{ "asi": "zurla.com", "sid": "ZRL-000000", "hp": 1 }]
    }
  }
}