Facebook App Events Reference

Android

Standard Events

Название события: AppEventsConstants Value	Параметры	Описание
Достижение уровня: `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`	Посещение важной для вас страницы с материалами (например, страницы товара, целевой страницы или статьи). Информацию о посещенной странице можно передавать в 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

App Store Connect для iOS 14

Возможно, в опроснике App Store Connect потребуется раскрыть типы данных событий, которые ваше приложение собирает и отправляет в Facebook. Убедитесь, что это отражено в политике конфиденциальности вашего приложения. Больше информации о типах данных, которые необходимо раскрыть, см. в стать с подробностями е о конфиденциальности 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 Value	Параметры	Описание
Достижение уровня: `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`	Посещение важной для вас страницы с материалами (например, страницы товара, целевой страницы или статьи). Информацию о посещенной странице можно передавать в 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