Download

[download 페이지](Rake manual#wiki-download)

설치

• 다운받은 압축 파일을 푼다.
• Mixpanel 폴더를 프로젝트에 drag & drop 한다. 그림과 같이 "Copy items into destination Group's folder"를 체크해서 복사한다.

• Targets > Build Phases > Link binary with libraries 에서 아래 framework를 추가한다.
  • Foundation.framework
  • UIKit.framework
  • SystemConfiguration.framework
  • CoreTelephony.framework
  • AdSupport.framework

ARC

현재 이 라이브러리는 ARC를 사용하지 않는다. ARC를 사용하는 프로젝트와 함께 사용하기 위해 다음의 작업이 필요하다.

• 메뉴의 Project > Target > Build Phases
• 각 add한 파일을 클릭하여 다음의 플래그를 삽입 : -fno-objc-arc.

코드 넣기

최초 초기화 하기

• application launch가 끝난 이후 초기화를 수행한다.

    #define MIXPANEL_TOKEN @"YOUR TOKEN" // 서비스에 할당 된 토큰을 사용한다.
    #define MIXPANLE_USE_DEVSERVER true     // 테스트용 개발서버를 사용하기 위해선 true로 세팅한다. 배포시에는 반드시 false로 세팅한다.
  
    - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
    {
        self.window = [ [ [UIWindow alloc] initWithFrame:[ [UIScreen mainScreen] bounds]] autorelease];
        self.mixpanel = [Mixpanel sharedInstanceWithToken:MIXPANEL_TOKEN andUseDevServer:MIXPANLE_USE_DEVSERVER];   // initialize
     
     
        self.viewController = [ [ [ViewController alloc] initWithNibName:@"ViewController" bundle:nil] autorelease];
        self.window.rootViewController = self.viewController;
        [self.window makeKeyAndVisible];
        
        
        [ [UIApplication sharedApplication] registerForRemoteNotificationTypes:(UIRemoteNotificationTypeBadge | UIRemoteNotificationTypeSound | UIRemoteNotificationTypeAlert)];
        
        return YES;
    }
  

• define 구문에서 token과 MIXPANLE_USE_DEVSERVER 를 셋팅해야 한다.

• 개발 서버를 사용하기 위해선 MIXPANLE_USE_DEVSERVERf를 true로 세팅한다. 실 환경에서는 반드시 false로 변경해야 한다.

페이지 전환이나 button 클릭 시에 로그를 쌓기

• 로그를 쌓는 것은 track()함수를 호출하면 된다.

• 아래와 같이 track()에 인자로 데이터를 넘기면 된다. 인자는 NSDictionary 타입이다.

• track() 함수의 첫번째 인자는 사용하지 않는다. SKP 내에서 로그 포맷이 정의되어 사용될 때는 NSDictionary에 미리 정의된 key, value로 데이터가 전달되어야 한다.

    - (IBAction)trackEvent:(id)sender
    {
        Mixpanel *mixpanel = [Mixpanel sharedInstance];
        [mixpanel track:[NSDictionary dictionaryWithObjectsAndKeys:
                                                   @"junghyun", @"userId",
                                                   @"a01jdksa904812df", @"purchaseId",
                                                   @"30000", @"price",
                                                   nil]];
    }
  

쌓인 로그를 서버에 보내기

• 로그를 쌓는 것과 로그를 서버에 보내는 것은 다르다. track()은 로그를 앱 내부(plist file)에 쌓고, flush()는 쌓은 로그를 서버에 보낸다.

• 쌓은 로그는 압축해서 전송된다. 따라서 여러 개의 로그를 한번에 서버에 보내는 것이 바람직하다. 이때 flush()를 호출하면 된다.

• 디폴트로는 1분에 한번 쌓인 로그를 전송한다. (setFlushInterval() 함수를 통해 설정 가능하다.)

• 보통은 activity의 onDestroy()에서 flush()를 호출한다.

    - (IBAction)flushPressed:(id)sender {
        statusText.text = [NSString stringWithFormat:@"flush button pressed"];
        Mixpanel *mixpanel = [Mixpanel sharedInstance];
        [mixpanel flush];
    }
  

반복되는 필드를 한번만 등록하기

NSString* memberId = @"CURRENT_MEMBER_ID";
NSString* sessionId = @"NEW_SESSION_ID";
[self.mixpanel registerSuperProperties:@{@"memeberId": memberId}];    // memeberId를 super properties로 설정
[self.mixpanel registerSuperProperties:@{@"sessionId": sessionId}];  // sessionID를 super properties로 설정

Sentinel과 함께 개발하기

• Sentinel 적용은 json을 직접 입력하는 대신 Pojo 클래스를 통해 입력하는 것이다.

• Sentine 홈페이지에서 iOS용 코드를 다운받아 프로젝트에 링크하여 사용한다.

    - (IBAction)clickMakeLogWithSentinel:(id)sender {
        RakeSampleSentinelShuttle *shuttle = [[RakeSampleSentinelShuttle alloc] init];
        
        [shuttle page_id:self.getMyPageId];
        [shuttle action_id:@"onclick"];
        [shuttle action_extra_value:@"3"];
        
        [self.rake track:[shuttle toNSDictionary]];
        NSLog(@"%@", [shuttle toJSONString]);
    }
  

• 다른 코드는 동일하며 shuttle 객체에 먼저 데이터를 set 한 후 rake track 함수 호출시 NSDictionary 로 바꾸어 호출한다.

예제

• Rake 사용 예제 및 Sentinel 사용 예제
  • 각각의 사용 예제를 볼 수 있다.

API

• Mixpanel::track:(NSDictionary *) properties

  • properties : 데이터를 json 형태로 입력한다. SKP의 경우 로그 포맷에 정의된 key와 value를 넣어주면 된다.

• Mixpanel::registerSuperProperties:(NSDictionary *) properties

  • properties : 데이터를 json 형태로 입력한다. super properties 로 입력된 데이터는 모든 로그에 유지된다.

• Mixpanel::registerSuperPropertiesOnce:(NSDictionary *) properties

  • properties : 데이터를 json 형태로 입력한다. super properties 로 입력된 데이터는 모든 로그에 유지된다. 같은 키로 설정된 값이 이미 존재한다면, 새로 입력한 키는 무시되고 이전 값이 유지된다.

• Mixpanel::unregisterSuperProperties:(NSString *) propertyName

  • propertyName : propertyName에 해당하는 super property를 삭제 한다.

• Mixpanel::flush()

  • 로그를 서버에 전송 한다.

• Mixpanel::setFlushInterval:(NSUInteger)interval

  • milli-seconds 단위로 flush 주기를 설정한다.