앱 이벤트 시작하기(iOS)

이 가이드에서는 Facebook SDK를 통합한 다음 이러한 이벤트를 로깅하여 새로운 앱이나 기존 앱에 앱 이벤트를 추가하는 방법을 설명합니다.

시작하기 전에

다음과 같은 항목이 필요합니다.

• Facebook 개발자 계정
• Facebook 광고 계정
• Facebook 비즈니스 계정(아직 없는 경우 새로운 비즈니스 계정 생성)
• Facebook 앱

1단계: Facebook 앱 구성하기

앱 대시보드에서 내 앱을 클릭하고 앱이 없다면 새 앱을 만듭니다. 설정 > 기본에서 앱 ID, 앱 시크릿 코드 및 앱에 대한 기타 상세 정보가 있는 앱 상세 정보 패널을 확인합니다.

페이지 하단으로 스크롤한 다음, 플랫폼 추가를 클릭합니다. iOS를 선택하고 앱 상세 정보를 추가한 다음 변경 사항을 저장합니다.

다음 상세 정보를 추가해 광고에 맞게 앱을 설정하세요.

• 앱 도메인 - 앱의 Apple App Store URL을 제공합니다.
• 개인정보처리방침 URL - 개인정보처리방침 URL을 제공합니다. 앱을 전체 공개하려면 필수입니다.
• 서비스 약관 URL - 서비스 약관 URL을 제공합니다.
• 플랫폼 - 설정 패널의 하단으로 스크롤하여 iOS 플랫폼을 추가합니다.

아이콘 또는 카테고리와 같은 자세한 정보를 앱에 추가하는 방법은 앱 개발 문서를 참조하세요.

2단계: 광고와 비즈니스 계정 연결

광고를 게재하고 광고 관리자에서 설치를 측정하려면 하나 이상의 광고 계정과 하나의 비즈니스 계정을 앱과 연결합니다.

1. 앱 대시보드에서 설정 > 고급을 클릭합니다.
2. 승인된 광고 계정 ID에 광고 계정 ID를 추가합니다. 광고 계정 ID는 광고 관리자에서 가져올 수 있습니다.
3. 광고 계정 패널에서 시작하기를 클릭하고 지침에 따라 앱과 비즈니스를 연결합니다.

3단계: 개발 환경 설정

다음 절차에서는 Swift Package Manager를 사용하여 XCode에서 개발 환경을 설정합니다.

1. Xcode에서 파일 > 패키지 추가...를 클릭합니다.
2. 표시되는 검색 필드에서 저장소 URL(https://github.com/facebook/facebook-ios-sdk)을 입력합니다.
3. 종속성 규칙에서 다음 주 버전까지를 선택하고 최신 버전을 입력합니다. 최신 릴리스는 https://github.com/facebook/facebook-ios-sdk/releases/에 나와 있습니다.
4. 사용하려는 라이브러리와 해당 라이브러리를 추가할 타겟을 선택합니다.
5. 패키지 추가를 클릭하여 설정을 완료합니다.

4단계: Facebook에 앱 등록 및 구성

번들 식별자를 추가하고 앱의 SSO를 활성화합니다.

5단계: 프로젝트 구성

6단계: 앱 델리게이트와 장면 델리게이트 연결

    
// AppDelegate.swift
import UIKit
import FacebookCore

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {    
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {          
        ApplicationDelegate.shared.application(
            application,
            didFinishLaunchingWithOptions: launchOptions
        )

        return true
    }
          
    func application(
        _ app: UIApplication,
        open url: URL,
        options: [UIApplication.OpenURLOptionsKey : Any] = [:]
    ) -> Bool {
        ApplicationDelegate.shared.application(
            app,
            open: url,
            sourceApplication: options[UIApplication.OpenURLOptionsKey.sourceApplication] as? String,
            annotation: options[UIApplication.OpenURLOptionsKey.annotation]
        )
    }  
}

// SceneDelegate.swift
import FacebookCore
  ...
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else {
        return
    }

    ApplicationDelegate.shared.application(
        UIApplication.shared,
        open: url,
        sourceApplication: nil,
        annotation: [UIApplication.OpenURLOptionsKey.annotation]
    )
}

7단계: 앱 이벤트 추가

앱에서 이벤트를 추적하는 방법은 세 가지가 있습니다.

• 자동 로깅된 이벤트 - 앱 설치, 시작 및 앱 내 구매는 Facebook SDK로 자동 로깅됩니다.
• 코드리스 앱 이벤트 도구 - 이 도구를 사용하면 앱에 코드를 추가하지 않고 표준 이벤트를 추가할 수 있습니다.
• 수동 로깅된 이벤트 - 앱에 코드를 추가하여 표준 이벤트와 맞춤 이벤트를 추적합니다.

자동 로깅된 이벤트

기기 동의받기

iOS 14.5부터 AdvertiserTrackingEnabled를 설정하고 Facebook과 데이터를 공유할 권한을 기기에 부여할 때마다 로깅해야 합니다.

기기에서 동의를 제공할 경우 Settings.shared.isAdvertiserTrackingEnabled = true를 설정합니다.

기기에서 추적을 허용하지 않을 경우 Settings.shared.isAdvertiserTrackingEnabled = false를 설정합니다.

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

<key>FacebookAdvertiserIDCollectionEnabled</key>
<false/>

이벤트 수동 로깅

맞춤 이벤트를 로깅하려면 이벤트 이름을 AppEvents.Name으로 전달하세요.

AppEvents.shared.logEvent(AppEvents.Name("battledAnOrc"))

이벤트 매개변수

Facebook에서는 표준 이벤트 또는 맞춤 이벤트를 포함하는 데 유용한 이벤트 매개변수 세트를 만들었습니다. 개발자가 직접 매개변수를 제공할 수도 있습니다.

이와 같이 미리 정의된 매개변수는 공통적인 로깅 패턴에 대한 지침을 제공하며 보고서와 기타 UI에서 더욱 읽기 쉽게 표시될 수 있습니다. 분석 데이터를 보고 싶은 매개변수 세트를 로깅하세요. 이러한 매개변수에 대한 권장 설명은 지침용으로만 제공됩니다. 이러한 매개변수를 앱에 적절한 용도로 사용할 수 있습니다.

매개변수는 사전을 통해 전달되며, 여기서 키는 매개변수 이름을 AppEvents.ParameterName으로 유지하고 값은 String 또는 숫자(예: Int, Double)여야 합니다.

8단계: 이벤트 테스트

앱 광고 지원 도구를 사용하면 앱이 Facebook에 이벤트를 보내도록 앱에서 앱 이벤트를 테스트할 수 있습니다.

1. 앱 광고 지원 도구를 엽니다.
2. 앱 선택에서 앱을 선택한 후 제출을 선택합니다.
3. 하단으로 스크롤하여 이벤트 테스트를 선택합니다.
4. 앱을 시작한 후 이벤트를 보냅니다. 그러면 이벤트가 페이지에 표시됩니다.

더 알아보기

• 모범 사례 가이드 - 광범위한 샘플 앱 및 각 샘플 앱에서 앱 이벤트를 처리하는 방식을 확인하세요.
• FAQ - 자주 묻는 질문을 확인하세요.
• Meta Blueprint 과정: iOS용 SDK 및 앱 이벤트 구성
• Meta Blueprint 과정: 앱 이벤트를 사용하여 타겟, 최적화 및 측정

예시 앱

앱 이벤트를 사용하는 방법을 더 쉽게 확인할 수 있도록 Facebook에서는 다양한 앱별 예시를 작성했습니다. 각 예시 앱에서는 수집할 수 있는 여러 다른 이벤트와 매개변수의 화면별 분석 데이터를 제공합니다. 각 섹션의 끝에는 각 앱의 권장 이벤트와 매개변수가 나열된 표가 있습니다. 필요에 따라 고유 이벤트와 매개변수를 만들 수 있습니다.