Pages

Before you create any sites in the Frosmo Control Panel, make sure you understand what a site is in the Frosmo context and whether you need to create one or more sites.

You can perform the following site-related tasks for companies to which you have access:

What is a site?

In the Frosmo Platform, a site represents an actual website of a company. Each site has its own custom script that contains the Frosmo-specific configurations (such as cached modifications, placements, and segments) and custom code for the website. When you create and manage a site in the Frosmo Control Panel, you're actually creating and managing a custom script. You cannot share configurations between different sites (with the exception of target groups, which are a company-specific rather than a site-specific feature). Each site also has its own dedicated set of data and statistics tracked by the Frosmo Platform on the website (such as product data, modification statistics, and conversions statistics).

Sites in the Frosmo Platform

Figure: Sites in the Frosmo Platform

A site typically corresponds to a single domain or subdomain, such as company.com or docs.company.com. You can also manage multiple domains and subdomains with just one site.

You can create one or more sites for a company. For example, if your company has a localized website for each country it operates in, or if you have separate websites for different brands, you can manage these as separate sites in the Frosmo Platform, if necessary.

One site or multiple sites?

Whether you need to create one or more sites in the Frosmo Platform is ultimately a question of whether you can manage your domains and subdomains, including their usage data and statistics, as a single whole.

Since each site in the Frosmo Platform comes with its own custom script, creating two or more sites means that you're committing to managing two or more custom scripts. If you have a lot of overlap in the modifications and other configurations you apply to the sites through the Frosmo Platform, you need to create and maintain those configurations separately for each site. In other words, you're potentially introducing a lot of overhead to your website development process. For example, if you use the same modification on three sites, you need to create and maintain three separate versions of the modification, one per site.

As a rule of thumb, create as few separate sites as possible in the Frosmo Platform. This is especially true if you don't need to isolate the usage data and statistics for the different websites, and if you have a lot overlap between the features you're implementing on the websites with the Frosmo Platform.

The following are common use cases where having multiple sites in the Frosmo Platform makes development and business sense:

Separate development and production website

If you develop your website in one environment and deploy it to production in another environment, and if you want to keep the Frosmo Platform statistics for these two environments separate, create dedicated sites in the Frosmo Platform. In practice, this means that you:

  • Use two separate custom scripts: one for the development website, and the other for the production website.
  • Copy any Frosmo Platform updates from the development site to the production site before deployment. For example, if you create a new modification in the development site, you must create that same modification in the production site before you deploy the website to production.

Dedicated sites and custom scripts for development and production

Figure: Dedicated sites and custom scripts for development and production

On the other hand, if you don't care about polluting your production site statistics with development site statistics, you can create a single site in the Frosmo Platform and use the one custom script for both the development and production websites. However, since the websites now share the same custom script, you will need to create and manage duplicate features in the Frosmo Platform, so that a feature you're developing does not also show up in production.

Shared site and custom script for development and production

Figure: Shared site and custom script for development and production

For example, if you want to create a new modification, you have a number of options for making sure that the modification does not show up on your production website until after deployment:

  • Create a single modification but with two separate placements: one that targets the development website and another that targets the production website. During development, use the development placement for the modification. When you deploy the website to production, switch the modification to use the production placement.
  • Create a single modification and placement for the development website. When you deploy the website to production, update the placement to target the production website.
  • Create a workspace, and create and test the modification in the workspace during development. When you deploy the website to production, publish the workspace.

Separate desktop and mobile websites

If you have a separate mobile version of your website, such as m.company.com, it can make sense to create a dedicated site for it in the Frosmo Platform and use that custom script on the website. Mobile websites typically have significantly different structure and content from the default or desktop version of the website, so the Frosmo features you create for one are not necessarily transferable to the other. This means that there might not be too much feature overlap and you would not be maintaining identical features for two separate sites.

Dedicated sites and custom scripts for desktop and mobile

Figure: Dedicated sites and custom scripts for desktop and mobile

Localized websites that require dedicated data and statistics

If you have localized versions of your website, for example fi.company.com and us.company.com, and if you need to keep their data and statistics separate, create a dedicated site for each localized version.

Localized websites with dedicated sites and custom scripts

Figure: Localized websites with dedicated sites and custom scripts

On the other hand, if you don't need to keep the data and statistics separate, and if the only difference between the localized versions is the content language, create a single site and use its custom script on all the localized websites.

Localized websites with a shared site and custom script

Figure: Localized websites with a shared site and custom script

Distinct website sections that are easier to manage separately

If your website consists of distinct sections built on different web applications or platforms, such as company.comdocs.company.com, and shop.company.com, and if these sections do not have much overlap in terms of content and statistics, or in how you would customize and manage the sections with the Frosmo Platform, create a dedicated site for each section.

Dedicated sites and custom scripts for distinct website sections

Figure: Dedicated sites and custom scripts for distinct website sections

Creating a site

You can create one or more sites for a company.

To create a site:

  1. In the Control Panel, click your user name, and select Company Settings.

    Accessing company settings

  2. In the companies and sites list, find the company for which you want to create the site. To filter the list, start typing the company name in the search field.
  3. Click the quick menu button for the company, and select Create site.

    Creating a site

  4. Define the basic site settings:

    • Site URL: Enter the complete URL for the site (for example, "https://docs.company.com/"). You can also edit the URL after you've created the site. As a rule, this URL also determines the site name ("origin") used to identify the site in the site's custom script and in the Frosmo back end (for example, "docs_company_com").

      Do not use the site's IP address, as the platform does not accept IP addresses as URLs.

      On request, the site name can also be hashed (e.g., "ac298a631da428dad32b0ba787ec0775").

      Editing the URL after creating the site does not change the site name.

    • Shared context: Enable this feature only if your website contains multiple domains or uses multiple protocols, and if you want to track visitors across the different domains and/or protocols (for example, https://www.company.com/ and https://docs.company.com/, or http://www.company.com/ and https://www.company.com/). To enable this feature, click Enable. You cannot enable or disable this feature after you've created the site. For more information about this feature, see Data collection and storage.

      Do not enable this feature just in case you might need it in the future. The feature can have a minor negative impact on page load times. If you do not currently need the feature, keep it disabled, and if you then later find that you need it, contact your Frosmo representative and request that they enable it.

    • Frosmo status: Toggle the Frosmo Platform on or off for the site by clicking Frosmo on / Frosmo off. You can also switch the Frosmo Platform on or off after you've created the site.

      When the Frosmo Platform is switched off for the site, visitors will not get any content or user experience improvements delivered through the Frosmo Platform, and the Frosmo Platform will not track any data on the site.

    Creating a site

  5. Select Conversion settings, and select the currency used to measure revenue on the site. You can also change the currency after you've created the site.

    Creating a site

  6. When you're done, click Create.
  7. If you need to activate specific modules for the site, contact your Frosmo representative. By default, the only module that is active for a new site is IE10 support. For more information about modules, see Viewing site modules.

    Creating a site

To actually integrate the website with the Frosmo Platform, so that the platform can deliver content to and track data on the site, you must add the Frosmo scripts to every page on the site. For more information, see Setting up the Frosmo Platform for your site.

Editing site settings

You can edit the following settings for a site:

  • Site URL
  • Frosmo status
  • Currency

To edit site settings:

  1. In the Control Panel, click your user name, and select Company Settings.

    Accessing company settings

  2. In the companies and sites list, find the site whose settings you want to edit. To filter the list, start typing the company or site name in the search field.
  3. Click the quick menu button for the site, and select Edit settings.

    Editing site settings

  4. Edit the site settings. For more information about the settings, see Creating a site.
  5. When you're done, click Save.

Removing a site

You can remove a site that you no longer need to manage with the Frosmo Platform. Removing a site means that the Frosmo Platform stops delivering content and otherwise interacting with the corresponding domain.

If the site itself remains operational, remove the Frosmo script elements from the site source code, as they are now redundant. (Removing a site automatically empties the site's custom script file.)

To remove a site:

  1. In the Control Panel, click your user name, and select Company Settings.

    Accessing company settings

  2. In the companies and sites list, find the site you want to remove. To filter the list, start typing the company or site name in the search field.
  3. Click the quick menu button for the site, and select Edit settings.

    Editing site settings

  4. Select Remove site, and click Remove.

    Removing a site

  5. To confirm, click Remove.

    Removing a site

Viewing site modules

A site module is a feature, such as selective profiling or the data layer, that is either active or inactive on a site. You can view information about the modules, including whether they are currently active. Your Frosmo team activates and deactivates the modules for your sites.

To view site module information:

  1. In the Control Panel, click your user name, and select Company Settings.

    Accessing company settings

  2. In the companies and sites list, find the site whose module information you want to view. To filter the list, start typing the company or site name in the search field.
  3. Click the quick menu button for the site, and select View modules.

    Viewing site modules

    The modules view lists all the modules supported by the Frosmo Platform. Active modules have the Active label on their row. To view more information about a module, click its row.

    Viewing site modules

Getting the script elements for a site

The Frosmo scripts that integrate a site with the Frosmo Platform load through two <script> elements in the site source code. The first element loads the Frosmo Core library (frosmo.easy.js) and the second element loads the site-specific Frosmo custom script (<site_origin>.js). For more information about the scripts, see Setting up the Frosmo Platform for your site and Technical overview. You can get the <script> code from the Control Panel.

To get the script elements for a site:

  1. In the Control Panel, click your user name, and select Company Settings.

    Accessing company settings

  2. In the companies and sites list, find the site whose script elements you want to get. To filter the list, start typing the company or site name in the search field.
  3. Click the quick menu button for the site, and select View script elements.

    Getting the script elements for a site

  4. Copy the code for the script elements.

    Getting the script elements for a site

  • No labels