This page summarizes how to manage your brands on Ordering End-to-End and covers some advanced use cases.
What is a brand?
On Ordering End-to-End a brand consists of a collection of localizations. Each localization has a brand name, logo, privacy policy, terms of service, country and language targets. This allows you to specify localized branding at the country + language level. Brands are separately configured in the sandbox and production.
Managing brands
To manage your brands, open the Actions Center and navigate to Configuration > Brands. At present, only one brand is supported, however this brand may be localized into as many languages and countries as you would like. To add a brand click the Add Brand button. Enter a name and ID for the brand. The brand name you enter is not used in any consumer-facing surface, only localizations of a brand are shown to users. The ID is not currently used.
To add localizations, click the Add localization button and fill out the form. What you enter on this screen is shown on consumer-facing ordering surfaces. Localizations are targeted at a country and language. For example: If you create a brand whose country is set to "United States" and language is set to "English (United States)" that brand will be displayed on the consumer ordering UI to users in the US whose language is set to "English (United States)" in their Google account. Users in countries for which there is no localization configured will not be able to access the ordering flow. Branding changes take effect immediately. If your integration is launched to production and you make a change to a brand localization, that change will be applied to all restaurants using that brand localization immediately.
Localizing a brand to multiple languages
Say you operate an online ordering platform called "Pay and Eat" in Canada and you have localized branding for both English and French-speaking users (based on the language set in their Google account). You have the following brand assets:
- A brand name localized for English and French ("Payer et Manger")
- Different logos for English and French
- Different ToS and Privacy Policy links for each English and French
Start by creating your brand. Then add one localization for English with the location set to "Canada", the language set to "English (Canada)" and configure this localization with the English-language brand assets. Then add a localization for French with the location set to "Canada", the language set to "French (Canada)" and configure this localization with the French-language brand assets.
Now users visiting from Canada with their language set to English will see the English branding and users visiting from Canada with their language set to French will see the French branding.
You will also need to choose a default brand. See the Brand serving logic section below for an explanation of how the default brand is used in serving.
Brand serving logic
Sometimes a user's language or country won't match any of the localizations you have configured. In order to determine which brand localization to use apply the following logic in order:
- If the country the user is visiting from has no localizations configured, the ordering flow will not be available for that user.
- If there exists a brand localization with an exact country match and exact language match (i.e. "English (Canada)"), then that localization is used.
- If there exists a brand localization with an exact country match and a partial language match, then that localization is used. A partial language match means that the language portion matches but not the region of the language i.e. "English (Canada)" is considered a partial match for "English (US)" and all other English dialects.
- If there exists brand localizations for that country but none match the
user's language, then the default localization for that country is used.