This document explains the things you need to consider when you design your service before adopting Kakao Sync.
For the successful use of Kakao Sync, it is important to optimize the features that Kakao Sync provides. The main features of Kakao Sync are as follows:
|Use a wide range of user information||You can set more various user information such as a shipping address to 'Required consent' or 'Optional consent' as well as default user information.|
|Simple Signup||Allow users to sign up with their Kakao Accounts by consenting to service terms, instead of asking them to input their personal information.|
|Advanced features connected to Kakao Business Solution||You can use Kakao Marketing Solutions more effectively such as Kakao Talk Channel, Kakao Bizboard, Chatbot.|
When a user attempts Kakao Login in your service that adopts Kakao Sync for the first time, the user is asked to provide user data on the Simple Signup Consent screen. Once the user consents, the user's account is linked with your service app. The Kakao Sync Simple Signup allows users to consent to the followings:
To implement a signup process with a better user experience, read Creating service account.
This occurs when the user has not been registered in your service database. Registering as a service member is not completed even after the Kakao Sync Simple Signup unless you register the user in your service database. Your service must implement the signup process internally with the user information obtained when a user logs in.
To see how to handle the users who want to delete their account in the service, read Deleting service account.
To optimize Kakao Sync, you should figure out which user information your service can use throughout your service as well as for the signup process. After identifying which user information is provided by Kakao Sync, specify the user information when applying Kakao Sync.
Because this document only covers the type of user information, refer to Kakao Login > User information in the development stage for more details.
You can get the following user information without an extra review process.
|Name (Scope ID)||Description||Default Consent Type|
|Service user ID (
||A unique identifier for a service to identify a user.||Required|
|Profile image (
||A URL of profile image.||Required|
|Thumbnail image (
||A URL of profile image thumbnail.||Required|
NOTE: Cautions when using email
||Name of Kakao Account.||Optional|
|Phone number (
|Kakao Talk Channel addition status and details(plusfriends)||The relationship between a user and a Kakao Talk Channel.||Required|
|Age range (
||The age range such as under 14, above 14, 20s, or 30s.||Optional|
|Shipping information (
||Recipient name, shipping address, phone number.||Optional|
Here are the user information that requires a review to set it to 'Required consent'.
|Name (Scope ID)||Description|
|Name (name)||Name of Kakao Account.|
|Birth Year (birthyear)||Birth year.|
|Age range (age_range)||The age range such as under 14, above 14, 20s, or 30s.|
|Shipping information (shipping_address)||Recipient name, shipping address, phone number.|
|CI (account_ci)||An encoded identifier to check if the same user has already been collected in the membership database.|
Kakao does not retain private information such as resident registration number, passport number, clothing size. If such information is necessary for your service, collect it from users internally in your service.
Here is what you need to consider when you plan your service and set on the Simple Signup page:
|Service Terms||Decide the service term to be added is required or optional. Register the service term's URLs where users can see the complete service term.|
|Consent for age 14 and over||Decide whether to allow users under 14 to use the service.
Note that if you add consent for age 14 and over, children under the age of 14 cannot use sign up for the app.
If your app is used for multiple services and each service requires consent to different service terms, or if a new required service term is added to your service, you can apply the following scenario:
The service terms you registered on the Simple Signup page are displayed on the Consent screen when users log in through Simple Signup to ask for consent.
However, when you map the Kakao Accounts of users onto the existing accounts, the service terms that have been consented by each account may differ. For this case, you can use the Retrieving consent details for service terms API.
The registered service terms have their own tags, so you can compare the tags of the user consented service terms passed in the response with all registered tags. If required, implement a process to request consent internally in your service.
To see how to implement this function, see the following development guides:
This API enables you to request consent to specific service terms that a user has not consented to, regardless of whether the user has already signed up.
You can use the Getting consent to desired service terms API in the following cases:
With this API, you can request to consent to only the service terms that a user has not consented even those who are already linked to your service.
When you use
service_terms when you request this API, you must specify the tags for the service terms that the consent is required. If not, all service terms are not displayed on the Consent screen. In this case, a user who has signed up through Simple Signup can log in without consenting to all service terms. To prevent a problem, you should test this feature before applying it to your actual service.
If you do not pass
service_terms, all service terms are displayed on the Consent screen. To specify a particular service term, set
service_terms to the desired terms. If you pass an empty string for
service_terms, no service term is displayed on the Consent screen.
If you request to get consent to the service term that a user has already agreed to only, or to the optional service terms only, the Consent screen does not appear. To see more details and solutions, refer to FAQ.
If your service does not allow the children under 14 to sign up, you can add a consent item to allow only the users who are 14 or older. According to user information, the scenario works as follows.
|If users are considered as children under 14||Unable to log in and sign up.|
|If Kakao does not retain user's age range information||Allow only users who select the 'I am 14 years or older' option on the Consent screen to sign up.|
If the age range is not saved in the user's account, the user under 14 can sign up when selecting the option as above. If the service has to allow only the users who are 14 or older to sign up according to the Operating Policy, set 'CI(Connecting Information)' to 'Required Item' to check the user's age range using the CI.
If your service transfers or stores user information out of Korea, you must notify the users of the fact and get consent to the transfer of personal information overseas. If you operate a business out of Korea, go to [My Application] > [Kakao Login] > [Transfer of Personal Information Overseas] and register the business information. Even when domestic business transfers or stores the user information to other countries through overseas business, you must also notify the users of the change and get consent to the service term about the transfer of personal information.
After registering the information on the Transfer of Personal Information Overseas page, the 'Consent to the Transfer of Personal Information to Foreign Parties' item is included as a Required item on the Consent screen.
When you design the user scenarios after adopting for Kakao Sync, you need to consider how users access your service and member status to provide a natural and convenient flow for users and meet your service's purpose.
Kakao Sync provides a set of features that extend the Kakao Login, as well as the Simple Signup feature. You can take advantage of Kakao Sync with the extra features, such as events for signup, channel messages, biz messages and QR code. Users also can access your service by QR code more easily rather than through mobile or web pages.
Users can access the service that adopts Kakao Sync through various platforms such as the Kakao Talk Channel connected to your service, chatbots, chat bubbles sent through Kakao Talk Sharing, and Kakao Bizboard.
When designing user scenarios, you may need to customize a landing page for users who logged in from the Kakao Talk in-app browse through Auto Login.
To attract more users, you can send messages to the users who are targeted through the Customer file management in the Kakao Talk Channel Admin center. Refer to Kakao Talk Channel Customer Management for more details.
Your service must register users who are linked with your service through the Kakao Sync Simple Signup into the user database stored in your service server. For the users who have previously been registered before adopting Kakao Sync, you can change the user to a Kakao Sync user through a service user ID to map the user accounts with the existing user accounts. In this case, you must get additional consent from the existing users using Kakao Login. Even the users required to register as new members must also consent on the Kakao Sync Consent screen.
If the service user ID same as the existing service user ID is passed, you need to update the user information to the information provided by Kakao Sync, considering the user has already been signed up through Kakao Login.
To see how to map existing users, refer to Handling Kakao Login users.
You can use not only Kakao Sync but also various Kakao services or APIs, including Kakao Login that is an essential feature for Kakao Sync Simple Signup to provide more convenient services.
The main Kakao services and APIs are as follows. Before developing Kakao Sync service, it is recommended to review what you can integrate into the service.
|Kakao Talk Channel||Sends the service news to users who added your Kakao Talk Channel through Kakao Talk.|
|Kakao Pay||Simple payment service with various payment methods such as Kakao Pay.
A partnership is required.
|Kakao Map||Provides South Korea's map and location information.|
|Kakao Login||Provides a social login feature to use various services with Kakao Account.|
|Kakao Talk Friend information||Retrieves friends of Kakao Talk linked with a Kakao Account.
Only the same service app users are provided.
|Kakao Talk Sharing||Allows users to share texts, images, or videos through Kakao Talk messages.|
|Kakao Talk Messaging||Sends Kakao Talk messages through Kakao Talk linked with the Kakao Account in the template designated by a service. Sending auto-messages is not supported.|
|Push Notification||Sends a push notification to a Kakao Account user.|