코드를 사용하지 않는 앱 이벤트

코드를 사용하지 않는 앱 이벤트는 v4.34에 도입되었으며, 코드를 구현하거나 새 버전의 앱을 출시하지 않고도 이벤트 관리자를 사용해서 앱 이벤트를 추가하거나 삭제할 수 있습니다.

Android

요구 사항

다음 중 하나가 있어야 합니다.

Android용 Facebook SDK 최신 버전을 설치하려면 Android용 앱 이벤트 시작하기 가이드를 참조하세요. SDK 최신 버전으로 업그레이드하려면 업그레이드 가이드를 참조하세요. v4.34-4.37을 설치했다면 <your_app> | Gradle Scripts | build.gradle (Module: app)을 열어서 다음을 dependencies{} 섹션에 추가하는 방법으로 마케팅 키트를 추가하세요.

implementation 'com.facebook.android:facebook-marketing:[4,5)' 

잊지 말고 프로젝트도 다시 빌드하세요.

코드를 사용하지 않는 앱 이벤트 기능 구현

코드를 사용하지 않는 디버그 이벤트를 활성화하려면 AndroidManifest.xml에 다음의 줄을 추가합니다.

<meta-data
    android:name="com.facebook.sdk.CodelessDebugLogEnabled"
    android:value="true" />

앱 이벤트 추가

이벤트 관리자로 이동하여 추적하고자 하는 앱 이벤트를 코드 없이 추가하세요.

  1. 이벤트 관리자에서 새로운 데이터 소스 추가를 클릭하고 드롭다운 메뉴에서 앱 이벤트를 선택합니다.
  2. 코드를 사용하지 않는 이벤트 설정 도구 사용을 클릭한 다음, 이벤트를 추가할 앱을 선택합니다.
  3. 설정 시작을 클릭하여 플랫폼을 선택합니다.
  4. 코드를 사용하지 않는 플로를 처음 방문하는 경우 간단한 튜토리얼이 표시됩니다. 튜토리얼을 마치면 모바일 기기에서 앱의 새로운 세션을 엽니다.
  5. 앱 버전이 나타날 때까지 휴대폰을 흔듭니다.
  6. 요소를 클릭하여 앱 이벤트를 추가합니다. 앱의 서로 다른 페이지로 이동하고 앱 전반에서 요소들을 선택합니다.
  7. 팝업 메뉴에서 저장을 클릭하거나, 이벤트를 추가하지 않으려면 취소를 클릭합니다.
  8. 모든 이벤트를 추가했으면 검토 및 완료를 클릭합니다.
  9. 이벤트 테스트를 클릭하거나 저장하고 종료합니다.

참고: 이벤트 관리자에 이벤트가 표시되기까지 최대 30분이 소요될 수 있습니다.

통합 인증

앱 광고 지원 도구로 이동합니다.

  • 앱을 선택하고 제출을 클릭합니다.
  • 개발자 도구 섹션으로 스크롤을 내려서 앱 이벤트 테스트를 클릭합니다.
  • 앱에서 fb_codeless_debug 이벤트를 전송 중인 경우, 선택한 테스트 이벤트가 테이블에 나열됩니다.

참고:Facebook SDK v4.35 이상에서만 작동합니다.

iOS

요구 사항

  • Facebook iOS Full SDK v4.34-v7.1.1
  • Facebook iOS Core SDK v4.38-v7.1.1
  • Facebook iOS Core SDK v4.34-4.37-v7.1.1 및 마케팅 키트

제한 사항

iOS SDK 최신 버전을 설치하려면 iOS용 앱 이벤트 시작하기 가이드를 참조하세요. SDK 최신 버전으로 업그레이드하려면 업그레이드 가이드를 참조하세요. Core SDK의 v4.34-4.37만 설치했다면 Podfile에 다음을 추가하는 방법으로 마케팅 키트를 추가하세요.

pod 'FBSDKMarketingKit' 

pod update를 실행한 다음, pod install --repo-update를 실행하는 것을 잊지 마세요.

코드를 사용하지 않는 앱 이벤트 기능 구현

앱의 .plist를 Xcode에서 코드로 열어 코드를 사용하지 않는 디버그 이벤트 로깅을 활성화하고 다음 XML을 자산 사전에 추가합니다.

<key>FacebookCodelessDebugLogEnabled</key>
<true/>

앱 이벤트 추가

iOS 14용 App Store Connect

앱이 수집하여 Facebook에 보내는 이벤트는 App Store Connect 질문에 이러한 데이터 유형을 공개해야 할 수 있습니다. 여러분은 앱의 개인정보처리방침에 해당 내용을 반영해야 할 책임이 있습니다. 공개해야 할 데이터 유형에 대해 자세히 알아보려면 Apple App Store 개인정보처리방침 상세 정보 문서를 참조하세요.

이벤트 관리자로 이동하여 추적하고자 하는 앱 이벤트를 코드 없이 추가하세요.

  1. 이벤트 관리자에서 데이터 소스 추가를 클릭하고 드롭다운 메뉴에서 앱 이벤트를 선택합니다.
  2. 코드를 사용하지 않는 이벤트 설정 도구 사용을 클릭한 다음, 이벤트를 추가할 앱을 선택합니다.
  3. 설정 시작을 클릭하여 플랫폼을 선택합니다.
  4. 코드를 사용하지 않는 플로를 처음 방문하는 경우 간단한 튜토리얼이 표시됩니다. 튜토리얼을 마치면 모바일 기기에서 앱의 새로운 세션을 엽니다.
  5. 앱 버전이 나타날 때까지 휴대폰을 흔듭니다.
  6. 요소를 클릭하여 앱 이벤트를 추가합니다. 앱의 서로 다른 페이지로 이동하고 앱 전반에서 요소들을 선택합니다.
  7. 팝업 메뉴에서 저장을 클릭하거나, 이벤트를 추가하지 않으려면 취소를 클릭합니다.
  8. 모든 이벤트를 추가했으면 검토 및 완료를 클릭합니다.
  9. 이벤트 테스트를 클릭하거나 저장하고 종료합니다.

참고: 이벤트 관리자에 이벤트가 표시되기까지 최대 30분이 소요될 수 있습니다.

통합 인증

앱 광고 지원 도구로 이동합니다.

  • 앱을 선택하고 제출을 클릭합니다.
  • 아래로 내려가서 앱 이벤트 테스터를 선택합니다.
  • 앱에서 fb_codeless_debug 이벤트를 전송 중인 경우 해당 이벤트가 테이블에 나열됩니다.

Unity

Facebook Unity SDK v4.34 이상이 필요합니다.

Facebook Unity SDK의 최신 버전을 설치하려면 Facebook Unity SDK 시작하기를 참조하고 Unity iOS 또는 Unity Android의 플랫폼별 설정을 따르세요.

코드를 사용하지 않는 앱 이벤트 활성화

이 옵션을 활성화하려면 Unity Editor에서 Facebook | Edit Settings를 선택한 다음, Auto Logging App Events를 선택합니다.

앱 이벤트 추가

이때 이벤트 관리자로 앱 이벤트를 추가할 수 있습니다.

  1. Add Data Source에서 App Events를 선택합니다.

  2. User our codeless event setup tool을 클릭합니다.

  3. 이벤트를 추가할 앱을 선택합니다.

  4. Start Setup을 클릭하여 플랫폼을 선택합니다. 코드를 사용하지 않는 플로를 처음 방문하는 경우 간단한 튜토리얼이 표시됩니다.

  5. 튜토리얼을 마치면 모바일 기기에서 앱의 새로운 세션을 엽니다.

  6. 앱 버전이 나타날 때까지 모바일 기기를 흔듭니다.

  7. 앱에서 요소를 클릭하여 앱 이벤트를 추가합니다. 앱의 서로 다른 페이지로 이동하고 앱 전반에서 요소들을 선택합니다.

  8. Unity Editor에서 Save를 클릭하여 이벤트를 추가합니다.

  9. 모든 이벤트를 추가했으면 Review and Finish를 클릭합니다.

  10. Test Events 또는 Save and Exit를 클릭합니다.

이벤트 관리자에 이벤트가 표시되기까지 최대 30분이 소요될 수 있습니다. 게임에서 지원하는 각 플랫폼(예: iOS, Android)에 대해 이 단계를 반복합니다.

통합 인증

앱 광고 지원 도구로 이동합니다.

  • Select an App에서 Submit을 클릭합니다.

  • App Events Tester를 선택합니다.

  • 앱에서 fb_codeless_debug 이벤트를 전송할 경우 해당 이벤트가 테이블에 표시됩니다.

FAQ

일반

1. 코드를 사용하지 않는 기능이 올바르게 통합되었는지 어떻게 확인할 수 있나요?

테스트 기기에서 앱을 시작하고 몇 분이 지나면 이벤트 관리자fb_codeless_debug라는 이름의 이벤트가 표시됩니다.

2. 코드를 사용하지 않는 기능은 어떻게 비활성화하나요?

코드를 사용하지 않는 앱 이벤트 로깅을 비활성화하려면 코드를 사용하지 않는 이벤트 설정 도구를 사용하여 모든 이벤트를 삭제합니다.


Android

1. 다음과 같은 빌드 오류가 나타나면 어떻게 해야 하나요?
Android SDK build Error:Execution failed for task ':app:processDebugManifest'.> Manifest merger failed : 
Attribute activity#com.facebook.FacebookActivity@theme value=(@android:style/Theme.Translucent.NoTitleBar) 
from AndroidManifest.xml:69:13-72is also present at [com.facebook.android:facebook-android-sdk:4.16.0] 
AndroidManifest.xml:32:13-63 value=(@style/com_facebook_activity_theme).Suggestion: add
'tools:replace="android:theme"' to <activity> element at AndroidManifest.xml:66:9-70:47 to override.
AndroidManifest.xml 파일의 manifest 요소에 다음을 추가합니다.
<manifest>
  ...
  xmlns:tools="http://schemas.android.com/tools"
  ...
</manifest>
그리고 다음을 activity 요소에 추가합니다.
<activity>
  ...
  tools:replace="android:theme"
  ...
</activity>

iOS

1. 다음 경고가 나타나면 어떻게 해야 하나요?
[!] Unable to find a specification for FBSDKMarketingKit
pod updatepod install --repo-update를 차례로 실행합니다.