Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Reference

用語

Required Terminology
Description
Remarks

PID

PID 代表產品識別碼。這是一個在應用程式註冊時自動發放的唯一 ID 值。

PID 不應與 AID 混淆。

支援客户端版本

大韓民國

商店版本
備註
套件包名稱
支援版本

T store

-

com.skt.skaf.A000Z00040

Version Name = 5.0.0 / Version Code = 50000 以上

Olleh Market

預載版本

com.kt.olleh.storefront

Version Name = 5.0.0 / Version Code = 50000 以上

U+Store

LTE終端

com.lguplus.appstore

Version Name = 5.0.0 / Version Code = 50000 以上

大韓民國以外國家/地區

商店版本
備註
套件包名稱
支援版本

新加坡/臺灣

-

com.onestorecorp.gaa.storeapp

支援所有版本

美國

-

com.dti.folderlauncher

Version Name = 4.0.0 / Version Code = 400000 以上

選定商店(Deprecated)

  • 以下內容不建議使用（Deprecated處理） 作為選定商店的分隔符，建議使用common方式。 

    onestore://{store selection }/product/{product PID}?view_type={value}
    選定商店
    假設
    動作

    common

    只安裝一個應用程式商品客戶端時

    立即連動相應商店

    common

    已安裝兩個以上的應用程式商品客戶端時

    首先顯示一個畫面，可自行選擇欲連動的商品

    tstore

    ollehmarket

    uplusstore

    只安裝一個應用程式商品客戶端時

    如果已安裝相應商店客戶端，立即連動

    如果未安裝相應商店客戶端，停止操作（無回應）

    tstore

    ollehmarket

    uplusstore

    已安裝兩個以上的應用程式商品客戶端時

    如果已安裝相應商店客戶端，立即連動

    如果未安裝相應商店客戶端，停止操作（無回應）

    示例

    onestore://common/product/{product PID}?view_type={view_type}
onestore://tstore/product/{product PID}?view_type={view_type}
onestore://ollehmarket/product/{product PID}?view_type={view_type}
onestore://uplusstore/product/{product PID}?view_type={view_type}

關於URL scheme連動 Reference

  • 商品詳細查看 Reference

    command

    Parameter
    Type
    Mandatory
    Limit
    sample
    Description

    product id

    String

    M

    十位數字

    0000252337

    商品的PID（數字）

  • 商品搜尋查看 Reference

    command

    Parameter
    Type
    Mandatory
    Limit
    sample
    Description

    關鍵字

    String

    M

    10 digit number

    0000252337

    輸入關鍵字

  • 請求更新

    command

    Parameter

    Type

    Mandatory

    Limit

    sample

    Description

    product id

    String

    M

    十位數字

    0000252337

    商品的PID（數字）

  • 請求更新時規格的參考事項

    • 更新在Background進行，通過提示（Noti）告知進行過程。

    • 若已經安裝最新版本，將無視更新請求。

    • 該動作只針對會員，故系統只有是ONE Store會員才會有反應。

    • 若用戶不是會員或是登入失敗，為了進行認證將自動顯示登入畫面。

    • 收費應用程式：已有購買紀錄才可啟動。

    • 免費應用程式：自動進行購買處理並下載。

查詢referrer統計

command

refType
referrer
callerType
備註

1

package name

7: Android app 8: 網頁瀏覽器 9: 短信(SMS) 10: 推播訊息（GCM 等） 11: 廣告網路 (T-AD 等）

通過應用程式呼叫時，建議使用套件包名稱（PKG Name），除此之外都使用URL (UTF-8)呼叫

2

URL

相同

相同

3

合作夥伴名稱 + PID

如果與合作夥伴共同進行行銷活動，建議使用該方法

伺服器 API

使用套件包名（packageName）確認PID及版本名稱

command

Request Parameters

Parameter
Type
Mandatory
Limit
sample
Description

pkgNm

String

M

??100

com.nhn.android.search

應用程式的套件包名稱

deviceModelCd

String

O

??100

SM-N920S

osVer

String

O

5

6.0.1

終端設備的OS版本

sdkVersion

String

O

5

30

Response Parameters

Name
Mandatory
Type
Description

result

M

Object

回應結果訊息

code

M

String

  • 000 : success

  • 100 : no data

  • 200 : server error

  • 400 : bad request

  • 509 : server busy

desc

M

String

回應訊息

prodId

M

String

商品PID

verNm

M

String

應用程式版本名稱，只有註冊終端設備名稱和OS版本才會顯示

verCd

M

String

應用程式版本代碼（請見下面說明）

longVerCd

String

  • Version Code

    • Android OS版本為Pie以上且已註冊Major Version Code時，回應如下。

    • Major Version Code 和 version Code 合併版本代碼

      • (((long) major) << 32) | (((long) minor) & 0xffffffffL)

    • 此外，回應與"verCd"相同的值

title

M

String

商品名稱

topMenuId

M

String

版本名稱，只有註冊終端設備名稱和OS版本才會顯示

topMenuNm

M

String

版本名稱，只有註冊終端設備名稱和OS版本才會顯示

menuId

M

最大分類代碼

menuNm

M

String

最大分類名稱

sellerNm

M

String

銷售者名稱

game

M

boolean

不輸入型號時的回應

Last updated