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

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 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