1. TÍCH HỢP KỸ THUẬT CỦA ỨNG DỤNG
TRÊN ZING ME
Web Business Development – VNG Corporation
2. GIỚI THIỆU
■ Zing Me là một sản phẩm của tập đoàn VNG được ra mắt vào tháng 08 năm
2009. Nhằm thỏa mãn nhu cầu của người dùng mạng xã hội, Zing Me luôn mong
muốn hợp tác và luôn tạo điều kiện tối đa cho các nhà phát hành ứng dụng cùng
khai thác và chia sẻ lợi nhuận.
■ Với lợi thế hơn 8,2 triệu người dùng là những khách hàng tiềm năng, đồng
thời có nhân sự hỗ trợ dành cho các đối tác đặc biệt và có hệ thống kênh
phân phối, thanh toán thuận tiện, Zing Me cung cấp mô hình Appstore bao
gồm:
- User base (Zing ID)
- Kênh thanh toán (Zing Xu)
- Tài liệu và hỗ trợ kỹ thuật (SDK)
Việc tích hợp kỹ thuật của ứng dụng trên Zing Me, điều đầu tiên và trước nhất
là bên đối tác cần gửi hồ sơ ứng dụng tới địa chỉ mail: dunglt2@vng.com.vn.
3. CÁC BƯỚC TÍCH HỢP KỸ THUẬT
CỦA ỨNG DỤNG TRÊN ZING ME
■ Tích hợp Sandbox
Là môi trường phát triển ứng dụng, để tạo được sandbox, bên Zing Me cần có
các thông tin sau:
- Thông tin bên thứ 3:
Thông tin công ty: Tên công ty, địa chỉ, giấy phép kinh doanh.
Thông tin người đại diện: Họ và tên, địa chỉ, chức vụ, số CMND, điện thoại và
địa chỉ email.
Mục đích phát triển ứng dụng
Kịch bản ứng dụng
4. - Thông tin ứng dụng:
Tên ứng dụng: phải là tên duy nhất, không trùng tên với các ứng dụng đã có
trên Zing Me tại Appstore. Chứa các kí tự a-z, A-Z, 0-9, '_', '-', không chấp nhận
những kí tự đặc biệt khác.
Tên hiển thị: Tên hiển thị của ứng dụng trên các trình duyệt web (không quá
18 ký tự)
CallbackURL trên server của đối tác: domain của callbackURL phải trùng với
domain của redirect_uri.
Ngôn ngữ phát triển ứng dụng.
Sau khi tiếp nhận hồ sơ ứng dụng, bộ phận kỹ thuật của Zing Me sẽ thiết lập môi
trường thử nghiệm, đồng thời gửi các tài liệu kỹ thuật liên quan tới bên đối tác,
bao gồm: <client_id> & <client_secret>.
Zing Me SDK sử dụng OAuth 2.0 và Graph API để hỗ trợ cho việc phát triển ứng
dụng trên Zing Me.
5. ■ Tích hợp Payment (Zing Credits)
- Zing Credits là một core-application trên Zing Me hỗ trợ cho việc thanh toán
các vật phẩm hoặc dịch vụ trong App/Game, hoặc chuyển tiền vào ví riêng của
App/Game.
- Đơn vị tiền trong Zing Credits là Zing Xu, là đơn vị được dùng chung cho các
sản phẩm của công ty VNG. Zing Credits hiện là kênh thanh toán duy nhất cho
các App/Game ngoài VNG.
- Zing Credits hiện hỗ trợ thanh toán theo phương pháp Push (tức là
App/Game gửi yêu cầu thanh toán đến Zing Credits, Zing Credits cập nhật tài
khoản của người dùng, sau đó gửi lại một yêu cầu cập nhật kết quả cho
App/Game).
- Giao thức được dùng trong API của Zing Credits là REST over HTTP.
6. Thông tin tạo payment: Bên App/Game cần cung cấp cho bên Zing Credits các
thông tin sau:
Tên của App/Game: hiển thị trên UI, độ dài dưới 256 kí tự. Ví dụ “Siêu thị Bạn
bè”.
Mô tả: đoạn văn bản mô tả về App/Game, độ dài dưới 1024 kí tự. Ví dụ “Trò
chơi mua bạn bè làm thú cưng”.
URL: đường dẫn URL trên Zing Me của App/Game.
Icon: file ảnh đại diện cho App/Game, kích thước 64x64 pixels.
UpdateResult URL: đường dẫn URL để Zing Credits gửi request
UpdateResult (commit transaction) sau khi đã xử lý yêu cầu thanh toán (cập nhật
trừ Zing Xu trong tài khoản).
Ví dụ: "http://ffs.apps.zing.vn/app/payment/updateresult".
7. Sau khi đăng ký thông tin App/Game vào hệ thống, Zing Credits sẽ gửi lại cho
App/Game các thông tin sau:
AppID: ID đại diện cho App/Game dùng trong tất cả quá trình trao đổi dữ liệu
với Zing Credits.
Key1: Mã bí mật dùng cho việc mã hóa dữ liệu khi tạo billing URL.
Key2: Mã bí mật dùng cho việc giải mã dữ liệu khi xử lý yêu cầu
UpdateResult từ Zing Credits.
Auth Method: phương pháp thực hiện mã hóa/giải mã dữ liệu (là tham số cho
hàm mã hóa/giải mã).
Lưu ý: Bên App/Game có trách nhiệm giữ bí mật Key1, Key2 sau khi nhận
được.
8. ■ Chế độ màn hình
- Zing Me hỗ trợ 2 chế độ màn hình:
o Landingpage (mặc định): W: 836px; H: Auto resize.
9. o Fullscreen: được áp dụng khi nhấn vào chức năng của ứng dụng như:
Server, Chơi ngay… từ màn hình của Landingpage.
10. 4. Feed
- Zing Me hỗ trợ các chế độ Feed cho các ứng dụng được tích hợp vào Zing Me.
- Feed được chia sẻ lên tường nhà của users.
Xem thêm chi tiết tại đây: http://open.zing.vn/vi/developers
Tài liệu kỹ thuật: http://open.zing.vn/vi/developers/zing-document