無程式碼應用程式事件

無程式碼應用程式事件是我們在 4.34 版推出的功能,可讓您使用事件管理工具新增或移除應用程式事件,而無需執行程式碼或發佈新版應用程式。

Android

必要條件

您必須採用下列其中一種工具配置:

請查閱 Android 專用的應用程式事件新手指南以安裝最新版本的 Facebook Android SDK;如需升級至最新版本的 SDK,則請參閱升級指南;又或者,如果您已安裝 4.34 至 4.37 版,請開啟 <your_app> | Gradle Scripts | build.gradle (Module: app),並將下列內容加入 dependencies{} 區段,以加入 Marketing Kit。

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 4.35 版及更新版本。

iOS

必要條件

  • Facebook iOS Full SDK 4.34 至 7.1.1 版本
  • Facebook iOS Core SDK 4.38 至 7.1.1 版本
  • Facebook iOS Core SDK 4.34-4.37 版本至 7.1.1 版本及 Marketing Kit

限制

請瀏覽 iOS 專用的應用程式事件新手指南以安裝最新版本的 iOS SDK;如需升級至最新版本的 SDK,則請參閱升級指南;又或者,如果您只安裝了 4.34 至 4.37 版 Core SDK,請將下列內容加入 Podfile 以加入 Marketing Kit。

pod 'FBSDKMarketingKit' 

別忘了順序執行 pod updatepod install --repo-update

安裝無程式碼應用程式事件功能

啟用無程式碼除錯事件記錄功能,方法是在 Xcode 中開啟應用程式的 .plist 作為程式碼,然後在屬性字典中加入以下 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 4.34 版或更新版本。

請參閱 Facebook Unity SDK 新手指南以安裝最新版本的 Facebook Unity SDK,並採用 Unity iOSUnity 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 EventsSave and Exit

您最長可能需要等待 30 分鐘,才會在事件管理工具中看見事件。在每個平台重複以上步驟,例如是您的遊戲支援的 iOS 或 Android 平台。

驗證整合

請前往應用程式廣告協助工具

  • Select an App 下點擊 Submit

  • 選擇 App Events Tester

  • 如果您的應用程式在傳送 fb_codeless_debug 事件,此類事件會在表格中列出。

常見問題

一般

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