Segment는 기업이 고객 데이터를 수집, 정리, 다양한 대상으로 라우팅할 수 있도록 지원하는고객 데이터 인프라(CDI) 플랫폼입니다. 웹사이트, 모바일 앱, 서버, 클라우드 서비스 등 여러 소스에서 데이터를 수집할 수 있는 Singular API를 제공하는 것은 mParticle과 유사합니다.
Singular는 iOS 및 Android 모바일 활동에 대한 Singular 서버 간(S2S) REST API를 통해 Segment로부터 이벤트 데이터를 수신할 수 있습니다. 이를 "클라우드 모드" 대상이라고 합니다. 아래 지침은 세그먼트에 Singular 대상을 추가하는 방법을 설명합니다.
| 대상 가이드 | 엔지니어링 팀 |
| 전제 조건 | 이 문서에서는 앱에이미 세그먼트 iOS 또는 안드로이드 애널리틱스 SDK가 연동되어있다고 가정합니다. |
이 연동을 사용하려면 세그먼트의 모바일 애널리틱스 SDK를 사용 중이어야 합니다. 이 연동은 비모바일 이벤트 데이터와 호환되지 않습니다. 서버 또는 웹 이벤트는 지원되지 않습니다.
- 기본 인스톨 어트리뷰션
- 커스텀 인앱 이벤트 추적
- 구매 추적
- 커스텀 사용자 ID
- SkAdNetwork 지원
- 메타 인스톨 리퍼러 어트리뷰션
- 딥링킹
- 제한된 데이터 공유 지원
- 구글 연동 전환 측정(ICM)
- Apple 검색 광고 어트리뷰션
Singular가 제공하는 "전체 기능"에 대한 S2S 지원이 필요한 경우, 세그먼트와 별도로 Singular S2S REST API를 구현해야 합니다. 서버 간(S2S) 연동 가이드는 여기를 참조하세요.
시작하기
- Segment 웹 앱의 '연결' 메뉴에서 '카탈로그'를 클릭합니다.
- 카탈로그에서 "Singular"을 검색하여 선택한 다음 "대상 추가" 버튼을 클릭합니다.
- 대상을 연결할 소스를 선택하고 "다음"을 클릭합니다.
- 대상의 이름을 지정하고 "대상 만들기"를 클릭합니다.
-
"개발자 도구 > SDK 연동 > SDK 키"의 Singular 대시보드에서 Singular "SDK 키"를 찾아 "연결 설정"의 "API 키" 아래에 있는 세그먼트에 추가합니다.
참고: "클라우드 모드" 연동의 경우, API 키(SDK 키) 값만 입력합니다.
"비밀"은 비워둡니다.
중요: 세그먼트의 API 키 값은 반드시 Singular SDK 키를 사용해야 합니다. Singular 보고 API 키를 사용하지 마세요. 잘못된 키를 사용하면 Singular에서 데이터를 수신하지 못합니다.
추가 설정
Apple 검색 광고 어트리뷰션 지원
참고: 기기 기반 타겟을 사용하는 경우, 데이터가 이미 자동으로 수집되므로 아래 코드를 구현할 필요가 없습니다.
어트리뷰션 데이터를 Singular로 가져오려면, 애널리틱스 SDK 버전 3.6.0 이상과 애널리틱스-ios-iads-attribution 종속성을 포함해야 합니다.
설치하려면 포드파일에 다음 줄을 추가하기만 하면 됩니다:
pod "Analytics"
pod "Analytics-iAds-Attribution"
그런 다음 헤더를 가져와 구성을 초기화합니다:
#import <Analytics-iAds-Attribution/SEGADTracker.h>
// Initialize the configuration as you would normally.
SEGAnalyticsConfiguration *configuration = [SEGAnalyticsConfiguration
configurationWithWriteKey:@"YOUR_WRITE_KEY"];
...
// Configure the client with the iAD middleware to attach iAd properties.
configuration.middlewares = @[ [SEGADTracker middleware] ];
[SEGAnalytics setupWithConfiguration:configuration];
import Analytics-iAds-Attribution
// Initialize the configuration as you would normally.
var configuration = SEGAnalyticsConfiguration(writeKey: "WriteKey")
...
// Configure the client with the iAD middleware to attach iAd properties.
configuration.middlewares = [SEGADTracker.middleware()]
SEGAnalytics.setup(with: configuration)
iAd 정보를 사용할 수 있는 경우, 어트리뷰션 정보는 이러한 방식으로 세그먼트 컨텍스트로 변환됩니다:
[analytics track:@"Application Installed",
properties: nil,
options: @{
@"context" : @{
@"campaign" : @{
@"provider" : @"Apple",
@"click_date" : attributionInfo[@"iad-click-date"],
@"conversion_date" : attributionInfo[@"iad-conversion-date"],
@"source" : @"iAd",
@"name" : attributionInfo[@"iad-campaign-name"],
@"content" : attributionInfo[@"iad-keyword"],
@"ad_creative" : attributionInfo[@"iad-org-name"],
@"ad_group" : attributionInfo[@"iad-adgroup-name"],
@"id" : attributionInfo[@"iad-campaign-id"],
@"ad_group_id" : attributionInfo[@"iad-adgroup-id"]
}
}
}];
Singular는 iAd 정보를 제공하기 위해 애플리케이션 설치 수명 주기 이벤트를 명시적으로 매핑했습니다.
설치 어트리뷰션
초기화 구성 파라미터(iOS, Android)를 사용하여 수명 주기 이벤트(애플리케이션 열기, 애플리케이션 설치, 애플리케이션 업데이트)의 자동 추적을 활성화하여 Singular에서 설치 및 세션을 추적할 수 있습니다. 위의 이벤트를 포함하기만 하면 연동에 의해 Singular "세션"이 자동으로 전송됩니다.
사용자 지정 이벤트 추적
세그먼트 사양에 익숙하지 않다면 트랙 메서드가 어떤 기능을 하는지 살펴보세요.
세그먼트 추적 기능을 사용하면 이벤트를 번역하여 Singular로 전송할 수 있습니다:
[[SEGAnalytics sharedAnalytics] track:@"simple event"];
Analytics.with(this).track("event_name");
세그먼트는 모든 이벤트 속성을 Singular 이벤트의 콜백 파라미터로 포함합니다.
이벤트는 리포팅 및 사용자 수준 내보내기에서 사용할 수 있습니다.
참고:
- 타사 파트너 및 분석 솔루션과의 호환성을 보장하기 위해 이벤트 이름과 속성을 영어로 전달할 것을 적극 권장합니다.
- 이벤트 이름은 32개의 ASCII 문자로 제한됩니다. ASCII가 아닌 문자로 된 문자열은 UTF-8로 변환한 후 32바이트 미만이어야 합니다.
- 속성 및 값은 500자로 제한됩니다.
구매 추적
구매 속성이 포함된 이벤트가 전송될 때(0 값 포함) 구매 추적을 받습니다. 선택적으로 통화를 전달할 수 있습니다( ISO 4217 통화 코드 코드 ). 기본 통화는 USD입니다.
[[SEGAnalytics sharedAnalytics] track:@"segment revenue event" properties:@{@"currency": @"USD", @"revenue":@20}];
Analytics.with(this).track("purchase", new Properties().putRevenue(2.5).putValue("currency","USD"));
참고: 통화를 세 글자로 된 ISO 4217 통화 코드(예: "USD", "EUR", "INR")로 전달합니다.
사용자 지정 사용자 ID
세그먼트 식별 방법을 사용하여 세그먼트 사용자 ID를 Singular에 보낼 수 있습니다.
참고: Singular의 크로스 디바이스 솔루션을 사용하는 경우 모든 플랫폼에서 동일한 사용자 ID를 수집해야 합니다.
- 사용자 ID는 모든 식별자가 될 수 있으며 PII(개인 식별 정보)를 노출해서는 안 됩니다. 예를 들어 사용자의 이메일 주소, 사용자 이름 또는 전화번호를 사용해서는 안 됩니다. Singular는 퍼스트 파티 데이터에만 고유한 해시값을 사용할 것을 권장합니다.
- 또한 Singular에 전달되는 사용자 ID 값은 모든 플랫폼(웹/모바일/PC/콘솔/오프라인)에서 캡처한 내부 사용자 ID와 동일해야 합니다.
- Singular는 사용자 수준 내보내기, ETL 및 내부 BI 포스트백(구성된 경우)에 사용자 ID를 포함합니다. 사용자 ID는 퍼스트 파티 데이터이며, Singular는 이를 다른 당사자와 공유하지 않습니다.
- 사용자 ID 값은 설정된 경우 세그먼트 재설정 방법을 사용하여 재설정하지 않거나 앱을 제거할 때까지 유지됩니다. 앱을 닫거나 다시 시작해도 사용자 ID는 설정이 해제되지 않습니다.
iOS, Android에 대해 구성하려면 여기 단계를 따르세요.
[[SEGAnalytics sharedAnalytics] identify:@"segment custom user id"];
Analytics.with(context).identify("myUserId");
사용자 지정 사용자 아이디를 재설정하려면 재설정 메서드를 호출하세요.
[[SEGAnalytics sharedAnalytics] reset];