로딩중입니다
애드브릭스 커머스 고급 분석 연동 : iOS
1/19/2017 10:07:24 AM

애드브릭스 커머스 분석 연동 : iOS

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

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

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

  • IgaworksCore : 2.3.4
  • Adbrix : 2.2.0

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


로그인

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

AdBrix.commerceLogin:(NSString*)encryptedUserId;
/* 유저아이디는 반드시 암호화 처리 하여야 합니다. */
[AdBrix commerceLogin:@"dGVzdF91c24="];


딥링킹 앱 오픈

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

AdBrix.commerceDeeplinkOpen:(NSString *)deeplinkUrl;
[AdBrix commerceDeeplinkOpen:@"myapp://path/page/detail?product_id=30290121"];


홈화면 열기

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

AdBrix.commerceViewHome;
[AdBrix commerceViewHome];


카테고리(기획전) 진입

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

AdBrix.commerceCategoryView:(AdBrixCommerceProductCategoryModel*)category;
//카테고리 [기획전]을 열었을때
[AdBrix commerceCategoryView:[AdBrixCommerceProductCategoryModel create:@"기획전"]];

//카테고리는 최대 5단계까지 입력할 수 있습니다.
//[AdBrix commerceCategoryView:[AdBrixCommerceProductCategoryModel create:@"cat1" category2:@"cat2" category3:@"cat3" category4:@"cat4" category5:@"cat5"]];


상품 상세보기

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

AdBrix.commerceProductView:(AdBrixCommerceProductModel*)product;
/* 여름한정 떨이상품 크록스 회색 20%할인 */

[AdBrix commerceProductView:
    [AdBrix createCommerceProductModel:@"30290121"
                           productName:@"여름한정 떨이상품 크록스 회색 20%할인"
                                 price:50000.00
                              discount:10000.00
                              quantity:1
                        currencyString:[AdBrix currencyName:AdBrixCurrencyKRW]
                              category:[AdBrixCommerceProductCategoryModel create:@"기획전"]
                         extraAttrsMap:[AdBrixCommerceProductAttrModel create:@{
                                                                                @"color" : @"blue",
                                                                                @"size" : @"250"
                                                                                }]
     ]
 ];


장바구니 담기

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

// 단품 담기
AdBrix.commerceAddToCart:(AdBrixCommerceProductModel *)product;
// 복품 담기                    
AdBrix.commerceAddToCartBulk:(NSArray *)productsInfos;
/* 여름한정 떨이상품 크록스 20%할인 3종 */
/* 상품 정보 모델 생성 */
NSMutableArray *productArr = [NSMutableArray array];

[productArr addObject:
    [AdBrix createCommerceProductModel:@"30290121"
                        productName:@"여름한정 떨이상품 크록스 회색 20%할인"
                              price:50000.00
                           discount:10000.00
                           quantity:1
                     currencyString:[AdBrix currencyName:AdBrixCurrencyKRW]
                           category:[AdBrixCommerceProductCategoryModel create:@"기획전"]
                      extraAttrsMap:[AdBrixCommerceProductAttrModel create:@{ @"color" : @"메탈블랙", @"size" : @"250" }]
    ]
];

[productArr addObject:
    [AdBrix createCommerceProductModel:@"30290121"
                        productName:@"여름한정 떨이상품 크록스 회색 20%할인"
                              price:50000.00
                           discount:10000.00
                           quantity:1
                     currencyString:[AdBrix currencyName:AdBrixCurrencyKRW]
                           category:[AdBrixCommerceProductCategoryModel create:@"기획전"]
                      extraAttrsMap:[AdBrixCommerceProductAttrModel create:@{ @"color" : @"크림화이트", @"size" : @"260" }]
    ]
];

[productArr addObject:
    [AdBrix createCommerceProductModel:@"30290121"
                        productName:@"여름한정 떨이상품 크록스 회색 20%할인"
                              price:50000.00
                           discount:10000.00
                           quantity:1
                     currencyString:[AdBrix currencyName:AdBrixCurrencyKRW]
                           category:[AdBrixCommerceProductCategoryModel create:@"기획전"]
                      extraAttrsMap:[AdBrixCommerceProductAttrModel create:@{ @"color" : @"크리스탈블루", @"size" : @"270" }]
    ]
];

/* 장바구니 담기 */
[AdBrix commerceAddToCartBulk:productArr];


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

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

AdBrix.commerceAddToWishList:(AdBrixCommerceProductModel *)product;
/* 일산 뽀로로 마을 입장권 */
[AdBrix commerceAddToWishList:
    [AdBrix createCommerceProductModel:@"990192001"
                           productName:@"일산 뽀로로 마을 입장권"
                                 price:20000.00
                              discount:5000.00
                              quantity:1
                        currencyString:[AdBrix currencyName:AdBrixCurrencyKRW]
                              category:[AdBrixCommerceProductCategoryModel create:@"전시회"
                                                                        category2:@"일산,파주지역"
                                                                        category3:@"유아" ]
                         extraAttrsMap:[AdBrixCommerceProductAttrModel create:@{ @"나이제한" : @"7세 이하" }]
     ]
 ];


주문 내역 검토

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

//단품
AdBrix.commerceReviewOrder:(NSString *)orderId product:(AdBrixCommerceProductModel *)product discount:(double)discount deliveryCharge:(double)deliveryCharge;
//복품
AdBrix.commerceReviewOrderBulk:(NSString *)orderId productsInfos:(NSArray *)productsInfos discount:(double)discount deliveryCharge:(double)deliveryCharge;
/*
[ 크록스 메탈블랙색 1개, 알파인화이트색 1개, 크리스탈블루색 1개 ]
쿠폰까지 써서 배송비 3500원을 할인받음
할인은 각 상품별로 적용 되었음.
*/

/* 상품 정보 모델 생성 */
NSMutableArray *productArr = [NSMutableArray array];

[productArr addObject:
    [AdBrix createCommerceProductModel:@"30290121"
                        productName:@"여름한정 떨이상품 크록스 회색 20%할인"
                              price:50000.00
                           discount:10000.00
                           quantity:1
                     currencyString:[AdBrix currencyName:AdBrixCurrencyKRW]
                           category:[AdBrixCommerceProductCategoryModel create:@"기획전"]
                      extraAttrsMap:[AdBrixCommerceProductAttrModel create:@{ @"color" : @"메탈블랙", @"size" : @"250" }]
    ]
];

[productArr addObject:
    [AdBrix createCommerceProductModel:@"30290121"
                        productName:@"여름한정 떨이상품 크록스 회색 20%할인"
                              price:50000.00
                           discount:10000.00
                           quantity:1
                     currencyString:[AdBrix currencyName:AdBrixCurrencyKRW]
                           category:[AdBrixCommerceProductCategoryModel create:@"기획전"]
                      extraAttrsMap:[AdBrixCommerceProductAttrModel create:@{ @"color" : @"크림화이트", @"size" : @"260" }]
    ]
];

[productArr addObject:
    [AdBrix createCommerceProductModel:@"30290121"
                        productName:@"여름한정 떨이상품 크록스 회색 20%할인"
                              price:50000.00
                           discount:10000.00
                           quantity:1
                     currencyString:[AdBrix currencyName:AdBrixCurrencyKRW]
                           category:[AdBrixCommerceProductCategoryModel create:@"기획전"]
                      extraAttrsMap:[AdBrixCommerceProductAttrModel create:@{ @"color" : @"크리스탈블루", @"size" : @"270" }]
    ]
];

/* 주문검토하기 */
[AdBrix commerceReviewOrderBulk:@""
                  productsInfos:productArr
                       discount:0.00
                 deliveryCharge:3500.00
];


상품 결제

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

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

//단품 결제
AdBrix.commercePurchase:(NSString *)orderId product:(AdBrixCommerceProductModel *)product discount:(double)discount deliveryCharge:(double)deliveryCharge paymentMethod:(NSString *)paymentMethod;
//복품 결제
AdBrix.commercePurchase:(NSString *)orderId productsInfos:(NSArray *)productsInfos discount:(double)discount deliveryCharge:(double)deliveryCharge paymentMethod:(NSString *)paymentMethod;
/* 색상이 각각 다른 3개의 크록스를 일괄 구매, 신용카드 결제, 배송료 3500원 */                    
/* 상품 정보 모델 생성 */
NSMutableArray *productArr = [NSMutableArray array];

[productArr addObject:
    [AdBrix createCommerceProductModel:@"30290121"
                        productName:@"여름한정 떨이상품 크록스 회색 20%할인"
                              price:50000.00
                           discount:10000.00
                           quantity:1
                     currencyString:[AdBrix currencyName:AdBrixCurrencyKRW]
                           category:[AdBrixCommerceProductCategoryModel create:@"기획전"]
                      extraAttrsMap:[AdBrixCommerceProductAttrModel create:@{ @"color" : @"메탈블랙", @"size" : @"250" }]
    ]
];

[productArr addObject:
    [AdBrix createCommerceProductModel:@"30290121"
                        productName:@"여름한정 떨이상품 크록스 회색 20%할인"
                              price:50000.00
                           discount:10000.00
                           quantity:1
                     currencyString:[AdBrix currencyName:AdBrixCurrencyKRW]
                           category:[AdBrixCommerceProductCategoryModel create:@"기획전"]
                      extraAttrsMap:[AdBrixCommerceProductAttrModel create:@{ @"color" : @"크림화이트", @"size" : @"260" }]
    ]
];

[productArr addObject:
    [AdBrix createCommerceProductModel:@"30290121"
                        productName:@"여름한정 떨이상품 크록스 회색 20%할인"
                              price:50000.00
                           discount:10000.00
                           quantity:1
                     currencyString:[AdBrix currencyName:AdBrixCurrencyKRW]
                           category:[AdBrixCommerceProductCategoryModel create:@"기획전"]
                      extraAttrsMap:[AdBrixCommerceProductAttrModel create:@{ @"color" : @"크리스탈블루", @"size" : @"270" }]
    ]
];

/* 상품 결제 */
[AdBrix commercePurchase:@"290192012"
           productsInfos:productArr
                discount:0.00
          deliveryCharge:3500.00
           paymentMethod:[AdBrix paymentMethod:AdBrixPaymentCreditCard]
];


주문 취소(환불)

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

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

//단품 취소(환불)
AdBrix.commerceRefund:(NSString *)orderId product:(AdBrixCommerceProductModel *)product penaltyCharge:(double)penaltyCharge;
//복품 취소(환불)
AdBrix.commerceRefundBulk:(NSString *)orderId productsInfos:(NSArray *)productsInfos penaltyCharge:(double)penaltyCharge;

/* 일괄 주문 중에서 크리스탈블루 1개 환불. 배송비 3500원이 청구됨. */

/* 주문 취소(환불) */
[AdBrix commerceRefund:@"290192012"
               product:
                    [AdBrix createCommerceProductModel:@"30290121"
                                           productName:@"여름한정 떨이상품 크록스 회색 20%할인"
                                                 price:50000.00
                                              discount:10000.00
                                              quantity:1
                                        currencyString:[AdBrix currencyName:AdBrixCurrencyKRW]
                                              category:[AdBrixCommerceProductCategoryModel create:@"기획전"]
                                         extraAttrsMap:[AdBrixCommerceProductAttrModel create:@{
                                                                                                @"color" : @"크리스탈블루",
                                                                                                @"size" : @"270" }]
                     ]
         penaltyCharge:3500.00
 ];


상품 검색

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

AdBrix.commerceSearch:(NSArray *)productsInfos keyword:(NSString *) keyword;
/* 나이키 검색*/

/* 검색 결과 상품 모델 생성 */
/* 검색 결과에서 수량과 상세 옵션을 확보할 수 없는 경우 0과 nil로 설정합니다. */
NSMutableArray *productArr = [NSMutableArray array];

[productArr addObject:
    [AdBrix createCommerceProductModel:@"n24jsda922"
                        productName:@"[나이키] 나이키NIKE WMNS AIR MAX THEA WHITEwomens 599409-103"
                              price:149900.00
                           discount:40000.00
                           quantity:0
                     currencyString:[AdBrix currencyName:AdBrixCurrencyKRW]
                           category:[AdBrixCommerceProductCategoryModel create:@"[나이키]운동화기획전"]
                      extraAttrsMap:nil
     ]
];

[productArr addObject:
    [AdBrix createCommerceProductModel:@"saf323dsa23d4f"
                        productName:@"[나이키] 나이키NIKE WMNS AIR MAX THEA WHITEwomens 599409-104"
                              price:165000.00
                           discount:40000.00
                           quantity:0
                     currencyString:[AdBrix currencyName:AdBrixCurrencyKRW]
                           category:[AdBrixCommerceProductCategoryModel create:@"[나이키]운동화기획전"]
                      extraAttrsMap:nil
    ]
];

[productArr addObject:
    [AdBrix createCommerceProductModel:@"hh5j34dz"
                        productName:@"[나이키] 나이키NIKE WMNS AIR MAX THEA WHITEwomens 599409-105"
                              price:105000.00
                           discount:20000.00
                           quantity:0
                     currencyString:[AdBrix currencyName:AdBrixCurrencyKRW]
                           category:[AdBrixCommerceProductCategoryModel create:@"[나이키]운동화기획전"]
                      extraAttrsMap:nil
    ]
];

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


상품 공유

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

/// Enum > AdBrixSharingChannel (Facebook, KakaoTalk, KakaoStory, SMS, Email, ...)
AdBrix.commerceShare:(NSString*)channel product:(AdBrixCommerceProductModel *)product;
/* 크록스 여름 한정 상품을 카카오톡으로 공유*/

/* 상품 공유 */
[AdBrix commerceShare:[AdBrix sharingChannel:AdBrixSharingKakaoTalk]
              product:[AdBrix createCommerceProductModel:@"30290121"
                                             productName:@"여름한정 떨이상품 크록스 회색 20%할인"
                                                   price:50000.00
                                                discount:10000.00
                                                quantity:1
                                          currencyString:[AdBrix currencyName:AdBrixCurrencyKRW]
                                                category:[AdBrixCommerceProductCategoryModel create:@"기획전"]
                                           extraAttrsMap:[AdBrixCommerceProductAttrModel create:@{
                                                                                                  @"color" : @"크리스탈블루",
                                                                                                  @"size" : @"270" }]
    ]
];




IGAWORKS
© IGAWorks. ALL Rights Reserved.