...
The following tasks must be completed before Aspenware can install the Identity v3 (Powered by Auth0) plugin. Please contact Aspenware Service Customer Success (support@aspenware.com) if you have any questions.
...
To implement Identity v3 (Powered by Auth0), the your resort must meet the following criteria:
Resort must be an Aspenware Cloud customer using the Aspenware Cloud hosting platform.
Resort must be on the following minimum versions or later:
Unity 3.47
Commerce 3.6
Accounts 1.8.1
Cloud UI 1.7
Arrival 1.10
Resort must have an active account with Auth0.
...
Resort completes the application section on the onboarding form below and sends to Aspenware.
Application Description
Application type
Callback URL
Logout URL
withScheme (recommended 'app')
Aspenware sets up Auth0 applications for the Resort 3rd party application.
Once application(s) are setup in Auth0 Tenant, Aspenware will provide resort with connection name and scope to put in their application(s) code-base.
Resort Dev team to setup application using Auth0 guidelines.
Resort Dev team to test.
Aspenware Dev to guide/assist during process.
...
Content & Language Strings
Auth0 Sign-in Screens | |||
Description | Language String | Default | Customer Request |
Title | title | None |
|
Description | description | None | |
Email placeholder | emailPlaceolder | ||
Account lookup link | var-passMediaLinkText | Lookup email by pass number |
|
Account lookup title | var-passMediaTitleText | Let’s lookup your account |
|
Lookup instruction | var-passMediaInstructionsText | Enter the number on your pass |
|
Pass number | passMediaFieldLabel | Pass Number | |
Account lookup Success message | var-passMediaSuccessPrompt | An Account was found | |
Account lookup success body | var-passMediaSuccessDescription | The email we have on file with this pass number is: |
|
Auth0 Sign-Up Screens | |||
Description | Language String | Default Customer Request | |
Title | title | None | |
Description | description | None | |
Email placeholder | emailPlaceolder |
| |
Yes/No for Pass | var-havePassTitle | Do you have a pass |
|
Instruction | var-passNumberTitle | Enter the number on your pass |
|
‘Pass number’ field placeholder | var-passMediaFieldLabel | Pass number | |
Create account with pass error: | var-signupWithPassError | There was a problem creating your account. Please call resort ###-###-#### or create an account without a pass | |
Receive updates and what’s new happening at {resort} | accounts.userprofile.receiveemailstext | Receive updates and what’s new happening at {resort} |
|
Customer matching | accounts.accountexists.subtitle | Call Resort to verify account Resort phone number: ###-###-#### | |
Rewards Enrollment Consent | Accounts.UserProfile.CustomConsentDescription | This is a custom consent message with a link |
|
Aspenware Commerce Tasks
...
Create Customer Profile Page
Description | Language String | Default |
|---|---|---|
Create Customer | accounts.userprofile.detailsheading | Account details |
Create Customer | accounts.userprofile.formtitle.existinguser | Can you help us with a few required details? |
Create Customer | accounts.userprofile.formtitle.newuser | Almost there! Finishing setting u your account |
Create Customer (Rewards) | accounts.userprofile. customconsentdescription | This is a custom consent message with a [link](https://example.com |
Create Customer (marketing) | accounts.userprofile.receiveemailstext | Receive updates and what's new happening at [TODO] |
Create Customer | accounts.userprofile.updateprofileerror | There was an error updating your profile. Please try again |
Single Customer Verification | accounts.verificationrequired.subtitle | Verify your identity |
Single Customer Verification | accounts.verificationrequired.title | Account already exists |
Single Customer Verification | accounts.verificationrequired.verificationsent | Verification sent via email |
Multiple Customer Match | accounts.accountexists.contactlabel | Resort phone number |
Multiple Customer Match | accounts.accountexists.contactnumber | (###)-###-#### |
Multiple Customer Match | accounts.accountexists.subtitle | Call resort to verify account |
Multiple Customer Match | accounts.accountexists.title | Account already exists |
Customer profile (if rewards enrollment enabled) | Accounts.UserProfile.CustomConsentDescription | This is a custom consent message with a link |
Required information - new user | accounts.userprofile.formtitle.newuser | Almost there! Finish setting up your account. |
Required information - existing user | accounts.userprofile.formtitle.existinguser | Can you help us with a few required details? |
Aspenware Commerce Tasks
| Info |
|---|
NOTE: Credentials will continue to be stored in RTP; Resort support staff can still adjust auth profile credentials. |
Settings
Configuration | Description |
|---|---|
customersettings.usernamesenabled | Must set to FALSE to disable usernames in Aspenware Commerce. |
customersettings.dateofbirthminimumage | Ability to set the age restriction for creating an account |
ordersettings.anonymouscheckoutbyproduct | Enables guest checkout to occur. |
checkout.guestcheckout.preferguest | Must be set to ‘true.' Enables guest to sign in as an option. |
auth0externalauthsettings.emailmarketingconsentenabled | Enable Email Marketing on create customer |
auth0externalauthsettings.customconsentenabled | Enables custom consent to be submitted by guest when completing customer profile (E.g. rewards enrollment) |
auth0externalauthsettings.customconsentdefaultvalue | Defaults consent checkbox to checked or unchecked |
...
Identify v3 (Powered by Auth0) includes robust Google Analytics tracking. The following events are included in the data layer.
Location |
Event Name |
Project |
Schema / Message | Use Case | |||
Login | successful_login | Commerce |
| User has signed in successfully and landed on store |
Login | error | Auth0 | errorType: "signin_error," "errorMessage": "{message}" | User has encountered an error, password or API |
Sign-in Page | n/a | Auth0 | When a customer views sign in page |
Auth0
Page View
Forgot password page | n/a | Auth0 | Customer view ‘forgot password’ page |
Forgot Password |
Page View
forgot_password_ |
submitted |
Customer selected ‘forgot password’
Customer match (1) page
Customer views ‘verification needed’ page after match
AW Cloud UI
Auth0 |
Event
forgot_password_submitted
Customer sent email to themselves to reset password
Auth0
Event
signin_attempt
Customer selects ‘continue’ from sign in
Auth0
Event
signin_error
Customer experiences a sign in error, such as password didn’t match, account exists, etc.
Auth0
Event
successful_login
Customer has been authenticated and directed to shop successfully
AW Cloud UI & Commerce
Event
signup_selection
Customer selects ‘sign up’ in auth0
Auth0
Event
Sign-up Page
Customer views sign up page
Auth0
Page View
signup_attempt
Customer selects ‘continue’ after input email/password when creating a new account
Auth0
Event
signup_success
Customer is successful in creating new account in auth0
Auth0
Event
auth0_account_error
Error occurred during sign up in auth0 such as email in use, API error.
Auth0
Event
Customer profile page
Customer views create customer profile page
AW Cloud UI
Page View
customer_match
Customer submits create profile and is matched to an existing customer in RTP (1 or many)
AW Cloud UI
Event
create_profile
Customer is successful in creating new customer
AW Cloud UI
Event
Update_Customer_Profile_Error
Customer experienced an error at creating a new customer
AW Cloud UI
Event
account_lookup
Customer selects ‘look up account with pass’
Auth0
Event
account_found
Customer inputs a valid pass and found an account
Auth0
Event
account_notfound
Customer input an invalid pass or no account found
Auth0
Event
signupwithpass_invitesent
Customer inputs correct pass, has email on file, and has no auth profile
Auth0
Event
Property: error_accountexists
Customer inputs a valid pass but account exists
Auth0
Event
Property: error_incorrectnumber
Customer inputs a invalid pass number and nothing found.
Auth0
Event
error_noemail
Customer inputs a valid pass but no email profile exists to verify
Auth0
Event
| User has sent a password reset email | |||
Sign up | signup_selection | Auth0 |
| User has selected 'sign up' |
Sign up | signup_success | Auth0 |
| User has created an account in auth0 (email/password) |
Sign up | create_profile | Commerce |
| User has created a customer |
Sign up | successful_login | Commerce |
| User has been authenticated and logged in successfully and landed on store |
Sign up | error | Auth0 | errorType: "auth0_signup_error," "errorMessage": "{message}" | User has encountered an error, user exists or API |
Customer profile page | n/a | AW Cloud UI | Customer views create customer profile page | |
Customer Matching | signup_success | Auth0 |
| User has created an account in auth0 (email/password) |
Customer Matching | create_profile | Commerce |
| User has created a customer |
Customer Matching | customer_match | Commerce | { "event": "awc_customer_match", "type", "#"} | User has matched to a customer in RTP |
Customer match (1) page | n/a | AW Cloud UI | Customer views ‘verification needed’ page after match | |
Customer match (many) page | n/a | AW Cloud UI | Customer view ‘call resort’ after being matched to multiple customers in RTP |
AW Cloud UI
Page View
Account Lookup | account_lookup | Auth0 |
| User has selected 'account lookup with pass number' on sign in screen |
Account Lookup | account_found | Auth0 |
| User entered a pass that is associated with an account |
Account Lookup | account_notfound | Auth0 | { "event": "error", "errorType": "account not found", "errorMessage": "{error message}" } | User entered a pass that is not associated with an account |
Pass Account Create | signup | Auth0 | signupMethod: "pass_media" | User has entered a valid pass number |
Pass Account Create | verify_account_view | Auth0 | signupMethod: "pass_media" | User has been sent an email to verify their identity before finishing account create with pass flow |
Pass Account Create | resend_email | Auth0 | signupMethod: "pass_media" | User has resent invite |
Pass Account Create | signup_error | Auth0 | signupMethod: "pass_media", "message": "no_email" | User has encountered an error related to customer not having an email profile on file in RTP |
Pass Account Create | signup_error | Auth0 | signupMethod: "pass_media", "message": "account_exists" | User has encountered an error related to customer having an existing account |
Pass Account Create | signup_error | Auth0 | signupMethod: "pass_media", "message": "invalid_value" | User has encountered an error related to a wrongly input pass number |
Pass Account Create | create_profile | Commerce |
| User has accepted invite, added a password, and has completed their profile |
Pass Account Create | successful_login | Commerce |
| User has accepted invite, added a password, and has completed their profile, and signed in/landed on store |
Add password | n/a | Auth0 | Page View | When a guest lands on the add password screen |
Implementation
Once Aspenware has received your onboarding information, they will send you a timeline for your implementation and be in contact as the process progresses.
Questions about Identity v3 (Powered by Auth)? Check out our Frequently Asked Questions page or contact your Aspenware Service AgentCustomer Success Representative.
...