Meta 應用程式事件

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

在您的網站、應用程式或其他資產（例如產品搜尋、旅行搜尋等）上所執行的搜尋。

FB 幣支出：EVENT_NAME_SPENT_CREDITS

valueToSum：支出 FB 幣的總值

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

在您的網站、應用程式或其他資產（例如產品搜尋、旅行搜尋等）上所執行的搜尋。

FB 幣支出：EVENT_NAME_SPENT_CREDITS

valueToSum：支出 FB 幣的總值

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