Home GREE Platform Overview

GREE Platform Overview

Introduction

This document is a general overview of the GREE Platform. All information included in this document is subject to change without prior notice.

1. GREE Platform

The "GREE Platform" is now one of the world's largest gaming platform, and it enables you to release your applications to 169 countries and regions. It also supports 14 languages including Japanese and English. It has the potential to become the biggest gaming platform with the promising rise of the smartphone market.

The following benefits of the "GREE Platform" are provided to developers.

The GREE Platform provides various software development kits (SDK) to meet developers' purpose and needs, and provides the following merits for developers' applications.

Users around the world can gather around developers' applications

  • A feature for users to invite friends to a game (Invite Service)
  • A feature where users can share their application experience with friends, drawing them into the game (Share Service)
  • A structure that allows users around the world to seamlessly come and go between applications. (Game Dashboard function)

Services to maintain continuous app play

  • A feature to compare scores to friends on GREE and other users to increase the competitive spirit between users (Casual Game API)
  • A feature where users can send requests to ask other users to take action (Request Service)
  • A feature for developers to send messages directly to app users (Message API)
  • A feature to use the Request Service and Message API as push notifications (Push Notification function)

Maximize revenue from applications

  • A billing feature for getting and spending virtual currency that can be used within apps on GREE (Payment System function)

If the operating system and terms of use do not restrict the use of this feature, it will also be provided for the GREE Platform Android SDK (hereinafter Android SDK) and GREE Platform iOS SDK (hereinafter iOS SDK) as noted in later sections.

2. GREE Platform SDK

The Android SDK and iOS SDK provided by the GREE Platform are SDKs that can be used to build in features provided by GREE into Android/iOS applications respectively.

2.1. Function Overview

The GREE Platform allows provided features to be easily used with methods of the SDK. You can also provide more effective features by combining transmissions from the application to your (the developer's) server and API calls from your server to GREE. The following is a diagram of the system overview.

2.2. SDK Functions

The following functions are available when this SDK is implemented into applications.

Platform Authentication

  • An authentication function to link app users to their GREE accounts

Social API

  • An API that allows interaction between users connected through GREE's Social Graph and access to users' information.
  • A feature for GREE users to invite non-GREE users to the corresponding application.

Casual Game API

  • An API that allows you to retrieve and update game related information such as rankings and achievements.

Virtual Currency and Item Billing

  • This feature allows users to get virtual currency and spend it on items within the application.

User Security

  • This function provides a safe execution environment for social applications with an automatic monitoring system for free input statements and privacy settings for profiles.

Push Notifications

  • An API with push notification functionality from the server side using Android's GCM(C2DM) service and the iOS Apple Push Notification, as well as local notifications within apps (timed notifications).
  • Messages can be displayed when applications are launched / idle, and applications can be launched if parameters are added.

Dashboard / Notification Board

  • A dashboard that displays game related information such as SNS, app info, ranking, and achievements.
  • A notification board that displays messages between users or requests sent and received between users and developers.

2.3. Distribution

The GREE Platform SDK can be downloaded from the following link.

Android SDK

The SDK is distributed as a library and in the form of a Java source code tree which implements all provided functionality.

Android SDK

iOS SDK

The SDK is distributed as a library and in the form of an Objective-C source code tree which implements all provided functionality.

iOS SDK

2.4. Development Environment

The development environment used for the GREE Platform is as follows.

Android SDK

We recommend developing Android apps in the standard Eclipse environment as the application development environment for this SDK. The following includes descriptions under the assumption that apps are developed in Eclipse.

  • Development Language: Java
  • Android OS Version: 2.1, 2.2, 2.3.X, 4.0.X, 4.1.X, and 4.2.X

iOS SDK

The standard iOS app development environment shall be Xcode 4.2 and later for this SDK. Later descriptions assume that apps are developed with Xcode.

  • Development Language: Objective-C
  • iOS Version: 4.3, 5.X and 6.X

3. GREE Platform WebView App SDK

The GREE Platform Webview App SDK provided by the GREE Platform is an SDK that allows developers to create native Android/iOS applications by utilizing web components to use the Web Platform API.

3.1. Function Overview

The functions provided by the GREE Platform available in the GREE Platform SDK are also available in this SDK. The following is a diagram of the system overview.

3.2. SDK Functions

The following functions can be used in addition to the functions of the GREE Platform SDK.

WebView UI Functionality

  • A WebView function for displaying web apps with AppActivity for Android and UIViewController for iOS.

WebView App-Specific UI

  • A control UI for Web app control provided as a WebView app-specific status bar on the top of the screen and a navigation bar on the bottom of the screen that can easily create shortcuts for URLs often accessed.

3.3. Distribution

The distribution of the GREE Platform WebView App SDK is the same as the GREE Platform SDK. Refer to "2.3. Distribution".

3.4. Development Environment

The development environment used for the GREE Platform WebView App SDK is the same as the GREE Platform SDK. Refer to "2.4. Development Environment".

3.5. OAuth Authentication

To authenticate communication between the GREE Platform and developer servers, OAuth 1.0 (RFC5849) is used for all communication from the GREE Platform to the developer server and vice versa.

OAuth Authentication Method

4.Common Specifications

Details for GREE Platform functions that are commonly provided are as follows.

4.1. Social APIs

People API

The People API is used for acquiring user information connected with the GREE social graph and friend information of that user.
The following information is linked with each GREE user ID, and can be accessed and used within games.

  • Nickname
  • Birthday
  • Gender
  • Residing country
  • Profile picture
  • Friend list
  • User grade

People API

Request Service

Request Service is a function that allows users to send requests to other users as follows.

  • Sending User: sends requests such as "Accept Gift" or "Support for Battle".
  • Receiving User: takes action to approve received events.

App activity can be vitalized by including this Request Service.
The UI for this service is not to be implemented by the developer. All UI will be prepared by GREE.

Request Service

Share Service

Share Service is a function that allows users to post "status" updates from applications, a common communication device in SNS. A "status update with picture" can also be posted by taking a picture of the application field when posting.

Users can share their game experience via one-to-many communication channels (not specific to particular users but wide-ranged networks) through this API. "Status update with picture" can increase CTR from other users, so share according to the desired effect and usage scenario.
The UI for this service is not to be implemented by the developer. All UI will be prepared by GREE.

Share Service

4.2. Casual Game APIs

Leaderboard API

The Leaderboard API allows developers to implement functions for posting and managing the leaderboard for game scores without having to set up their own servers. Score units and titles can be flexibly set.
The UI for this service is not to be implemented by the developer. All UI will be prepared by GREE.

The Leaderboard API includes features to compare scores to friends, which will increase the competitive spirit between users.

Leaderboard API

Score API

The Score API can retrieve high scores from games linked to a Leaderboard.
This API helps clarify game goals as achievement points, strongly encouraging user loyalty and play through completion. Developers can design and display rankings freely and create highly effective ranking pages to match various scenarios and UI/UX through the Score API.

Achievement API

The Achievement API allows developers to implement functions for posting, disclosing, and managing game results without having to set up their own servers. Achievement points and titles can be flexibly set.
The UI for this service is not to be implemented by the developer. All UI will be prepared by GREE.

Goals in the game can be distinguished and user loyalty can be increased through the Achievement API.

Achievement API

* The Casual Game API cannot be used from apps that use the GREE Platform WebView App SDK.

4.3. Message API

Message API is an API for developers to send messages to app users.
Developers can send the most suitable messages according to users' use cases and encourage continued application use through the Message API.

Message API

4.4. GREE Dashboard

The GREE Dashboard provides a dashboard that displays game and SNS related information such as SNS, App Portal, ranking, and achievements.
Results to be expected include an increase in the percentage of the continued app usage, active use of invitations, and directs from other apps because users can transition from applications to the GREE Dashboard seamlessly. The GREE Dashboard offers the following services to users.

SNS

The communication between users within an app will be active because they are socially connected outside the app through the following functions.

  • Profile
  • Email
  • Guestbook
  • Community
  • Status Timeline
  • Friends
  • Visitors
  • Invites and more...

Game Dashboard

The Game Dashboard function allows users to check their achievements and friends' rankings.

App Portal

The App Portal allows users to easily find apps that suit their tastes from the various applications created by developers around the world.

Notification Board

Requests from friends sent with the Request Service ("Accept Gift" and "Support for Battle") as well as messages in applications (events, campaign ads) sent from developers through the Message API are displayed on the Notification Board.
Users will always see requests and messages while in the Dashboard. Users can also transition to applications seamlessly from those requests and messages.

Link to Game Dashboard

For a link from apps to the Game Dashboard, refer to the following Developer's Guides.

iOS SDK

Android SDK

4.5. Payment System

The Payment System is a function that controls the purchase and consumption of GREE's virtual currency as well as manages the virtual currency.
The following functions are provided for the purchase and consumption of virtual currency. Developers can use them to implement the most suitable UX for the user.

Deposit API

An API that processes the purchase of virtual currency used to buy items within applications.

Payment API

An API that processes the consumption of items within applications purchased with virtual currency.

Other Rules / Payment System in Android and iOS

  • Android Native App

    • Excluding iOS, Android native apps use GREE coins, the common virtual currency on the GREE Platform.
    • GREE Coins can be purchased in Android native apps through the GREE App provided by GREE.
    • The payment method in Android native apps use the In-app Billing feature provided by Android.

    Payment System (GREE Platform Android SDK)

  • iOS Native App

    • iOS native apps use an app-specific currency unique to each app.
    • The settlement method in iOS native apps use the In App Purchase feature provided by iOS.

    Payment System (GREE Platform iOS SDK)

Rules for Using Virtual Currency within Games

Hard Currency (HC) provided by GREE must be implemented.
Using Hard Currency (HC) provided by GREE, Soft Currency (SC) can be purchased to be used as in-game currency/points.

4.6. User Security

Moderation API

The Moderation API inspects and saves free input text from GREE app users.
The words used in users' free input text are unpredictable and may include inappropriate posts from other users.
If text can be freely input by users in the GREE app, developers can use this API to store and inspect free input text on GREE instead of saving content on the developer's server. (Required for certain apps/regions.)

Moderation API

Ignorelist API

Ignorelist API is used to acquire a blocked user list set by users on GREE that prohibits access. Users can block access from unwanted users through this API.

Ignorelist API

4.7. User Grades

User grades are a new feature on the GREE Platform given to users according to their usage level. A new user registration flow will accompany user grades. (For example, different user grades will be given accordingly after mobile phone verification, email address registration, or other simple information registration.)

After downloading an application, users can play games with simple verification that does not involve mobile phone verification or email address registration, reducing the psychological burden for users to start using an app and contributing towards continued use by users. Following that, registering an email/password and verifying mobile numbers will change user grades.

User Grades

4.8. Notification Features

An API with push notification functionality from the server side using Android's GCM(C2DM) service and the iOS Apple Push Notification, and local notifications can be set within apps (timed notifications).

Push Notifications

Requests from friends sent with the Request Service ("Accept Gift" and "Support for Battle") as well as messages in applications (events, campaign ads) through the Message API are linked to notifications.
Developers can suggest applications to be launched from push notifications and launch applications by adding the right parameters.

Local Notifications

Developers can encourage users to launch applications by displaying messages after the specified time has passed by presetting notifications within applications to send after events such as the recovery of a character.
These notifications are easier to use than push notifications as all you have to do is set the timing of the notifications within applications.

For more details, refer to the following Developer's Guides.

iOS SDK

Android SDK

Home GREE Platform Overview