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`	在网站、应用或其他平台上进行的搜索，例如产品搜索、旅行搜索等。
花费点数：`EVENT_NAME_SPENT_CREDITS` valueToSum：花费的点数总值	`CONTENT_TYPE` 和 `CONTENT_ID` 或 `CONTENT`	用户在完成交易时花费您公司或应用程序专用的点数，例如应用内货币。
开始试用：`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`	在网站、应用或其他平台上进行的搜索，例如产品搜索、旅行搜索等。
花费点数：`EVENT_NAME_SPENT_CREDITS` valueToSum：花费的点数总值	`CONTENT_TYPE` 和 `CONTENT_ID` 或 `CONTENT`	用户在完成交易时花费您公司或应用程序专用的点数，例如应用内货币。
开始试用：`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