로딩중입니다
애드브릭스 커머스 고급 분석 연동 : 안드로이드
1/13/2017 2:31:51 PM

애드브릭스 커머스 분석 연동 : 안드로이드

오픈마켓, 쇼핑몰, 홈쇼핑, O2O 등과 같은 커머스 앱에서 발생하는 구매와 관련된 유저 행동을 분석을 제공합니다.
단순 매출 분석을 넘어서 딥링킹 오픈, 로그인, 환불, 상품상세보기, 장바구니담기, 위시리스트 담기, 검색하기, 공유하기와 같은
유저 행동을 분석할 수 있습니다.

다음의 가이드를 참고하여 각각의 행동에 대한 연동을 진행합니다.

주의! 본 가이드를 적용하기 전에 공통연동을 진행해야 합니다. [공통연동 가이드 바로가기]
주의! 본 가이드를 적용하기 위해서는 최소한 아래 버전의 SDK가 설치되어 있어야 합니다.

  • IgawCommon : 4.4.2
  • IgawAdbrix : 4.4.1

* 가이드 및 커머스 분석에 대한 문의는 abx_partner@igaworks.com 으로 부탁 드립니다.



로그인

유저의 로그인을 추적합니다.

IgawAdbrix.Commerce.login(Context context, String encrytedUserId);
/* 유저아이디는 반드시 암호화 처리 하여야 합니다. */
IgawAdbrix.Commerce.login(this, "dGVzdF91c24=");


딥링킹 앱 오픈

딥링크URL을 통해서 앱을 오픈한 것을 추적합니다.

IgawAdbrix.Commerce.deeplinkOpen(Context context, String deeplinkUrl);
IgawAdbrix.Commerce.deeplinkOpen(this, "myapp://path/page/detail?product_id=30290121");


홈화면 열기

앱의 메인 화면을 오픈한 것을 추적합니다.

IgawAdbrix.Commerce.viewHome(this);
IgawAdbrix.Commerce.viewHome(this);


카테고리(기획전) 진입

카테고리(기획전) 메뉴로 진입한 것을 추적합니다.

IgawAdbrix.Commerce.categoryView(Context context, IgawCommerceProductCategoryModel category);
//카테고리 [기획전]을 열었을때
IgawCommerceProductCategoryModel cats = IgawCommerceProductCategoryModel.create("기획전");
IgawAdbrix.Commerce.categoryView(this, cats);
//카테고리는 최대 5단계까지 구성할 수 있습니다. 
//IgawCommerceProductCategoryModel.create("cat1","cat2","cat3","cat4","cat5");
                    


상품 상세보기

상품 상세보기 페이지로 진입한 것을 추적합니다.

IgawAdbrix.Commerce.productView(Context context, IgawCommerceProductModel product);
/* 여름한정 떨이상품 크록스 회색 20%할인 */
IgawCommerceProductCategoryModel cats = IgawCommerceProductCategoryModel.create("기획전");
IgawAdbrix.Commerce.productView(
    this,
    new IgawCommerceProductModel()
        .setProductID("30290121")
        .setProductName("여름한정 떨이상품 크록스 회색 20%할인")
        .setPrice(50000)
        .setDiscount(10000)
        .setCurrency(IgawCommerce.Currency.KR_KRW)
        .setCategory(cats)
);


장바구니 담기

상품을 장바구니에 담은 것을 추적합니다.

// 단품 담기
IgawAdbrix.Commerce.addToCart(Context context, IgawCommerceProductModel productModel);
// 복품 담기                    
IgawAdbrix.Commerce.addToCartBulk(Context context,  List<IgawCommerceProductModel> productModels);
/* 여름한정 떨이상품 크록스 20%할인 3종 */
/* 카테고리 모델 생성 */
final IgawCommerceProductCategoryModel cats = IgawCommerceProductCategoryModel.create("기획전");

/* 상품 정보 모델 생성 */
ArrayList<IgawCommerceProductModel> productModels productModels = new ArrayList<IgawCommerceProductModel>() {{
    add(new IgawCommerceProductModel()
            .setProductID("30290121")
            .setProductName("여름한정 떨이상품 크록스 20%할인")
            .setPrice(50000)
            .setQuantity(1)
            .setDiscount(10000)
            .setCurrency(IgawCommerce.Currency.KR_KRW)
            .setCategory(cats)
            .setExtraAttrs("color", "메탈블랙"));
    add(new IgawCommerceProductModel()
            .setProductID("30290121")
            .setProductName("여름한정 떨이상품 크록스 20%할인")
            .setPrice(50000)
            .setQuantity(1)
            .setDiscount(10000)
            .setCurrency(IgawCommerce.Currency.KR_KRW)
            .setCategory(cats)
            .setExtraAttrs("color", "크림화이트"));
    add(new IgawCommerceProductModel()
            .setProductID("30290121")
            .setProductName("여름한정 떨이상품 크록스 20%할인")
            .setPrice(50000)
            .setQuantity(1)
            .setDiscount(10000)
            .setCurrency(IgawCommerce.Currency.KR_KRW)
            .setCategory(cats)
            .setExtraAttrs("color", "크리스탈블루"));
}};

/* 상품 장바구니 담기 */
IgawAdbrix.Commerce.addToCartBulk(this, productModels);


위시리스트(관심상품) 추가

상품을 위시리스트(관심상품)에 추가한 것을 추적합니다.

IgawAdbrix.Commerce.addToWishlist(Context context, IgawCommerceProductModel product);
/* 일산 뽀로로 마을 입장권 */
IgawCommerceProductCategoryModel cats = IgawCommerceProductCategoryModel.create("전시회","일산,파주지역","유아");
IgawAdbrix.Commerce.addToWishList(
    this,
    new IgawCommerceProductModel()
        .setProductID("990192001")
        .setProductName("일산 뽀로로 마을 입장권")
        .setPrice(50000)
        .setQuantity(1)
        .setDiscount(10000)
        .setCurrency(IgawCommerce.Currency.KR_KRW)
        .setCategory(cats)
        .setExtraAttrs("나이제한", "7세 이하")
);


주문 내역 검토

주문하기 전에 주문 내역을 확인하는 화면으로 진입한 것을 추적합니다.

//단품
IgawAdbrix.Commerce.reviewOrder(Context context, String orderId, IgawCommerceProductModel product, double discount, double deliveryCharge);
//복품
IgawAdbrix.Commerce.reviewOrderBulk(Context context, String orderId, List<IgawCommerceProductModel> productModels, double discount, double deliveryCharge);
/*
[ 크록스 메탈블랙색 1개, 알파인화이트색 1개, 크리스탈블루색 1개 ]
쿠폰까지 써서 배송비 3500원을 할인받음
할인은 각 상품별로 적용 되었음.
*/
/* 카테고리 모델 생성 */
final IgawCommerceProductCategoryModel cats = IgawCommerceProductCategoryModel.create("기획전");

/* 상품 정보 모델 생성 */
ArrayList<IgawCommerceProductModel> productModels = new ArrayList<IgawCommerceProductModel>() {{
    add(new IgawCommerceProductModel()
            .setProductID("30290121")
            .setProductName("여름한정 떨이상품 크록스 20%할인")
            .setPrice(50000)
            .setQuantity(1)
            .setDiscount(10000)
            .setCurrency(IgawCommerce.Currency.KR_KRW)
            .setCategory(cats)
            .setExtraAttrs("color", "메탈블랙"));
    add(new IgawCommerceProductModel()
            .setProductID("30290121")
            .setProductName("여름한정 떨이상품 크록스 20%할인")
            .setPrice(50000)
            .setQuantity(1)
            .setDiscount(10000)
            .setCurrency(IgawCommerce.Currency.KR_KRW)
            .setCategory(cats)
            .setExtraAttrs("color", "크림화이트"));
    add(new IgawCommerceProductModel()
            .setProductID("30290121")
            .setProductName("여름한정 떨이상품 크록스 20%할인")
            .setPrice(50000)
            .setQuantity(1)
            .setDiscount(10000)
            .setCurrency(IgawCommerce.Currency.KR_KRW)
            .setCategory(cats)
            .setExtraAttrs("color", "크리스탈블루"));
}};

/* 주문검토하기 */
IgawAdbrix.Commerce.reviewOrderBulk(this, "290192012", productModels, 0.00, 3500.00);


상품 결제

상품 결제한 것을 추적합니다.

* discount, deliveryCharge 금액은 애드브릭스 매출 분석에 포함되지 않으며 price x quantity 의 금액이 매출로 집계 됩니다.

//단품 결제
IgawAdbrix.Commerce.purchase(Context context, String orderID, IgawCommerceProductModel purchaseDetail, double discount, double deliveryCharge, IgawCommerce.IgawPaymentMethod paymentMethod);
//복품 결제
IgawAdbrix.Commerce.purchaseBulk(Context context, String orderID, List<IgawCommerceProductModel> productModels productModels, double discount, double deliveryCharge, IgawCommerce.IgawPaymentMethod paymentMethod);
/* 색상이 각각 다른 3개의 크록스를 일괄 구매, 신용카드 결제, 배송료 3500원 */                    
/* 카테고리 모델 생성 */
final IgawCommerceProductCategoryModel cats = IgawCommerceProductCategoryModel.create("기획전");

/* 상품 정보 모델 생성 */
ArrayList<IgawCommerceProductModel> productModels = new ArrayList<IgawCommerceProductModel>() {{
    add(new IgawCommerceProductModel()
            .setProductID("30290121")
            .setProductName("여름한정 떨이상품 크록스 20%할인")
            .setPrice(50000)
            .setQuantity(1)
            .setDiscount(10000)
            .setCurrency(IgawCommerce.Currency.KR_KRW)
            .setCategory(cats)
            .setExtraAttrs("color", "메탈블랙"));
    add(new IgawCommerceProductModel()
            .setProductID("30290121")
            .setProductName("여름한정 떨이상품 크록스 20%할인")
            .setPrice(50000)
            .setQuantity(1)
            .setDiscount(10000)
            .setCurrency(IgawCommerce.Currency.KR_KRW)
            .setCategory(cats)
            .setExtraAttrs("color", "크림화이트"));
    add(new IgawCommerceProductModel()
            .setProductID("30290121")
            .setProductName("여름한정 떨이상품 크록스 20%할인")
            .setPrice(50000)
            .setQuantity(1)
            .setDiscount(10000)
            .setCurrency(IgawCommerce.Currency.KR_KRW)
            .setCategory(cats)
            .setExtraAttrs("color", "크리스탈블루"));
}};

/* 상품 결제 */
IgawAdbrix.Commerce.purchaseBulk(this, "290192012", productModels, 0.00, 3500.00, IgawCommerce.IgawPaymentMethod.CreditCard );


주문 취소(환불)

완료한 주문을 취소하거나 환불을 요청한 것을 추적합니다.

* 해당 API는 실제 매출분석에 반영되지 않습니다.

//단품 취소(환불)
IgawAdbrix.Commerce.refund(Context context, String orderId, IgawCommerceProductModel product, double penaltyCharge);
//복품 취소(환불)
IgawAdbrix.Commerce.refundBulk(Context context, String orderId, List<IgawCommerceProductModel> productModels, double penaltyCharge);
/* 일괄 주문 중에서 크리스탈블루 1개 환불. 배송비 3500원이 청구됨. */
/* 카테고리 모델 생성 */
final IgawCommerceProductCategoryModel cats = IgawCommerceProductCategoryModel.create("기획전");

/* 상품 모델 생성 */
IgawCommerceProductModel productModel = 
        new IgawCommerceProductModel()
            .setProductID("30290121")
            .setProductName("여름한정 떨이상품 크록스 20%할인")
            .setPrice(50000)
            .setQuantity(1)
            .setDiscount(10000)
            .setCurrency(IgawCommerce.Currency.KR_KRW)
            .setCategory(cats)
            .setExtraAttrs("color", "크리스탈블루");

/* 주문 취소(환불) */
IgawAdbrix.Commerce.refund(this, "290192012", productModel, 3500.00);


상품 검색

상품을 검색한 키워드와 검색결과를 추적합니다.

IgawAdbrix.Commerce.search(Context context, String keyword, List<IgawCommerceProductModel> resultProductModels);
/* 나이키 검색*/
/* 카테고리 모델 생성 */
final IgawCommerceProductCategoryModel cats = IgawCommerceProductCategoryModel.create("스포츠의류/운동화");

/* 검색 결과 상품 모델 생성 */
ArrayList<IgawCommerceProductModel> resultProductModels = new ArrayList<IgawCommerceProductModel>() {{
    add(new IgawCommerceProductModel()
            .setProductID("n24jsda922")
            .setProductName("[나이키] 나이키NIKE WMNS AIR MAX THEA WHITEwomens 599409-103")
            .setPrice(94300)
            .setCurrency(IgawCommerce.Currency.KR_KRW)
            .setCategory(cats));
    add(new IgawCommerceProductModel()
            .setProductID("saf323dsa23d4f")
            .setProductName("나이키] 나이키NIKE WMNS AIR MAX THEA WHITEwomens 599409-104")
            .setPrice(106650)
            .setCurrency(IgawCommerce.Currency.KR_KRW)
            .setCategory(cats)):    
    add(new IgawCommerceProductModel()
            .setProductID("hh5j34dz")
            .setProductName("나이키] 나이키NIKE WMNS AIR MAX THEA WHITEwomens 599409-105)
            .setPrice(111150)
            .setCurrency(IgawCommerce.Currency.KR_KRW)
    .setCategory(cats));
}};

/* 상품 검색 결과 */
IgawAdbrix.Commerce.search(this, "나이키", resultProductModels);


상품 공유

공유한 상품과 공유 방법 등에 대해서 추적합니다.

/// Enum > IgawSharingChannel (Facebook, KakaoTalk, KakaoStory, SMS, Email, ...)
IgawAdbrix.Commerce.share(Context context, IgawSharingChannel sharingChennel, IgawCommerceProductModel product);
/* 크록스 여름 한정 상품을 카카오톡으로 공유*/
/* 카테고리 모델 생성 */
final IgawCommerceProductCategoryModel cats = IgawCommerceProductCategoryModel.create("기획전");

/* 상품 모델 생성 */
IgawCommerceProductModel productModel = 
        new IgawCommerceProductModel()
            .setProductID("30290121")
            .setProductName("여름한정 떨이상품 크록스 20%할인")
            .setPrice(50000)
            .setQuantity(1)
            .setDiscount(10000)
            .setCurrency(IgawCommerce.Currency.KR_KRW)
            .setCategory(cats)
            .setExtraAttrs("color", "크리스탈블루");

/* 상품 공유 */
IgawAdbrix.Commerce.share(this, IgawCommerce.IgawSharingChannel.KakaoTalk, productModel);