Widgets

A widget is a popular ad format that combines several ads in one block. Though Adserver.Online doesn't support widgets in a separate ad format (meaning you won't find a special ad code for widgets on the panel), so we have a special tool that allows you to create ad widgets manually.

As a result, you will be able to create widgets like this: https://adserver.online/demo/widgets/

Please note that each ad in a widget is served independently. A widget is only a visual composition of independent ads in a block.

How to create a widget

The following information should be considered a recommendation. Widgets don't have built-in checks on image size, etc. Feel free to experiment with different sizes/formats/styles, but first, follow our recommendations to get a general understanding of how ad widgets work.

1. Add a zone

Format: Banner
Size: 200×200

2. Create ads

Format: Native banner
Image proportion: 16:9
On the banner form, you should select options as follows:

Since widgets don't display duplicated ads by default, you should create at least one ad per widget slot. For example, if you are going to make a widget with 4 slots, it's better to create at least 4 ads.

3. Write an ad code

<ins id="asoWidget1"></ins>
<script data-cfasync="false">
    (function (w, a) {
        w[a] = w[a] || {};
        w[a].queue = w[a].queue || [];
        w[a].queue.push(function () {
            _ASO.loadScript("https://media.aso1.net/js/wgts/w2.js", function () {
                createWidget("asoWidget1", {
                    zone: XXXXX
                    /* additional options here */
                });
            });
        });
    })(window, "_aso");
</script>
<script data-cfasync="false" async="async" src="https://media.aso1.net/js/code.min.js">

Where XXXXX is the zone ID you get in step 1) above.

Additional parameters:

  • cols – number of columns. Default 4, max 6
  • rows – number of rows. Default 1, max 3
  • theme – changes the widget's colour (the text colour only). Values: dark or white. Default: white.
  • css – a string that defines a custom CSS style to be used on a widget's iframe and applied to all widget's content.
  • nad – allow/disallow displaying duplicated ads. Default "true" – (note: it's a string, not boolean!) This means that a widget will not display duplicated ads by default. If you want to allow duplicated ads, use a "false" value.

If you'd like to publish several widgets on the same page, you need to use a unique widget ID for each widget.

<ins id="asoWidgetXXX"></ins>
<script data-cfasync="false">
  ...
  ...
          createWidget("asoWidgetXXX", {
              ...
          });
  ...
  ...
</script>
<script data-cfasync="false" async="async" src="https://media.aso1.net/js/code.min.js">

Please note that since widgets contain several ads in them, each ad creates a separate ad request. Therefore, one widget creates as many ad requests simultaneously as there are ads in it.