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,确保事件记录准确,并结合动态广告和类似受众功能,最大化投放回报。