無程式碼應用程式事件

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 完整 SDK 4.34 至 7.1.1 版
  • Facebook iOS 核心 SDK 4.38 至 7.1.1 版
  • Facebook iOS 核心 SDK 4.34-4.37 至 7.1.1 版和 Marketing Kit

限制

請參閱 iOS 應用程式事件新手指南來安裝最新版 iOS SDK;參閱升級指南來升級到最新版 SDK;或者,如果您只有安裝 4.34 至 4.37 版的核心 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