Singular
Singular는 기여도, 비용 집계, 마케팅 분석, 크리에이티브 보고 및 워크플로 자동화를 제공하는 통합 마케팅 분석 플랫폼입니다.
이 통합은 Singular에서 유지 관리합니다.
통합 소개
Braze와 Singular의 통합을 통해 유료 설치 기여도 데이터를 가져와 생애주기 캠페인 내에서 지능적으로 세그먼트할 수 있습니다.
전제 조건
| 요구 사항 | 설명 |
|---|---|
| Singular 계정 | 이 파트너십을 활용하려면 Singular 계정이 필요합니다. |
| iOS 또는 Android 앱 | 이 통합은 iOS 및 Android 앱을 지원합니다. 플랫폼에 따라 애플리케이션에 코드 스니펫이 필요할 수 있습니다. 이러한 요구 사항에 대한 자세한 내용은 통합 프로세스의 1단계에서 확인할 수 있습니다. |
| Singular SDK | 필수 Braze SDK 외에도 Singular SDK를 설치해야 합니다. |
통합
1단계: 사용자 ID 매핑
Android
Android 앱이 있는 경우, 다음 코드 스니펫을 포함하여 고유한 Braze 사용자 ID를 Singular에 전달해야 합니다.
String appboyDeviceId = Braze.getInstance(context).getDeviceId();
SingularConfig config = new SingularConfig("SDK KEY", "SDK SECRET")
.withGlobalProperty(“brazeDeviceID”, appboyDeviceId, true);
iOS

2023년 2월 이전에는 Singular 기여도 통합에서 공급업체 식별자(IDFV)를 iOS 기여도 데이터를 매칭하기 위한 기본 식별자로 사용했습니다. Objective-C를 사용하는 Braze 고객은 설치 시 Braze device_id를 가져와 Singular에 전송할 필요가 없습니다. 서비스 중단이 발생하지 않기 때문입니다.
Swift SDK v5.7.0 이상을 사용하는 경우, IDFV를 상호 식별자로 계속 사용하려면 useUUIDAsDeviceId 필드가 false로 설정되어 있는지 확인하여 통합이 중단되지 않도록 해야 합니다.
true로 설정된 경우, Braze가 iOS 기여도를 적절히 매칭할 수 있도록 앱 설치 시 Braze device_id를 Singular에 전달하기 위해 Swift용 iOS 기기 ID 매핑을 구현해야 합니다.
SingularConfig* config = [[SingularConfig
alloc] initWithApiKey:SDKKEY andSecret:SDKSECRET];
[config setGlobalProperty:@"brazeDeviceId" withValue:brazeDeviceId
overrideExisting:YES];
[Singular start:config];
config.setGlobalProperty("brazeDeviceId", withValue: brazeDeviceId, overrideExisting: true)
2단계: Braze 데이터 가져오기 키 받기
Braze에서 파트너 통합 > 기술 파트너로 이동한 후 Singular를 선택합니다.
여기에서 REST 엔드포인트를 찾고 Braze 데이터 가져오기 키를 생성할 수 있습니다. 키가 생성되면 새 키를 만들거나 기존 키를 무효화할 수 있습니다.
통합을 완료하려면 데이터 가져오기 키와 REST 엔드포인트를 Singular 계정 매니저에게 제공해야 합니다.
3단계: 통합 확인
Braze의 Singular 기술 파트너 페이지에서 연결 표시기는 2단계에서 데이터 가져오기 API 키를 생성하기 전까지 연결되지 않음으로 표시됩니다. 키를 생성하면 표시기가 연결됨으로 변경되고 타임스탬프가 표시됩니다. 이 타임스탬프는 Singular가 마지막으로 포스트백을 보낸 시점이 아니라, Braze에서 통합이 처음 설정된 시점(데이터 가져오기 키가 생성된 시점)을 나타냅니다.
설치 기여도 데이터가 Singular에서 전달되고 있는지 확인하려면, Braze Segment 필터에 비오가닉 설치 데이터가 표시되는지 확인합니다. Braze는 Singular 포스트백에서 오가닉 설치를 무시하며, 이를 기여 설치 데이터로 저장하지 않습니다.
Facebook 및 X(구 Twitter) 기여도 데이터
Facebook 및 X(구 Twitter) Campaigns의 기여도 데이터는 파트너를 통해 제공되지 않습니다. 이러한 미디어 소스는 파트너가 기여도 데이터를 제3자와 공유하는 것을 허용하지 않으므로, 파트너가 해당 데이터를 Braze로 전송할 수 없습니다.
Braze에서 Singular 클릭 추적 URL 사용하기 (선택 사항)
Braze Campaign에서 클릭 추적 링크를 사용하면 어떤 Campaign이 앱 설치 및 재참여를 유도하고 있는지 쉽게 확인할 수 있습니다. 이를 통해 마케팅 활동의 효과를 보다 정확하게 측정하고, 최대 ROI를 위해 어디에 더 많은 리소스를 투자할지 데이터 중심의 의사 결정을 내릴 수 있습니다.
Singular 클릭 추적 링크를 시작하려면 Singular 설명서를 참조하세요. Singular 클릭 추적 링크를 Braze Campaign에 직접 삽입할 수 있습니다. 그러면 Singular가 확률적 기여도 분석 방법론을 사용하여 링크를 클릭한 사용자에게 기여도를 부여합니다. Braze Campaign의 기여도 분석 정확도를 높이기 위해 Singular 추적 링크에 기기 식별자를 추가하는 것을 권장합니다. 이렇게 하면 링크를 클릭한 사용자에게 결정론적으로 기여도를 부여할 수 있습니다.
Android의 경우, Braze에서 Google 광고 ID 수집(GAID)에 옵트인할 수 있습니다. GAID는 Singular SDK 통합을 통해서도 기본적으로 수집됩니다. 다음 Liquid 로직을 사용하여 Singular 클릭 추적 링크에 GAID를 포함할 수 있습니다:
{% if most_recently_used_device.${platform} == 'android' %}
aifa={{most_recently_used_device.${google_ad_id}}}
{% endif %}
iOS의 경우, 결정론적 기여도 분석을 개선하기 위해 Braze 기기 식별자를 추가합니다. Liquid에서 most_recently_used_device.${id}는 Braze 기기 ID이며, Swift SDK의 useUUIDAsDeviceId 설정에 따라 IDFV 또는 UUID일 수 있습니다. Singular 클릭 추적 URL은 일반적으로 이 값에 idfv 쿼리 매개변수를 사용합니다:
{% if most_recently_used_device.${platform} == 'ios' %}
idfv={{most_recently_used_device.${id}}}
{% endif %}

이 권장 사항은 전적으로 선택 사항입니다
현재 클릭 추적 링크에 Braze 기기 ID 또는 GAID와 같은 기기 식별자를 사용하지 않거나, 향후에도 사용할 계획이 없는 경우에도 Singular는 확률적 모델링을 통해 이러한 클릭에 기여도를 부여할 수 있습니다.