Singular SDK와 함께 Facebook SDK 사용하기
구성 요구 사항, 데이터 정확도 고려 사항 및 연동 모범 사례를 다루는 동일한 앱에서 Facebook SDK와 Singular SDK를 모두 구현하기 위한 종합 가이드입니다.
연동 개요
모바일 측정 파트너로서의 Singular
앱에 Singular SDK가 연동된 경우, 페이스북 어트리뷰션 추적이나 페이스북 플랫폼에서 이벤트 조회를 위해 페이스북 SDK가 필요하지 않습니다. 페이스북의 인증된 모바일 측정 파트너(MMP)인 Singular SDK는 모든 어트리뷰션 및 이벤트 추적 요구사항을 처리합니다.
Singular MMP 기능:
- 어트리뷰션 추적: 페이스북 캠페인의 설치 및 전환을 자동으로 추적합니다.
- 이벤트 포워딩: 캠페인 최적화를 위해 인앱 이벤트를 Facebook으로 전송합니다.
- 데이터 리포팅: 페이스북을 포함한 모든 채널에서 연동 어트리뷰션 데이터를 제공합니다.
- 인증된 연동: 전체 API 액세스 권한을 갖춘 Facebook 인증 측정 솔루션
Facebook SDK 사용 시기
유효한 사용 사례
Singular SDK는 어트리뷰션 및 분석을 처리하지만, 일부 조직은 측정 이외의 추가적인 Facebook 전용 기능을 위해 Facebook SDK를 연동하기로 선택합니다.
소셜 기능
페이스북 로그인
사용자가 Facebook 자격 증명을 사용하여 인증할 수 있도록 지원하여 온보딩을 간소화하고 등록 마찰을 줄입니다.
Facebook 공유
사용자가 앱 콘텐츠를 Facebook에 직접 공유할 수 있도록 하여 유기적 도달 범위와 바이럴 성장 잠재력을 높일 수 있습니다.
고급 광고 기능
Facebook 모바일 앱 설치 광고
다음과 같은 Facebook 모바일 앱 설치 광고의고급 기능을 활용하세요:
- 다이나믹 제품 광고: 맞춤화된 제품 추천으로 사용자를 재타겟팅하세요.
- 오디언스 네트워크: Facebook 플랫폼을 넘어 파트너 앱으로 캠페인을 확장하세요.
- 맞춤 오디언스: Facebook 사용자 데이터를 기반으로 오디언스 생성
- 고급 타겟팅: Facebook의 세부 타겟팅 옵션 활용
페이스북 플랫폼 연동
그래프 API 액세스
페이스북 소셜 그래프에 데이터를 읽고 쓰기 위해 페이스북 그래프 API와 연동하세요.
메신저 연동
고객 지원 또는 참여 캠페인을 위해 Facebook 메신저를 통한 커뮤니케이션을 활성화하세요.
연동 결정: 앱에 어트리뷰션 및 분석 이외의 특정 Facebook 플랫폼 기능이 필요한 경우에만 Facebook SDK를 연동하세요. 측정 목적으로만 사용할 경우, Singular SDK는 완벽한 기능을 제공합니다.
데이터 정확도 고려 사항
동일한 앱에서 Facebook SDK와 Singular SDK를 모두 사용하는 경우, 데이터 정확성을 유지하고 불일치를 방지하기 위해 적절한 구성이 필수적입니다.
일반적인 데이터 문제
이벤트 중복
적절한 구성이 없으면 이벤트가 Facebook에 두 번(Facebook SDK에서 한 번, Singular SDK에서 한 번) 전송되어 이벤트 수가 부풀려지고 부정확한 보고가 발생할 수 있습니다.
중대한 문제: 중복 이벤트 추적은 다음과 같이 이어집니다:
- 부풀려진 이벤트 수: Facebook이 실제 이벤트를 두 배로 보고하여 캠페인 성과 지표를 왜곡합니다.
- 잘못된 세션 수: Facebook 플랫폼에서 세션 데이터가 인위적으로 높게 나타남
- 캠페인 최적화 문제: Facebook 알고리즘이 캠페인 최적화를 위한 잘못된 신호를 수신함
- 예산 할당 문제: 부정확한 데이터가 캠페인 전반의 예산 배분에 영향을 미침
솔루션 요구 사항
구성 전략
두 SDK를 모두 사용할 때 데이터 정확도를 유지하려면, Facebook SDK에서 자동 이벤트 로깅을 비활성화하고 Singular SDK가 모든 측정 및 이벤트 전달을 Facebook으로 처리하도록 허용하세요.
연동 아키텍처:
| 구성 요소 | 책임 | 구성 |
|---|---|---|
| Singular SDK |
|
표준 구성 특별한 변경이 필요하지 않습니다. |
| Facebook SDK |
|
자동 로깅 비활성화 중복 이벤트 전송 방지 |
구현 단계
다음 단계에 따라 데이터 정확성을 유지하고 이벤트 중복을 방지하면서 Facebook SDK를 Singular SDK와 함께 사용하세요.
1단계: Facebook SDK 이벤트 로깅 비활성화하기
플랫폼별 구성
기본적으로 Facebook SDK는 Facebook 플랫폼에 자동으로 이벤트를 전송합니다. 중복 이벤트 추적을 방지하려면 이 자동 로깅을 비활성화해야 합니다.
구성 방법
iOS용 앱 이벤트 시작하기의'자동으로 기록되는 이벤트 비활성화하기'에 있는 Facebook의 공식 지침을 따르세요.
Info.plist 구성
Info.plist 파일에 다음 키를 추가하여 자동 이벤트 로깅을 비활성화합니다:
<key>FacebookAutoLogAppEventsEnabled</key>
<false/>
확인 단계
-
Info.plist를 확인합니다: 값이
false로 설정된 키가 올바르게 추가되었는지 확인합니다. - 빌드 테스트: 앱을 빌드하고 실행하여 구성이 적용되었는지 확인합니다.
- 이벤트 모니터링: Facebook 애널리틱스 대시보드를 사용하여 Facebook SDK가 이벤트를 전송하지 않는지 확인합니다.
중요: 자동 로깅을 비활성화하면 Facebook SDK가 Facebook에 이벤트를 전송하지 않습니다. 모든 이벤트 포워딩은 Facebook 플랫폼으로 전달되는 모든 이벤트를 Singular SDK가 처리합니다.
설정 방법
안드로이드용 앱 이벤트 시작하기의'자동 로깅 이벤트 비활성화'에 있는 Facebook의 공식 지침을 따르세요.
안드로이드 매니페스트.xml 구성
<application> 태그 내에 AndroidManifest.xml파일에 다음 메타데이터를 추가합니다:
<application>
...
<meta-data
android:name="com.facebook.sdk.AutoLogAppEventsEnabled"
android:value="false" />
...
</application>
대안: 프로그래밍 방식 구성
또는 애플리케이션 클래스에서 프로그래밍 방식으로 자동 로깅을 비활성화할 수 있습니다:
import com.facebook.FacebookSdk;
import com.facebook.appevents.AppEventsLogger;
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
// Disable automatic event logging
FacebookSdk.setAutoLogAppEventsEnabled(false);
}
}
import com.facebook.FacebookSdk
import com.facebook.appevents.AppEventsLogger
class MyApplication : Application() {
override fun onCreate() {
super.onCreate()
// Disable automatic event logging
FacebookSdk.setAutoLogAppEventsEnabled(false)
}
}
확인 단계
-
안드로이드 매니페스트를 확인합니다:
false으로 설정된 값으로 메타데이터가 올바르게 추가되었는지 확인합니다. - 애플리케이션 빌드: 앱을 정리하고 다시 빌드하여 구성이 적용되었는지 확인합니다.
- 이벤트 모니터링: Facebook 애널리틱스 대시보드를 사용하여 Facebook SDK가 이벤트를 전송하지 않는지 확인합니다.
중요: 둘 다 선택하지 말고 AndroidManifest 구성 또는 프로그래매틱 구성 중 하나를 선택하세요. 일관성을 위해 매니페스트 구성을 권장합니다.
2단계: 페이스북 어트리뷰션 구성
Singular 파트너 구성
Facebook SDK 이벤트 로깅을 비활성화한 후, 표준 설정 절차에 따라 Singular 플랫폼에서 Facebook 어트리뷰션을 구성합니다.
설정 지침: Facebook 광고 어트리뷰션 연동가이드의 1~4단계에 따라 Facebook 어트리뷰션 구성을 완료합니다.
구성 체크리스트:
- Facebook 앱 ID를 추가합니다: Singular 플랫폼에서 어트리뷰션 → 파트너 구성으로 이동하여 Facebook 앱 ID를 추가합니다.
- 어트리뷰션 설정을 구성합니다: 어트리뷰션 윈도우 및 측정 기본 설정
- 이벤트 매핑: 이벤트 매핑: Singular와 페이스북 간의 이벤트 매핑을 구성합니다.
- 포스트백을 활성화합니다: 캠페인 최적화를 위해 Singular에서 페이스북으로 이벤트 포스트백을 설정합니다.
3단계: 구성 검증
테스트 절차
구성을 완료한 후 Singular 및 Facebook 테스트 도구를 사용하여 제대로 구현되었는지 검증합니다.
Singular SDK 검증
- 테스트 콘솔: Singular 테스트 콘솔을사용하여 이벤트가 올바르게 추적되는지 확인합니다.
- 이벤트 로그: Singular 내보내기 로그를 확인하여 기록된 이벤트를 확인합니다.
- 어트리뷰션 검증: 어트리뷰션 확인: Singular 리포트에서 페이스북 인스톨이 올바르게 어트리뷰션되었는지 확인합니다.
페이스북 플랫폼 검증
- 이벤트 관리자: 페이스북 이벤트 매니저를 열고 Singular에서 표시되는 이벤트를 확인합니다.
- 이벤트 수 비교: Singular와 페이스북 간의 이벤트 수를 비교하여 중복이 없는지 확인합니다.
- 세션 추적: 세션 수가 인플레이션 없이 예상 값과 일치하는지 확인합니다.
데이터 정확성 검사
| 확인 | 예상 결과 |
|---|---|
| 이벤트 카운트 | 이벤트는 중복되지 않고 페이스북에 한 번만 표시됩니다(Singular에서). |
| 세션 수 | 페이스북은 인위적인 부풀림 없이 정상적인 세션 수를 표시합니다. |
| 어트리뷰션 데이터 | Singular 리포트는 정확한 캠페인 데이터로 Facebook 인스톨을 보여줍니다. |
| 페이스북 기능 | Facebook 로그인, 공유 및 기타 기능이 앱에서 올바르게 작동합니다. |
검증 타임라인: 초기 설정 후 24-48시간이 지나면 데이터가 두 플랫폼에 올바르게 전달됩니다. 일부 데이터는 초기에는 지연되어 표시될 수 있습니다.
문제 해결
Facebook SDK와 Singular SDK를 함께 사용할 때 발생하는 일반적인 문제와 해결 방법.
일반적인 문제
증상
- Facebook의 이벤트 수가 예상치를 두 배로 초과함
- 동일한 이벤트가 동일한 타임스탬프로 여러 번 표시됨
- 부풀려진 지표로 인해 Facebook 캠페인 최적화가 영향을 받음
원인
Facebook SDK 자동 이벤트 로깅이 비활성화되지 않아서 Facebook SDK와 Singular SDK가 모두 동일한 이벤트를 Facebook 플랫폼에 전송합니다.
해결 방법
-
iOS Info.plist에서
FacebookAutoLogAppEventsEnabled이false으로 설정되어 있는지 확인합니다. -
Android AndroidManifest.xml에서
com.facebook.sdk.AutoLogAppEventsEnabled이false으로 설정되어 있는지 확인합니다. - 앱을 정리하고 다시 빌드하여 구성이 적용되었는지 확인
- 24시간 동안 Facebook 이벤트 관리자를 모니터링하여 문제가 해결되었는지 확인합니다.
증상
- 페이스북 인스톨이 Singular 리포트에 나타나지 않음
- 페이스북 캠페인이 아닌 오가닉으로 어트리뷰션된 인스톨
- Singular 애널리틱스에서 캠페인 데이터가 누락됨
원인
페이스북이 Singular 플랫폼에서 어트리뷰션 파트너로 구성되지 않았거나 페이스북 앱 ID가 누락되었거나 부정확합니다.
해결 방법
- Singular → 어트리뷰션 → 파트너 구성으로 이동하여 페이스북을 검색합니다.
- Facebook 앱 ID가 올바르게 입력되었는지 확인합니다.
- 페이스북 연동이 활성화되어 있고 활성화되어 있는지 확인
- 어트리뷰션 윈도우 설정이 캠페인 요구사항과 일치하는지 확인
- 전체 설정은 Facebook 광고 어트리뷰션 연동가이드를 참고하세요.
증상
- Facebook 로그인 실패 또는 오류 반환
- 페이스북 공유 버튼이 작동하지 않음
- 앱에서 Facebook SDK 기능을 사용할 수 없음
원인
자동 이벤트 로깅이 비활성화되어 있음에도 불구하고 Facebook SDK가 제대로 초기화되거나 구성되지 않았습니다.
해결 방법
- 앱에서 Facebook SDK가 올바르게 초기화되었는지 확인합니다(자동 로깅을 비활성화해도 SDK 초기화에는 영향을 미치지 않음).
- 앱 설정에서 Facebook 앱 ID 및 구성을 확인합니다.
- 특정 기능 요구 사항에 대한 Facebook SDK 설명서를 검토합니다.
- Facebook 기능을 독립적으로 테스트하여 연동 문제를 분리합니다.
참고: 자동 이벤트 로깅을 비활성화하면 이벤트 추적에만 영향을 미치며 로그인 및 공유와 같은 Facebook 플랫폼 기능에는 영향을 미치지 않습니다. 이러한 기능은 계속 정상적으로 작동합니다.
추가 리소스
Facebook과 Singular SDK 연동에 대한 전체 문서를 참조하세요.
문서 링크
Singular 리소스
- Singular SDK/S2S 시작하기- 전체 SDK 연동 가이드
- 페이스북 광고 어트리뷰션 연동- 페이스북 파트너 구성
- Facebook 데이터 커넥터- 비용 및 캠페인 데이터 집계
- Singular SDK 연동 테스트- 검증 및 문제 해결 절차
Facebook 개발자 리소스
- iOS용 Facebook 앱 이벤트- iOS SDK 구성 및 이벤트 로깅
- 안드로이드용 Facebook 앱 이벤트- 안드로이드 SDK 구성 및 이벤트 로깅
- Facebook 모바일 앱 설치 광고- 고급 광고 기능 및 기능
지원
도움 받기
Facebook과 Singular SDK 연동에 대한 추가 지원이 필요하면 Singular 지원팀에 문의하거나 고객 성공 매니저와 상담하세요.