로딩중입니다
애드브릭스 연동 : iOS
3/6/2015 5:38:30 PM
애드브릭스(adbrix) 연동 : iOS

애드브릭스는 광고성과 추적과 이용자 분석을 동시에 지원하는 서비스입니다.
본 아티클에서는 애드브릭스 사용을 위해 필요한 SDK연동방법을 안내합니다.
애드브릭스 서비스에 대한 자세한 내용은 아래의 아티클에서 확인할 수 있습니다.

[애드브릭스 서비스 안내]


애드브릭스 연동 순서

애드브릭스 Add-On(고급연동) 전에 공통 연동이 완료되어야 합니다.

1. 공통연동   [이용가이드]

공통연동을 완료하면 New Install, DAU, 재방문율(Retention rate) 등 App Install 및 Open과 관련된 기본지표 확인이 가능합니다.

1) SDK 다운로드   >   2) 설치가이드   >     3) 연동가이드


2. 고급연동

1) 커스텀 액티비티 연동   [이용 가이드]

커스텀 액티비티를 연동하면 New Install 이후의 앱 내 이용자의 특정 행동(회원가입, 로그인, 구매 등)을 분석하거나
포스트백에 사용할 수 있습니다. 적용예시와 활용방법 가이드를 추가로 참고하실 수 있습니다.


2) 코호트 분석  [이용 가이드]

코호트 분석을 통해 특정 이용자 그룹별로 필터링해 리포트를 분석 할 수 있습니다.
ex) 지역(서울) / LEVEL 5 이상 / 구매 10만원 이상 이용자의 DAU추이 등

3) 딥링크 설정 [연동 가이드]

애드브릭스 트래킹링크의 딥링크 기능을 이용하기 전 딥링크 연동 가이드를 반드시 확인해주시기 바랍니다.


4) 페이스북 트래킹 설정 [설정 가이드 - AOS, iOS]

애드브릭스를 이용하여 페이스북 모바일 앱 광고 트래킹을 하기 위해서는 OS별 페이스북 트래킹 설정 가이드를 
반드시 확인해주시기 바랍니다.

* 1) 커스텀 액티비티 분석 및 2) 코호트 분석을 위한 연동 가이드는 아래 가이드에서 확인 가능합니다.




2-1) 고급연동 : 애드브릭스 커스텀 액티비티 

앱 내 이용자의 특정 행동(회원가입, 로그인, 구매 등)을 분석하거나 포스트백에 사용할 수 있습니다.

(1) New User Session
 - API 명칭 : firstTimeExperience API 
 - 애드브릭스 리포트 내 확인 : Advanced analytics - New User session
 - 목적 : firstTimeExperience API는 앱을 최초로 실행한 이용자의 이탈 시점을 파악하기 위해 사용합니다. 
 - 특징 : 최초로 앱을 실행한 일자 당일의 데이터만을 제공합니다. 
             (예: 1월 1일 유입된 유저가 1월 2일 레벨 10 달성 시 1월 2일의 레벨 10 달성은 분석하지 않음)
#import <AdBrix/AdBrix.h>

- (void)firstTimeExperienceUserActionTrackingSample {
    //[AdBrix firstTimeExperience:@"loginComplete"];
[AdBrix firstTimeExperience:@"CharacterCreate"];
[AdBrix firstTimeExperience:@"TutorialComplete"];
[AdBrix firstTimeExperience:@"Level5Complete"];
[AdBrix firstTimeExperience:@"Stage5C"];
}
+ 위 샘플은 게임으로 가정하여 작성되었습니다.
+ userActivity 파라미터에는 영어와 숫자로 된 공백없는 문자열을 사용하시는 것을 권장합니다.
※ 주의 : New User Session 그래프는 신규유저의 유입 당일 자정까지만의 분석을 제공합니다.
              따라서 유저가 유입 당일 도달이 가능한 액션까지만을 연동해 주시기 바랍니다.


(2) In App Purchasing
- API 명칭 : Purchase API 
- 애드브릭스 리포트 내 확인 : RevenueAdvanced analytics - First - time purchaseROAS Reporting
- 목적 : 모든 유저의 인앱 구매 행동을 일자별로 분석하고, 재설치/재실행 유저의 매출 분석이 가능합니다. 
- 특징 : 애드브릭스에 노출되는 매출은 'price x quantity' 로 계산됩니다.
#import <AdBrix/AdBrix.h>

- (void)inAppPurchasingUserActionTrackingSample {

    // AdBrix purchase:@"orderId" product:AdBrixCommerceProductModel paymentMethod:AdBrixPaymentMethod"
    [AdBrix purchase:@"orderId_1"
         product: [AdBrix createCommerceProductModel:@"productId_1"
         productName:@"상품이름"
         price:10000.00
         discount:0
         quantity:1
         currencyString:[AdBrix currencyName:AdBrixCurrencyKRW]
         category:[AdBrixCommerceProductCategoryModel create :@"카타고리명1"]
         extraAttrsMap:nil]
         paymentMethod:[AdBrix paymentMethod:AdBrixPaymentMobilePayment]];
}
+ orderID : 주문 아이디
+ productID : 상품 아이디
productName : 상품명 (Buy api를 사용했던 앱을 업데이트 하는 경우, productName에 기존 사용하셨던 buy api의 purchaseItemName을 입력합니다.)
price : 상품단가
+ discount : 할인가. 없을 경우 0 으로 표시합니다.
quantity : 구매 수량
+ currency : 구매 통화 단위 (AdbrixCurrency 사용)
+ category : 최대 5단계의 상품 카테고리, 각 단계는 마침표(.)으로 구분
+paymentMethod : 구매방식 (AdbrixPayment 사용)
    Purchase API를 통해 매출지표가 분석되어 리포트됩니다. 실제 구매 발생했을 때 사용하는 것을 권장합니다.

Buy API 제공 종료 안내

2017. 8. 31 부로 Buy API 제공이 종료되었습니다. Purchase api 를 이용해 주시길 부탁드립니다.



(3) In App Activities 
- API 명칭 : retention API 
- 애드브릭스 리포트 내 확인 : Advanced Analytics - In-app activities 
- 목적 : 모든 유저가 앱내에서 일으키는 행동 (예: 로그인, 레벨달성, 상점 방문, 회원가입 등)의 일자별 분석이 가능합니다. 
- 특징 : 일자별 액티비티 실행 수와 실행 유저수를 제공하며, 하위 파라미터를 사용할 수 있습니다.
#import <AdBrix/AdBrix.h>

- (void)inAppActivityUserActionTrackingSample {
    // [AdBrix retention:@"inAppActivity"];
    [AdBrix retention:@"openStore"];
    [AdBrix retention:@"stageClear"];
    [AdBrix retention:@"purchaseItemWithVirtualCurrency"];
    [AdBrix retention:@"inviteFriends"];
}
+ inAppActivity 파라미터에는 영어와 숫자로 된 공백없는 문자열을 사용하시는 것을 권장합니다.
+ Retention API는 하위 파라미터 분석을 지원합니다.


기타1) Sub Activity 설정

- Sub activity 설정 가능한 API : retention API는 하위 액티비티 설정 가능 
- 애드브릭스 리포트 내 확인 : Advanced Analytics - In-app activities
- 목적 : 유저의 특정 행동을 하위로 세분화하여 분석하실 수 있습니다.
  (예: 로그인 - 카카오톡 / 네이버 / 페이스북)

[AdBrix retention:@"inviteFriends" param:@"kakaotalk"];


기타2) User Info
- API 명칭 : setAge API, setGender API 
- 애드브릭스 리포트 내 확인 : Demographic & Device - 연령 / 성별 
- 목적 : 유저정보 분석(User Info)는 유저의 나이와 성별 정보를 분석할 수 있습니다.
- 특징 : 연령 및 성별 외 디바이스 모델, 통신사, 안드로이드 OS, 언어, 국가 등의 정보는 IGAW 공통 연동을 통해서 기본 제공 됩니다.

유저 나이
setAge API를 호출하여 유저 나이를 입력합니다. 유저 나이는 1~99까지의 정수를 입력합니다.

#import <IgaworksCore/IgaworksCore.h>

- (void)userAgeTracking {
    [IgaworksCore setAge:30];
}


유저 성별
setGender API를 호출하여 유저 성별을 입력합니다. 유저 성별은 IgaworksCore.h 에 정의된 Gender enum 값을 사용합니다.

#import <IgaworksCore/IgaworksCore.h>

- (void)userGenderTracking {
    [IgaworksCore setGender:IgaworksCoreGenderMale];
}




2-2) 고급연동 : 애드브릭스 코호트 API

코호트 분석에서는 유저 그룹을 총 3개까지 커스텀 생성하여 그룹 별로 분석할 수 있습니다.

코호트 분석 지표에 대한 설명과 사용법은 아래 링크에서 확인할 수 있습니다.

커스텀 코호트 필터 설정 
- API 명칭 : setCustomCohort API
- 애드브릭스 리포트 내 확인 : 애드브릭스 모든 리포트 상단 (일부 리포트 제외) 
- 목적 :특정한 유저 그룹으로 필터링 해 애드브릭스 리포트를 별도 확인 가능합니다.  (예: 성별, 나이, 구매금액 등)
- 특징 : 커스텀 코호트는 3가지 그룹을 지정하실 수 있습니다. 

#import <AdBrix/AdBrix.h>

- (void)customCohortFilterSample {
    [AdBrix setCustomCohort:AdBrixCustomCohort_1 filterName:@"paying_user"];
    [AdBrix setCustomCohort:AdBrixCustomCohort_2 filterName:@"social_sharing"];
    [AdBrix setCustomCohort:AdBrixCustomCohort_3 filterName:@"playing_2hour_per_day_user"];
}

+ 코호트 필터는 AdBrix.h header에 미리 정의된 AdBrixCustomCohort_1~3 까지 총 3개가 제공됩니다.
+ 코호트 필터의 이름은 AdBrix.h header에 미리 정의된 enum 값을 사용합니다.
+ 애드브릭스 리포트 내 코호트 미적용 메뉴는 다음과 같습니다. 
   a. Tracking Link - Reporting, ROAS Reporting
   b. Analytics - Retention, Active Users
   c. Advanced Analytics - New User Session
   d. Revenue - Revenue by Install date