Table of Contents
Overview
FreeWheel DSP Solutions supports extensive white labeling capabilities. Several fields in the UI appearance and automated emails can be customized. Additionally, the domain name can be set behind an alias using a CNAME record.
For further details on what can be customized, as well as instructions for white labeling these components, see below.
White Label FreeWheel DSP
DSP customers have the option to customize the UI within each account as well as remove the FreeWheel branding from system emails. Navigate to the below sections for instructions on how to white label these features.
Customize the UI Appearance
The following features in the UI can be customized through the account settings page:
Main Color | Hex, RGB, or HSL color string | Color for main navigation bar |
Text & Icon Color | Black or white | Color for navigation bar text |
Logo | JPG, JPEG, PNG, SVG, or URL string | Image to use for logo in main navigation bar |
How to White Label the UI
To white label the main color, text & icon color, or logo, do the following:
- Navigate to Admin > Accounts > Select an account name from the List View > Settings.
- To the right of "Navigation Style" heading, toggle on "Custom Style". Once "Custom Style" is on, these features can be customized:
- Main Color
- Select the color code to choose the color for the main navigation bar by using the color picker or by inputting a color code
- Use the up and down arrows to the right of the color code to pick between Hex, RGB, and HSL color code formats
- Text & Icon Color
- Choose between black and white for the color of the icons and text in the main navigation bar
- Logo
- Upload a logo to replace the FreeWheel logo in the main navigation bar
- Acceptable image formats include JPG, JPEG, PNG, SVG, and image URL
- Main Color
White Label System Emails
DSP customers can opt in to a simplified email template that removes all FreeWheel branding for their system emails by turning on the "Custom Style" feature in account settings.
To turn on "Custom Style":
- Navigate to Admin > Accounts > Select an account name from the List View > Settings.
- To the right of "Navigation Style" heading, toggle on "Custom Style".
White Labeling Buyer Cloud
Customize the UI Appearance
Buyer Cloud customers can access the same UI white labeling features as DSP customers and two additional options. Below are all UI white labeling options and how to enable them:
Main Color | Hex, RGB, or HSL color string | Color for main navigation bar | For an individual account, see the How to White Label the UI section above; to customize at the buzzkey level, contact your account representative. |
Text & Icon Color | Black or white | Color for navigation bar text | For an individual account, see the How to White Label the UI section above; to customize at the buzzkey level, contact your account representative. |
Logo | JPG, JPEG, PNG, SVG, or URL string | Image to use for logo in main navigation bar | For an individual account, see the How to White Label the UI section above; to customize at the buzzkey level, contact your account representative. |
Website Icon | URL string | Image to use for website icon (favicon) | Contact your account representative. |
Page Title | String | Browser page title | Contact your account representative. |
Customize the Login Page Appearance
All five Buyer Cloud UI customization options can also be applied to the login page. To add customization to your login page, contact your Account representative with the fields you want customized.
Customize System Email Template
Buyer Cloud customers have the option to apply their own custom branding to their system emails.
Emails are sent to users for the following events:
- Alert emails
- Query Tool scheduled reports
- Reporting scheduled reports
- User creation
- Password resets
The email address and email content can be white labeled for all these processes, with the exception of reports sent from Report Builder, where the "from email address" is always set to the bidderreport.com domain.
To white label emails, please follow the below steps:
- Share the email address you wish emails to come from with your account representative. FreeWheel will send a verification email to that address. Click on the link within the email to finalize the set up.
Depending on your firewall settings, FreeWheel Engineering may need to generate DKIM records and send the record set to you to configure on your end. Configuring DKIM records is a way for your server to register the signature that FreeWheel adds to the emails.
- Provide the system fields to be white labeled and the new values for your account representative.
The parts of an email that can be rebranded are detailed in the table below:
Email Logo | URL String | Logo to use in email templates |
Project Name | String | Project name to use in email templates, such as "My Bidder" |
Project Website | URL String | URL to link to in emails |
Email Sender | String | The sender for emails from this system. For example, email@mybidder.com. |
Email "From Name" | String | The name of the sender for emails from this system, such as "My Bidder" |
Email "From Address" | String | From address for emails, if different from the above "Email Sender." Must be a valid email address. |
Bidder UI URL | String | Any links in the email directing the user to the UI will use this domain for the landing page. This should match your CNAME bidder domain. For more details on CNAME bidder domains, see White Label Bidder Domain Using a CNAME below. |
White Label Bidder Domain Using a CNAME
To white label the bidder domain, create a CNAME and verify CNAME ownership:
- Share the desired domain name with your account representative.
- Your account representative will request an SSL certificate from AWS for the CNAME provided and generate a validation CNAME DNS record.
- Your account representative will return the CNAME DNS record, which contains the following details:
- Name
- Type: CNAME
- Value
- Create a CNAME record using the information provided above to verify ownership of the domain within 72 hours; after this time, the verification will fail. The procedure for adding CNAME records can vary depending on the DNS service provider.
- If verification fails, FreeWheel will restart all processes starting from step 2.
- Create a secondary CNAME record for the preferred URL for the UI (such as "mybidder.customer.com") and point it to ".beeswax.com".
- Once verification is complete, FreeWheel will finalize the CNAME deployment.
The REST API endpoint cannot use a CNAME, and as a result cannot be white labeled.
Features That Cannot be White Labeled
The following features are not able be white labeled:
- Cookie syncing process
- Segment Tags
- Postback URLs
- Conversion/Event Tags
Additionally, creative previews cannot be white labeled, but can be removed entirely if needed.