Brands Configuration

Learn how to create a brand and upload a logo in Partner Portal.

Partner logos are surfaced to users as part of the flow to accurately describe where the inventory originates from. Uploading logos is a mandatory step in completing your integration, so please follow the instructions below.

Note: The settings in the Configuration > Brands tab are environment specific.

Adding a brand and logo

Partners may use a single brand or multiple brands across their inventory. If multiple brands are used, each brand should have its own logo and corresponding metadata.

A brand contains

  • Logo: See specific logo requirements below.
  • Terms of Service: URL to the brand's terms of service page (Not required for redirect integrations).
  • Privacy Policy: URL to the brand's privacy policy page (Not required for redirect integrations).
  • Merchant Signup URL: URL to the brand's merchant sign-up page.
    • Country-specific URLs can also be specified which overrides the brand-level URLs based on the location of the merchant.
  • Opt-out URL: URL provided by the brand where a merchant can opt-out of being included in your data feed.
  • Domains: Domains are used to associate a group of top-level URLs with a specific brand. For example, you can have your UK domains show a UK-specific brand.
  • Domain Country: Associates your domain to a specific country. Can be set to "All Countries".

Every merchant that you submit to Actions Center by data feeds or API requests is strictly associated with a single brand. If the brand ID is left unset, a merchant is associated with the default brand.

Default Brands

Your default brand is already included in your Actions Center account and has special behavior when compared to any additional brands:

  • The default brand has a blank value for "Brand Id".
  • At least 1 domain must be set in the default brand for your inventory to go live.
  • All inventory will map to your default brand, regardless of domain, unless the domain matches a different brand.

Multiple Brands

If your brand is known by a different name or logo in a different region of the world, you can configure multiple brands.

This example assumes the brand is called "Example Company".

  1. Configure your default brand as "Example Company" and add "example.com" as the domain.
  2. Set the country as "All Countries".
  3. Create a new brand called "Example Company UK"
  4. Set the domain as "example.co.uk" and the country as "UK".

End-to-end integration

Each brand can have its own logo, as well as its own Terms of Service, Privacy Policy, and Merchant signup URLs. Country-specific URLs can also be specified, which, if provided, override the brand-level URLs based on the location of the merchant.

Defining multiple brands is optional. It is recommended if your business manages multiple user-facing brands, or if your business operates in multiple countries that each have their own unique branding.

The requirements to upload a logo for an integration are the following:

Logo Guidelines

Although brands and their associated attributes are defined per environment, it's generally recommended that you keep your brand definitions synchronized between your Sandbox and Production Environments.

If you wish to update our partners page with a new logo or URL, open a case on Partner Portal for support. The logos on the partners page aren't the same logos used in "Brand Configuration."

Each brand can have its own logo and country-specific URLs.

The requirements to upload a logo for a business link or redirect integration are the following:

Logo Guidelines

Instructions to create a brand:

  1. Go to the ‘Brands’ tab under 'Configuration' in Partner Portal
  2. If not already in the 'Sandbox Environment', switch to it in the top environment switcher.
  3. Click on the pencil icon after hovering over a brand to add a logo to an existing brand or click ‘Add Brand’ to create a new brand.
  4. Click the ‘Upload’ button to select a logo file for upload.
  5. Confirm that the logo passes all requirement checks.
  6. Press ‘Submit’ at the bottom of the menu to save your changes.
  7. Once you have confirmed the logo is correct, switch to 'Production Environment' in the top environment switcher and replicate steps 1-6.

This section describes the guidelines to follow when you create assets for your logo listing on the Actions Center.

When you create your artwork, ensure it conforms to the following requirements:

  • Final size: 512 px x 512 px.
    • Logo should be placed in the middle of the 512px x 512px square with max size of 384px x 384px
    • Note: Effective draw space is 384px x 384px
  • Format: 32-bit PNG.
  • Color space: sRGB.
    • Note: No transparent background is allowed
    • A logo can have any background color that follows the partner brand guidelines
    • The background color should cover the entire 512px x 512px area
    • The artwork must be placed within the 384px x 384px drawspace at the center.
  • Max file size: 1024 KB.
  • Shape: Full square.
    • Actions Center dynamically handles masking.
    • Radius is equivalent to 20% of icon size.
  • Shadow: None.

You should design your logo to be 512px x 512px, but the icon asset work should only populate the 384px x 384px centered space. It is recommended to use keylines as guidelines and position your artwork elements on a keyline grid. After the asset is uploaded, the Actions Center dynamically applies the rounded mask to ensure consistency across all icons and logos.

Example of a logo:

Asset size.
Asset size.
Figure 1. Total logo dimensions and size.
Keylines.
Figure 2. Example icon keylines that showcase 384px x 384px of effective drawspace. Note: the space outside of the 384px x 384px center is reserved for an empty margin.

 

Size

Reminder: 1. Use the center asset space (384px x 384px) as the background when you deal with minimalistic artwork. 2. Use the keylines as guides when you position artwork elements, such as logos.

Full bleed.
Figure 3. The final asset, which uses all of the available asset space (The center 384px x 384px)
Rounded corners.
Figure 4. Actions Center dynamically applies the result with rounded corners and a border.

Do not force your logo or artwork to fit the full asset space. Instead, use the keyline grid to position it.

If shapes are a critical part of a logo, do not force the artwork to go full bleed. Instead place it on the new keyline grid.

If possible, pick a background color for your asset that's appropriate for your brand and doesn't include any transparency.

Do not full bleed.
Don't: Force drastic brand and artwork transformations to full bleed.
Do keylines.
Do: Place freeform icon artwork on keylines - centered and within the 384px x 384px asset space.

 

Corner radius

Do not deliver assets with rounded corners. Actions Center dynamically applies a corner radius and border to logos. This ensures consistency when the icon is resized across different UI layouts. The radius is equivalent to 20% of icon size.

Don't round corners.
Don't: Round the edges of your final asset
Do fill artwork.
Do: Fill the center asset space with artwork when possible, do not bleed into the empty margins.
Next
Accounts and Users