FBSDKAppEventName 和 FBSDKAppEventParameterName 常量列表FBSDKAppE

FBSDKAppEventName 常量

FBSDKAppEventName 是 NSString 类型的常量，表示标准事件名称，用于标识用户在应用中的关键行为。以下是常见事件列表，包含常量名称、字符串值、描述和投放场景：

常量名称	字符串值	描述	投放场景
`FBSDKAppEventNameAchievedLevel`	`fb_mobile_level_achieved`	用户在应用中达到某等级	优化游戏用户参与度，追踪进度
`FBSDKAppEventNameAddedPaymentInfo`	`fb_mobile_add_payment_info`	用户输入支付信息	优化支付转化率，分析购买意向
`FBSDKAppEventNameAddedToCart`	`fb_mobile_add_to_cart`	用户将商品加入购物车	优化电商转化漏斗，动态广告
`FBSDKAppEventNameAddedToWishlist`	`fb_mobile_add_to_wishlist`	用户将商品加入愿望清单	分析用户兴趣，精准再营销
`FBSDKAppEventNameCompletedRegistration`	`fb_mobile_complete_registration`	用户完成注册	优化用户获取成本（CPI）
`FBSDKAppEventNameCompletedTutorial`	`fb_mobile_tutorial_completion`	用户完成教程	提升新用户留存率
`FBSDKAppEventNameInitiatedCheckout`	`fb_mobile_initiated_checkout`	用户进入结账流程	优化结账转化率
`FBSDKAppEventNamePurchased`	`fb_mobile_purchase`	用户完成交易	优化 ROAS 和 LTV
`FBSDKAppEventNameRated`	`fb_mobile_rate`	用户对项目评分	分析用户满意度
`FBSDKAppEventNameSearched`	`fb_mobile_search`	用户执行搜索	优化搜索相关广告
`FBSDKAppEventNameSpentCredits`	`fb_mobile_spent_credits`	用户消耗应用内货币	优化虚拟货币消费
`FBSDKAppEventNameUnlockedAchievement`	`fb_mobile_achievement_unlocked`	用户解锁成就	提升游戏用户粘性
`FBSDKAppEventNameViewedContent`	`fb_mobile_content_view`	用户查看内容	优化内容推荐广告
`FBSDKAppEventNameContact`	`fb_mobile_contact`	用户与商家联系	优化客户服务转化
`FBSDKAppEventNameCustomizeProduct`	`fb_mobile_customize_product`	用户定制产品	分析个性化需求
`FBSDKAppEventNameDonate`	`fb_mobile_donate`	用户捐款	优化公益活动参与
`FBSDKAppEventNameFindLocation`	`fb_mobile_find_location`	用户查找地点	优化本地化广告
`FBSDKAppEventNameSchedule`	`fb_mobile_schedule`	用户预约	优化服务类转化
`FBSDKAppEventNameStartTrial`	`fb_mobile_start_trial`	用户开始免费试用	优化试用转化率
`FBSDKAppEventNameSubmitApplication`	`fb_mobile_submit_application`	用户提交申请	优化申请流程
`FBSDKAppEventNameSubscribe`	`fb_mobile_subscribe`	用户开始付费订阅	优化订阅收入
`FBSDKAppEventNameAdImpression`	`fb_mobile_ad_impression`	用户查看广告	优化广告曝光
`FBSDKAppEventNameAdClick`	`fb_mobile_ad_click`	用户点击广告	优化广告点击率

类型

类型：NSString。
限制：事件名称长度 2-40 字符，仅限字母、数字、下划线、连字符或空格；应用总计约 1000 种唯一事件名称。

使用方法

通过 FBSDKAppEvents 的 logEvent 方法记录事件，可附加数值（valueToSum）和参数（parameters）。示例：

[FBSDKAppEvents logEvent:FBSDKAppEventNameAddedToCart
              valueToSum:@29.99
              parameters:@{FBSDKAppEventParameterNameContentID : @"item456",
                           FBSDKAppEventParameterNameContentType : @"product"}];

此代码记录用户将价值 29.99 的商品加入购物车，包含商品 ID 和类型，适用于动态广告优化。

投放场景

IAA 优化：使用 AdImpression 和 AdClick 追踪广告曝光和点击，优化 eCPM 和 CTR。
IAP 优化：使用 Purchased 和 InitiatedCheckout 分析购买行为，优化 ROAS 和 LTV。
用户获取：使用 CompletedRegistration 和 CompletedTutorial 降低 CPI，提升留存率。

FBSDKAppEventParameterName 常量

FBSDKAppEventParameterName 是 NSString 类型的常量，作为事件参数的键，提供事件上下文。以下是常见参数列表：

常量名称	字符串值	描述	适用事件	值类型
`FBSDKAppEventParameterNameCurrency`	`fb_currency`	交易货币（如 "USD"）	Purchased, AddedToCart	NSString
`FBSDKAppEventParameterNameRegistrationMethod`	`fb_registration_method`	注册方式（如 "email"）	CompletedRegistration	NSString
`FBSDKAppEventParameterNameContentType`	`fb_content_type`	内容类型（如 "product"）	ViewedContent, AddedToCart	NSString
`FBSDKAppEventParameterNameContent`	`fb_content`	内容详情（如 JSON 字符串）	ViewedContent	NSString
`FBSDKAppEventParameterNameContentID`	`fb_content_id`	内容或商品 ID	Purchased, AddedToCart	NSString
`FBSDKAppEventParameterNameSearchString`	`fb_search_string`	搜索关键词	Searched	NSString
`FBSDKAppEventParameterNameSuccess`	`fb_success`	动作是否成功（0 或 1）	Multiple	NSNumber
`FBSDKAppEventParameterNameMaxRatingValue`	`fb_max_rating_value`	最大评分值	Rated	NSNumber
`FBSDKAppEventParameterNamePaymentInfoAvailable`	`fb_payment_info_available`	支付信息是否可用（0 或 1）	AddedPaymentInfo	NSNumber
`FBSDKAppEventParameterNameNumItems`	`fb_num_items`	商品数量	InitiatedCheckout	NSNumber
`FBSDKAppEventParameterNameLevel`	`fb_level`	达到的等级	AchievedLevel	NSString
`FBSDKAppEventParameterNameDescription`	`fb_description`	事件描述	Multiple	NSString
`FBSDKAppEventParameterNameLaunchSource`	`fb_mobile_launch_source`	应用启动来源	Multiple	NSString
`FBSDKAppEventParameterNameAdType`	`ad_type`	广告类型	AdImpression, AdClick	NSString
`FBSDKAppEventParameterNameOrderID`	`fb_order_id`	订单 ID	Purchased	NSString

类型

类型：NSString（作为参数字典的键）。
值类型：参数值通常为 NSString 或 NSNumber，视具体参数而定。
限制：参数名称长度 2-40 字符，单事件约 25 个唯一参数，值长度约 100 字符。

使用方法

参数作为键值对传递给 logEvent 方法的 parameters 参数，示例：

[FBSDKAppEvents logEvent:FBSDKAppEventNameSearched
              parameters:@{FBSDKAppEventParameterNameSearchString : @"blue shoes",
                           FBSDKAppEventParameterNameSuccess : @1}];

此代码记录用户搜索“blue shoes”且成功的事件，适用于优化搜索相关广告。

投放场景

精准定向：使用 ContentID 和 ContentType 优化动态广告，匹配用户兴趣。
转化分析：使用 Currency 和 NumItems 分析购买行为，优化 ROAS。
用户行为细分：使用 SearchString 和 RegistrationMethod 细分用户群体，提升转化率。

使用注意事项

命名规范：事件和参数名称需符合 Facebook 限制，避免使用非法字符或超长名称。
隐私合规：参数值（如 ContentID）不得包含敏感用户数据，需加密并获取用户同意，符合 GDPR 和 CCPA。
标准事件优先：使用标准事件（如 logPurchase）而非自定义事件，确保与广告系统兼容。
参数匹配：选择与事件相关的参数，如 Purchased 搭配 Currency 和 ContentID，提升分析精度。
测试与验证：在 Events Manager 中验证事件和参数是否正确记录，优化投放效果。

示例代码

以下是综合示例，展示如何记录购买事件：

[FBSDKAppEvents logEvent:FBSDKAppEventNamePurchased
              valueToSum:@49.99
              parameters:@{FBSDKAppEventParameterNameCurrency : @"USD",
                           FBSDKAppEventParameterNameContentID : @"item789",
                           FBSDKAppEventParameterNameNumItems : @2,
                           FBSDKAppEventParameterNameOrderID : @"order123"}];

此代码记录用户购买了 2 件总价 49.99 美元的商品，订单 ID 为 order123，适用于优化 IAP 投放。

结论

FBSDKAppEventName 和 FBSDKAppEventParameterName 常量为 IAA 和 IAP 投放提供了强大的数据支持。通过合理使用标准事件和参数，可优化 CPI、ROAS 和 LTV，提升广告效果。建议定期检查 Events Manager，确保事件记录准确，并结合动态广告和类似受众功能，最大化投放回报。