Brand Bonus Widget

⚠️ Important Notice: We are transitioning from <bw-widget> to <nw-blocks> tags. While <bw-widget> is still supported for backward compatibility, all new implementations should use <nw-blocks>. Please update your existing widgets when possible.


Overview

The Brand Bonus Widget displays a comprehensive brand card featuring the brand logo, bonus information, and a customizable call-to-action button. This widget is ideal for showcasing casino or sports betting promotions with bonus details and compliance information.

Key Features:

  • Brand logo display with tracking
  • Bonus and extra bonus text display
  • Customizable CTA button with gradient colors
  • Optional social proof ribbon
  • Compliance disclaimer support
  • Full-width layout option
  • Responsive design

Basic Usage

Standard Brand Bonus Widget

Expand me...

With Custom Button Colors

Expand me...

For Different Languages and Countries

Expand me...


Attributes Reference

Attribute Type Default Description
id string required Component identifier (brandbonus)
cloakedlink string "" The cloaked tracking link slug for the brand
language string "en" Language code (e.g., “fr”, “en”, “es”)
country string "ZZ" Country code (e.g., “FR”, “US”, “DE”, “ZZ” for generic)
countryState string - State code for US/CA (e.g., “NY”, “ON”)
ctakey string "wgt-reviewpage-cta-getbonus" i18n translation key for button text
ctatext string "" Custom button text (overrides ctakey translation)
target string "_blank" Link target attribute
rel string "nofollow" Link rel attribute
trackinglinktarget string "" Additional tracking target parameter
referer string - Referer parameter for tracking
ctacolors string/array "#05842A" Button gradient colors (single color or array: ['start', 'end'])
ctahovercolors string/array "#096725" Button hover gradient colors (single color or array)

Widget Layout

The Brand Bonus Widget is structured with three main sections:

1. Logo Section (Left)

  • Displays the brand logo
  • Clickable with tracking
  • Automatically fetched based on cloaked link

2. Bonus Section (Center)

  • Shows bonus text and additional bonus information
  • Can be hidden via backend configuration
  • Supports bonus ribbon tags
  • Displays social proof text when available

3. CTA Button (Right)

  • Customizable button with gradient colors
  • Supports text color and background customization
  • Includes tracking parameters
  • Arrow icon included

Color Configuration

The widget supports flexible color configuration for the CTA button:

Single Color

ctacolors="#05842A"
ctahovercolors="#096725"

Gradient Colors (Array Format)

ctacolors="['#05842A', '#04691E']"
ctahovercolors="['#096725', '#065520']"

The button will create a gradient from the first color to the second color.


Advanced Features

1. Full-Width Layout

The widget can be configured to span the full width of its container (controlled via backend configuration).

2. Compliance Disclaimer

Automatically displays compliance disclaimers when configured for specific brands, products, countries, and languages.

3. Social Proof Ribbon

When social proof data is available, a ribbon displays ratings or vote counts.

4. Bonus Flexibility

  • Primary bonus text
  • Additional bonus text
  • Bonus tag/ribbon
  • Option to hide all bonus information

5. No Bonus Case

When bonus information is hidden or unavailable, the widget adapts its layout accordingly.


Integration with Tracking

The widget includes comprehensive tracking capabilities:

  • Widget ID: Unique identifier passed in URL parameters (wid)
  • Tracking Link: Generated from the cloaked link
  • Tracking Target: Additional targeting parameter
  • Tracking Data: Custom tracking data
  • Referer: Optional referer parameter

Generated URL Format:

https://{websiteId}/go/{cloakedLink}/{trackingTarget}?wid={id}&trackingData={data}&referer={referer}

Backward Compatibility

All examples above use the new <nw-blocks> tag. If you need to use the legacy <bw-widget> tag for backward compatibility, simply replace <nw-blocks> with <bw-widget> in any example:

<!-- New way (recommended) -->
<nw-blocks id="brandbonus" cloakedlink="greatwin-casino" language="en">
</nw-blocks>

<!-- Old way (still supported) -->
<bw-widget id="brandbonus" cloakedlink="greatwin-casino" language="en">
</bw-widget>

Both tags work identically and support all the same attributes and functionality.


Common Use Cases

1. Casino Promotion Card

<nw-blocks id="brandbonus" 
    cloakedlink="your-casino" 
    language="en" 
    country="US"
    ctakey="cta-claim-bonus"
    ctacolors="['#05842A', '#04691E']">
</nw-blocks>

2. Sports Betting Bonus

<nw-blocks id="brandbonus" 
    cloakedlink="your-sportsbook" 
    language="en" 
    country="UK"
    ctatext="Bet Now"
    trackinglinktarget="homepage"
    ctacolors="['#1E90FF', '#0066CC']">
</nw-blocks>

3. Localized French Market

<nw-blocks id="brandbonus" 
    cloakedlink="french-casino" 
    language="fr" 
    country="FR"
    ctakey="cta-claim-bonus"
    trackinglinktarget="welcome-bonus">
</nw-blocks>

4. Custom Branded Colors

<nw-blocks id="brandbonus" 
    cloakedlink="your-casino" 
    language="en" 
    country="CA"
    ctatext="Join Now"
    ctacolors="['#FF6B35', '#F7931E']"
    ctahovercolors="['#E85A2B', '#E07A0A']"
    referer="campaign-2024">
</nw-blocks>

Best Practices

  1. Always Specify Language and Country: For accurate content delivery and compliance
  2. Use Descriptive CTA Text: Clear, action-oriented button text improves conversions
  3. Consistent Color Schemes: Match button colors with your brand identity
  4. Include Tracking Targets: For better analytics and campaign tracking
  5. Test Across Markets: Different countries may have different bonus structures and compliance requirements

Styling Notes

The widget includes several CSS classes for customization:

  • .umbrella-widget: Main widget container
  • .no-disclaimer: Applied when no compliance disclaimer is present
  • .is-fw: Applied for full-width layouts
  • .has-label-rated: Applied when social proof ribbon is present
  • .no-bonuses: Applied when bonus information is hidden

These classes can be targeted with custom CSS for additional styling.