Sections

About Sections

Reach your APSIS One account's Sections by accessing Account Settings and into the Sections tab.

Sections1.jpg

 

What is a Section?

Your account is divided into Sections to best keep track of the data stored in the platform. Create Sections to make sure that the right information from your different markets is organised efficiently. A Section may or may not contain a domain, depending on whether your business has a website.

In a nutshell: Sections are used to organise Profile data in APSIS One.

Sections also allow you to set up Section permissions for users so that the right information is always in the right hands. Different brands, markets, countries, etc., different Sections.

A Section may have several domains, each one corresponding to a different country or website, then we can use the following example:

A company that manages multiple brands especially benefits from the APSIS One data Section structure by adding each brand as a Section, and then each brand’s different domains into the Sections. This allows Section-specific data from each domain to be tracked separately, managing consent appropriately, and increasing the level of personalisation and variety for each activity performed in the APSIS One platform.

Click an item below to expand:

Adding a Section

How to Add a Section

1. Reach your Account Settings from the Information Centre.

accountSettings4.jpg

 

2. The Sections tab will be the first one to open. If these settings are not available to you, get in touch with an account owner or admin user.

Sections2.jpg

 

3. Click New Section.

Sections3.jpg

 

4. Enter your Section's name.

Sections4.jpg

 

5. Click Add Section.

Sections5.jpg

 

Renaming a Section

How to Rename a Section

1. Click on the Section you wish to rename.

Sections6.jpg

 

2. On the left, select the Section Settings tab.

Sections7.jpg

 

3. Click Rename.

Sections8.jpg

 

4. Make your changes, then click Rename.

Sections9.jpg

 

 


 

Section Preferences

To open a Section's preferences, simply select the Section in your Account Settings. 

Within a Section, you can easily locate the corresponding Tracking Script, set up your domains and languages, APSIS One Integrations and more. Also, you must review and adjust your data collection preferences within Data Model, as well as your Double Opt-in email and confirmation.

Continue reading below, or click an item in the left navigation to jump to a specific part of your Section preferences.

Sections10.jpg

 


 

Domains

A domain is a website that corresponds with your brand and belongs to your business. It is added into APSIS One as a part of a section, which is where Admin users can set up preferences related to Attributes, tags and find the Tracking Script. Read more about sections...

Please consider that if your domain is protected and can only be accessed with a specific link or by using a VPN, password or any other credentials, APSIS One will not be able to display your domain's status. What is more, the Tracking Script will not be able to collect data.

Jump to Languages below to read more about your domain's language settings.

Here's some basic information about domains.

Click an item below to expand:

Supported Domain Suffixes

About Public Domain Suffixes

When setting up your domains and Tracking Script, it's important to consider your website's public suffix. A public suffix is a catalog providing suffixes (.com, for example) under which domains can be registered.

To ensure that your domain and Tracking Script will communicate effectively, and that data is transferred seamlessly into APSIS One, please review the following list of public suffixes. The website is updated and maintained as a community resource, and is an initiative of Mozilla.

Take a look at the list here, or paste this address into your browser to verify your domain:

https://publicsuffix.org/list/public_suffix_list.dat

 

Adding a Domain

How to Add a Domain

1. Select a Section in your Account Settings.

Sections6.jpg

 

2. The Domains & Languages tab will be the first one to open.

domain1.jpg

 

3. Enter a name to identify your domain under Domain name, and the address to your website under URL.

To ensure that the domain will work effectively with APSIS One, enter your URL in the following format: "example.com", "example.co.uk".

Please consider that if your domain is protected and can only be accessed with a specific link or by using a VPN, password or any other credentials, APSIS One will not be able to display your domain's status. What is more, the Tracking Script will not be able to collect data.

domain2.jpg

  

4. Done? Click Verify.

domain3.jpg

 

Your domain will initially show as pending until the Tracking Script is installed and detected by APSIS One. When it has been verified, it will show as verified.

If your domain supports multiple language support, you will need to set up your language options. Website tool activities will make use of these languages in order to display the right activities for the right language displayed in your domain.

Jump to Languages below to read more about your domain's language settings.

Once you save your domain, you can Add Tracking and start collecting visitor data from those who browse your page. If you don't intend to add multiple languages, you can set up tracking for the whole domain.

Jump to Tracking below to learn more!

domain4.jpg

 

Domain Status

About the Domain Status

Here you can see whether the Tracking Script has been successfully installed in your domain(s). It may take up to one hour for the status to update. Hover over the information icon to see what each status means.

trackingScript2.jpg

 

This is what every status means:

Pending: APSIS One is checking your domains.

Site Unavailable: We're unable to reach your domain.

No Script: The Tracking Script was not found.

Wrong Script: The Tracking Script installed is from a different section.

Connected: Successfully feeding data into APSIS One.

 

Is something wrong?

Double-check that you installed your Tracking Script properly. If it still doesn't work, please contact support.

 

Editing a Domain

How to Edit a Domain 

1. Locate the domain you wish to edit.

Domains-_-Tracking-Script07.jpg

 

2. Click on the pencil icon on the right end of the domain name container.

Domains-_-Tracking-Script08.jpg

 

3. Make your changes and press enter in your keyboard, or click the pencil icon once again.

domain2.jpg 

 

Deleting a Domain

How to Delete a Domain 

1. Locate the domain you wish to remove and click on the X icon on the right end of the domain name container.

Domains-_-Tracking-Script13.jpg

 

3. Are you sure you wish to delete this domain? If yes, click Delete.

Otherwise, click Cancel.

domain15.jpg

 

 


 

Languages

If your domain supports multiple language support, you will need to set up your domain's language options. Website tool activities will make use of these languages in order to display the right activities for the right language displayed in your domain.

Also, if your domain supports multiple languages, you must set up data tracking for each language.

Click an item below to expand

Adding a Language to a Domain

How to Add a Language to a Domain

1. In Account Settings, select a Section with a domain.

Sections6.jpg

 

2. Under the domain, you'll see Languages.

Click Add Language.

domain5.jpg

 

3. Enter a name for your language. This will help you easily set up APSIS One activities for different languages.

domain7.jpg

 

4. Expand the Type drop-down menu and choose how you want the Tracking Script to detect your website's language.

You can choose Cookie to detect your website's language via a cookie name and its value, or choose URL path to detect the language via your website's URL.

It's important that you choose either an URL path or cookies to detect your website's language, and that you don't try to use both. This is hardly a common setup but, if you set up two methods of detecting languages, your Website tool activities will not work as expected.

If your website's default language doesn't have a specific URL path, you may set the default language with a URL path and simply enter a slash (/) as the path.

domain6.jpg

 

If you choose Cookie, enter the cookie name and value that corresponds.

domain8.jpg

If you choose URL Path, enter the url path after a slash (/): /en for example.

domain9.jpg

 

5. When done, click Verify.

Repeat this process for the languages that you support for very domain that you may have in your Section.

domain3.jpg

 

Once you save your language, you can Add Tracking and start collecting visitor data from those who browse the domain in that specific language.

Jump to Tracking below to learn more!

 

Default Language

How to Set a Default Language

If your website's default language doesn't have a specific URL path, you may set the default language with a URL path and simply enter a slash (/) as the path.

Follow the instructions described above on Adding a Language to a Domain and save your language. APSIS One will show a message confirming that this is now your default language for the case in which no other languages are detected.

domain11.jpg

 

Editing or Deleting a Domain's Language

How to Edit or Delete a Domain's Language

1. Locate the language you wish to edit or delete.

domain12.jpg

 

To edit, click on the pencil icon and follow the steps described above in Adding a Language to a Domain.

domain13.jpg

 

To delete, click on the red X icon.

Domains-_-Tracking-Script13.jpg

 

Are you sure you want to delete this language? Click Delete to confirm, otherwise Cancel.

domain14.jpg

 

 


 

Tracking

Coming soon...

After adding and verifying your domains and languages, you'll see an option to Add Tracking.

Tracking feeds website interaction data into APSIS One, and allows you to enrich Audience Profiles. Make sure that you've installed the Tracking Script and have an active Cookie Banner for this feature to work as intended.

If you have multiple languages set up for your domain, you will have to add tracking for each language. The option to Add Tracking will be shown once you save your language.

If you're wondering about what sort of data is collected, take a look at Website Interactions in Advanced: Profile data. The data collected depends on how you set up tracking for your domain.

Click an item below to expand 

Add Tracking to a Domain

How to Add Tracking to a Domain

Coming soon...

1. After adding your domain, click Add Tracking to get started.

tracking1.jpg 

 

2. Tick the boxes that correspond with the visitor data you wish to track. Here are the available options:

  • Google Analytics
  • Google SEO/SEM
  • Page view
  • File download
  • Site search
  • Facebook Ad Referral

tracking2.jpg

 

If you're wondering about what sort of data is collected, take a look at Website Interactions in Advanced: Profile data. The data collected depends on how you set up tracking for your domain.

 

3. If you wish to collect site searches, enter a search key.

tracking3.jpg 

 

 About the Search Key

The search key will allow APSIS One to identify when a visitor performs a search in your website.

To locate the search key, perform a search in your website and take a look at the address bar of your browser. The address bar will display the search key as a URL parameter followed by the search parameter.

For example, if searching for "denim":

http://www.heartland.com/catalogsearch/result/?q=denim

The search key is q in this example.

If you're having difficulties locating the search key of your website, please reach out to the development team of your organisation or contact Support.

 

4. Done? Click Save.

tracking4.jpg 

 

Add Tracking to a Domain's Language

How to Add Tracking to a Domain's Language

Coming soon...

1. After adding a language to your domain, click Verify. Afterwards, click Add Tracking to get started.

tracking1.jpg 

 

2. Tick the boxes that correspond with the visitor data you wish to track. Here are the available options:

  • Google Analytics
  • Google SEO/SEM
  • Page view
  • File download
  • Site search
  • Facebook Ad Referral

tracking2.jpg

 

If you're wondering about what sort of data is collected, take a look at Website Interactions in Advanced: Profile data. The data collected depends on how you set up tracking for your domain's language.

 

3. If you wish to collect site searches, enter a search key.

tracking3.jpg 

 

 About the Search Key

The search key will allow APSIS One to identify when a visitor performs a search in your website.

To locate the search key, perform a search in your website and take a look at the address bar of your browser. The address bar will display the search key as a URL parameter followed by the search parameter.

For example, if searching for "denim":

http://www.heartland.com/catalogsearch/result/?q=denim

The search key is q in this example.

If you're having difficulties locating the search key of your website, please reach out to the development team of your organisation or contact Support.

 

4. Done? Click Save.

 tracking4.jpg

 

 


 

Tracking Script

The APSIS One Tracking Script is a piece of code that allows your website to feed data into APSIS One. For us to gather data and give you fitting insights, you must install it. It will be used to gather web statistics for your websites, and it will also allow us to display the Cookie banners, Sign-up bars, etc. created with APSIS One.

trackingScript5.jpg

 

Do you need more advanced information about the Tracking Script and data collection? Head over to Advanced: Tracking Script & Data Collection 

trackingScript1.jpg

 

Here's some basic information about the Tracking Script.

Click an item below to expand:

Tracking Script Status

About Tracking Script Status

Review the Status of your Tracking Script—whether the data is being received or not. It might take up to 48 hours for your Tracking Script to point to APSIS One.

The Tracking Script status reflects whether it has been able to feed data into Audience, which is the result of a successful installation and an active Cookie Banner. 

trackingScript3.jpg

 

This is what every Tracking Script status means:

No data received yet: The Tracking Script may have been successfully installed but no data has been fed into APSIS One. You must have a Cookie Banner in place for the Tracking Script to feed data into APSIS One.

Connected: You have successfully installed the Tracking Script in your domain(s) and it's now collecting data. You will see this status once data is being sent to your APSIS One Audience for the first time.

Note that, if you happen to remove the Tracking Script from your domain after it's successfully connected, its status will remain as Connected. However, your domain's status will update, showing No Script.

If you tick the Run Tracking Script independently box, it will start collecting data regardless of whether you have an active Cookie Banner activity or not. Only enable that option if you have an existing cookie banner in your website that can collect consent from your visitors. Read more about connecting your own cookie banner...

 

Installing the Tracking Script

How to Install the Tracking Script

The following instructions are for admin users. To see how to access the Tracking Script for non-admin users, head over to Account Settings.

 

1. Open your Account Settings and go into your Section.

 Sections6.jpg

 

2. Under Domains & Languages, click Tracking Script.

trackingScript5.jpg

 

3. Click Copy Tracking Script, and paste it into the head section of your main HTML page. This will track all of the subpages as well.

trackingScript1.jpg

 

4. Review the status of your script. It might take up to 48 hours for your Tracking Script to be fully functional.

trackingScript3.jpg

 

Your Tracking Script will only show as Connected once the cookie banner is feeding data into APSIS One. Until then, it will show No data received yet. Read more about cookies...

 

Advanced Settings

Run Tracking Script Independently

If you already have a cookie banner implemented in your website, you might want to keep it instead of creating one with APSIS One. However, in order for APSIS One to gather data with consent, you must link your cookie banner to your tracking script. Read more about the tracking script...

If this option is enabled, the request for consent relies completely on your existing cookie banner, which must make sure that the data fed into APSIS One is gathered with consent. In order to collect and store visitor's data you must acquire informed consent, which is provided by visitors through a cookie banner. Consult your legal team before enabling this feature to make sure that you have an existing solution for acquiring visitors' informed consent.

Cookie consent is recorded at the moment the visitor provides their consent in your own cookie banner.

If you would like to read more about cookies, head over to this article. Please refer to your own development team in order to make sure your cookie banner is paired with the APSIS One tracking script.

To enable or disable this feature, simply toggle the Run Tracking Script Independently option.

You may choose to run the tracking script only when a certain cookie matches a value. This will simplify the way your cookie banner communicated with APSIS One's tracking script.

Tick the Match cookie value to start tracking box and enter a Cookie name, Match type and Value.

trackingScript4.jpg

 

 


 

Data Model

Click on the Data Model tab on the left to adjust the Profile data preferences for your Section.

dataModel10.jpg

 

In the Data Model tab of your Section preferences, you can review and adjust the types of Profile data collected in your account's Section.

For more in-depth information, head over to Advanced: Profile data.

dataModel1.jpg

 

Here's some practical information about how you can manage the types of Profile data in your Section. 

Click an item below to expand:

Renaming Attributes and Tags

How to Rename an Attribute or Tag

1. Switch between the Attributes and Tags tabs to edit the name of your data points.

dataModel9.jpg

 

2. Click the edit icon to expand the item.

dataModel8.jpg

 

3. Rename your Attribute or Tag. These changes will be reflected only in this particular Section.

dataModel7.jpg

 

4. Click Save.

domain10.jpg

 

Adding a New Custom Attribute

How to Add a New Custom Attribute

1. Within a Section's Data Model, Enter the Attributes tab. Scroll down to your Custom Attributes and click Add New Attribute.

dataModel2.jpg

 

2. Enter a name for the Attribute.

dataModel3.jpg

 

3. Choose an Attribute type to make sure that the Attribute values are in the right format:

These are the five types of Attributes you can choose to track with APSIS One:

Text: UTF-8 encoded text (string) value with a 1000-character limit. For example: Female, Non-binary, Male.

True/False: A boolean Attribute. For example, downloaded the app = true. The supported values are: true or false (lower case).

Number: A field for numbers, like an age or a phone number.

Number w/decimals: Same as the number field, yet this one has the ability to track numbers with decimals. Like a person's height.

Date: A date of birth, for example. The date format currently supported is ISO-8601 (YYYY-MM-DD).

dataModel4.jpg

 

4. Done? Click Save.

domain10.jpg

 

Adding a New Tag

How to Add a New Tag

1. Within a Section's Data Model, enter the Tags tab. Click Add New Tag.

dataModel5.jpg

 

2. Enter your Tag's name. Profiles tagged will receive this text as a Tag.

dataModel6.jpg

 

3. Click Save.

domain10.jpg

 

 


 

Double Opt-in

In the Double Opt-in tab you can customise your Double Opt-in email and confirmation page.

Double Opt-in allows you to confirm the subscription of those Profiles who opt-in to your communications by providing their Email consent.

Consider that Profiles that opt-in via a Sign-up bar without Double Opt-in enabled, are subscribed via the File Import Wizard or any other sources, will gain the Opt-in type of consent (as opposed to Confirmed Opt-in).

DOI1.jpg

 

Once a visitor has provided their consent, and depending on your Sign-up bar's messaging, they will receive an email message where they are asked to confirm their subscription. This email will lead them to a landing page where they can confirm their subscription and then back to your website, promoting a successful Profile merge if it happens in the same device and/or browser. Until they've confirmed their subscription, their Profile will show their email channel consent as pending. Read more about consent...

Profiles with a Pending Opt-in Email type of consent will not receive any of your sendings until they confirm their subscription.

DOI3.jpg

 

Before you can enable Double Opt-in for your Sign-up bar, you must complete these settings.

Once done, head over to the Website tool to edit your Signup bar. Read more...

Double Opt-in makes for an easy and secure way to make sure that the visitor who provided consent is the same individual who owns the email address, and even shows a confirmation to the Profile once they've verified their identity.

DOI2.jpg

 

Click an item below to expand:

Enable Double Opt-in

The Email Details are the basic, essential settings for Double Opt-in to be available in your Sign-up bar activity. However, we suggest that you review the design of the email and confirmation page for it to match your branding guidelines. Continue reading this article for more details on the email and confirmation page design.

Once done with your email details and design, click Save to activate Double Opt-in.

DOI14.jpg 

 

Double Opt-in Email

This is the first email they receive once they sign up for your email communications. In this section you may adjust the email's details, sender information and the email's design.

Adjust the details of your email so that it's recognised instantly by the recipients.

 

Email Details

Enter a Subject line, pre-header text, as well as the sender details for the Double Opt-in email.

Make sure that your name and email match your business's address, and that your reply email will make it easy for Profiles to contact you if they find it necessary.

DOI2.jpg

 

Double Opt-in Email Design

In this section you can Preview your existing Double Opt-in email design, and make any changes you deem necessary with APSIS One's Email Editor.

Click Preview or Edit to take a look at your Double Opt-in email.

DOI6.jpg

 

Click an item below to expand: 

Preview

How to Preview Double Opt-in Email

In Preview, you can see how your Double Opt-in email looks like. Toggle the desktop, mobile and text version of your email to make sure it will work perfectly in all devices.

This is how the default Double Opt-in email looks like:

DOI7.jpg

 

Edit

How to Edit Double Opt-in Email

Once you click Edit, you will be taken to the Email Editor. If you need more guidance, check out the Email Editor section where we have all the details and step-by-step guides that will help you make the most out of this feature.

If you need a hand with the design of your email, take a look at Email Design Tips & Tricks.

The Double Opt-in email can be customised just as any other email created with APSIS One's Email Editor.

DOI2.jpg

 

Opt-in Link

For your Double Opt-in email to work as intended you must include an Opt-in link.

This is the link that your subscribers must click in order to reach a confirmation page where they can confirm their subscription, so make sure that it stands out from the rest of your email and that it's easily accessible in all devices.

You may add an opt-in link to most of the Elements available in the Design Panel, either via the Element Settings as shown in the image above, or via the Inline Text Editor as shown below:

DOI9.jpg

  

Confirmation Page

Recipients will see this page once they click the link in your Double Opt-in email. By clicking the button on this page, they can confirm their subscription to your communications. After confirming their subscription, they will be redirected back to your website automatically.

Here you may adjust the page's content and its design.

DOI3.jpg

 

Confirmation Page Details

Enter a title for the confirmation page. This is the title that will be displayed in the browser when the subscriber reaches the confirmation page.

DOI8.jpg

 

Confirmation Page Design

In this section you can Preview and Edit your confirmation page, and make any changes you deem necessary with APSIS One's Email Editor.

Click Preview or Edit to take a look at your confirmation page design.

DOI7.jpg

 

Click an item below to expand: 

Preview

How to Preview the Confirmation Page 

In Preview, you can see how your confirmation page looks like. Toggle the desktop, mobile and text version to make sure it will work perfectly in all devices.

This is how the default confirmation page looks like:

DOI10.jpg

 

Edit

How to Edit the Confirmation Page 

Once you click Edit, you will be taken to the Email Editor. If you need more guidance, check out the Email Editor section where we have all the details and step-by-step guides that will help you make the most out of this feature.

If you need a hand with the design of your page, take a look at Email Design Tips & Tricks.

The confirmation page can be customised just as any other email created with APSIS One's Email Editor.

DOI3.jpg

 

Opt-in Link

For your Confirmation page to work as intended you must include an Opt-in link.

This is the link that your subscribers must click in order to confirm their subscription, so make sure that it stands out and that it's easily accessible in all devices. After clicking this link, they will gained a Confirmed Opt-in type of consent, and will be redirected to your website.

You may add an opt-in link to most of the Elements available in the Design Panel, either via the Element Settings as shown in the image above, or via the Inline Text Editor as shown below:

DOI9.jpg

 

 


 

Cookie

Under the Cookie tab, you can adjust your preferences as to the collection of browsing behaviour in your domain(s). 

cookie1.jpg

 

Click an item below to expand:

Cookie Lifetime

There is a number of reasons why your business may wish to determine the lifetime of the cookies gathered. Whether it's due to GDPR standards or your organisation's privacy policies, it is possible for Admin users to decide how long the cookies will be kept after Profiles have provided their cookie consent.

Toggle the Cookie Lifetime switch to choose a lifetime for APSIS One cookies. If left unticked, the cookies will be kept indefinitely.

cookie2.jpg

 

Click on the Lifetime drop down menu to choose a time length.

cookie4.jpg

 

Person Detection

Enabling person detection will allow each visitor's activity tracked in your domains to be available in all domains across all sections. This allows for a more personalised cookie-related experience. 

Click on the switch to toggle person detection on and off.

Important: This must be aligned with your cookie policy in order to be GDPR-compliant. Visitors must be made aware that their cookies will be utilised in other domains.

cookie3.jpg

 

 


 

Integrations

In the Integrations tab you can enable and manage the connection between your other platforms and systems and APSIS One.

We have a dedicated category for all our content about integrations! Check it out.

integrations1.jpg 

 


 

Section Settings

Access these settings by clicking the Section Settings tab on the left.

Sections7.jpg

 

Here in these settings you can modify your Section's name.

Sections9.jpg

 

Was this article helpful?