Facebook App Events Reference

Android

Standard Events

Nom de l’évènement : valeur AppEventsConstants	Paramètres	Description
Terminer un niveau : `EVENT_NAME_ACHIEVED_LEVEL`	`LEVEL`	Le passage de certains niveaux spécifiques que vous définissez au sein de votre application, entreprise ou organisation.
Activer une app : `EVENT_NAME_ACTIVATED_APP`		Le lancement de votre app.
Cliquer sur une publicité intégrée à une application : `EVENT_NAME_AD_CLICK`	`AD_TYPE`	Lorsque quelqu’un clique sur une publicité issue d’une plate-forme tierce au sein de votre app.
Impression publicitaire intégrée à une application : `EVENT_NAME_AD_IMPRESSION`	`AD_TYPE`	Une publicité issue d’une plate-forme tierce apparaît à l’écran au sein de votre app.
Ajouter des informations de paiement : `EVENT_NAME_ADDED_PAYMENT_INFO`	`SUCCESS`	L’ajout d’informations de paiement par un client lors d’un processus de paiement.
Ajouter au panier : `EVENT_NAME_ADDED_TO_CART` valueToSum : prix de l’article ajouté	`CONTENT_TYPE`, `CONTENT_ID` ou `CONTENT` et `CURRENCY`	L’ajout d’un article à un panier d’achats. Après un clic sur le bouton Ajouter au panier dans un site web, par exemple.
Ajouter à la liste de souhaits : `EVENT_NAME_ADDED_TO_WISHLIST` valueToSum : prix de l’article ajouté	`CONTENT_TYPE`, `CONTENT_ID` ou `CONTENT` et `CURRENCY`	L’ajout d’un article à une liste de souhaits. Après un clic sur le bouton Ajouter à la liste de souhaits dans un site web, par exemple.
Finaliser une inscription : `EVENT_NAME_COMPLETED_REGISTRATION`	`REGISTRATION_METHOD`	L’envoi d’informations par un client en échange d’un service proposé par votre entreprise. Un abonnement à la réception d’e-mails, par exemple.
Terminer un didacticiel : `EVENT_NAME_COMPLETED_TUTORIAL`	`SUCCESS` et `CONTENT_ID` ou `CONTENT`	La réalisation d’un didacticiel sur votre app.
Contacter : `EVENT_NAME_CONTACT`		Un appel téléphonique, un texto, un e-mail, une discussion en direct ou tout autre type de contact entre un client et votre entreprise.
Personnaliser un produit : `EVENT_NAME_CUSTOMIZE_PRODUCT`		La personnalisation de produits à l’aide d’un outil de configuration ou de toute autre application détenue par votre entreprise.
Donner : `EVENT_NAME_DONATE`		Le don de fonds à votre organisme ou votre cause.
Trouver un lieu : `EVENT_NAME_FIND_LOCATION`		Lorsqu’une personne trouve l’un de vos sites physiques, via le web ou une app, avec l’intention de s’y rendre. Lorsqu’une personne recherche un produit et le trouve dans l’un de vos magasins proches de chez elle, par exemple.
Initier un paiement : `EVENT_NAME_INITIATED_CHECKOUT` valueToSum : prix total des articles dans le panier	`CONTENT_TYPE`, `CONTENT_ID` ou `CONTENT`,`NUM_ITEMS`, `PAYMENT_INFO_AVAILABLE` et `CURRENCY`	Le lancement d’un processus de paiement.
Acheter : `EVENT_NAME_PURCHASED` valueToSum : prix d’achat	`NUM_ITEMS`, `CONTENT_TYPE`, `CONTENT_ID` ou `CONTENT` et `CURRENCY`	La réalisation d’un achat, généralement concrétisée par la réception d’une confirmation de commande ou d’achat, ou encore d’un reçu de transaction.
Évaluer : `EVENT_NAME_RATED` valueToSum : note donnée	`CONTENT_TYPE`, `CONTENT_ID` ou `CONTENT` et `MAX_RATING_VALUE`	L’évaluation de quelque chose au sein de votre app, entreprise ou organisation. Lorsque quelqu’un attribue une note à un restaurant au sein d’une app d’évaluation de restaurants, par exemple.
Programmer : `EVENT_NAME_SCHEDULE`		La réservation d’un rendez-vous pour visiter l’un de vos sites.
Rechercher : `EVENT_NAME_SEARCHED`	`CONTENT_TYPE`, `SEARCH_STRING` et `SUCCESS`	Une recherche effectuée sur votre site web, votre app ou toute autre propriété, comme une recherche de produit, de voyage, etc.
Crédits dépensés : `EVENT_NAME_SPENT_CREDITS` valueToSum : valeur totale des crédits dépensés	`CONTENT_TYPE` et `CONTENT_ID` ou `CONTENT`	La réalisation d’une transaction dans laquelle des personnes dépensent des crédits spécifiques à votre entreprise ou à votre application, comme une monnaie en jeu, par exemple.
Commencer une période d’essai : `EVENT_NAME_START_TRIAL` valueToSum : prix de l’abonnement	`ORDER_ID` et `CURRENCY`	Le début de l’essai gratuit d’un produit ou d’un service que vous proposez, comme une inscription pour une période d’abonnement gratuit.
Soumettre une demande : `EVENT_NAME_SUBMIT_APPLICATION`		L’envoi d’une demande pour un produit, un service ou un programme que vous proposez, comme une carte de crédit, un programme d’études ou un emploi.
S’abonner : `EVENT_NAME_SUBSCRIBE` valueToSum : prix de l’abonnement	`ORDER_ID` et `CURRENCY`	Le début d’un abonnement payant à un produit ou un service que vous proposez.
Débloquer un succès : `EVENT_NAME_UNLOCKED_ACHIEVEMENT`	`DESCRIPTION`	La réalisation d’activités ou actions spécifiques que vous souhaitez récompenser au sein de votre application, entreprise ou organisation. Par exemple, parrainer un ami, finir de renseigner votre profil, etc.
Consulter un contenu : `EVENT_NAME_VIEWED_CONTENT` prix de l’article consulté (le cas échéant)	`CONTENT_TYPE`, `CONTENT_ID` ou `CONTENT` et `CURRENCY`	Une visite sur une page de contenu qui vous intéresse, comme la page d’un produit, une page de destination ou un article. Les informations sur la Page consultée peuvent être transmises à Facebook afin d’alimenter les publicités dynamiques.

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

Connexion à l’App Store pour iOS 14

Les évènements que votre application collecte et envoie à Facebook peuvent nécessiter que vous divulguiez ces types de données dans le formulaire de connexion à l’App Store. Il vous incombe de veiller à refléter cette information dans la politique de confidentialité de votre application. Consultez l’article relatif à la confidentialité des données dans l’App Store d’Apple pour en savoir plus sur les types de données que vous devrez divulguer.

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

Nom de l’évènement : valeur AppEventsConstants	Paramètres	Description
Terminer un niveau : `EVENT_NAME_ACHIEVED_LEVEL`	`LEVEL`	Le passage de certains niveaux spécifiques que vous définissez au sein de votre application, entreprise ou organisation.
Activer une app : `EVENT_NAME_ACTIVATED_APP`		Le lancement de votre app.
Cliquer sur une publicité intégrée à une application : `EVENT_NAME_AD_CLICK`	`AD_TYPE`	Lorsque quelqu’un clique sur une publicité issue d’une plate-forme tierce au sein de votre app.
Impression publicitaire intégrée à une application : `EVENT_NAME_AD_IMPRESSION`	`AD_TYPE`	Une publicité issue d’une plate-forme tierce apparaît à l’écran au sein de votre app.
Ajouter des informations de paiement : `EVENT_NAME_ADDED_PAYMENT_INFO`	`SUCCESS`	L’ajout d’informations de paiement par un client lors d’un processus de paiement.
Ajouter au panier : `EVENT_NAME_ADDED_TO_CART` valueToSum : prix de l’article ajouté	`CONTENT_TYPE`, `CONTENT_ID` ou `CONTENT` et `CURRENCY`	L’ajout d’un article à un panier d’achats. Après un clic sur le bouton Ajouter au panier dans un site web, par exemple.
Ajouter à la liste de souhaits : `EVENT_NAME_ADDED_TO_WISHLIST` valueToSum : prix de l’article ajouté	`CONTENT_TYPE`, `CONTENT_ID` ou `CONTENT` et `CURRENCY`	L’ajout d’un article à une liste de souhaits. Après un clic sur le bouton Ajouter à la liste de souhaits dans un site web, par exemple.
Finaliser une inscription : `EVENT_NAME_COMPLETED_REGISTRATION`	`REGISTRATION_METHOD`	L’envoi d’informations par un client en échange d’un service proposé par votre entreprise. Un abonnement à la réception d’e-mails, par exemple.
Terminer un didacticiel : `EVENT_NAME_COMPLETED_TUTORIAL`	`SUCCESS` et `CONTENT_ID` ou `CONTENT`	La réalisation d’un didacticiel sur votre app.
Contacter : `EVENT_NAME_CONTACT`		Un appel téléphonique, un texto, un e-mail, une discussion en direct ou tout autre type de contact entre un client et votre entreprise.
Personnaliser un produit : `EVENT_NAME_CUSTOMIZE_PRODUCT`		La personnalisation de produits à l’aide d’un outil de configuration ou de toute autre application détenue par votre entreprise.
Donner : `EVENT_NAME_DONATE`		Le don de fonds à votre organisme ou votre cause.
Trouver un lieu : `EVENT_NAME_FIND_LOCATION`		Lorsqu’une personne trouve l’un de vos sites physiques, via le web ou une app, avec l’intention de s’y rendre. Lorsqu’une personne recherche un produit et le trouve dans l’un de vos magasins proches de chez elle, par exemple.
Initier un paiement : `EVENT_NAME_INITIATED_CHECKOUT` valueToSum : prix total des articles dans le panier	`CONTENT_TYPE`, `CONTENT_ID` ou `CONTENT`,`NUM_ITEMS`, `PAYMENT_INFO_AVAILABLE` et `CURRENCY`	Le lancement d’un processus de paiement.
Acheter : `EVENT_NAME_PURCHASED` valueToSum : prix d’achat	`NUM_ITEMS`, `CONTENT_TYPE`, `CONTENT_ID` ou `CONTENT` et `CURRENCY`	La réalisation d’un achat, généralement concrétisée par la réception d’une confirmation de commande ou d’achat, ou encore d’un reçu de transaction.
Évaluer : `EVENT_NAME_RATED` valueToSum : note donnée	`CONTENT_TYPE`, `CONTENT_ID` ou `CONTENT` et `MAX_RATING_VALUE`	L’évaluation de quelque chose au sein de votre app, entreprise ou organisation. Lorsque quelqu’un attribue une note à un restaurant au sein d’une app d’évaluation de restaurants, par exemple.
Programmer : `EVENT_NAME_SCHEDULE`		La réservation d’un rendez-vous pour visiter l’un de vos sites.
Rechercher : `EVENT_NAME_SEARCHED`	`CONTENT_TYPE`, `SEARCH_STRING` et `SUCCESS`	Une recherche effectuée sur votre site web, votre app ou toute autre propriété, comme une recherche de produit, de voyage, etc.
Crédits dépensés : `EVENT_NAME_SPENT_CREDITS` valueToSum : valeur totale des crédits dépensés	`CONTENT_TYPE` et `CONTENT_ID` ou `CONTENT`	La réalisation d’une transaction dans laquelle des personnes dépensent des crédits spécifiques à votre entreprise ou à votre application, comme une monnaie en jeu, par exemple.
Commencer une période d’essai : `EVENT_NAME_START_TRIAL` valueToSum : prix de l’abonnement	`ORDER_ID` et `CURRENCY`	Le début de l’essai gratuit d’un produit ou d’un service que vous proposez, comme une inscription pour une période d’abonnement gratuit.
Soumettre une demande : `EVENT_NAME_SUBMIT_APPLICATION`		L’envoi d’une demande pour un produit, un service ou un programme que vous proposez, comme une carte de crédit, un programme d’études ou un emploi.
S’abonner : `EVENT_NAME_SUBSCRIBE` valueToSum : prix de l’abonnement	`ORDER_ID` et `CURRENCY`	Le début d’un abonnement payant à un produit ou un service que vous proposez.
Débloquer un succès : `EVENT_NAME_UNLOCKED_ACHIEVEMENT`	`DESCRIPTION`	La réalisation d’activités ou actions spécifiques que vous souhaitez récompenser au sein de votre application, entreprise ou organisation. Par exemple, parrainer un ami, finir de renseigner votre profil, etc.
Consulter un contenu : `EVENT_NAME_VIEWED_CONTENT` prix de l’article consulté (le cas échéant)	`CONTENT_TYPE`, `CONTENT_ID` ou `CONTENT` et `CURRENCY`	Une visite sur une page de contenu qui vous intéresse, comme la page d’un produit, une page de destination ou un article. Les informations sur la Page consultée peuvent être transmises à Facebook afin d’alimenter les publicités dynamiques.

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