SERVICE SPECIFICATION
Introduction
This document sets out the functionality of the Turtl product for use in customer license agreements.
Please note that the Turtl product is being continually evolved and, as such, features will be added and / or deprecated from time to time. The Turtl feature set is broad, so the below is intended as an outline only. If you are unsure which features are available to you under your licence agreement or if you would like more information on any aspect of the solution, please speak to your usual Turtl contact or send a message to info@turtl.co.
Features
Turtl is a cloud-based Software-as-a-Service product which allows customers to create and distribute high-quality online documents and monitor their performance over time.
- Reading †
- Reader access control †
- Authoring
- Personalizing *
- Publishing
- Analytics †
- Integrations †
- User management *
- License type, permissions and Roles †
- Content management
- Compatibility
- Limits
* These features are only available if specified in the customer’s licence agreement
† Elements of these features are only available if specified in the customer’s licence agreement
1. Reading †
Documents created in Turtl are referred to as “Turtl Docs” and are rendered in Turtl’s proprietary Surf and Immerse reading format. This format is based on psychological research regarding optimal human reading behavior. A “Published Turtl Doc” is a Turtl Doc that no longer sits in draft format.
Published Turtl Docs are rendered as HTML5 webpages and are accessed by readers through a compatible web browser. Navigation is accomplished by moving through Surf pages until a topic of interest is identified, at which point a “Read on” button can be clicked to access an Immerse level where further information and interactive elements can be found.
General features:
- Proprietary Surf and Immerse reading experience
- Page turn animation for desktop reading
- Page slide animation for mobile reading
- Automatically generated contents menu
- Social sharing tools on every page
- Full screen button (where supported)
- Download as PDF option
- Page numbering throughout
- Page turn animations on desktop (slide animations on mobile)
Surf page features:
- Image zoom effect on the cover page
- “Read on” button to access Immerse pages
- Heading and subheading text
- Brand-specific layout options *
- Brand-specific color options
Immerse page features:
- Flexible, column-based layouts
- Multi-column elements
- Brand-specific typography and styling *
- Optional lead capture form
- Interactive elements, including:
- Polls
- Quotes
- Video
- Audio
- Maps
- Charts
- Hyperlinks
Back cover features:
- Sharing options
- Custom thank you message
- Custom contact details
- Optional sign-up form
2. Reader access control
Turtl provides tools to allow control over who can read each Published Turtl Doc. The following options are available:
- Public on the web – Anyone on the internet can find and access your Doc. Search engine indexing will be enabled.
- Anyone with the link – Anyone who has the link can access your Doc. Search engine indexing will be turned off.
- Anyone at my company * – Anyone with a login or an SSO account at your company can access. Search engine indexing will be turned off
- Specific people only – Specific people on the list provided can access. Search engine indexing will be turned off.
3. Authoring
Turtl provides an interactive HTML5 web application for creating Turtl Docs which is hosted and served by Turtl. The following are provided:
General features:
- Automatic and manual saving
- Mobile preview
- Toggle gridline visibility
- Toggle preview visibility
- Timeline for page management including:
- Copy
- Paste
- Delete
- Insert
- Drag and drop re-ordering
Surf page features:
- Set heading and subheading
- Select and crop image
2.1. Direct upload
2.2. Rights-free image bank
2.3. Paste URL
2.4. Customer library (where available) - Select text layout
- Select text position
- Select text color scheme
Immerse page features:
- Enable or disable Immerse page
- Show sign up form
- Set sign up form as optional or required
- Choose Immerse page style
- Choose Immerse page column count
- Drag and drop interface for controlling layout
- Snap to grid and column functionality
Immerse page text editor features:
- Custom rich text editor
- Common formatting options (bold, italic etc.)
- Page and column breaks
- Apply brand-specific styles and colors *
- Interactive elements, including:
- Polls
- Quotes
- Video
- Audio
- Maps
- Charts
- Hyperlinks
Back cover features:
- Set text
- Set contact details
- Toggle sign-up form visibility
4. Personalizing *
Turtl allows users with the necessary permissions to personalize Turtl Docs through the Personalization Module by adding tokens and rules to pages and defining data sources to create dynamic content.
Personalization tokens specify the text, images, videos, or tables that are replaced during the personalization process. There is no limit on the number of tokens used to configure Turtl Docs.
Adding rules to pages determines whether a page/ section/ block is included.
The data points required to personalize a Turtl Doc can use one of the following sources:
- Internal forms
- Reader forms
- File upload (CSV file, max 20,000 rows)
- Customer database (using API or native integrations)
The service generates personalized Turtl Docs, it does not cover the distribution of files by email or marketing automation platforms.
Forms display with styling to reflect the customer Brand Theme as the default. Professional services support is available for more complex styling and branding requirements.
Personalization using a direct connection to customer CRM or reporting databases (via native integrations or the Turtl API) may require professional services support. Professional services support is assessed on a case-by-case basis.
Each personalized Published Turtl Doc collects its own set of analytics and all personalized versions of a given Published Turtl Doc will update their content elements automatically to reflect any changes made to the source Turtl Doc.
5. Converting
Turtl allows users with the necessary permissions to convert PDFs into Turtl Docs using Adobe Sensei AI. The following functionality is available when converting a PDF:
Design Options:
- Turtl gets you started – the resulting Turtl Doc will be split into chapters and interactive layouts will be created. The converted Turtl Doc is available in the creation studio for editing. This option utilises the AI features referred to below.
- Just import content – the resulting Turtl Doc will be split into chapters with no layouts applied. The converted Turtl Doc is available in the creation studio for editing.
Optional AI features:
- AI image suggestions – Turtl will use AI to pick relevant royalty-free images to improve the Turtl Doc if the PDF doesn’t contain enough quality imagery for each Surf page. Turtl use OpenAI to understand the topic of the content and source relevant images from Freepik. This option can be disabled before converting a PDF.
- AI content enrich – Turtl will use OpenAI to understand the content and generate quotes, and polls and pull out significant text into text boxes to make the content more engaging. Turtl will utilise Sightengine to score the quality of images in the PDF to determine if they are of good enough quality to use on Surf pages. This option can be disabled before converting a PDF.
6. Publishing
Turtl provides tools to assist with publishing to popular online channels.
Email tools:
- Animated front cover animation in GIF format to be embedded in emails
Website tools:
- Static cover image
- Customizable embed code featuring:
- Animation on hover
- Color options
- Option to open Published Turtl Doc in lightbox or new tab
- Sizing options
Social tools:
- Auto-generated social cards for major networks
- Auto-generated short link
Other:
- Specify a custom URL for each Published Turtl Doc
7. Analytics †
Turtl provides a complete set of analysis tools across four different types of reporting dashboard whose functionality is described below:
Company dashboard:
- Graph of reads and signups over time
- Counters for headline metrics
- Breakdown of reads by different variables
- List of the most read Published Turtl Docs with headline metrics
- List of known readers with headline metrics †
Doc dashboard:
- Graph of reads and signups over time
- Counters for headline metrics
- Breakdown of reads by different variables
- List of pages with key metrics
- List of interactive elements with key metrics
- List of known readers with headline metrics
- Raw data download option
Benchmarks dashboard:
- View of Doc metrics comparison to:
1.1. All Team Docs – All the Docs in the Team
1.2. Industry – All Docs in the industry
1.3. Global – All Docs across all Teams in Turtl. - Breakdown of key metrics and comparisons
- Graph of bounce rate comparisons
- Graph of returning readers comparisons
- Graphs of read time comparisons
- Graph of share rate comparisons
- Graph of sign-up rate comparisons
Reader dashboard: †
- Graph of reads and signups over time
- Counters for headline metrics
- Breakdown of reads by different variables
- List of pages with key metrics
- List of interactive elements with key metrics
General functionality:
- Filter dashboards by:
1.1. Time
1.2. Source
1.3. Device type
1.4. Location
1.5. UTM tokens - Download XLS data
8. Integrations †
Turtl integrates with a number of popular CRMs. While each integration differs slightly, the following broad functionality is generally available for each:
Forms:
- Replace Turtl sign-up forms with CRM forms
- Capture leads directly into customer’s CRM
- Track readers as individuals once they have completed a form
Link tracking:
- Send out tracking links via CRM email
- Track readers as individuals once they have followed a tracked link
Auto tracking:
- Track readers as individuals if known to the CRM by cookie
9. User management †
Users can be approved by Turtl staff or the customer. The following authentication methods are available:
SSO:
- SAML 2.0 via customers own IDP
Email and password:
- Set minimum length
- Set maximum length
- Set require an uppercase character
- Set require a lowercase character
- Set require a special character
- Set require different from last n passwords
- Set max password age
10. License type, permissions and Roles †
The following license types, Additional Permissions and Roles are available subject to the agreed terms and pricing stated in the license agreement:
License types
Full User
A Full User is a User Subscription that can be assigned Global Admin, Admin and Brand Manager permissions and any Roles.
Limited User
A Limited User is a User Subscription that can be assigned the Integrations Manager permission and access to Reviewer, Analyst and Personalizer Roles in a Workspace.
Additional permissions
Additional Permissions are available for users that need to manage specific functionality within a Team which are as follows:
Global Admin
A Global Admin has access to all Workspaces and analytics dashboards and to all functions within a Team including adding other users, and creating, managing and publishing new Turtl Docs.
They can:
- Create Workspaces and manage them
- Add, remove and manage user permissions of Workspaces
- Create, edit and manage templates and Brand Themes
- Manage and view integrations
- Add, remove and create labels
- View and export analytics
- Leave, reply to and resolve comments
NB: this additional permisson is only accessible upon request. To avail yourself of this additional permission please speak with your account manager or customer success manager.
Admin
An Admin user manages an entire Workspace and has access to all functions within a Team including adding other users and creating, managing and publishing new Turtl Docs.
They can:
- Create Workspaces and manage them
- Add, remove and manage user permissions of this Workspace
- Create, edit and manage templates and Brand Themes
- Manage and view integrations
- Add, remove and create labels
- View and export analytics
- Leave, reply to and resolve comments
Brand Manager
A Brand Manager manages the branding within a Team.
They can:
- Create, edit and manage templates and Brand Themes
Integrations Manager
An Integrations Manager manages the integrations within a Team.
They can:
- Manage and view integrations
Roles
Owner
An Owner manages an entire Workspace and has access to all Turtl Doc functions including creating, managing and publishing new Turtl Docs. They can:
- Create, edit, publish, share and manage Turtl Docs
- Rename and delete the applicable Workspace
- Add, remove and manage user permissions of the applicable Workspace
- Personalize and batch personalize Turtl Docs
- Create and edit templates
- Add and remove labels
- View and export analytics
- Leave, reply to and resolve comments
Publisher
A Publisher is a member of a Workspace who can create, manage and publish Turtl Docs as well as Workspace templates. They can:
- Create, edit, publish, share, and manage Turtl Docs
- Personalize and batch personalize Turtl Docs
- View and export analytics
- Add and remove labels
- Create and edit templates
- Leave, reply to and resolve comments
Editor
An Editor is a member of a Workspace who can create and manage Turtl Docs but cannot publish them to live. They can:
- Create, edit, share and manage Turtl Docs
- Personalize and batch personalize Turtl Docs
- View and export analytics
- Add and remove labels
- Create and edit templates
- Leave, reply to and resolve comments
Personalizer *
A Personalizer is a member of a Workspace who can take existing Turtl Docs and quickly personalize them prior to sharing with a target recipient. They can:
- View and share Turtl Docs
- Create and share one-to-one personalizations (note: batch personalization is not available for this role)
- View and export analytics of personalizations
- Leave, reply to and resolve comments
Analyst
An Analyst can:
- View and share Turtl Docs
- View and export analytics
- Leave, reply to and resolve comments
Reviewer
A Reviewer can:
- View and share Turtl Docs
- Leave, reply to and resolve comments
11. Content management
Turtl organizes Turtl Docs into workspaces – distinct groupings of content within your Turtl instance. Each workspace contains its own set of users plus roles, Turtl Docs and other features. Turtl Docs can be moved between workspaces and users can belong to one or more workspaces.
12. Compatibility
Turtl is designed for use with modern browsers. The following browsers are officially supported for the following functionalities:
Supported browsers, November 2020:
Reading:
- Google Chrome – last three major versions
- Mozilla Firefox – last three major versions
- Microsoft Edge – last three major versions
- Apple Safari – last three major versions
- Apple Mobile Safari – latest version
All other functions:
- Google Chrome – last three major versions
- Mozilla Firefox – last three major versions
13. Limits
Turtl Docs are limited to a maximum size of 5MB each, exclusive of images, videos and other media in order to ensure fast loading times across all device types and network conditions. This equates to about 600 pages of content per Doc. If larger Docs are required, it is possible to join several together using the “Included Doc” functionality.
14. Glossary
Additional Permissions – Authorized Users that need to manage specific functionality within a Tenant, subject to the type of User Subscription purchased.
Admin – an Additional Permission that manages an entire Workspace and has access to all functions on the Tenant including adding other users and creating, managing and publishing new Turtl Docs.
Analyst – a limited Role that can only view and share Turtl Docs; view and export analytics; and leave, reply to and resolve comments.
Authorized User – those employees, agents and independent contractors of the customer who are authorized by the customer to use the services.
Brand Manager – an Additional Permission that manages the branding on the Tenant.
Editor – a member of a Workspace who can create and manage Turtl Docs but cannot publish them to live.
Full User – a user that can be assigned Global Admin, Admin and Brand Manager permissions and any Roles.
Global Admin – an Additional Permission that has access to all Workspaces and analytics dashboards and to all functions on the Tenant including adding other users, and creating, managing and publishing new Turtl Docs
Immerse Page – contains the main content of a Turtl Doc and forms the body of a given section. Readers navigate from the Surf Page to the Immerse Page.
Integrations Manager – an Additional Permission that manages the integrations on the Tenant.
Limited User – a user that can be assigned the Integrations Manager permission and access to Reviewer, Analyst and Personalizer Roles in a Workspace.
Owner – a Role that manages an entire Workspace and has access to all Turtl Doc functions including creating, managing and publishing new Turtl Docs.
Personalization Module – the content assembly tool which enables users to pull together content from a pre-defined library in order to produce personalised content for Readers.
Personalizer – a member of a Workspace who can take existing Turtl Docs and quickly personalize them prior to sharing with a target recipient.
Published Turtl Doc – a Turtl Doc that no longer sits in draft format.
Publisher – a member of a Workspace who can create, manage and publish Turtl Docs as well as Workspace templates.
Reader – readers of Turtl Docs, ie employees, clients, customers or prospective customers to whom links to Turtl Docs are distributed by the customer.
Reviewer – a limited Role that can only view and share Turtl Docs and
leave, reply to and resolve comments.
Roles – a role controls the level of access and responsibilities that an Authorized User is given in a Workspace subject to the User Subscription purchased by the customer.
Surf Page – a page within a Turtl Doc that introduces a section of content and takes the Reader to the corresponding Immerse Pages.
Team(s) – a space within a Tenant where Authorized Users can create and store their Workspaces and Turtl Docs. Authorized Users can be members of multiple Teams on a Tenant and can easily switch between the Teams they have access to.
Tenant – the dedicated log in page for Authorized Users to access the services and Teams they have access to.
Turtl Doc – the electronic document created by Authorized Users in the course of using the services, which may include, text, images and/or videos and the primary purpose of which is to promote the goods and/or services of the customer.
User Subscription – the full or limited user subscriptions purchased by the customer which entitle Authorized Users to select Additional Permissions and their Role, subject to the type of user subscription purchased, and to access and use the services.
Workspace(s) – workspaces sit within a Team and are folders containing Turtl Docs that an Authorized User wants to group together.