Singular iOS SDK | |
---|---|
다운로드 | Singular iOS SDK version 10.3.0 |
호환성 | iOS 8+ |
샘플 앱 |
Singular SDK를 전체적으로 연동한 샘플 앱을 확인해주세요. 베스트 프랙티스에 기반하여 여러 연동 부분이 어떻게 결합될 수 있는지 확인하세요. |
연동 가이드 |
이벤트 트래킹
캠페인 성과를 분석하고 KPI를 측정하기 위해 Singular를 통해 앱 내의 이벤트 데이터를 수집할 수 있습니다.
예를 들어 게임 고객사는 유저 로그인, 회원 가입, 튜토리얼 완료, 레벨 업 등과 같은 데이터를 수집하기를 원할 수 있습니다.
이 경우 event나 eventWithArgs 메서드를 사용해서 Singular로 인앱이벤트를 보낼 수 있습니다.
주의:
- 서드 파티 파트너 및 외부 분석 솔루션과의 호환성을 위해 이벤트 이름과 속성에는 영어를 사용하세요.
- 이벤트 이름은 32자 이하의 ASCII 캐릭터로 제한됩니다. ASCII 캐릭터가 아닌 문자열은 UTF-8로 변환되었을 때 32 byte 미만이어야 합니다.
- 속성과 값은 500자 이하의 ASCII 캐릭터로 제한됩니다.
event 메서드 | |
---|---|
정의 | 트래킹을 위해 이벤트를 추가 정보 없이 Singular로 전송 |
메서드 | +(void)event:(NSString *)name |
사용예 |
Objective-C:
Swift (bridging header 필요):
|
eventWithArgs 메서드 |
|
정의 | 트래킹을 위해 이벤트를 추가 정보를 포함하여 Singular로 전송 |
메서드 | +(void)eventWithArgs:(NSString *)name, ... |
사용예 |
Objective-C:
Swift (requires bridging header):
|
event 메서드 (NSDictionary 형식의 아규먼트 포함) | |
정의 | NSDictionary 오브젝트 추가 정보를 포함하여 이벤트를 Singular로 전송 |
메서드 | + (void) event:(NSString *)name withArgs:(NSDictionary *)args; |
사용예 |
Objective-C:
Swift:
|
매출 트래킹
캠페인 성과 및 캠페인 ROI를 분석하기 위해 Singular를 통해 앱 내의 매출 데이터를 수집할 수 있습니다. 수집하는 경우 Singular의 리포트, 로그 익스포트, 포스트백을 통해 해당 데이터를 확인할 수 있습니다.
Singular에 매출 이벤트를 보내는 경우 iapComplete SDK 메서드 사용을 권장하며, 이 경우 Apple의 인앱구매인 IAP 매출 이벤트를 Singular에 보냅니다. 여기에는 다음 두 항목이 포함됩니다.
- 전체 트랜잭션 세부 사항: Singular가 보다 자세한 리포트를 제공하는데 필요한 여러 정보가 포함됩니다.
- 트랜잭션 영수증: Singular에서 백엔드에서 구매를 검증하는데 활용하고 프러드 방지에 사용할 수 있습니다.
주의: 매출을 여러 다른 통화 단위로 보내더라도 데이터 확인 시에는 Singular 계정에 설정한 고객사의 통화 단위로 자동으로 변환되어 표시됩니다.
iapComplete 메서드 |
|
---|---|
정의 | 트랜잭션 영수증을 포함하여 Singular에 매출 이벤트 전송 |
메서드 | (void)iapComplete:(id)transaction (void)iapComplete:(id)transaction withName:(NSString *)name; |
사용예 |
Objective-C:
Swift:
|
다른 방식으로 매출 이벤트 리포팅
앞서 설명한 iapComplete로 매출 이벤트를 전송하기를 권장하지만, 다른 방식으로 매출 이벤트를 전송하고자 하는 경우 revenue나 customRevenue를 사용할 수도 있습니다.
다음에서 설명하는 메서드를 사용하면 트랜잭션 금액과 통화 단위를 수동으로 특정할 수 있고 추가적인 세부 사항도 선택적으로 전송할 수 있습니다. customRevenue를 사용하면 커스텀 매출 이벤트 이름도 지정할 수 있습니다.
단, 두 메서드 모두 트랜잭션 영수증을 전송하지 않으므로 Singular에서 트랜잭션을 검증할 수 없습니다.
revenue 메서드 |
|
---|---|
정의 | 금액과 통화 단위 및 추가적인 세부 사항을 포함하여 Singular에 매출 이벤트 전송 |
메서드 | (void)revenue:(NSString *)currency amount:(double)amount; (void)revenue:(NSString *)currency amount:(double)amount productSKU:(NSString *)productSKU productName:(NSString *)productName productCategory:(NSString *)productCategory productQuantity:(int)productQuantity productPrice:(double)productPrice; 주의: 통화(currency)는 세 글자로 이뤄진 ISO 4217 통화 코드를 사용합니다. 예: “USD”, “EUR”, “KRW” |
사용예 |
Objective-C:
Swift:
|
customRevenue 메서드 |
|
정의 | 금액과 통화 단위 및 추가적인 세부 사항을 포함하여 Singular에 커스텀 이름으로 매출 이벤트 전송 |
메서드 | (void)customRevenue:(NSString *)eventName currency:(NSString *)currency amount:(double)amount; (void)customRevenue:(NSString *)eventName currency:(NSString *)currency amount:(double)amount productSKU:(NSString *)productSKU productName:(NSString *)productName productCategory:(NSString *)productCategory productQuantity:(int)productQuantity productPrice:(double)productPrice; 주의: 통화(currency)는 세 글자로 이뤄진 ISO 4217 통화 코드를 사용합니다. 예: “USD”, “EUR”, “KRW” |
사용예 |
Objective-C:
Swift:
|