Description

This guide will show you how to quickly get started using SAP Customer Identity (previously Registration-as-a-Service, or RaaS). The easiest way to start using Customer Identity is to use SAP Customer Data Cloud Screen-Sets on your website, for quickly setting up user-facing flows of registration and login. By following the steps below you can have a working basic implementation up and running in under 20 minutes.

This guide assumes you have already set up a site in the Gigya Dashboard with a valid API Key.

Implementing SAP Customer Identity Screen-Sets

Note:  The Screen-Set API is part of the  Customer Identity package, which is a premium platform that requires separate activation. If it is not part of your site package please contact your SAP Customer Data Cloud or contact us by filling in a  support form  on our site. You can also access the support page by clicking "Support" on the upper menu of the SAP Customer Data Cloud Console.

Screen-Set Quick Start Guide

The following tutorial will show you how to begin using SAP Customer Data Cloud Console default Screen-Sets as soon as possible, without customization.

The quickest and easiest way to immediately implement Screen-Sets on your site is by using simple HTML links in your sites menu bar.

  1. Add the SAP Customer Data Cloud Console Web SDK to your site via the following <script> tag in the head of your pages.

    <script type="text/javascript" src="http://cdn.gigya.com/js/gigya.js?apikey=YOUR-API-KEY-HERE"></script>

     

    Your API Key is available from the Dashboard of the Console.
     

  2. Add the viewport <meta> tag to the <head> of your sites pages.  It is important that this is the very first item within the <head> (before the gigya.js script) to ensure proper functionality of the Mobile Screen-Sets.

    <meta name="viewport" content="width=device-width, user-scalable=no">
  3. Add Login, Register, Edit, and Logout links to your menu with the following <href> tags. These links will open the default set of Screen-Set Dialog popups when clicked.

    1. <a href="#" onclick="gigya.accounts.showScreenSet({screenSet:'Default-RegistrationLogin'});">Login</a>

    2. <a href="#" onclick="gigya.accounts.showScreenSet({screenSet:'Default-RegistrationLogin', startScreen:'gigya-register-screen'});">Register</a>

    3. <a href="#" onclick="gigya.accounts.showScreenSet({screenSet:'Default-ProfileUpdate'});">Edit</a>

    4. <a href="#" onclick="gigya.accounts.logout();">Logout</a>

      Best Practice: To ensure users know they have logged out of your site, it is recommended to use a function, rather than just calling the socialize.logout() method directly, e.g.,

      <script type="text/javascript">
      	function logOutUser() {
      		gigya.accounts.logout();
      		alert ('You have been logged out!');
      	}
      </script>
      <a href="#" onclick="logOutUser();">Logout</a>

       


       

  4. Navigate to the Policies page of the SAP Customer Data Cloud Console.



  5. In the Login Identifier, leave Email selected.

  6. In the Link Accounts Support, select All Identities (this will enable users that login using multiple providers to be considered as the same user. If this is not selected and users login with multiple providers using the same email address, you will have multiple accounts created for that user).

  7. In the Default Login & Registration Screen-Set fields, be sure that you have the correct screen-set chosen for both options. (If you are using the Default Screen-Sets, this will already be set to use those).

  8. If your organization uses Terms Of Service, go to the Screen-Sets page of the Gigya Console, find the default-RegistrationLogin Screen-Set and open it via the UI Builder. Navigate to the Registration Screen in the Screens section on the left hand menu. Locate the Terms field and edit the Label section to include the URL of the page containing your Terms Of Service. If your company does not use Terms Of Service, You can remove this field by clicking on the  when you mouse-over it and saving the Screen.

  9. A sample complete code example for reference:

    <html>
    <head>
        <title>Mobile Ready Screen-Set Implementation Example</title>
    	<meta name="viewport" content="width=device-width"><!-- VERY IMPORTANT TO PLACE HERE!! -->
     	<SCRIPT type="text/javascript" lang="javascript" 
    	   src="http://cdn.gigya.com/js/gigya.js?apikey=<YOUR-API-KEY-HERE"></SCRIPT>	   
    </head>
    <body>
    		<a href="#" onclick="gigya.accounts.showScreenSet({screenSet:'Default-RegistrationLogin'});">Login</a>&nbsp;&nbsp;|&nbsp;&nbsp; 
    		<a href="#" onclick="gigya.accounts.showScreenSet({screenSet:'Default-RegistrationLogin', startScreen:'gigya-register-screen'});">Register</a>&nbsp;&nbsp;&nbsp;&nbsp;
    		</br></br></br>
    		<a href="#" onclick="gigya.accounts.showScreenSet({screenSet:'Default-ProfileUpdate'});">Edit Your Profile</a>&nbsp;&nbsp;&nbsp;&nbsp;
    		</br></br></br>
    		<a href="#" onclick="gigya.accounts.logout({callback:onLogout});">Logout</a>&nbsp;&nbsp;&nbsp;&nbsp;
    <script>
    	function onLogout(response) {   
    		if ( response.errorCode == 0 ) {                
    			alert('You are now logged out'); 
    		} 
    		else { 
    			alert('Error :' + response.errorMessage); 
    		} 
    	}
    </script>
    </body>
    </html>



  10. Congratulations! Your site should now have the basic functionality of RaaS Screen-Set Implementation, however, be sure to also review the Next Steps section below.

Important Notes

More Information

View the following pages for additional information and examples.

Default Gigya Screen-Sets

accounts.showScreenSet method

Demo - Screen-Sets Hosted On Gigya

Lite Registration Quick Start Guide 

Markup Extensions

 

Next Steps

Once you have Customer Identity successfully integrated within your site there are some additional items to familiarize yourself with.

Identity Access

Using Gigya's Identity Access tool you can administrate and manage users through an easy to use graphical user interface.

See Identity Access for more information.

Customer Insights

View the demographics of your visitors using Gigya's Customer Insights tool.

 

See Customer Insights for more information.

Site Groups and SSO

Implementing Gigya's Registration-as-a-Service (RaaS) within a Site group requires additional setup. Please see Site Groups and Single Sign-On for detailed instructions.

Useful Links

 

The following guide will show you how to begin using Gigya's Default Screen-Sets as soon as possible, without customization.