Apps
DOWNLOAD
First things first !
To download this implementation guide, click the download button below.
If you need more information about the implementation guide, you can read the Table of Contents below.
Distribute Your Apps
Salesforce Summer
PREVIEW
Note This release is in preview Features described in this document dont become generally available
until the latest general availability date that Salesforce announces for this release Before then and
where features are noted as beta pilot or developer preview we cant guarantee general availability
within any particular time frame or at all Make your purchase decisions only on the basis of generally
available products and features
salesforcedocs
Last updated March
Copyright Salesforce Inc All rights reserved Salesforce is a registered trademark of Salesforce Inc as are other
names and marks Other marks appearing herein may be trademarks of their respective owners
CONTENTS
Why Use Trialforce
Custom Branding for Trialforce
Create and Edit Your Trialforce Source Organizations
Create a Trialforce Template
SignUps Using the API
Create a Signup Request
Signup Request Details
WHY USE TRIALFORCE
Trialforce lets you provision a free trial of your offering quickly and easily Each time a trial is provisioned Trialforce creates a lead in the
License Management App which helps you track usage and convert prospects into paying customers
With Trialforce you can
Run your own marketing campaign to maximize customer reach and adoption
Customize your offering including branding functionality design data and trial experience
Manage trials for multiple offerings versions and editions from one convenient place
Let customers including nonadmin users try your app or component without logging in to their production environment
Custom Branding for Trialforce
App developers using Trialforce to create trials of their product can optionally set up a branded login site and system emails By
branding these areas with your companys look and feel users of your application are immersed in your brand from signup to log
in Use custom branding for nonCRM apps not for apps that extend Salesforce CRM and require Salesforce standard objects such
as Leads Opportunities and Cases
Create and Edit Your Trialforce Source Organizations
Use the Trialforce Source Organizations page to manage your Trialforce source organizations
Create a Trialforce Template
Create a template to simplify signing up trial organizations
Custom Branding for Trialforce
App developers using Trialforce to create trials of their product can optionally set up a branded
login site and system emails By branding these areas with your companys look and feel users of
your application are immersed in your brand from signup to log in Use custom branding for
nonCRM apps not for apps that extend Salesforce CRM and require Salesforce standard objects
such as Leads Opportunities and Cases
A branded login page enables you to specify your login domain and login site
A login domain ends with cloudforcecom so if your company name is mycompany
your login domain is mycompanycloudforcecom
Your custom login site includes your text and company logo and mobilefriendly versions of
your login site
Branded emails allow you to specify fields in systemgenerated emails so that your company name
address and other pertinent details are used in email correspondence You can create multiple
branded email sets for different campaigns or customer segments
EDITIONS
Available in Salesforce
Classic
Available in Developer
Edition
USER PERMISSIONS
To manage Trialforce
Customize Application
Note To configure branding you must be logged in to a Trialforce Management Organization TMO To get your TMO log a
support case in the Salesforce Partner Community For product specify Partner Programs Benefits For topic specify ISV
Technology Request Branding isnt available for Trialforce Source Orgs created in the Environment Hub
Why Use Trialforce
Trialforce Branded Login Site
Trialforce Branded Login Site
Use the Trialforce Branded Login Site page to create publish and edit a login page that has your companys look and feel
Trialforce Branded Email Sets
Trialforce Email Branding allows you to modify systemgenerated emails so that they appear to come from your company rather
than from Salesforce Trialforce Email Branding only applies to users who sign up for your application through Trialforce
Trialforce Branded Login Site
Use the Trialforce Branded Login Site page to create publish and edit a login page that has your
companys look and feel
EDITIONS
If you havent set up a login site yet click Set Up Login Site
Available in Salesforce
Classic
If youve already set up a login site click Publish to make the site available or Launch Site
Editor to make changes
Choose a Trialforce Login Site Domain
Choose a subdomain where customers will log into your application Usually the subdomain
is the name of your company
Create a Branded Login Page
Customers typically log in to your app using the traditional loginsalesforcecom site A branded
login page enables you to customize this domain and parts of this login page so you can provide
a branded experience for your customers
Available in Developer
Edition
USER PERMISSIONS
To define package
branding
Package Branding
Design Your Login Pages
Use the Login Branding Editor to design your login pages
Choose a Trialforce Login Site Domain
Choose a subdomain where customers will log into your application Usually the subdomain is the name of your company
In the field provided enter a name
Click Check Availability
Accept the terms of use
Click Save and Launch Editor
Why Use Trialforce
Trialforce Branded Login Site
Create a Branded Login Page
Customers typically log in to your app using the traditional loginsalesforcecom site A branded
login page enables you to customize this domain and parts of this login page so you can provide
a branded experience for your customers
Your custom login site includes your text and company logo and mobilefriendly versions of your
login site as well
Log in to your Trialforce Management Organization
EDITIONS
Available in Salesforce
Classic
Available in Developer
Edition
From Setup enter Login Site in the Quick Find box then select Login Site
Click Set Up Login Site
USER PERMISSIONS
Select a subdomain for your login site by providing a name in the field provided Usually this
is the name of your company
To manage Trialforce
Customize Application
Note A login domain ends with cloudforcecom so if your company name is
mycompany your login domain is mycompanycloudforcecom
Check the availability of the domain and then accept the terms of use
Click Save and Launch Editor
Use the Login Brand Editor to change how your login page looks For additional help using the editor click Help for this Page
Click Save and Close
If youre ready to make these changes available to your TSO click Publish Otherwise your changes are saved and you can publish
later
Design Your Login Pages
Use the Login Branding Editor to design your login pages
EDITIONS
Log into your Trialforce Management Organization
From Setup enter Login Site in the Quick Find box then select Login Site
At the top of the editor click the tab for the login page size Desktop or Mobile
In the left pane expand the Page Header node and click Select File to choose your company
logo for each size screen your app supports
In the Logo Link Use custom link field optionally enter a web address to be used when a
customer clicks your logo such as your corporate website The URL must start with http
or https If you leave this field blank your logo will not have a link
Expand the Page Content node and paste the URL of the trial signup link into the Trial SignUp
Link Use custom link field This is the link your prospects will click to request a free trial on
your website Typically ISVs create a separate signup page for this purpose
Available in Salesforce
Classic
Available in Developer
Edition
USER PERMISSIONS
To manage Trialforce
Customize Application
Provide URLs for the right and bottom of the page If you leave these fields blank the frames default to the ones used on the Salesforce
login page
Expand the page footer and provide your company name and font color
Expand the page background node and provide a background image and color
At the top of the page click Save and Close
Why Use Trialforce
Trialforce Branded Email Sets
On the Branded Login Site page click Preview for the size of the page you want to see Make sure your login page appears correct
for each login page your app supports
Trialforce Branded Email Sets
Trialforce Email Branding allows you to modify systemgenerated emails so that they appear to
come from your company rather than from Salesforce Trialforce Email Branding only applies to
users who sign up for your application through Trialforce
Each Trialforce source organization comes with a standard set of email notifications that are sent
to customers For example customers get an email notification when they first sign up or when
they reset their password You dont have to rewrite all of these systemgenerated emails yourself
Just provide the values for the fields and the system takes care of the rest
Edit Trialforce Branded Email Set
Each Trialforce source organization comes with a standard set of email notifications that are
sent to customers
EDITIONS
Available in Salesforce
Classic
Available in Developer
Edition
USER PERMISSIONS
To define package
branding
Package Branding
Edit Trialforce Branded Email Set
Each Trialforce source organization comes with a standard set of email notifications that are sent to customers
To begin click New Email Set or Edit next to an existing email set
Fill in the fields with your company info
In the Preview Emails area click through the different types of generated emails and make sure they read correctly
Click Save
If youre ready to make these emails available to your Trialforce source organizations click Publish Otherwise your changes are
saved and you can publish later
Create and Edit Your Trialforce Source Organizations
Use the Trialforce Source Organizations page to manage your Trialforce source organizations
EDITIONS
If you have an existing source organization you want to use click Login
To edit an existing source organization click Edit then enter the source organization name
and select the branding
Available in Salesforce
Classic
To create a new source organization click New
Available in Developer
Edition
Enter a new username and email address for the administrator account
Enter the source organization name and select the branding
USER PERMISSIONS
Click Create
To define package
branding
Package Branding
Why Use Trialforce
Create a Trialforce Template
Create a Trialforce Template
Create a template to simplify signing up trial organizations
EDITIONS
Click New Trialforce Template You can create a template only if your TSO is less than or equal
to GB
Specify a description of the template and whether to include data in the dialog that appears
Click Save
You receive an email with the ID of the new template after its generated Submit the template for
review before you can use it to sign up trial organizations Remember to generate a new template
each time you make updates to your TSO so that your trials always reflect the most recent state
Each template has a status with one of these values
In Progress
When a template is first created it always has this status It then moves
to either Success or Error status
Success
The template can be used to create trial organizations
Error
The template cannot be used because something has gone wrong
and debugging is required
Deleted
The template is no longer available for use Deleted templates are
removed during system updates
Available in Salesforce
Classic
Available in Developer
Edition
USER PERMISSIONS
To define package
branding
Package Branding
SIGNUPS USING THE API
Use API calls to the SignupRequest object to create signups for prospective customers
Using API calls to the SignupRequest object you can collect and analyze detailed information on
all signups from your business organization You have control over the signup process and
enhanced visibility into your prospective customers For example you can
Run reports and collect metrics such as the number of signups per day or the number of
signups in different countries
USER PERMISSIONS
To create or view signup
requests
SignupRequest API
Customize the SignupRequest object to add fields of special interest to your company
Create triggers to initiate specific actions such as send an email notification when a new signup request is made
Enable signups from a wide range of client applications and devices so you have more channels for customer acquisition
For more information on working with objects see the Object Reference for Salesforce and Lightning Platform
Create a Signup Request
The Signup Requests tab displays the signup requests home page
Signup Request Details
From the Signup Request detail page you can delete and clone signup requests
Create a Signup Request
The Signup Requests tab displays the signup requests home page
USER PERMISSIONS
From signup requests home page you can perform these actions
Create a new signup If you using a Trialforce template to create the signup make sure the
template has been approved
To create or view signup
requests
Signup Request API
View the details of a previous signup including its history and approval status
Create new views to display signups matching criteria that you specify
To create a signup select Signup Request from the Create New dropdown list in the sidebar or click New next to Recent Signup
Requests on the signup requests home page
Enter the information for the signup request
Click Save when youre finished or click Save New to save the current signup request and add another
Signup Request Details
From the Signup Request detail page you can delete and clone signup requests
This table lists the attributes details in alphabetical order
Attribute
Description
Company
The name of the company requesting the trial signup
SignUps Using the API
Signup Request Details
Attribute
Description
Country
The twocharacter uppercase ISO country code You can find a full list of these codes at a
number of sites such as
wwwisochisoenprodsservicesisomaisocodelistslistenhtml
Created Org
The character Organization ID of the trial organization created This is a readonly field provided
by the system once the signup request has been processed
The email address of the admin user for the trial signup
Error Code
The error code if the signup request isnt successful This is a readonly field provided by the system
to be used for support purposes
First Name
The first name of the admin user for the trial signup
Last Name
The last name of the admin user for the trial signup
Edition
The Salesforce template that is used to create the trial organization Possible values are Partner
Group Professional Partner Professional Sales Enterprise
Professional TSO Enterprise Partner Enterprise Service
Professional Enterprise TSO Developer and Partner Developer
Preferred Language
The language of the trial organization being created Specify the language using a language code
listed under Fully Supported Languages in Supported Languagesin Salesforce Help For example
use zhCN for simplified Chinese The value you select overrides the language set by the locale If
you specify an invalid language the organization defaults to the default language of the country
Populated during the signup request and for internal use by Salesforce
ShouldConnectToEnvHub When set to true the trial organization is connected to the Environment Hub The signup must
take place in the hub master organization or a spoke organization
Source Org
The character Organization ID of the Trialforce Source Organization from which the Trialforce
template was created
Status
The status of the request Possible values are New In Progress Error or Success The
default value is New
Template
The character ID of the approved Trialforce template that is the basis for the trial signup The
template is required and must be approved by Salesforce
Template Description The description of the approved Trialforce template that is the basis for the trial signup
Trial Days
The duration of the trial signup in days Must be equal to or less than the trial days for the approved
Trialforce template If not provided it defaults to the trial duration specified for the Trialforce template
Username
The username of the admin user for the trial signup It must follow the address convention specified
