FBSDKAppEventName 和 FBSDKAppEventParameterName 常量列表

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 种唯一事件名称。

使用方法

通过 FBSDKAppEventslogEvent 方法记录事件,可附加数值(valueToSum)和参数(parameters)。示例:

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

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

投放场景

  • IAA 优化:使用 AdImpressionAdClick 追踪广告曝光和点击,优化 eCPM 和 CTR。
  • IAP 优化:使用 PurchasedInitiatedCheckout 分析购买行为,优化 ROAS 和 LTV。
  • 用户获取:使用 CompletedRegistrationCompletedTutorial 降低 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(作为参数字典的键)。
  • 值类型:参数值通常为 NSStringNSNumber,视具体参数而定。
  • 限制:参数名称长度 2-40 字符,单事件约 25 个唯一参数,值长度约 100 字符。

使用方法

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

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

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

投放场景

  • 精准定向:使用 ContentIDContentType 优化动态广告,匹配用户兴趣。
  • 转化分析:使用 CurrencyNumItems 分析购买行为,优化 ROAS。
  • 用户行为细分:使用 SearchStringRegistrationMethod 细分用户群体,提升转化率。

使用注意事项

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

示例代码

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

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

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

结论

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

©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容