2. Terms

2.1. Initialize

Infodesk

This is the server that performs the necessary tasks in the game entry phase on the platform.
Prior to entering the game, the necessary information is communicated to the client, and emergency notification, check processing, and version-specific update instructions are provided.

System Notice

It is a message such as urgent notice, inspection guide, version update guide before entering the app.

White List

This is a function that allows to pass for testing purposes when the game can not be entered by the inspection.
Whitelists can be registered through the sample app or admin. For whitelisted devices, you can pass the check and enter the game.

User Id (playerId)

All users has unique Id in this platform. It is represented by 'player Id' programmatically.

IDP

Kakao, Facebook, Google, Apple Game Center, and so on.

IDP Account

This is the key you use for the user account in Kakao, Facebook, Google, and Apple Game Center. (Google / Facebook email account, Kakao service user ID)

Login

A user ID is created in IDP units, and login is attempted with the corresponding user ID.

Integrated Login

Zinny SDK provides one API to login IDP and platform at one go.

Platform Login

It means login into the platform using IDP's login information.

ZAT(Zinny Access Token)

It is an access token issued by the Zinny platform for use where platform authentication is required after login.

Logout

Logout for each app, and it will not affect other apps.

Unregistration

By leaving each app, it means that the record of each game is initialized.

Switching Account

(Login Guest, Apple Game Center, or Google Account only)
This feature allows users who logged in with {Guest login, Apple Game Center, Google Account} maintain user's game data by mapping to a Kakao or Facebook account when the user switches different mobile devices.

Log bucket

A server that collects logs from the platform.

Standard Indicator(Platform Indicator)

It is an index of the platform data base and is provided only with the Kakao game platform interlocking without additional work.

Game Indicator

Provide customized metrics for each game. You must first define the log format for extracting the game indicators you need.

Push Certification Key

Each game requires an authorization key to send device-based pushes.

• Android: Project ID information of game registered in Google API Console is needed

• IPhone: Push certificate file issued by Apple Developer Center (iOS Developer Center) and required password for this certificate

Online Notice

This function allows you to send messages to users who are accessing the game.

• When you send an online notification message by admin, it disappears after 3 seconds exposure with Toast popup at the top of client UI

• Five minutes after the check is started, the check message registered by the administrator is exposed as a message pop-up in the center of the client (when the OK button is clicked, the app is terminated)

Social Push

It informs the game progress of social friends on KakaoTalk, raising game loyalty by inducing competition among friends.

• Push notifications for first visit: When a new user first enters the game, it sends a notification push to friends who have already played the game.

Message Box

You can place multiple message boxes in the game as a list of messages sent for providing game items in the game.

Message

The content sent to provide the game item is called a message.

In-game Promotion

Promotions to login, level up, and purchase events within the game.

Cross Promotion

A promotion that encourages the installation of certain games to exchange traffic between two games.

URL Promotion

It is a promotion that users share the URL to access the game on external website (Facebook, Twitter, Website, etc.) and give compensation when users click the URL to access the game.

Pre-booking Promotion

It is a promotion that can pay compensation for accessing the game to the users participating in the pre-booking of the Kakao.
Once the pre-booking is started after registering the pre-booking information in the Kakao Game Center Admin, the pre-booking event information and the list of the users participating in the event are linked to the Kakao Game Platform Promotion Server, and the compensation can be paid from the promotion server.

Fixed Type

You can create a coupon code of at least 2 to 20 characters by specifying a common string in English / numbers / Korean.

Randomize Type

Coupon code will be generated with 16 digits as a coupon issued in random combination with English / number.

2.8.  Customer Center,Announcements/Events, Community

Announcements/Events

• Expose the four latest bulletins and event banners that are being exposed in your admin.

• If there are more than 4 announcements, you can see more announcements because 'more' buttons are displayed. Event banners are all exposed without any limit.

In-app Webview

• Supports the display of web content within the app.

Deeplink URL

• When you click a link, it is a link to a specific location or webpage.

• You can move to the specific location you want, and you do not have to go through the middle steps.

2.9. Leaderboard

Leaderboard

• We provide a real-time ranking system including seasonal (daily, weekly, monthly) rankings.

• Define leaderboards and report score changes to the platform to provide full rankings in real time.

• If you are certified with Cacao or Facebook, the SDK will provide you with social ratings for each of your friends.

Entire Ranking

• Ranking is collected from the leaderboard server for all users, and ranking information is provided

Friends Ranking

• For users with social authentication, provide rankings among friends

• In the case of friend rankings, rankings are counted based on the list of friends who are held on a per-user basis, without ranking on the leaderboard server, and are exposed to the user

• Leaderboard rankings provided by Platform Admin are not available in friend rankings

Save the Past Season

• Season: The period for which the rankings are counted. Daily / Weekly / Monthly / Entire

• If not the entire ranking, you can set up the saving period of ranking information for the past season.

Threshold of Valid Score

• In order to prevent attacking, the platform administrator can define the maximum or minimum number of valid points, which can be excluded from the ranking list.

• Scores that exceed the limit of valid scores are not reflected in the ranking ranking.

2.10. System Information

Language Code

The language setting information set on the device.

Locale Code

For devices supporting 3g / LTE, the country code returned by the communication module is returned. For wifi-only devices, the country code set in the device is returned.

DeviceId

This is the value that can distinguish the device.

• Android: Encrypt android android id provided by OS.

• iOS: Not provided by OS, iOS SDK creates device alias with arbitrary value.

Device Model

Current device model information.

Network Type

The current network type (wifi / cellular / unknown) to which the device is connected.

2.11. Kakao Social

KakaoTalk Invite Message

Users can send to friends of KakaoTalk who have not yet authenticated the game.

talkOs

OS information of devices subscribed to KakaoTalk

• String value: "android" or "iOS" 

• You have to implement sending message by referring to the talkOs value.

KakaoTalk Recommended invitees

It is a friend of KakaoTalk who has a high chance of joining a game derived from a big data base by Kakao.

KakaoTalk Game Message

Users can send game messages to friends who have joined the game.

KakaoTalk Game Message Receive Settings

Users can set whether or not to receive messages from KakaoTalk game friends.
If they set unreceive it, friends can not send you game messages.

KakaoTalk Group Chatting Message

• If a user has a group chat room in the Kakao Talk conversation list, you can send the message to the group chat room.

• A group room message is the third message type, not a game message or an invitation message.

Message Template

• Kakao Game Center You can register message templates in Game Management.

• You must create each by invitation, game, and group message.

• You can add some tags in the template, and the client can replace it and send the message dynamically.

Message Template Id

Template ID created in Game Center

Daily Quota

Messages that one person can send to a specific app during the day (regardless of the recipient)

Monthly Quota

Messages a user can send to a specific person for a specific app for a month