Facebook SDK와 Singular SDK/S2S를 동일 앱에서 사용하기

Facebook SDK와 Singular SDK를 함께 사용하기

동일한 앱에서 Facebook SDK와 Singular SDK를 모두 구현하기 위한 종합 가이드로, 설정 요구사항, 데이터 정확성 고려사항, 연동 모범 사례를 다룹니다.


연동 개요

모바일 측정 파트너로서의 Singular

앱에 Singular SDK가 연동되어 있다면, Facebook 어트리뷰션을 추적하거나 Facebook 플랫폼에서 이벤트를 확인하기 위해 Facebook SDK가 필요하지 않습니다. Facebook의 공인 모바일 측정 파트너(MMP)인 Singular SDK가 모든 어트리뷰션 및 이벤트 추적 요구사항을 처리합니다.

Singular MMP 기능:

  • 어트리뷰션 추적: Facebook 캠페인의 설치 및 전환을 자동으로 추적합니다
  • 이벤트 포워딩: 캠페인 최적화를 위해 인앱 이벤트를 Facebook으로 전송합니다
  • 데이터 리포팅: Facebook을 포함한 전체 채널에 걸친 연동 어트리뷰션 데이터를 제공합니다
  • 공인 연동: 전체 API 액세스를 갖춘 Facebook 승인 측정 솔루션입니다

Facebook SDK를 사용해야 하는 경우

유효한 사용 사례

Singular SDK가 어트리뷰션과 분석을 처리하지만, 일부 조직에서는 측정 이외의 Facebook 특정 기능을 위해 Facebook SDK를 연동하기도 합니다.

Facebook SDK 기능

소셜 기능

Facebook 로그인

사용자가 Facebook 자격증명으로 인증할 수 있게 하여 온보딩을 간소화하고 가입 마찰을 줄입니다.

Facebook 공유

사용자가 앱 콘텐츠를 Facebook에 직접 공유할 수 있게 하여 자연 도달 범위와 바이럴 성장 잠재력을 높입니다.


고급 광고 기능

Facebook 모바일 앱 설치 광고

Facebook 모바일 앱 설치 광고 의 고급 기능에 액세스합니다:

  • 다이나믹 제품 광고: 개인화된 제품 추천으로 사용자를 리타겟팅합니다
  • Audience Network: 캠페인을 Facebook 플랫폼 외부의 파트너 앱으로 확장합니다
  • Custom Audiences: Facebook 유저 데이터를 기반으로 오디언스를 생성합니다
  • 고급 타겟팅: Facebook의 상세한 타겟팅 옵션을 활용합니다

Facebook 플랫폼 연동

Graph API 액세스

Facebook 소셜 그래프에서 데이터를 읽고 쓰기 위해 Facebook Graph API와 연동합니다.

Messenger 연동

고객 지원 또는 인게이지먼트 캠페인을 위해 Facebook Messenger를 통한 커뮤니케이션을 지원합니다.

연동 결정: 앱에 어트리뷰션 및 분석 이외의 특정 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으로 포워딩합니다
  • 연동 분석을 제공합니다

기본 설정

별도의 변경 불필요

Facebook SDK
  • Facebook 플랫폼 기능을 제공합니다
  • 로그인, 공유 등을 지원합니다
  • 이벤트를 전송하지 않습니다
  • 어트리뷰션을 추적하지 않습니다

자동 로깅 비활성화

이벤트 중복 전송 방지


구현 단계

데이터 정확성을 유지하고 이벤트 중복을 방지하면서 Singular SDK와 함께 Facebook SDK를 사용하려면 다음 단계를 따르세요.

1단계: Facebook SDK 이벤트 로깅 비활성화

플랫폼별 설정

기본적으로 Facebook SDK는 이벤트를 Facebook 플랫폼에 자동으로 전송합니다. 이벤트 중복 추적을 방지하려면 이 자동 로깅을 비활성화해야 합니다.

iOS - 자동 이벤트 로깅 비활성화

설정 방법

iOS용 앱 이벤트 시작하기 의 "자동 로깅 이벤트 비활성화"에 있는 Facebook 공식 지침을 따르세요.


Info.plist 설정

자동 이벤트 로깅을 비활성화하려면 Info.plist 파일에 다음 키를 추가하세요:

<key>FacebookAutoLogAppEventsEnabled</key>
<false/>

확인 단계

  1. Info.plist 확인: 키가 false 값으로 올바르게 추가되었는지 확인합니다
  2. 테스트 빌드: 앱을 빌드하고 실행하여 설정이 적용되었는지 확인합니다
  3. 이벤트 모니터링: Facebook Analytics 대시보드를 사용하여 Facebook SDK가 이벤트를 전송하지 않는지 확인합니다

중요: 자동 로깅을 비활성화하면 Facebook SDK가 Facebook으로 어떠한 이벤트도 전송하지 않습니다. Singular SDK가 Facebook 플랫폼으로의 모든 이벤트 포워딩을 처리합니다.

Android - 자동 이벤트 로깅 비활성화

설정 방법

Android용 앱 이벤트 시작하기 의 "자동 로깅 이벤트 비활성화"에 있는 Facebook 공식 지침을 따르세요.


AndroidManifest.xml 설정

<application> 태그 내의 AndroidManifest.xml 파일에 다음 메타데이터를 추가하세요:

<application>
    ...
    <meta-data
        android:name="com.facebook.sdk.AutoLogAppEventsEnabled"
        android:value="false" />
    ...
</application>

대안: 프로그래밍 방식 설정

또는 Application 클래스에서 프로그래밍 방식으로 자동 로깅을 비활성화할 수 있습니다:

JAVA KOTLIN
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);
    }
}

확인 단계

  1. AndroidManifest 확인: 메타데이터가 false 값으로 올바르게 추가되었는지 확인합니다
  2. 앱 빌드: 앱을 클린 빌드하여 설정이 적용되었는지 확인합니다
  3. 이벤트 모니터링: Facebook Analytics 대시보드를 사용하여 Facebook SDK가 이벤트를 전송하지 않는지 확인합니다

중요: AndroidManifest 설정 또는 프로그래밍 방식 설정 중 하나만 선택하고, 두 가지를 동시에 사용하지 마세요. 일관성을 위해 Manifest 설정을 권장합니다.


2단계: Facebook 어트리뷰션 설정

Singular 파트너 설정

Facebook SDK 이벤트 로깅을 비활성화한 후, 표준 설정 절차에 따라 Singular 플랫폼에서 Facebook 어트리뷰션을 설정하세요.

설정 안내: Facebook 광고 어트리뷰션 연동 가이드의 1-4단계를 따라 Facebook 어트리뷰션 설정을 완료하세요.

설정 체크리스트:

  1. Facebook 앱 ID 추가: Singular 플랫폼에서 어트리뷰션 → 파트너 설정으로 이동하여 Facebook 앱 ID를 추가합니다
  2. 어트리뷰션 설정 구성: 어트리뷰션 기간 및 측정 기본 설정을 지정합니다
  3. 이벤트 매핑: Singular와 Facebook 간의 이벤트 매핑을 설정합니다
  4. 포스트백 활성화: 캠페인 최적화를 위해 Singular에서 Facebook으로의 이벤트 포스트백을 설정합니다

3단계: 설정 검증

테스트 절차

설정을 완료한 후, Singular와 Facebook 테스트 도구를 사용하여 올바른 구현을 검증하세요.

검증 체크리스트

Singular SDK 검증

  1. 테스트 콘솔: Singular 테스트 콘솔 을 사용하여 이벤트가 올바르게 추적되는지 확인합니다
  2. 이벤트 로그: Singular 내보내기 로그를 확인하여 이벤트가 기록되었는지 검증합니다
  3. 어트리뷰션 검증: Singular 보고서에서 Facebook 설치가 올바르게 어트리뷰션되었는지 확인합니다

Facebook 플랫폼 검증

  1. 이벤트 관리자: Facebook 이벤트 관리자를 열고 Singular에서 이벤트가 표시되는지 확인합니다
  2. 이벤트 수 비교: 중복이 없는지 확인하기 위해 Singular와 Facebook 간의 이벤트 수를 비교합니다
  3. 세션 추적: 세션 수가 과다 집계 없이 예상 값과 일치하는지 확인합니다

데이터 정확성 확인

확인 항목 예상 결과
이벤트 수 이벤트가 Facebook에 한 번만 표시됩니다(Singular에서), 중복 없음
세션 수 Facebook에 인위적인 과다 집계 없이 정상적인 세션 수가 표시됩니다
어트리뷰션 데이터 Singular 보고서에 올바른 캠페인 데이터와 함께 Facebook 설치가 표시됩니다
Facebook 기능 Facebook 로그인, 공유 및 기타 기능이 앱에서 올바르게 작동합니다

검증 일정: 초기 설정 후 24-48시간을 기다려야 데이터가 두 플랫폼을 통해 올바르게 흐릅니다. 일부 데이터는 초기에 지연될 수 있습니다.


문제 해결

Facebook SDK와 Singular SDK를 함께 사용할 때의 일반적인 문제와 해결책입니다.

일반적인 문제

Facebook에서 이벤트 중복

증상

  • Facebook의 이벤트 수가 예상 값의 두 배입니다
  • 동일한 이벤트가 동일한 타임스탬프로 여러 번 나타납니다
  • 과다 집계된 지표로 인해 Facebook 캠페인 최적화가 영향을 받습니다

원인

Facebook SDK 자동 이벤트 로깅이 비활성화되지 않아 Facebook SDK와 Singular SDK 모두 동일한 이벤트를 Facebook 플랫폼에 전송합니다.


해결책

  1. iOS Info.plist에서 FacebookAutoLogAppEventsEnabled false 로 설정되었는지 확인합니다
  2. Android AndroidManifest.xml에서 com.facebook.sdk.AutoLogAppEventsEnabled false 로 설정되었는지 확인합니다
  3. 앱을 클린 빌드하여 설정이 적용되었는지 확인합니다
  4. 24시간 동안 Facebook 이벤트 관리자를 모니터링하여 문제가 해결되었는지 확인합니다
Singular에서 Facebook 어트리뷰션 누락

증상

  • Singular 보고서에 Facebook 설치가 나타나지 않습니다
  • 설치가 Facebook 캠페인 대신 자연량으로 어트리뷰션됩니다
  • Singular 분석에서 캠페인 데이터가 누락됩니다

원인

Facebook이 Singular 플랫폼에서 어트리뷰션 파트너로 설정되지 않았거나 Facebook 앱 ID가 없거나 잘못되었습니다.


해결책

  1. Singular → 어트리뷰션 → 파트너 설정으로 이동하여 Facebook을 검색합니다
  2. Facebook 앱 ID가 올바르게 입력되었는지 확인합니다
  3. Facebook 연동이 활성화되어 있는지 확인합니다
  4. 어트리뷰션 기간 설정이 캠페인 요구사항과 일치하는지 확인합니다
  5. 완전한 설정을 위해 Facebook 광고 어트리뷰션 연동 가이드를 검토합니다
Facebook 기능이 작동하지 않음

증상

  • Facebook 로그인이 실패하거나 오류를 반환합니다
  • Facebook 공유 버튼이 작동하지 않습니다
  • 앱에서 Facebook SDK 기능을 사용할 수 없습니다

원인

자동 이벤트 로깅이 비활성화되어 있음에도 불구하고 Facebook SDK가 올바르게 초기화되거나 설정되지 않았습니다.


해결책

  1. 앱에서 Facebook SDK가 올바르게 초기화되었는지 확인합니다(자동 로깅 비활성화는 SDK 초기화에 영향을 주지 않습니다)
  2. 앱 설정에서 Facebook 앱 ID 및 설정을 확인합니다
  3. 특정 기능 요구사항에 대한 Facebook SDK 문서를 검토합니다
  4. 연동 문제를 격리하기 위해 Facebook 기능을 독립적으로 테스트합니다

참고: 자동 이벤트 로깅을 비활성화하면 이벤트 추적에만 영향을 미치며, 로그인 및 공유와 같은 Facebook 플랫폼 기능에는 영향을 주지 않습니다. 이러한 기능은 정상적으로 계속 작동해야 합니다.


추가 리소스

Facebook 및 Singular SDK 연동에 대한 전체 문서입니다.

문서 링크

Singular 리소스


Facebook 개발자 리소스


지원

도움 받기

Facebook 및 Singular SDK 연동에 대한 추가 지원이 필요하면 Singular 지원팀에 문의하거나 고객 성공 매니저에게 문의하세요.