TikTok 앱 이벤트 SDK를 통합하는 방법

마지막 업데이트: 2026 년 3 월

사전 준비 사항

Android 및 iOS용 틱톡 앱 이벤트 SDK를 사용하려면 틱톡 광고 계정과 틱톡 앱 ID가 필요합니다. 기존 앱이 있다면 해당 앱을 사용할 수 있고, 아니면 새 앱을 생성할 수 있습니다.


참고: 이제 TikTok 앱 이벤트 SDK가 동일한 계정 내에서 MMP를 통한 하이브리드 설정을 지원합니다. 새 TikTok 광고 계정을 만들어 SDK를 통합하거나 기존 MMP 계정을 사용하여 SDK를 통합할 수 있습니다.

TikTok 앱 이벤트 SDK를 통합하는 방법

1단계: 앱을 생성하거나 기존 앱을 사용하여 TikTok 앱 ID와 앱 시크릿을 생성합니다

옵션 1: SDK를 MMP에 연결한 앱에 추가(하이브리드 설정)

  1. TikTok Ads Manager에 로그인합니다.

  2. 도구 탭을 클릭한 다음 이벤트 관리자를 클릭합니다.

  3. 데이터 소스를 선택한 후 SDK 연결을 추가하려는 앱을 선택합니다.

    App Events SDK - screenshot 1

  4. 설정 탭으로 이동한 후 TikTok 앱 이벤트 SDK에서 파트너 선택을 클릭합니다.

    App Events SDK - screenshot 2

  5. 프로세스에 따라 계정에 SDK를 추가합니다. TikTok 앱 ID와 앱 시크릿을 생성합니다.

    App Events SDK - screenshot 3

옵션 2: 새로 생성된 앱에 SDK 추가

  1. TikTok Ads Manager에 로그인합니다.

  2. 도구 탭을 클릭한 다음 이벤트 관리자를 클릭합니다.

  3. 왼쪽 상단 내비게이션에서 데이터 소스 연결을 선택하고 앱을 선택합니다.

    App Events SDK - screenshot 4

  4. 앱에 연결할 TikTok SDK를 선택합니다.

    App Events SDK - screenshot 5

  5. 앱 상세 정보를 입력하고 앱을 생성합니다. 프로세스에 따라 TikTok 앱 ID와 앱 시크릿을 생성합니다.

    App Events SDK - screenshot 6

2단계: TikTok 개발자 센터 가이드에 나와 있는 지침에 따라 TikTok 앱 이벤트 SDK를 통합합니다

  1. SDK를 초기화하려면 1단계에서 미리 생성한 앱 ID, TikTok 앱 ID, 앱 시크릿이 있어야 합니다.

    1. 앱 ID 및 TikTok 앱 ID 데모:

      TikTok App ID - screenshot

    2. 앱 시크릿 데모:

      App secret - screenshot

  2. GitHub에서 SDK를 다운로드합니다. 현재 TikTok은 네이티브 iOS SDK, 네이티브 Android SDK, Unity SDK를 지원합니다.

3단계: SDK를 통한 이벤트 포스트백

  1. 로그를 남길 수 있는 표준 앱 이벤트 및 자동 로그된 이벤트의 전체 목록은 표준 이벤트를 참고하세요.

  2. 자동 로그된 이벤트는 아래에 나와 있습니다. 참고: 자동 로그된 이벤트를 끌 수 있습니다. 자세한 내용은 앱 이벤트 SDK 개발자 문서를 참고하세요.

    1. LaunchApp: 앱이 실행되고 있을 때 발생합니다.

    2. InstallApp: 앱이 처음으로 실행될 때 발생합니다.

    3. 2DRetention: 앱을 처음 열고 다음 날에 앱을 다시 열 때 발생합니다.

    4. Purchase: 소비재/비소비재/구독에 대한 결제가 성공적으로 완료되었을 때 발생합니다.

      1. 활성화하기 전에 자동 로그 구매 포스트백이 비즈니스 요구 사항과 일치하는지 확인하세요. iOS 자동 로그 구매 이벤트와 Android 자동 로그 구매 이벤트에 대해 자세히 살펴보세요.

자동 로그 구매 이벤트에 대한 특별 안내: SDK는 StoreKit(iOS) 또는 Google Play Billing(Android)을 통해 이루어진 거래를 자동으로 캡처할 수 있습니다. 추가 속성과 파라미터를 전달해야 하거나 Apple이나 Google의 기본 결제 게이트웨이를 사용하지 않는 경우에는 수동 구매 포스트백을 사용하는 것이 좋습니다.

4단계: [iOS] SKAN 이벤트를 측정합니다

SKAdNetwork(SKAN) 환경에서는 하나의 SDK만 전환값을 보고하도록 하는 것이 좋습니다. MMP 또는 다른 SDK를 사용하여 SKAdNetwork에 전환값을 업데이트하는 경우 구성에 disableSKAdNetworkSupport()를 추가하여 업데이트 충돌을 방지해야 합니다.


TikTok SDK SKAN 측정을 활성화해야 할지 판단하세요.


MMP가 있는 경우:

  • MMP SDK가 전환값(CV)을 업데이트하고 MMP의 SKAN 스키마를 사용하려는 경우: TikTok SDK에서 SKAdNetwork 지원을 끄고 스키마를 TikTok Events Manager에 업로드하지 마세요. (MMP가 CV 업데이트 및 스키마의 단일 정보 출처 역할을 계속 수행합니다.)

MMP가 없는 경우:

앱에서 SKAN 전환값을 업데이트하는 SDK가 하나만 있어야 합니다.

  • MMP가 아닌 다른 SDK가 CV를 업데이트하는 경우: TikTok SDK에서 SKAdNetwork 지원을 끄되, 스키마를 TikTok Events Manager에 업로드하세요. (TikTok이 사용자의 스키마를 사용하지만 중복된 CV 업데이트는 수행하지 않습니다.)

  • TikTok SDK가 CV 업데이트를 담당하는 경우: TikTok SDK에서 SKAdNetwork 지원을 활성화하고 스키마를 TikTok Events Manager에 업로드하세요. (TikTok이 SKAN CV 업데이트의 기본 처리 주체가 됩니다.)

자세한 내용은 앱 이벤트 SDK 개발자 문서를 참고하세요.

5단계: 디버그 모드를 사용하여 실시간으로 포스트백을 확인합니다

SDK 버전 1.5.0부터, 사용자는 다음과 같은 두 가지 방법으로 출시 전에 SDK 통합을 인증할 수 있습니다.

  • (권장) 토큰 기반 테스트 이벤트 모드. 전적으로 TikTok Events Manager에서만 진행되며 코드 수정이 필요하지 않습니다.

  • 수동 디버그 모드. 수정이 필요합니다. 수동 디버그를 사용하는 경우 앱을 출시하기 전에 디버그 모드를 반드시 꺼야 합니다. 이러한 도구 중 하나를 사용할 때 생성된 이벤트는 테스트 파이프라인을 거치며, 리포팅용으로는 사용될 수 없습니다.

    • 디버그 모드: 켜짐

      App Event SDK - Debug Mode ON

      디버그 모드: 꺼짐

      App Event SDK - Debug Mode OFF

6단계: TikTok SDK로 새로운 앱 버전을 App Store(iOS)/Play Store(Android)에 출시합니다

TikTok이 SDK로부터 실시간 시그널을 수신하기 시작하면 이벤트 관리자의 리포팅 탭에 SDK 이벤트가 표시되는 것을 확인할 수 있습니다. 테스트 모드에서 발생한 시그널은 여기에 표시되지 않습니다.

App Events SDK - screenshot 5

7단계: TikTok SDK를 사용하여 캠페인을 실행합니다

앱 이벤트 SDK를 통합하는 데 문제나 어려움이 있는 경우 고객 지원 팀에 티켓을 제출할 수 있습니다. 문제 분류로 측정과 앱 이벤트 SDK를 차례로 선택하세요.