常見問題

整合 Facebook SDK 後,除非停用自動應用程式事件記錄功能,否則系統會自動記錄並蒐集某些應用程式事件,以供事件管理工具使用。您可以在應用程式的程式碼中進行變更,也可以透過應用程式主控板或事件管理工具中的應用程式事件下的切換來進行變更。請注意,如果 AutoLogAppEventsEnabled 標記和切換之間的值發生衝突,我們將遵循「Facebook SDK 的自動事件記錄功能」切換中的值。如需深入瞭解系統會蒐集哪些資訊,以及如何停用自動應用程式事件記錄功能,請參閱自動應用程式事件記錄功能

限制

一個應用程式最多可以建立 1,000 個不重複的事件名稱。若超出此限制,進行記錄時可能會出現 100 Invalid parameter 錯誤。

若需要移除已過時的事件,您可遵循使用說明中的指示來停用事件。

我們發現開發人員超過事件限制的一個常見原因是,他們不利用參數,而是在應使用參數時記錄個別事件。舉例來說,每當用戶完成遊戲關卡時,開發人員不應記錄為獨立事件(例如已完成第 1 關、已完成第 2 關等),而應記錄為單一事件:已完成的關卡,並使用 level 參數代表關卡等級。

An event can have up to 25 parameters. This doesn't just mean for each call, but for all invocations using that event name.

If you need to remove obsolete parameters - you can deactivate parameters by following the instructions in our help center.

事件和參數名稱必須包含 2 至 40 個英數字元。

每個參數值的長度不能超過 100 個字元。

實作方式

應用程式事件提供下列管道的 SDK: iOSAndroidFacebook 遊戲平台Unity。此外,應用程式事件也支援透過 圖形 API

您可以定義想要擷取的自訂事件,並可在「 Facebook 分析工具 」主控板中查看該事件。最多可支援記錄 1,000 個自訂事件名稱,且不限制事件量。不過,「廣告分析報告」中只會顯示「標準應用程式事件」。您已建立的任何「自訂應用程式事件」會記錄為「其他行動應用程式集客力動作」。

針對 Unity 遊戲,您可以使用 Unity SDK 來記錄應用程式事件。針對在原生應用程式內使用網頁檢視的其他管道,選項之一是使用 應用程式事件 API 將事件從您的伺服器傳遞到 Facebook 伺服器。

開發人員通常會認為使用 Facebook SDK 整合應用程式事件比較簡單。這是因為 Facebook SDK 可有效減少需要編寫的程式碼數量,且會提供與應用程式相關的實用中繼資料,例如應用程式版本和應用程式名稱等等。SDK 會自動提供使用時間、連線階段數量和中斷次數等衡量指標,所以開發人員不需投入大量心力。此外,SDK 也能夠蒐集 Android 廣告主編號或 IDFA(如果您使用的是與廣告歸因相關的應用程式事件),並為您處理限制廣告追蹤作業。不過,SDK 的限制是您必須傳送新版應用程式,才能新增其他事件。對大多數的開發人員而言,SDK 選項的效能最佳。

如果開發人員想在不傳送應用程式更新版本的情況下,整合應用程式事件或新增其他應用程式事件,則選用 API 解決方案可能較為合適。對擁有混合式網頁應用程式的開發人員而言,使用 API 進行整合也比較容易。不過,API 解決方案會要求您自己處理限制廣告追蹤作業及蒐集 IDFA 和 Android 廣告主編號。此外,這個解決方案也不像 SDK 會自動蒐集並提供應用程式使用情形衡量指標。開發人員必須自行判斷想追蹤的額外衡量指標(如應用程式版本、應用程式名稱、使用時間、連線階段數量和中斷次數),然後透過 API 將這些指標以自訂參數的形式傳回。

If you are currently using an MMP to track installs or other actions in your app, you can request that your MMP passes those events server to server to Facebook.

您可以在應用程式中同時使用 MMP SDK 和 Facebook SDK,但請勿向這兩個 SDK 傳遞同一事件兩次,否則可能會發生重複計算的情形。

應用程式廣告幫手 可讓您測試應用程式中的應用程式事件,以確認應用程式會將事件傳送到 Facebook。

a.開啟 應用程式廣告幫手

b.在「選擇應用程式」中選擇您的應用程式,然後選擇「提交」。

c.選擇底部的「測試版應用程式事件」。

d.啟動應用程式,並傳送事件。事件會出現在網頁上。

Facebook 會根據我們的資料政策處理您的資料。這些資訊可用於提升我們的廣告目標設定和投遞功能,以及改善 Facebook 上的其他體驗,包括動態和搜尋內容排名功能。

  • 忘記傳遞購買或購買相關事件的幣別或數值
  • 將小數點放錯位置
  • 在數值中使用逗號而不是小數點
  • 以猜測「平均」順序值而不是傳遞實際值的方式,將轉換值寫在程式碼中

廣告相關問題

如果您是記錄自訂事件而非標準事件,該事件會顯示在「其他行動應用程式的集客力動作」下的「廣告分析報告」中,且不會進行資料解析。

是的,您可以使用應用程式事件建立自訂廣告受眾。你可以前往這裡查看相關說明。

可以,我們會以最低成本向最有可能採取特定動作的用戶投遞至少一次廣告。透過 API 建立針對特定應用程式事件最佳化的行動應用程式安裝廣告組合。除了以下幾點外,這與一般行動應用程式安裝廣告組合或行動應用程式互動廣告組合的建立方式類似:

  • optimization_goal:設定為 OFFSITE_CONVERSIONS
  • billing_event:設定為 IMPRESSIONS
  • promoted_object:將 custom_event_type 設定為您想最佳化的應用程式事件。
  • 行動應用程式互動廣告應最佳化標準應用程式事件(應用程式啟動事件除外)。您可以在廣告管理員和 API 中使用這些選項。請參閱 行銷 API:廣告組合

    自動記錄應用程式內購買

    第一步,確認您已在應用程式內安裝 Facebook Android Core SDK 4.36 版(或更新版本)。第二步,前往應用程式主控板中的「設定」>「基本」。在 Android 設定中,將「自動記錄應用程式內購買事件」開關切換到「」。

    若使用 4.27 到 4.35 版,請務必在應用程式啟動時呼叫 callbackManager.onActivityResult() ,並在應用程式主控板

    First, ensure that you have v3.22 (or higher) of the Facebook iOS SDK installed within your app. Second, ensure that you are calling the ActivateApp method.

    1. 前往 我的應用程式
    2. 選擇您的應用程式。
    3. 點擊左側導覽列上的設定頁籤。
    4. 找到標記為 Android 的區塊。
    5. 將「在 Android 上自動記錄應用程式內購買事件」設為「」。
    1. 前往 我的應用程式
    2. 選擇您的應用程式。
    3. 點擊左側導覽列上的設定頁籤。
    4. 找到標記為 iOS 的區塊。
    5. 啟用名為「在 iOS 上自動記錄應用程式內購買事件」的開關。

    啟用切換為記錄應用程式內購買之後,系統將追蹤以下應用程式事件:開始結帳、購買、購買取消。

    自動記錄可減少準確記錄應用程式事件所需的時間。您不需手動收集事件和判斷要傳遞的參數,系統會為您處理一切操作。例如,系統會自動記錄以下參數:產品編號、數量、總金額、幣別、產品標題和產品說明。此外,如果您使用的是 3.22 版或更新版本,無需向 App Store 提交更新的用戶端即可自動啟用此功能。

    如果目前已經在記錄應用程式內購買事件,則不需要啟用此功能。不過,如果您想要採用此功能,建議您明確停止記錄應用程式內購買事件,否則分析報告中可能會出現重複計算的情形。

    We recommend logging all events that are relevant to your app. You can use this best practices guide as a starting point to determine what events would be relevant for your business.