Google 애널리틱스 4(GA4) 어트리뷰션 포스트백 연동 설정

개요

Singular는 제3자 분석 파트너로서 Google Analytics 4(GA4) 와의 연동을 지원합니다.
이 가이드는 Singular를 사용하여 모바일 앱에 대한 GA4 측정을 구성하고 필요한 매개 변수가 올바르게 전달되도록 하는 방법을 설명합니다.

Singular은 캠페인 어트리뷰션 데이터를 GA4로 자동 전달하지만, 특정 인증 정보와 식별자는 Singular UI 및 SDK에서 구성해야 합니다.

Singular에서 GA4로 전송되는 매개변수

Singular는 다음 매개변수를 Google Analytics 4로 자동 전달합니다:

• 캠페인 이름

• 캠페인 ID

• 소스

• 매체

• 타임스탬프

Singular 파트너 구성 UI에서 필요한 설정

GA4 측정을 활성화하려면 Singular 대시보드에서 직접 다음 값을 구성해야 합니다.

1. API 비밀 키 (api_secret)

GA4 측정 프로토콜 API 시크릿.

찾는 방법:

GA4 Admin → Data Streams → Select your stream → Measurement Protocol → Create API Secret 

2. Firebase 앱 ID (firebase_app_id)

모바일 앱과 연결된 Firebase 앱 ID입니다.

찾는 방법:

Firebase Console → Project Settings → General → Your Apps → App ID 

Singular SDK 필수 설정

3. 앱 인스턴스 ID (app_instance_id)

app_instance_id 는 Firebase 앱의 특정 설치에 대한 고유 식별자입니다.

요구 사항:

• Firebase SDK에서 값을 가져옵니다.

• 이 가이드 에 명시된 대로 GLOBAL_PROPERTIES를 사용하여 Singular SDK에 전달

• 정확한 속성명 사용: app_instance_id

SDK 구현 예시 (Android – Kotlin)

글로벌 속성을 사용하여 애플리케이션 라이프사이클 전반에 걸쳐 앱 수준 및 사용자별 식별자를 추적하세요.

// Initialize the Singular SDK with app-level global properties val config = SingularConfig("SDK_KEY", "SDK_SECRET") .withGlobalProperty("app_instance_id", firebaseAppInstanceId, true) Singular.init(applicationContext, config)

// Set a third-party identifier on user login
fun onUserLogin(thirdPartyUserId: String) {
val success = Singular.setGlobalProperty(
"third_party_identifier",
thirdPartyUserId,
true
)
if (success) {
Log.d("Singular", "Third-party identifier set successfully")
}
}

// Clear the third-party identifier on user logout
fun onUserLogout() {
Singular.unsetGlobalProperty("third_party_identifier")
Log.d("Singular", "Third-party identifier cleared")
}

검증 및 문제 해결

설정 완료 후 연동을 검증하세요:

1. api_secret 와 firebase_app_id 가 Singular UI에 올바르게 저장되었는지 확인하세요.

2. SDK 초기화 전에 app_instance_id 이 설정되었는지 확인하십시오

3. GA4 디버그 뷰 또는 실시간 보고서를 사용하여 이벤트 수신 여부를 확인하세요

4. Singular SDK 초기화 오류가 있는지 앱 로그를 검토하세요