싱귤러는 iOS 및 Android 모바일 활동에 대한 싱귤러 서버 간(S2S) REST API를 통해 세그먼트에서 이벤트 데이터를 수신할 수 있습니다. 이를 "클라우드 모드" 대상이라고 합니다. 아래 지침은 세그먼트에 싱귤러 대상을 추가하는 방법을 설명합니다.
대상 가이드 | 엔지니어링 팀 |
전제조건 | 이 문서에서는 앱에 세그먼트 iOS 또는 안드로이드 애널리틱스 SDK가이미 연동되어있다고 가정합니다. |
이 통합을 사용하려면 세그먼트의 모바일 애널리틱스 SDK를 사용 중이어야 합니다. 이 통합은 비모바일 이벤트 데이터와 호환되지 않습니다. 서버 또는 웹 이벤트는 지원되지 않습니다.
- 기본 인스톨 어트리뷰션
- 애플 검색 광고 어트리뷰션
- 맞춤 인앱 이벤트 추적
- 구매 추적
- 맞춤 사용자 ID
- SkAdNetwork 지원
- 메타 인스톨 리퍼러 어트리뷰션
- 딥링킹
- 제한된 데이터 공유 지원
싱귤러가 제공하는 '전체 기능'을 위해 S2S 지원이 필요한 경우, 세그먼트와 별도로 싱귤러 S2S REST API를 구현해야 합니다. 서버 간(S2S) 통합 가이드는 여기를 참조하세요.
시작하기
- Segment 웹 앱의 "연결" 메뉴에서 "카탈로그"를 클릭합니다.
- 카탈로그에서 "싱글" 을 검색하여 선택한 다음 "대상 추가" 버튼을 클릭합니다.
- 대상을 연결할 소스를 선택하고 "다음"을 클릭합니다.
- 대상의 이름을 지정하고 "대상 만들기"를 클릭합니다.
- 싱글 대시보드의 " 개발자 도구 > SDK 연동 > SDK 키"에서 싱글 "SDK 키"를 가져와 "연결 설정"의 "API 키" 아래에 있는 세그먼트에 추가합니다.
참고: "클라우드 모드" 연동의 경우, API 키(SDK 키) 값만 입력합니다.
"비밀"은 비워둡니다.
중요: 세그먼트의 API 키 값은 반드시 단일 SDK 키를 사용해야 합니다. 단수 보고 API 키를 사용하지 마세요. 잘못된 키를 사용하면 단수에서 데이터를 수신하지 못합니다.
추가 설정
Apple 검색 광고 어트리뷰션 지원
참고: 기기 기반 타겟을 사용하는 경우, 데이터가 이미 자동으로 수집되므로 아래 코드를 구현할 필요가 없습니다.
어트리뷰션 데이터를 싱귤러로 가져오려면, 애널리틱스 SDK의 analytics-ios-iads-attribution종속 요소와 버전 3.6.0 이상을 포함해야 합니다.
설치하려면 포드파일에 다음 줄을 추가하기만 하면 됩니다:
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"]
}
}
}];
싱귤러는 iAd 정보를 제공하기 위해 애플리케이션 설치수명 주기 이벤트를 명시적으로 매핑했습니다.
설치 어트리뷰션
초기화 설정 파라미터(iOS, 안드로이드)를 사용하여 라이프사이클 이벤트(애플리케이션 열기, 애플리케이션 설치, 애플리케이션 업데이트)의 자동 추적을 활성화하여 싱귤러의 인스톨 및 세션을 추적할 수 있습니다. 위의 이벤트를 포함하기만 하면 통합에 의해 싱글 '세션'이 자동으로 전송됩니다.
사용자 지정 이벤트 추적
세그먼트 사양에 익숙하지 않은 경우, 트랙 메서드가 어떤 기능을 하는지 살펴보세요.
세그먼트 추적 기능을 사용하면 이벤트를 번역하여 단수로 전송할 수 있습니다:
[[SEGAnalytics sharedAnalytics] track:@"simple event"];
Analytics.with(this).track("event_name");
Segment는 모든 이벤트 속성을 Singular 이벤트의 콜백 파라미터로 포함합니다.
이벤트는 보고 및 사용자 수준 내보내기에서 사용할 수 있습니다.
수익 추적
수익 속성이 포함된 이벤트가 전송될 때(0 값 포함) Singular는 수익 추적을 수신합니다. 선택적으로 통화를 전달할 수 있습니다( 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에 보낼 수 있습니다.
참고: 싱귤러의 크로스 디바이스 솔루션을 사용하는 경우, 모든 플랫폼에서 동일한 사용자 ID를 수집해야 합니다.
- 사용자 ID는 모든 식별자가 될 수 있으며 PII(개인 식별 정보)를 노출해서는 안 됩니다. 예를 들어, 사용자의 이메일 주소, 사용자 이름 또는 전화번호를 사용해서는 안 됩니다. 싱귤러는 퍼스트 파티 데이터에만 고유한 해시값을 사용할 것을 권장합니다.
- 또한 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");
사용자 지정 사용자 ID를 재설정하려면 재설정 메서드를 호출합니다.
[[SEGAnalytics sharedAnalytics] reset];