문서

Singular와 브라즈의 연동으로 모바일 어트리뷰션 데이터를 고객 참여 플랫폼에 직접 연동하여 마케팅 역량을 강화할 수 있습니다. 이러한 원활한 연결을 통해 보다 타겟팅되고 효과적인 라이프사이클 마케팅 캠페인을 만들 수 있습니다.

중요:

데이터 공유 제한이 있는 광고 네트워크는 구성된 포스트백 설정을 무시하고 타사 파트너에게 포스트백을 전송하지 못하도록 합니다. 타사와의 데이터 공유 제한이 있는 미디어 소스에 대한 자세한 내용은 여기를 참조하세요.

전제 조건

요구 사항	설명
iOS 또는 Android 앱	이 연동 기능은 iOS 및 Android 앱을 지원합니다. 플랫폼에 따라 애플리케이션에 코드 스니펫이 필요할 수 있습니다. 이러한 요구 사항에 대한 자세한 내용은 연동 프로세스의 1단계에서 확인할 수 있습니다.
Singular SDK 및 Braze SDK	필수 Braze SDK 외에도 Singular SDK를 설치해야 합니다.

연동

Braze 연동을 완료하려면 Singular SDK 연동을 업데이트하고 Singular의 글로벌 속성을 통해 Braze 디바이스 ID를 전달해야 합니다. 글로벌 프로퍼티에 관한 SDK 문서(안드로이드 SDK 문서 및 iOS SDK 문서)를 참조하세요.

1단계: 사용자 ID 매핑

안드로이드

안드로이드 앱이 있는 경우, 고유한 Braze 사용자 ID를 Singular에 전달하는 다음 코드 스니펫을 포함시켜야 합니다.

// Retrieve the Braze deviceId

val brazeDeviceID = Braze.getInstance(context).deviceId

// Set the Singular Global Property in the Singular Config

val config = SingularConfig("SDK KEY", "SDK SECRET")
   .withGlobalProperty("brazeDeviceID", brazeDeviceID, true)

// Retrieve the Braze deviceId

String brazeDeviceID = Braze.getInstance(context).getDeviceId();

// Set the Singular Global Property in the Singular Config

SingularConfig config = new SingularConfig("SDK KEY", "SDK SECRET")
   .withGlobalProperty("brazeDeviceID", brazeDeviceID, true);

iOS

중요:

2023년 2월 이전에는 Singular 어트리뷰션 연동이 iOS 어트리뷰션 데이터와 일치시키기 위해 IDFV를 기본 식별자로 사용했습니다. Objective-C를 사용하는 Braze 고객은 서비스 중단이 발생하지 않으므로 설치 시 Braze device_id를 가져와서 Singular로 전송할 필요가 없습니다.

Swift SDK v5.7.0 이상을 사용하는 경우, IDFV를 상호 식별자로 계속 사용하려면 useUUIDAsDeviceId 필드가 false 으로 설정되어 있는지 확인해야 연동이 중단되지 않습니다.

true 로 설정된 경우, 앱 설치 시 Braze device_id를 Singular로 전달하기 위해 Swift용 iOS device ID 매핑을 구현해야 Braze가 iOS 속성과 적절하게 일치할 수 있습니다.

// Retrieve the Braze deviceId

let brazeDeviceId = AppDelegate.braze?.deviceId

// Set the Singular Global Property in the Singular Config

config.setGlobalProperty("brazeDeviceId", withValue: brazeDeviceId, overrideExisting: true)

// Retrieve the Braze deviceId

NSString *brazeDeviceId = ((AppDelegate *)[UIApplication sharedApplication].delegate).braze.deviceId;

// Set the Singular Global Property in the Singular Config

[config setGlobalProperty:@"brazeDeviceId" withValue:brazeDeviceId overrideExisting:YES];

2단계: Braze 데이터 가져오기 키 가져오기

Braze에서 Partner Integrations > Technology Partners 로 이동하여 Singular를 선택합니다.

참고: 이전 탐색을 사용하는 경우, 연동에서 기술 파트너를 찾을 수 있습니다.

여기에서 REST 엔드포인트를 찾아 Braze 데이터 가져오기 키를 생성할 수 있습니다. 키가 생성된 후에는 새 키를 만들거나 기존 키를 무효화할 수 있습니다.

연동을 완료하려면 데이터 가져오기 키와 REST 엔드포인트를 Singular 계정 관리자에게 제공해야 합니다.

3단계: 브라즈 포스트백 활성화하기

Singular의 왼쪽 메뉴에서 어트리뷰션 > 파트너 구성으로 이동합니다.

"파트너 추가" 버튼을 클릭하고"Braze"를 검색합니다.
앱을 선택합니다.
이전 단계에서 받은 Braze 데이터 가져오기 키를 입력합니다.
Braze 도메인 이름을 선택합니다.
저장을 클릭합니다.

4단계: 연동 확인

브라즈가 Singular로부터 어트리뷰션 데이터를 수신하면, 브라즈의 Singular 기술 파트너 페이지의 연결 상태 표시기가 "연결되지 않음"에서 "연결됨"으로 변경됩니다. 마지막으로 성공한 요청의 타임스탬프도 포함됩니다.

어트리뷰션된 인스톨에 대한 데이터가 수신될 때까지는 이러한 변화가 발생하지 않습니다. Singular 포스트백에서 제외되어야 하는 오가닉 인스톨은 API에서 무시되며, 연결 성공 여부를 판단할 때 집계되지 않습니다.