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

يمكن التواصل عبر هاتف أو رسالة SMS أو بريد إلكتروني أو دردشة أو نوع آخر من الاتصال بين العميل ونشاطك التجاري.

تخصيص المنتج: 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

يمكن زيارة محتوى الصفحة التي تهتم بها، مثل صفحة المنتج أو الصفحة المقصودة أو المقال. ويمكن تمرير المعلومات عن الصفحة التي تمت مشاهدتها إلى فيسبوك حتى يستخدمها في الإعلانات الديناميكية.

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 لنظام iOS 14

بالنسبة للأحداث التي يجمعها تطبيقك ويرسلها إلى فيسبوك، قد يتعين عليك الكشف عن أنواع هذه البيانات في الاستبيان الخاص بمنصة App Store Connect. تتحمل أنت مسؤولية ضمان توضيح ذلك في سياسة الخصوصية المتعلقة بتطبيقك. تفضل بزيارة مقالة تفاصيل الخصوصية في متجر App Store من Apple لمعرفة المزيد حول أنواع البيانات التي ستحتاج إلى الكشف عنها.

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

يمكن التواصل عبر هاتف أو رسالة SMS أو بريد إلكتروني أو دردشة أو نوع آخر من الاتصال بين العميل ونشاطك التجاري.

تخصيص المنتج: 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

يمكن زيارة محتوى الصفحة التي تهتم بها، مثل صفحة المنتج أو الصفحة المقصودة أو المقال. ويمكن تمرير المعلومات عن الصفحة التي تمت مشاهدتها إلى فيسبوك حتى يستخدمها في الإعلانات الديناميكية.

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