Facebook App Events Reference

Android

Standard Events

Tên sự kiện: Giá trị AppEventsConstants Thông số Mô tả

Qua bài: EVENT_NAME_ACHIEVED_LEVEL

LEVEL

Thành tích của các cấp độ cụ thể mà bạn xác định trong ứng dụng, doanh nghiệp hoặc tổ chức của mình.

Kích hoạt ứng dụng: EVENT_NAME_ACTIVATED_APP

Ra mắt ứng dụng của bạn.

Lượt click vào quảng cáo trong ứng dụng: EVENT_NAME_AD_CLICK

AD_TYPE

Một quảng cáo từ nền tảng của bên thứ ba được nhấp vào trong ứng dụng của bạn.

Lượt hiển thị quảng cáo trong ứng dụng: EVENT_NAME_AD_IMPRESSION

AD_TYPE

Một quảng cáo từ nền tảng của bên thứ ba xuất hiện trên màn hình trong ứng dụng của bạn.

Thêm thông tin thanh toán: EVENT_NAME_ADDED_PAYMENT_INFO

SUCCESS

Việc bổ sung thông tin thanh toán của khách hàng trong quá trình thanh toán.

Thêm vào giỏ hàng: EVENT_NAME_ADDED_TO_CART

valueToSum: Giá của mặt hàng đã thêm

CONTENT_TYPE, CONTENT_ID hoặc CONTENTCURRENCY

Việc thêm một mặt hàng vào giỏ hàng hoặc giỏ. Ví dụ: nhấp vào nút Thêm vào giỏ hàng trên trang web.

Thêm vào danh sách yêu thích: EVENT_NAME_ADDED_TO_WISHLIST

valueToSum: Giá của mặt hàng đã thêm

CONTENT_TYPE, CONTENT_ID hoặc CONTENTCURRENCY

Việc thêm mặt hàng vào danh sách yêu thích. Ví dụ: nhấp vào nút Thêm vào danh sách yêu thích trên trang web.

Hoàn tất đăng ký: EVENT_NAME_COMPLETED_REGISTRATION

REGISTRATION_METHOD

Một khách hàng gửi thông tin để có thể sử dụng dịch vụ do doanh nghiệp của bạn cung cấp. Ví dụ như đăng ký để nhận thông tin qua email.

Hoàn tất hướng dẫn: EVENT_NAME_COMPLETED_TUTORIAL

SUCCESSCONTENT_ID hoặc CONTENT

Hoàn tất hướng dẫn trên ứng dụng của bạn.

Liên hệ: EVENT_NAME_CONTACT

Điện thoại hoặc SMS, email, chat hoặc loại thông tin liên hệ khác giữa khách hàng và doanh nghiệp của bạn.

Tùy chỉnh sản phẩm: EVENT_NAME_CUSTOMIZE_PRODUCT

Việc tùy chỉnh các sản phẩm thông qua một công cụ cấu hình hoặc ứng dụng khác mà doanh nghiệp của bạn sở hữu.

Quyên góp: EVENT_NAME_DONATE

Việc quyên góp tiền cho tổ chức hoặc mục đích xã hội của bạn.

Tìm vị trí: EVENT_NAME_FIND_LOCATION

Khi một người tìm thấy một trong những địa điểm của bạn thông qua web hoặc ứng dụng, với ý định truy cập. Ví dụ: tìm kiếm một sản phẩm và tìm thấy sản phẩm đó tại một trong các cửa hàng địa phương của bạn.

Bắt đầu thanh toán: EVENT_NAME_INITIATED_CHECKOUT

valueToSum: Tổng giá của mặt hàng trong giỏ hàng

CONTENT_TYPE, CONTENT_ID hoặc CONTENT, NUM_ITEMS, PAYMENT_INFO_AVAILABLECURRENCY

Bắt đầu quy trình thanh toán.

Giao dịch mua hàng: EVENT_NAME_PURCHASED

valueToSum: Giá của giao dịch mua hàng

NUM_ITEMS, CONTENT_TYPE, CONTENT_ID hoặc CONTENTCURRENCY

Việc hoàn tất quá trình mua hàng, thường được biểu thị bằng việc nhận thông báo xác nhận đơn đặt hàng hoặc mua hàng hay biên lai giao dịch.

Xếp hạng: EVENT_NAME_RATED

valueToSum: Đã đưa ra xếp hạng

CONTENT_TYPE, CONTENT_ID hoặc CONTENTMAX_RATING_VALUE

Xếp hạng một mục trong ứng dụng, doanh nghiệp hoặc tổ chức của bạn. Ví dụ: xếp hạng một nhà hàng trong một ứng dụng đánh giá nhà hàng.

Lịch trình: EVENT_NAME_SCHEDULE

Việc đặt lịch hẹn ghé thăm một trong các địa điểm của bạn.

Tìm kiếm: EVENT_NAME_SEARCHED

CONTENT_TYPE, SEARCH_STRINGSUCCESS

Thao tác tìm kiếm được thực hiện trên trang web, ứng dụng hoặc tài sản khác của bạn, chẳng hạn như tìm kiếm sản phẩm, tìm kiếm đường đi, v.v.

Tín dụng đã chi tiêu: EVENT_NAME_SPENT_CREDITS

valueToSum: Tổng giá trị của tín dụng đã chi tiêu

CONTENT_TYPECONTENT_ID hoặc CONTENT

Việc hoàn thành giao dịch nơi mọi người chi tiêu tín dụng cụ thể cho doanh nghiệp hoặc ứng dụng của bạn, chẳng hạn như đơn vị tiền tệ trong ứng dụng.

Bắt đầu dùng thử: EVENT_NAME_START_TRIAL

valueToSum: Giá gói đăng ký

ORDER_IDCURRENCY

Bắt đầu dùng thử miễn phí một sản phẩm hoặc dịch vụ mà bạn cung cấp, chẳng hạn như đăng ký dùng thử.

Gửi đơn đăng ký: EVENT_NAME_SUBMIT_APPLICATION

Việc nộp đơn đăng ký cho một sản phẩm, dịch vụ hoặc chương trình bạn cung cấp, chẳng hạn như thẻ tín dụng, chương trình giáo dục hoặc công việc.

Đăng ký: EVENT_NAME_SUBSCRIBE

valueToSum: Giá gói đăng ký

ORDER_IDCURRENCY

Bắt đầu dùng gói đăng ký trả phí cho sản phẩm hoặc dịch vụ mà bạn cung cấp.

Mở khóa thành tích: EVENT_NAME_UNLOCKED_ACHIEVEMENT

DESCRIPTION

Việc hoàn thành các hoạt động hoặc hành động cụ thể mà bạn muốn tặng thưởng trong ứng dụng, doanh nghiệp hoặc tổ chức của mình. Ví dụ: giới thiệu một người bạn, hoàn thành hồ sơ của bạn, v.v.

Xem nội dung: EVENT_NAME_VIEWED_CONTENT

Giá của mặt hàng đã xem (nếu có)

CONTENT_TYPE, CONTENT_ID hoặc CONTENTCURRENCY

Truy cập vào một trang nội dung mà bạn quan tâm, chẳng hạn như trang sản phẩm, trang đích hoặc bài viết. Thông tin về trang đã xem có thể được chuyển đến Facebook để sử dụng trong quảng cáo động.

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

App Store Connect dành cho iOS 14

Có thể bạn sẽ phải tiết lộ các loại dữ liệu sự kiện mà ứng dụng của mình thu thập và gửi cho Facebook trong bảng câu hỏi App Store Connect. Bạn chịu trách nhiệm đưa thông tin này vào chính sách quyền riêng tư của ứng dụng. Hãy truy cập vào bài viết Thông tin chi tiết về quyền riêng tư của Apple App Store để tìm hiểu thêm về các loại dữ liệu mà bạn sẽ cần tiết lộ.

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

Tên sự kiện: Giá trị AppEventsConstants Thông số Mô tả

Qua bài: EVENT_NAME_ACHIEVED_LEVEL

LEVEL

Thành tích của các cấp độ cụ thể mà bạn xác định trong ứng dụng, doanh nghiệp hoặc tổ chức của mình.

Kích hoạt ứng dụng: EVENT_NAME_ACTIVATED_APP

Ra mắt ứng dụng của bạn.

Lượt click vào quảng cáo trong ứng dụng: EVENT_NAME_AD_CLICK

AD_TYPE

Một quảng cáo từ nền tảng của bên thứ ba được nhấp vào trong ứng dụng của bạn.

Lượt hiển thị quảng cáo trong ứng dụng: EVENT_NAME_AD_IMPRESSION

AD_TYPE

Một quảng cáo từ nền tảng của bên thứ ba xuất hiện trên màn hình trong ứng dụng của bạn.

Thêm thông tin thanh toán: EVENT_NAME_ADDED_PAYMENT_INFO

SUCCESS

Việc bổ sung thông tin thanh toán của khách hàng trong quá trình thanh toán.

Thêm vào giỏ hàng: EVENT_NAME_ADDED_TO_CART

valueToSum: Giá của mặt hàng đã thêm

CONTENT_TYPE, CONTENT_ID hoặc CONTENTCURRENCY

Việc thêm một mặt hàng vào giỏ hàng hoặc giỏ. Ví dụ: nhấp vào nút Thêm vào giỏ hàng trên trang web.

Thêm vào danh sách yêu thích: EVENT_NAME_ADDED_TO_WISHLIST

valueToSum: Giá của mặt hàng đã thêm

CONTENT_TYPE, CONTENT_ID hoặc CONTENTCURRENCY

Việc thêm mặt hàng vào danh sách yêu thích. Ví dụ: nhấp vào nút Thêm vào danh sách yêu thích trên trang web.

Hoàn tất đăng ký: EVENT_NAME_COMPLETED_REGISTRATION

REGISTRATION_METHOD

Một khách hàng gửi thông tin để có thể sử dụng dịch vụ do doanh nghiệp của bạn cung cấp. Ví dụ như đăng ký để nhận thông tin qua email.

Hoàn tất hướng dẫn: EVENT_NAME_COMPLETED_TUTORIAL

SUCCESSCONTENT_ID hoặc CONTENT

Hoàn tất hướng dẫn trên ứng dụng của bạn.

Liên hệ: EVENT_NAME_CONTACT

Điện thoại hoặc SMS, email, chat hoặc loại thông tin liên hệ khác giữa khách hàng và doanh nghiệp của bạn.

Tùy chỉnh sản phẩm: EVENT_NAME_CUSTOMIZE_PRODUCT

Việc tùy chỉnh các sản phẩm thông qua một công cụ cấu hình hoặc ứng dụng khác mà doanh nghiệp của bạn sở hữu.

Quyên góp: EVENT_NAME_DONATE

Việc quyên góp tiền cho tổ chức hoặc mục đích xã hội của bạn.

Tìm vị trí: EVENT_NAME_FIND_LOCATION

Khi một người tìm thấy một trong những địa điểm của bạn thông qua web hoặc ứng dụng, với ý định truy cập. Ví dụ: tìm kiếm một sản phẩm và tìm thấy sản phẩm đó tại một trong các cửa hàng địa phương của bạn.

Bắt đầu thanh toán: EVENT_NAME_INITIATED_CHECKOUT

valueToSum: Tổng giá của mặt hàng trong giỏ hàng

CONTENT_TYPE, CONTENT_ID hoặc CONTENT, NUM_ITEMS, PAYMENT_INFO_AVAILABLECURRENCY

Bắt đầu quy trình thanh toán.

Giao dịch mua hàng: EVENT_NAME_PURCHASED

valueToSum: Giá của giao dịch mua hàng

NUM_ITEMS, CONTENT_TYPE, CONTENT_ID hoặc CONTENTCURRENCY

Việc hoàn tất quá trình mua hàng, thường được biểu thị bằng việc nhận thông báo xác nhận đơn đặt hàng hoặc mua hàng hay biên lai giao dịch.

Xếp hạng: EVENT_NAME_RATED

valueToSum: Đã đưa ra xếp hạng

CONTENT_TYPE, CONTENT_ID hoặc CONTENTMAX_RATING_VALUE

Xếp hạng một mục trong ứng dụng, doanh nghiệp hoặc tổ chức của bạn. Ví dụ: xếp hạng một nhà hàng trong một ứng dụng đánh giá nhà hàng.

Lịch trình: EVENT_NAME_SCHEDULE

Việc đặt lịch hẹn ghé thăm một trong các địa điểm của bạn.

Tìm kiếm: EVENT_NAME_SEARCHED

CONTENT_TYPE, SEARCH_STRINGSUCCESS

Thao tác tìm kiếm được thực hiện trên trang web, ứng dụng hoặc tài sản khác của bạn, chẳng hạn như tìm kiếm sản phẩm, tìm kiếm đường đi, v.v.

Tín dụng đã chi tiêu: EVENT_NAME_SPENT_CREDITS

valueToSum: Tổng giá trị của tín dụng đã chi tiêu

CONTENT_TYPECONTENT_ID hoặc CONTENT

Việc hoàn thành giao dịch nơi mọi người chi tiêu tín dụng cụ thể cho doanh nghiệp hoặc ứng dụng của bạn, chẳng hạn như đơn vị tiền tệ trong ứng dụng.

Bắt đầu dùng thử: EVENT_NAME_START_TRIAL

valueToSum: Giá gói đăng ký

ORDER_IDCURRENCY

Bắt đầu dùng thử miễn phí một sản phẩm hoặc dịch vụ mà bạn cung cấp, chẳng hạn như đăng ký dùng thử.

Gửi đơn đăng ký: EVENT_NAME_SUBMIT_APPLICATION

Việc nộp đơn đăng ký cho một sản phẩm, dịch vụ hoặc chương trình bạn cung cấp, chẳng hạn như thẻ tín dụng, chương trình giáo dục hoặc công việc.

Đăng ký: EVENT_NAME_SUBSCRIBE

valueToSum: Giá gói đăng ký

ORDER_IDCURRENCY

Bắt đầu dùng gói đăng ký trả phí cho sản phẩm hoặc dịch vụ mà bạn cung cấp.

Mở khóa thành tích: EVENT_NAME_UNLOCKED_ACHIEVEMENT

DESCRIPTION

Việc hoàn thành các hoạt động hoặc hành động cụ thể mà bạn muốn tặng thưởng trong ứng dụng, doanh nghiệp hoặc tổ chức của mình. Ví dụ: giới thiệu một người bạn, hoàn thành hồ sơ của bạn, v.v.

Xem nội dung: EVENT_NAME_VIEWED_CONTENT

Giá của mặt hàng đã xem (nếu có)

CONTENT_TYPE, CONTENT_ID hoặc CONTENTCURRENCY

Truy cập vào một trang nội dung mà bạn quan tâm, chẳng hạn như trang sản phẩm, trang đích hoặc bài viết. Thông tin về trang đã xem có thể được chuyển đến Facebook để sử dụng trong quảng cáo động.

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