General blocks

The blocks on this page can be added to any build type, hence considered "general".

Content/Text Block

The Content block is a simple block that can be used to display a title and description. It can be used as an introduction to the quiz (= cover block) or as a conclusion.

Example:

{
    "type": "Content",
    "title": "Welcome to the quiz",
    "description": "This quiz will test your knowledge about the world"
}

Ad Block

In the ad block it is optional to add a title and description - both are optional as the Ad block does not necessarily need neither of them.

Adding ad blocks is possible in two ways:

Project ad slots

To add an ad to your build using a project ad slot, you need to add the property projectSlot in the Ad block, consisting of:

PropertyRequiredTypeDescriptionDefault
slotId✓ObjectThe ad slot to use(no default)
variablesObjectAn object with key-value pairs to override ad slot variables(no default)

Example:

{
    "type": "Ad",
    "projectSlot": {
        "slotId": "123456"
    }
}

Example with variables:

{
    "type": "Ad",
    "projectSlot": {
        "slotId": "123456",
        "variables": {
            "ad-variable-key1": "override-value1"
        }
    }
}

Custom iframe

To be more flexible with ads & to be more independent from the Riddle Creator you can add an Ad block with the iframe object set, consisting of:

PropertyRequiredTypeDescriptionDefault
url✓URLThe URL the iframe should link to(no default)
heightintegerThe height of the iframe in px; automatic resizing does not work with custom iframes80

Example:

{
    "type": "Ad",
    "iframe": {
        "url": "https://www.example.com/ad.html",
        "height": 250
    }
}

Full example

For this example we build a poll with a content + ad block.

{
    "type": "Poll",
    "build": {
        "title": "My poll",
        "blocks": [
            {
                "type": "Content",
                "title": "Welcome to the quiz",
                "description": "This quiz will test your knowledge about France"
            },
            {
                "type": "MultipleChoice",
                "question": "What is the capital of France?",
                "answers": {
                    "Paris": true,
                    "Lissabon": false,
                    "Berlin": false
                }
            },
            {
                "type": "Ad",
                "projectSlot": {
                    "slotId": "123456"
                }
            }
            {
                "type": "MultipleChoice",
                "question": "How do you say 'hello' in French?",
                "answers": {
                    "Bonjour": true,
                    "Hallo": false,
                    "Ciao": false
                }
            },
        ],
    }
}
Table of Contents