Your own offers

PlansFreeStarterProUltra

Offers shows your own bonus offers inside the widget: a sign-up bonus, an enhanced price, a free bet. You write each offer once, choose where it appears and how it looks, and the widget shows each visitor the offers meant for their country and device. You find it in the Offers section of the right-hand column of the configurator.

Offers are separate from affiliate links and banners: an affiliate link is one button in a match row, an offer is a unit of its own with your brand, the offer, its terms and a button.

How it works

The Offers section has three tabs:

• Offers (N): your offer library. Each offer has a brand, the offer itself, a button and its terms.
• Placements (N): where offers appear, in which format and style.
• Settings: switches that apply to every offer.

Every change shows in the preview at once. When you add your first offer, two placements switch on with it: an offer list Above the matches and a strip in the Match window footer. Change or remove them in Placements.

Formats

A list shows offers that have a Headline. An offer without one is a brand placement: it appears in offer cards, strips and the pinned bar, not in lists.

For lists you also choose:

• Density: Compact or Comfortable;
• Offers shown: 1 to 5 (default 3), and how many to show when the widget is narrower than 560 px (Below 560 px) or, for a grid, When tiles stack (default 2);
• Title, shown above the list (default: "Offers", in the widget language), and an optional See all link with its own label.

Placements

Item pages are the match, team, competition and player views that open inside the Livescore with the In-widget content navigation mode. Between leagues goes after the third competition of the list, not counting the favourites group, so it needs at least three competitions; it does not appear when Match layout is Grid. The Match window footer is the bottom of the window that opens over the widget; it is always in view. Offers never appear in floating cards.

To keep the widget readable:

• One commercial element per zone. An offer in a banner zone takes the place of the banner in that zone. If the offer has nothing for a visitor (no offer for their country, for example), the banner shows instead.
• At most two units on the same screen. The top banner counts as one while it is shown. In the match window on a phone, only one.
• A brand never repeats on the page. When two units could show the same brand, the placement that comes first in this order keeps it: Above the matches, Top of the widget, Item pages, top, Between leagues, Bottom of the widget, Item pages, bottom. The match window counts apart: its strip can show a brand that is also on the page.
• One unit per placement. If two placements point to the same place, the first one switched on is used.

Style and colours

Each placement has a Style:

• Follow cards: the surface of your template's cards, so the unit looks like part of the widget;
• Bordered: an outline in your accent colour and an outlined button, on your card surface;
• Solid: the unit filled with your accent colour.

Under Colours you can override eight colours, separately for the light and the dark theme: Background, Text 1 (primary), Text 2 (secondary), Border, Button background, Button text, Badge background and Badge text. If you set a background without its text colour, the widget picks a readable text colour for it. The editor warns when a pair you chose is below a 4.5:1 contrast.

Each offer can also have a Brand colour. It paints the plate behind the logo, and a thin top edge on grid tiles and on the offer card.

Offer card background

An Offer card can have a Card background:

• Gradient: a gradient per theme, edited like the other gradients of the configurator. The editor warns when your text does not stay readable where the gradient is weakest.
• Image: an https:// image. Use a dark, low-detail image: the text sits on top of it, over a dark layer.

Featured offer and badge

• Tick Featured on one offer to highlight it. It carries a Top offer label (in the widget language) and leads the pinned bar. Only one offer can be featured at a time.
• Badge adds a short label of your own to an offer, such as Exclusive (up to 16 characters).
• Promo code shows the code with a copy button.

Pin while scrolling

PlansFreeStarterProUltra

Pin while scrolling keeps a compact bar on screen after the reader has seen the unit and scrolled past it. It is offered on Above the matches and Top of the widget (banner zone), at the Top or the Bottom edge.

• An offer card, a strip and a grid that fits on one row pin as they are.
• A list, or a grid that wraps, pins as a bar with the featured offer (or the first one) and +N offers, which opens the full list.
• The bar shows the brand, a Visit button, the Advertising label with the age chip, and the responsible-gambling line. It never covers the unit while the unit is back in view.
• Readers can hide the bar with its close button. It stays hidden for the rest of their visit.
• A sticky banner keeps its edge: if your top banner is sticky, offers can only pin to the bottom, and the other way round.
• Floating cards keep the bottom edge: while an item is pinned, offers do not pin to the bottom.

The other placements do not pin: item pages have their own sticky header, and the match window footer is always in view.

Writing an offer

Use the arrows to change the order of your offers, and the buttons next to each offer to duplicate or delete it.

Every offer link opens in a new tab with rel="sponsored noopener". Only https:// links are shown. The offer frame (title, labels, buttons) follows the widget language. Your own texts (brand, offer, terms) are shown as you wrote them, in their own reading direction, also in an Arabic or Persian widget.

Settings

Plans and limits

PlansFreeStarterProUltra

The editor shows how many you use, for example 3 / 10 offers and 2 of 4 placements on. Offers above your limit are not shown, and placements above it are switched off; they come back when you upgrade. Free and Starter cannot add offers. Custom plans agree their limits with SoccersAPI.

Your markets, your rules

You manage the regulation of your offers in each market. The widget gives you tools; it does not decide what is legal where you advertise.

• Warnings, never blocks. The editor points out common problems: a missing brand or button link, an offer with no terms, "risk-free" wording, words such as "free" or "bonus" where they are restricted, pinning in Spain, or an offer visible in a country that your own policy restricts. Under Review, it lists markets with special rules where the offer can be seen. They are reminders to check, not legal advice, and you can always save.
• Targeting per offer: countries, devices, unknown country and an end date (see Writing an offer).
• Disclosure: the Advertising label, the age chip, the terms, the operator line in Spain, Mexico and Colombia, and a responsible-gambling line with a help link taken from the visitor's country, as in the widget's notice. Strips carry the label, the age chip and the terms only: the operator and responsible-gambling lines appear in lists, offer cards and the pinned bar.
• Your compliance policy. With Apply my compliance policy to offers on, gambling offers are hidden wherever your compliance policy switches off affiliate links or commercial banners: in the countries you restrict, everywhere in Clean mode, everywhere when you turn on Disable affiliate links or Disable commercial banners, and for visitors whose country cannot be detected when you restrict countries or set a site jurisdiction (unless you turn off Block betting when country is unknown). Automatic (the default) is on as soon as you have declared such a policy, and off otherwise. Offers in the Other category are never hidden by it.
• A policy agreed in your contract with SoccersAPI always applies to gambling offers, even with the setting Off.

Events for your analytics

The widget tells your page when an offer is seen and clicked, with the ls:offer-impression and ls:offer-click events. An impression counts when at least half of the unit has been on screen for one second, once per offer and placement while the page is open. The widget does not count them for you: send them to your own analytics. See Events for developers.

Events need the script installation of paid plans, which offers need anyway.

If an offer does not show

• Offers on is off, or the placement is switched off or above your plan's limit.
• The offer has no Brand name, or its button Link is missing or does not start with https://.
• A list only shows offers with a Headline.
• The offer is limited to other countries or devices, its Show until day has started, or the visitor's country is unknown and the offer hides in that case.
• Between leagues needs at least three competitions in the list and does not appear with Match layout set to Grid.
• Another unit already uses the two places on screen, or the same brand is already shown elsewhere on screen.
• Your compliance policy hides gambling offers for that visitor.