Facebook App Events Reference

Android

Standard Events

事件名稱：AppEventsConstants 值	參數	描述
用戶成功過關：`EVENT_NAME_ACHIEVED_LEVEL`	`LEVEL`	達到您在應用程式、企業或機構中定義的特定關卡。
啟動應用程式：`EVENT_NAME_ACTIVATED_APP`		用戶開啟了您的應用程式。
應用程式內廣告點擊：`EVENT_NAME_AD_CLICK`	`AD_TYPE`	用戶點擊了您的應用程式內來自第三方平台的廣告。
應用程式內廣告展示：`EVENT_NAME_AD_IMPRESSION`	`AD_TYPE`	您應用程式的畫面出現了來自第三方平台的廣告。
新增付款資料：`EVENT_NAME_ADDED_PAYMENT_INFO`	`SUCCESS`	在結帳流程中加入客戶付款資料。
新增至購物車：`EVENT_NAME_ADDED_TO_CART` valueToSum：已加入商品的價格	`CONTENT_TYPE`、`CONTENT_ID` 或 `CONTENT` 和 `CURRENCY`	用戶將商品新增至購物車或購物籃。例如，用戶在網站中點擊了「新增至購物車」按鈕。
新增至願望清單：`EVENT_NAME_ADDED_TO_WISHLIST` valueToSum：已加入商品的價格	`CONTENT_TYPE`、`CONTENT_ID` 或 `CONTENT` 和 `CURRENCY`	用戶將商品新增至願望清單。例如，用戶在網站中點擊了「新增至願望清單」按鈕。
完成註冊：`EVENT_NAME_COMPLETED_REGISTRATION`	`REGISTRATION_METHOD`	客戶提交資訊以換取由您企業提供的服務。例如，用戶註冊以訂閱電郵。
完成教學：`EVENT_NAME_COMPLETED_TUTORIAL`	`SUCCESS`，以及 `CONTENT_ID` 或 `CONTENT`	用戶完成應用程式中的教學。
聯絡：`EVENT_NAME_CONTACT`		電話或短信、電郵、聊天，或者客戶和您企業之間的其他聯絡方式。
自訂產品：`EVENT_NAME_CUSTOMIZE_PRODUCT`		用戶使用配置工具或您企業所擁有的其他應用程式完成產品訂製流程。
捐款：`EVENT_NAME_DONATE`		用戶向您的機構或事業捐贈資金。
尋找位置：`EVENT_NAME_FIND_LOCATION`		用戶透過網絡或應用程式尋找您的某間分店，並有意前往該分店。例如，用戶正在尋找某件產品，並找到您的某間實體店。
啟動結帳：`EVENT_NAME_INITIATED_CHECKOUT` valueToSum：購物車商品總金額	`CONTENT_TYPE`、`CONTENT_ID` 或 `CONTENT`、`NUM_ITEMS`、`PAYMENT_INFO_AVAILABLE`，以及 `CURRENCY`	用戶開始結帳流程。
購買：`EVENT_NAME_PURCHASED` valueToSum：購買價格	`NUM_ITEMS`、`CONTENT_TYPE`、`CONTENT_ID` 或 `CONTENT`，以及 `CURRENCY`	用戶完成購買程序，這通常表示用戶收到訂單或購買確認，或者交易收據。
評分：`EVENT_NAME_RATED` valueToSum：給予的評分	`CONTENT_TYPE`、`CONTENT_ID` 或 `CONTENT`，以及 `MAX_RATING_VALUE`	用戶為您應用程式、企業或機構的某個專案給予評分。例如，用戶在餐廳評價應用程式中為餐廳評分。
預定時間：`EVENT_NAME_SCHEDULE`		用戶預約前往您的某間分店。
搜尋：`EVENT_NAME_SEARCHED`	`CONTENT_TYPE`、`SEARCH_STRING` 和 `SUCCESS`	用戶在您的網站、應用程式或其他平台上搜尋內容，例如產品搜尋、旅行搜尋等。
已花費 Credit：`EVENT_NAME_SPENT_CREDITS` valueToSum：已花費 Credit 的總金額	`CONTENT_TYPE`，以及 `CONTENT_ID` 或 `CONTENT`	用戶完成了一筆交易，在交易中使用了您企業或應用程式專用 Credit 的消費額度，例如應用程式內貨幣。
開始試用：`EVENT_NAME_START_TRIAL` valueToSum：訂閱價格	`ORDER_ID` 和 `CURRENCY`	用戶開始免費試用您提供的產品或服務，例如訂閱試用。
提交應用程式：`EVENT_NAME_SUBMIT_APPLICATION`		用戶就您提供的產品、服務或計畫（如信用卡、教育計畫或工作）所提交的申請。
訂閱：`EVENT_NAME_SUBSCRIBE` valueToSum：訂閱價格	`ORDER_ID` 和 `CURRENCY`	用戶開始付費訂閱您提供的產品或服務。
解鎖成就：`EVENT_NAME_UNLOCKED_ACHIEVEMENT`	`DESCRIPTION`	用戶完成了您在應用程式、企業或機構中想要獎勵的特定活動或動作。例如，推薦一位朋友、填妥個人資料等。
瀏覽內容：`EVENT_NAME_VIEWED_CONTENT` 已瀏覽商品的價格（如適用）	`CONTENT_TYPE`、`CONTENT_ID` 或 `CONTENT` 和 `CURRENCY`	瀏覽您在意的內容頁面，例如產品頁面、連結頁面或文章。用戶查看過的頁面資訊可能會傳送至 Facebook，以用於刊登動態廣告。

Standard Event Parameters

AppEventConstants::EVENT_PARAM_*	Possible Values	Description
Ad Type: `EVENT_PARAM_AD_TYPE`	`string`	Type of ad: banner, interstitial, rewarded_video, native
Content ID: `EVENT_PARAM_CONTENT_ID`	`string`	International Article Number (EAN) when applicable, or other product or content identifier
Content: `EVENT_PARAM_CONTENT`	`string`	A list of JSON object that contains the International Article Number (EAN) when applicable, or other product or content identifier(s) as well as additional information about the products. `id` and `quantity` are the available fields. e.g. "[{\"id\": \"1234\", \"quantity\": 2}, {\"id\": \"5678\", \"quantity\": 1}]"
Content Type: `EVENT_PARAM_CONTENT_TYPE`	`string`	'product' or 'product_group'
Currency: `EVENT_PARAM_CURRENCY`	`string`	ISO 4217 code, e.g., "EUR", "USD", "JPY"
Description: `EVENT_PARAM_DESCRIPTION`	`string`	A string description
Level: `EVENT_PARAM_LEVEL`	`string`	Level of a game
Max. Rating Value: `EVENT_PARAM_MAX_RATING_VALUE`	`int`	Upper bounds of a rating scale, for example 5 on a 5 star scale
Number of Items: `EVENT_PARAM_NUM_ITEMS`	`int`	Number of items
Order ID: `EVENT_PARAM_ORDER_ID`	`string`	The unique ID for all events within a subscription
Payment Info Available: `EVENT_PARAM_PAYMENT_INFO_AVAILABLE`	`1` or `0`	`1` for yes, `0` for no
Registration Method: `EVENT_PARAM_REGISTRATION_METHOD`	`string`	Facebook, Email, Twitter, etc.
Search String: `EVENT_PARAM_SEARCH_STRING`	`string`	The text string that was searched for
Success: `EVENT_PARAM_SUCCESS`	`1` or `0`	`1` for yes, `0` for no

iOS

適用於 iOS 14 的 App Store Connect

您可能需要就應用程式所蒐集並傳送至 Facebook 的事件，在 App Store Connect 問卷中披露有關資料類型。您有責任確保在應用程式的私隱政策中列明這一點。請查閱 Apple App Store 私隱詳情文章，以進一步了解您需要披露的資料類型。

Standard Events

Event Name: FBSDKAppEventName	Parameters	Description
Achieve Level: `FBSDKAppEventNameAchievedLevel`	`Level`	The achievement of specific levels you define within your application, business or organization.
Activate App: `FBSDKAppEventNameActivatedApp`		The launch of your app.
In-App Ad Click: `FBSDKAppEventNameAdClick`	`AdType`	An ad from a third-party platform is clicked within your app.
In-App Ad Impression: `FBSDKAppEventNameAdImpression`	`AdType`	An ad from a third-party platform appears on-screen within your app.
Add Payment Info: `FBSDKAppEventNameAddedPaymentInfo`	`Success`	The addition of customer payment information during a checkout process.
Add to Cart: `FBSDKAppEventNameAddedToCart` valueToSum: Price of item added	`ContentType`, `ContentID` or `Content`, and `Currency`	The addition of an item to a shopping cart or basket. For example, clicking an Add to Cart button on a website.
Add to Wishlist: `FBSDKAppEventNameAddedToWishlist` valueToSum: Price of item added	`ContentType`, `ContentID` or `Content`, and `Currency`	The addition of items to a wishlist. For example, clicking an Add to Wishlist button on a website.
Complete Registration: `FBSDKAppEventNameCompletedRegistration`	`RegistrationMethod`	A submission of information by a customer in exchange for a service provided by your business. For example, sign up for an email subscription.
Complete Tutorial: `FBSDKAppEventNameCompletedTutorial`	`Success`, and `ContentID` or `Content`	A completion of a tutorial on your app.
Contact: `FBSDKAppEventNameContact`		A telephone or SMS, email, chat or other type of contact between a customer and your business.
Customize Product: `FBSDKAppEventNameCustomizeProduct`		The customization of products through a configuration tool or other application your business owns.
Donate: `FBSDKAppEventNameDonate`		The donation of funds to your organization or cause.
Find Location: `FBSDKAppEventNameFindLocation`		When a person finds one of your locations via web or app, with an intention to visit. For example, searching for a product and finding it at one of your local stores.
Initiate Checkout: `FBSDKAppEventNameInitiatedCheckout` valueToSum: Total price of items in cart	`ContentType`, `ContentID` or `Content`, `NumItems`, `PaymentInfoAvailable`, and `Currency`	The start of a checkout process.
~~Purchase: `FBSDKAppEventNamePurchased`~~ Use the `logPurchase` method instead. valueToSum: Purchase price	`NumItems`, `ContentType`, `ContentID` or `Content`, and `Currency`	The completion of a purchase, usually signified by receiving order or purchase confirmation or a transaction receipt.
Rate: `FBSDKAppEventNameRated` valueToSum: Rating given	`ContentType`, `ContentID` or `Content`, and `MaxRatingValue`	A rating of something within your app, business or organization. For example, rates a restaurant within a restaurant review app
Schedule: `FBventNameSchedule`		The booking of an appointment to visit one of your locations.
Search: `FBSDKAppEventNameSearched`	`ContentType`, `SearchString`, and `Success`	A search performed on your website, app or other property, such as product searches, travel searches, etc.
Spent Credits: `FBSDKAppEventNameSpentCredits` valueToSum: Total value of credits spent	`ContentType`, and `ContentID` or `Content`	The completion of a transaction where people spend credits specific to your business or application, such as in-app currency.
Start Trial: `FBSDKAppEventNameStartTrial` valueToSum: Total value of credits spent	`OrderID` and `Currency`	The start of a free trial of a product or service you offer, such as a trial subscription.
`Schedule`	See App Events Schema
Submit Application: `FBSDKAppEventNameSubmitApplication`		The submission of an application for a product, service or program you offer, such as a credit card, educational program or job.
`Subscribe`	See App Events Schema
Subscription: `FBSDKAppEventNameSubscription` valueToSum: Price of Subscription	`OrderID` and `Currency`	The start of a paid subscription for a product or service you offer.
Unlock Achievement: `FBSDKAppEventNameUnlockedAchievement`	`Description`	The completion of specific activities or actions you want to reward within your application, business or organization. For example, refer a friend, complete your profile, etc.
View Content: `FBSDKAppEventNameViewedContent` valueToSum: Price of item viewed (if applicable)	`ContentType`, `ContentID` or `Content`, and `Currency`	A visit to a content page you care about, such as a product page, landing page or article. Information about the page viewed can be passed to Facebook for use in Advantage+ catalog ads.

Standard Event Parameters

Parameter: FBSDKAppEventParameterName	Possible Values	Description
Ad Type: `FBSDKAppEventParameterNameAdType`	`string`	Type of ad: banner, interstitial, reward_video, native
Content: `FBSDKAppEventParameterNameContent`	`string`	A list of JSON object that contains the International Article Number (EAN) when applicable, or other product or content identifiers and additional information about the products. `id` and `quantity` are the available fields. e.g. "[{\"id\": \"1234\", \"quantity\": 2}, {\"id\": \"5678\", \"quantity\": 1}]"
Content ID: `FBSDKAppEventParameterNameContentID`	`string`	International Article Number (EAN) when applicable, or other product or content identifier
Content Type: `FBSDKAppEventParameterNameContentType`	`string`	`product` or `product_group`
Currency: `FBSDKAppEventParameterNameCurrency`	`string`	ISO 4217 code, for example, `EUR`, `USD`, `JPY`
Description: `FBSDKAppEventParameterNameDescription`	`string`	A string description
Level: `FBSDKAppEventParameterNameLevel`	`string`	Level of a player
Max. Rating Value: `FBSDKAppEventParameterNameMaxRatingValue`	`int`	Upper bounds of a rating scale, for example `5` on a `5` star scale
Number of Items: `FBSDKAppEventParameterNameNumItems`	`int`	Number of items
Order ID: `FBSDKAppEventParameterNameOrderID`	`string`	The unique ID for all events within a subscription
Payment Info Available: `FBSDKAppEventParameterNamePaymentInfoAvailable`	`1` or `0`	`1` for yes, `0` for no
Registration Method: `FBSDKAppEventParameterNameRegistrationMethod`	`string`	Facebook, Email, Twitter, etc.
Search String: `FBSDKAppEventParameterNameSearchString`	`string`	The string that was searched for
Success: `FBSDKAppEventParameterNameSuccess`	`1` or `0`	`1` for yes, `0` for no

Web

Standard Events

事件名稱：AppEventsConstants 值	參數	描述
用戶成功過關：`EVENT_NAME_ACHIEVED_LEVEL`	`LEVEL`	達到您在應用程式、企業或機構中定義的特定關卡。
啟動應用程式：`EVENT_NAME_ACTIVATED_APP`		用戶開啟了您的應用程式。
應用程式內廣告點擊：`EVENT_NAME_AD_CLICK`	`AD_TYPE`	用戶點擊了您的應用程式內來自第三方平台的廣告。
應用程式內廣告展示：`EVENT_NAME_AD_IMPRESSION`	`AD_TYPE`	您應用程式的畫面出現了來自第三方平台的廣告。
新增付款資料：`EVENT_NAME_ADDED_PAYMENT_INFO`	`SUCCESS`	在結帳流程中加入客戶付款資料。
新增至購物車：`EVENT_NAME_ADDED_TO_CART` valueToSum：已加入商品的價格	`CONTENT_TYPE`、`CONTENT_ID` 或 `CONTENT` 和 `CURRENCY`	用戶將商品新增至購物車或購物籃。例如，用戶在網站中點擊了「新增至購物車」按鈕。
新增至願望清單：`EVENT_NAME_ADDED_TO_WISHLIST` valueToSum：已加入商品的價格	`CONTENT_TYPE`、`CONTENT_ID` 或 `CONTENT` 和 `CURRENCY`	用戶將商品新增至願望清單。例如，用戶在網站中點擊了「新增至願望清單」按鈕。
完成註冊：`EVENT_NAME_COMPLETED_REGISTRATION`	`REGISTRATION_METHOD`	客戶提交資訊以換取由您企業提供的服務。例如，用戶註冊以訂閱電郵。
完成教學：`EVENT_NAME_COMPLETED_TUTORIAL`	`SUCCESS`，以及 `CONTENT_ID` 或 `CONTENT`	用戶完成應用程式中的教學。
聯絡：`EVENT_NAME_CONTACT`		電話或短信、電郵、聊天，或者客戶和您企業之間的其他聯絡方式。
自訂產品：`EVENT_NAME_CUSTOMIZE_PRODUCT`		用戶使用配置工具或您企業所擁有的其他應用程式完成產品訂製流程。
捐款：`EVENT_NAME_DONATE`		用戶向您的機構或事業捐贈資金。
尋找位置：`EVENT_NAME_FIND_LOCATION`		用戶透過網絡或應用程式尋找您的某間分店，並有意前往該分店。例如，用戶正在尋找某件產品，並找到您的某間實體店。
啟動結帳：`EVENT_NAME_INITIATED_CHECKOUT` valueToSum：購物車商品總金額	`CONTENT_TYPE`、`CONTENT_ID` 或 `CONTENT`、`NUM_ITEMS`、`PAYMENT_INFO_AVAILABLE`，以及 `CURRENCY`	用戶開始結帳流程。
購買：`EVENT_NAME_PURCHASED` valueToSum：購買價格	`NUM_ITEMS`、`CONTENT_TYPE`、`CONTENT_ID` 或 `CONTENT`，以及 `CURRENCY`	用戶完成購買程序，這通常表示用戶收到訂單或購買確認，或者交易收據。
評分：`EVENT_NAME_RATED` valueToSum：給予的評分	`CONTENT_TYPE`、`CONTENT_ID` 或 `CONTENT`，以及 `MAX_RATING_VALUE`	用戶為您應用程式、企業或機構的某個專案給予評分。例如，用戶在餐廳評價應用程式中為餐廳評分。
預定時間：`EVENT_NAME_SCHEDULE`		用戶預約前往您的某間分店。
搜尋：`EVENT_NAME_SEARCHED`	`CONTENT_TYPE`、`SEARCH_STRING` 和 `SUCCESS`	用戶在您的網站、應用程式或其他平台上搜尋內容，例如產品搜尋、旅行搜尋等。
已花費 Credit：`EVENT_NAME_SPENT_CREDITS` valueToSum：已花費 Credit 的總金額	`CONTENT_TYPE`，以及 `CONTENT_ID` 或 `CONTENT`	用戶完成了一筆交易，在交易中使用了您企業或應用程式專用 Credit 的消費額度，例如應用程式內貨幣。
開始試用：`EVENT_NAME_START_TRIAL` valueToSum：訂閱價格	`ORDER_ID` 和 `CURRENCY`	用戶開始免費試用您提供的產品或服務，例如訂閱試用。
提交應用程式：`EVENT_NAME_SUBMIT_APPLICATION`		用戶就您提供的產品、服務或計畫（如信用卡、教育計畫或工作）所提交的申請。
訂閱：`EVENT_NAME_SUBSCRIBE` valueToSum：訂閱價格	`ORDER_ID` 和 `CURRENCY`	用戶開始付費訂閱您提供的產品或服務。
解鎖成就：`EVENT_NAME_UNLOCKED_ACHIEVEMENT`	`DESCRIPTION`	用戶完成了您在應用程式、企業或機構中想要獎勵的特定活動或動作。例如，推薦一位朋友、填妥個人資料等。
瀏覽內容：`EVENT_NAME_VIEWED_CONTENT` 已瀏覽商品的價格（如適用）	`CONTENT_TYPE`、`CONTENT_ID` 或 `CONTENT` 和 `CURRENCY`	瀏覽您在意的內容頁面，例如產品頁面、連結頁面或文章。用戶查看過的頁面資訊可能會傳送至 Facebook，以用於刊登動態廣告。

Standard Event Parameters

AppEventConstants::EVENT_PARAM_*	Possible Values	Description
Ad Type: `EVENT_PARAM_AD_TYPE`	`string`	Type of ad: banner, interstitial, rewarded_video, native
Content: `EVENT_PARAM_CONTENT`	`string`	A list of JSON object that contains the International Article Number (EAN) when applicable, or other product or content identifier(s) as well as additional information about the products. `id`, `quantity`, and `item_price` are the available fields. e.g. "[{\"id\": \"1234\", \"quantity\": 2, \"item_price\": 5.99}, {\"id\": \"5678\", \"quantity\": 1, \"item_price\": 9.99}]"
Content ID: `EVENT_PARAM_CONTENT_ID`	`string`	International Article Number (EAN) when applicable, or other product or content identifier
Content Type: `EVENT_PARAM_CONTENT_TYPE`	`string`	'product' or 'product_group'
Currency: `EVENT_PARAM_CURRENCY`	`string`	ISO 4217 code, e.g., "EUR", "USD", "JPY"
Description: `EVENT_PARAM_DESCRIPTION`	`string`	A string description
Level: `EVENT_PARAM_LEVEL`	`string`	Level of a game
Max. Rating Value: `EVENT_PARAM_MAX_RATING_VALUE`	`int`	Upper bounds of a rating scale, for example 5 on a 5 star scale
Number of Items: `EVENT_PARAM_NUM_ITEMS`	`int`	Number of items
Order ID: `EVENT_PARAM_ORDER_ID`	`string`	The unique ID for all events within a subscription
Payment Info Available: `EVENT_PARAM_PAYMENT_INFO_AVAILABLE`	`1` or `0`	`1` for yes, `0` for no
Registration Method: `EVENT_PARAM_REGISTRATION_METHOD`	`string`	Facebook, Email, Twitter, etc.
Search String: `EVENT_PARAM_SEARCH_STRING`	`string`	The text string that was searched for
Success: `EVENT_PARAM_SUCCESS`	`1` or `0`	`1` for yes, `0` for no