티스토리 뷰

Dev Story

T store API: Linking to Your Products

ShellingFord 2013. 3. 5. 16:06

T store product linkage Guide

Linking to Your Products

+ Update : Feb/22/2013

T store client provides several link formats below that let you bring users to your products in the way you want, from Android apps, web pages, ads, reviews, articles, social media posts, and more.


The link formats let you:

App

via native cording

  1. Link to a specific app's product details page
  2. Link to a specific app's  download, payment, gift pages
  3. Link to a search result of your choice
    1. T store Client v2.05 or later 
    Web

    via HTML  

    1. Redirect users to a specific app's product details page (only)
    2. Link to T store install pages if user doesn't have T store Client


    T store API: PRODUCT_VIEW

    Linking to a Product Details Page 

    Update : Feb/22/2013

    Use deep-link users directly to a specific app's product details page. At the product details page, users can see the app description, screenshots, description, reviews and more, and then install it : ) 


    To create the deep link, you need to know the T store 'product ID', which is declared in the application list page at T store developer center. ( ex: AID: OA00258540) 


    Please replace OA, a platform letter of Application ID, with “00”.    
    AID is OA00258540 

    PID is 0000258540


    The product ID is also visible in your product detail pages at T store web below.


    < image 01: Product ID >


    For example, T store product URL :

    http://www.tstore.co.kr/userpoc/game/viewProduct.omp?t_top=DP000504&dpCatNo=DP04008&insDpCatNo=DP04008&insProdId=0000258540&prodGrdCd=PD004401



    highlighted (insProdId) is Product ID, 0000258540 of T store.



     1. Linking users via HTTP


    There are two general formats for links that are accessible to T store users on Android, The two formats trigger slightly different behaviors on the device:


    http://    Lets the user launch their browser to handle the request. 

    If the browser handles the request, it choose whether to launch T store Client or loads the target page on T store web site when the user don't install T store Client.



    as shown in the example below.


    http://tsto.re/PID


    Here's an example: http://tsto.re/0000313304 (Evernote)



    < image 02: Examples >



    2. Linking users via Android (Native)


    If you want to link to your T store products from an Android app, create an Intent that opens an T store deep-link URL. 


    A. Check installation of T store client

    the sample code below is verify installation of store Client.

    You can verify installation of T store Client by PKG name (com.skt.skaf.A000Z00040



    B. Summary of URL formats

    The table below provides a summary of the URLs currently supported by the T store Client in an Android application.


    PRODUCT_VIEW/(PID)/(Contents Rating)
    PRODUCT_VIEW/(PID)/(Contents Rating)/[REVIEW | GIFT?PID= | PAYMENT 

    PRODUCT_VIEW – prefix
    / - separator

     PID - 10 character string
    Contents Rating - 1 character string

    0 : rating for all
    1 : 12+
    2 : 15+
    4 : 19+
    (3 is not exist)

    REVIEW – Link to review page
    GIFT – Link to gift page

    PAYMENT – Link to payment page ( Already purchased, free download )

     EXAMPLE)

    PRODUCT_VIEW/0000012345/1
    PRODUCT_VIEW/0000012345/1/REVIEW
    PRODUCT_VIEW/0000012345/1/GIFT?PID=0000012345
    PRODUCT_VIEW/0000012345/1/PAYMENT


    Min-Version
     

    T store Client v2.00.00 or later
    ( android:versionName="2.34" android:versionCode="3" )


    REVIEW/GIFT : T store Client v2.70.01 or over
    ( android:versionName="2.90" android:versionCode="60" )


    PAYMENT: T store Client v2.72.00 or over
    ( android:versionName="2.92" android:versionCode="62" )

    Table 01: T store deep-link API

    3. Sample Code


    If you want to use it from your Android app, create an Intent that opens an T store URL, as shown in the example below. (just replace sample PID with yours)    
     
    - PACKAGE NAME:    com.skt.skaf.A000Z00040
    - CLASS NAME:         com.skt.skaf.A000Z00040.A000Z00040



    CAUTION
    1. This API is not available for VOD, eBook contents (Music contents are available) 
    2. If T store Client version is too law to support latest API, T store Client will update automatically. 
    3. In general, we recommend to use http:// redirection format on web and Apps. native code dosen't work without installation of T store Client. 




    사업자 정보 표시
    SK플래닛 | 서진우 | 경기도 성남시 분당구 판교로 264 the Planet | 사업자 등록번호 : 104-86-36968 | TEL : 02-1600-6573 | Mail : devhelper@tstore.co.kr | 통신판매신고번호 : 제2014-경기성남-0036호 | 사이버몰의 이용약관 바로가기

    'Dev Story' 카테고리의 다른 글

    What's changed #5: Documentations  (0) 2013.09.25
    What's changed #4: Payment  (0) 2013.09.25
    What's changed #3: Sub-IDs  (0) 2013.09.25
    What's changed #1: App submission  (0) 2013.09.25
    Get a chance to win money for your Game development  (0) 2013.06.25
    댓글
    공지사항
    최근에 올라온 글
    최근에 달린 댓글