FIREventNames.h 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418
  1. /// @file FIREventNames.h
  2. ///
  3. /// Predefined event names.
  4. ///
  5. /// An Event is an important occurrence in your app that you want to measure. You can report up to
  6. /// 500 different types of Events per app and you can associate up to 25 unique parameters with each
  7. /// Event type. Some common events are suggested below, but you may also choose to specify custom
  8. /// Event types that are associated with your specific app. Each event type is identified by a
  9. /// unique name. Event names can be up to 40 characters long, may only contain alphanumeric
  10. /// characters and underscores ("_"), and must start with an alphabetic character. The "firebase_",
  11. /// "google_", and "ga_" prefixes are reserved and should not be used.
  12. #import <Foundation/Foundation.h>
  13. /// Ad Impression event. This event signifies when a user sees an ad impression. Note: If you supply
  14. /// the @c AnalyticsParameterValue parameter, you must also supply the @c AnalyticsParameterCurrency
  15. /// parameter so that revenue metrics can be computed accurately. Params:
  16. ///
  17. /// <ul>
  18. /// <li>@c AnalyticsParameterAdPlatform (String) (optional)</li>
  19. /// <li>@c AnalyticsParameterAdFormat (String) (optional)</li>
  20. /// <li>@c AnalyticsParameterAdSource (String) (optional)</li>
  21. /// <li>@c AnalyticsParameterAdUnitName (String) (optional)</li>
  22. /// <li>@c AnalyticsParameterCurrency (String) (optional)</li>
  23. /// <li>@c AnalyticsParameterValue (Double) (optional)</li>
  24. /// </ul>
  25. static NSString *const kFIREventAdImpression NS_SWIFT_NAME(AnalyticsEventAdImpression) =
  26. @"ad_impression";
  27. /// Add Payment Info event. This event signifies that a user has submitted their payment
  28. /// information. Note: If you supply the @c AnalyticsParameterValue parameter, you must also supply
  29. /// the @c AnalyticsParameterCurrency parameter so that revenue metrics can be computed accurately.
  30. /// Params:
  31. ///
  32. /// <ul>
  33. /// <li>@c AnalyticsParameterCoupon (String) (optional)</li>
  34. /// <li>@c AnalyticsParameterCurrency (String) (optional)</li>
  35. /// <li>@c AnalyticsParameterItems ([[String: Any]]) (optional)</li>
  36. /// <li>@c AnalyticsParameterPaymentType (String) (optional)</li>
  37. /// <li>@c AnalyticsParameterValue (Double) (optional)</li>
  38. /// </ul>
  39. static NSString *const kFIREventAddPaymentInfo NS_SWIFT_NAME(AnalyticsEventAddPaymentInfo) =
  40. @"add_payment_info";
  41. /// Add Shipping Info event. This event signifies that a user has submitted their shipping
  42. /// information. Note: If you supply the @c AnalyticsParameterValue parameter, you must also supply
  43. /// the @c AnalyticsParameterCurrency parameter so that revenue metrics can be computed accurately.
  44. /// Params:
  45. ///
  46. /// <ul>
  47. /// <li>@c AnalyticsParameterCoupon (String) (optional)</li>
  48. /// <li>@c AnalyticsParameterCurrency (String) (optional)</li>
  49. /// <li>@c AnalyticsParameterItems ([[String: Any]]) (optional)</li>
  50. /// <li>@c AnalyticsParameterShippingTier (String) (optional)</li>
  51. /// <li>@c AnalyticsParameterValue (Double) (optional)</li>
  52. /// </ul>
  53. static NSString *const kFIREventAddShippingInfo NS_SWIFT_NAME(AnalyticsEventAddShippingInfo) =
  54. @"add_shipping_info";
  55. /// E-Commerce Add To Cart event. This event signifies that an item(s) was added to a cart for
  56. /// purchase. Add this event to a funnel with @c AnalyticsEventPurchase to gauge the effectiveness
  57. /// of your checkout process. Note: If you supply the @c AnalyticsParameterValue parameter, you must
  58. /// also supply the @c AnalyticsParameterCurrency parameter so that revenue metrics can be computed
  59. /// accurately. Params:
  60. ///
  61. /// <ul>
  62. /// <li>@c AnalyticsParameterCurrency (String) (optional)</li>
  63. /// <li>@c AnalyticsParameterItems ([[String: Any]]) (optional)</li>
  64. /// <li>@c AnalyticsParameterValue (Double) (optional)</li>
  65. /// </ul>
  66. static NSString *const kFIREventAddToCart NS_SWIFT_NAME(AnalyticsEventAddToCart) = @"add_to_cart";
  67. /// E-Commerce Add To Wishlist event. This event signifies that an item was added to a wishlist. Use
  68. /// this event to identify popular gift items. Note: If you supply the @c AnalyticsParameterValue
  69. /// parameter, you must also supply the @c AnalyticsParameterCurrency parameter so that revenue
  70. /// metrics can be computed accurately. Params:
  71. ///
  72. /// <ul>
  73. /// <li>@c AnalyticsParameterCurrency (String) (optional)</li>
  74. /// <li>@c AnalyticsParameterItems ([[String: Any]]) (optional)</li>
  75. /// <li>@c AnalyticsParameterValue (Double) (optional)</li>
  76. /// </ul>
  77. static NSString *const kFIREventAddToWishlist NS_SWIFT_NAME(AnalyticsEventAddToWishlist) =
  78. @"add_to_wishlist";
  79. /// App Open event. By logging this event when an App becomes active, developers can understand how
  80. /// often users leave and return during the course of a Session. Although Sessions are automatically
  81. /// reported, this event can provide further clarification around the continuous engagement of
  82. /// app-users.
  83. static NSString *const kFIREventAppOpen NS_SWIFT_NAME(AnalyticsEventAppOpen) = @"app_open";
  84. /// E-Commerce Begin Checkout event. This event signifies that a user has begun the process of
  85. /// checking out. Add this event to a funnel with your @c AnalyticsEventPurchase event to gauge the
  86. /// effectiveness of your checkout process. Note: If you supply the @c AnalyticsParameterValue
  87. /// parameter, you must also supply the @c AnalyticsParameterCurrency parameter so that revenue
  88. /// metrics can be computed accurately. Params:
  89. ///
  90. /// <ul>
  91. /// <li>@c AnalyticsParameterCoupon (String) (optional)</li>
  92. /// <li>@c AnalyticsParameterCurrency (String) (optional)</li>
  93. /// <li>@c AnalyticsParameterItems ([[String: Any]]) (optional)</li>
  94. /// <li>@c AnalyticsParameterValue (Double) (optional)</li>
  95. /// </ul>
  96. static NSString *const kFIREventBeginCheckout NS_SWIFT_NAME(AnalyticsEventBeginCheckout) =
  97. @"begin_checkout";
  98. /// Campaign Detail event. Log this event to supply the referral details of a re-engagement
  99. /// campaign. Note: you must supply at least one of the required parameters
  100. /// AnalyticsParameterSource, AnalyticsParameterMedium or AnalyticsParameterCampaign. Params:
  101. ///
  102. /// <ul>
  103. /// <li>@c AnalyticsParameterSource (String)</li>
  104. /// <li>@c AnalyticsParameterMedium (String)</li>
  105. /// <li>@c AnalyticsParameterCampaign (String)</li>
  106. /// <li>@c AnalyticsParameterTerm (String) (optional)</li>
  107. /// <li>@c AnalyticsParameterContent (String) (optional)</li>
  108. /// <li>@c AnalyticsParameterAdNetworkClickID (String) (optional)</li>
  109. /// <li>@c AnalyticsParameterCP1 (String) (optional)</li>
  110. /// <li>@c AnalyticsParameterCampaignID (String) (optional)</li>
  111. /// <li>@c AnalyticsParameterCreativeFormat (String) (optional)</li>
  112. /// <li>@c AnalyticsParameterMarketingTactic (String) (optional)</li>
  113. /// <li>@c AnalyticsParameterSourcePlatform (String) (optional)</li>
  114. /// </ul>
  115. static NSString *const kFIREventCampaignDetails NS_SWIFT_NAME(AnalyticsEventCampaignDetails) =
  116. @"campaign_details";
  117. /// Earn Virtual Currency event. This event tracks the awarding of virtual currency in your app. Log
  118. /// this along with @c AnalyticsEventSpendVirtualCurrency to better understand your virtual economy.
  119. /// Params:
  120. ///
  121. /// <ul>
  122. /// <li>@c AnalyticsParameterVirtualCurrencyName (String)</li>
  123. /// <li>@c AnalyticsParameterValue (Int or Double)</li>
  124. /// </ul>
  125. static NSString *const kFIREventEarnVirtualCurrency
  126. NS_SWIFT_NAME(AnalyticsEventEarnVirtualCurrency) = @"earn_virtual_currency";
  127. /// Generate Lead event. Log this event when a lead has been generated in the app to understand the
  128. /// efficacy of your install and re-engagement campaigns. Note: If you supply the
  129. /// @c AnalyticsParameterValue parameter, you must also supply the @c AnalyticsParameterCurrency
  130. /// parameter so that revenue metrics can be computed accurately. Params:
  131. ///
  132. /// <ul>
  133. /// <li>@c AnalyticsParameterCurrency (String) (optional)</li>
  134. /// <li>@c AnalyticsParameterValue (Double) (optional)</li>
  135. /// </ul>
  136. static NSString *const kFIREventGenerateLead NS_SWIFT_NAME(AnalyticsEventGenerateLead) =
  137. @"generate_lead";
  138. /// Join Group event. Log this event when a user joins a group such as a guild, team or family. Use
  139. /// this event to analyze how popular certain groups or social features are in your app. Params:
  140. ///
  141. /// <ul>
  142. /// <li>@c AnalyticsParameterGroupID (String)</li>
  143. /// </ul>
  144. static NSString *const kFIREventJoinGroup NS_SWIFT_NAME(AnalyticsEventJoinGroup) = @"join_group";
  145. /// Level End event. Log this event when the user finishes a level. Params:
  146. ///
  147. /// <ul>
  148. /// <li>@c AnalyticsParameterLevelName (String)</li>
  149. /// <li>@c AnalyticsParameterSuccess (String)</li>
  150. /// </ul>
  151. static NSString *const kFIREventLevelEnd NS_SWIFT_NAME(AnalyticsEventLevelEnd) = @"level_end";
  152. /// Level Start event. Log this event when the user starts a new level. Params:
  153. ///
  154. /// <ul>
  155. /// <li>@c AnalyticsParameterLevelName (String)</li>
  156. /// </ul>
  157. static NSString *const kFIREventLevelStart NS_SWIFT_NAME(AnalyticsEventLevelStart) = @"level_start";
  158. /// Level Up event. This event signifies that a player has leveled up in your gaming app. It can
  159. /// help you gauge the level distribution of your userbase and help you identify certain levels that
  160. /// are difficult to pass. Params:
  161. ///
  162. /// <ul>
  163. /// <li>@c AnalyticsParameterLevel (Int)</li>
  164. /// <li>@c AnalyticsParameterCharacter (String) (optional)</li>
  165. /// </ul>
  166. static NSString *const kFIREventLevelUp NS_SWIFT_NAME(AnalyticsEventLevelUp) = @"level_up";
  167. /// Login event. Apps with a login feature can report this event to signify that a user has logged
  168. /// in.
  169. static NSString *const kFIREventLogin NS_SWIFT_NAME(AnalyticsEventLogin) = @"login";
  170. /// Post Score event. Log this event when the user posts a score in your gaming app. This event can
  171. /// help you understand how users are actually performing in your game and it can help you correlate
  172. /// high scores with certain audiences or behaviors. Params:
  173. ///
  174. /// <ul>
  175. /// <li>@c AnalyticsParameterScore (Int)</li>
  176. /// <li>@c AnalyticsParameterLevel (Int) (optional)</li>
  177. /// <li>@c AnalyticsParameterCharacter (String) (optional)</li>
  178. /// </ul>
  179. static NSString *const kFIREventPostScore NS_SWIFT_NAME(AnalyticsEventPostScore) = @"post_score";
  180. /// E-Commerce Purchase event. This event signifies that an item(s) was purchased by a user. Note:
  181. /// This is different from the in-app purchase event, which is reported automatically for App
  182. /// Store-based apps. Note: If you supply the @c AnalyticsParameterValue parameter, you must also
  183. /// supply the @c AnalyticsParameterCurrency parameter so that revenue metrics can be computed
  184. /// accurately. Params:
  185. ///
  186. /// <ul>
  187. /// <li>@c AnalyticsParameterAffiliation (String) (optional)</li>
  188. /// <li>@c AnalyticsParameterCoupon (String) (optional)</li>
  189. /// <li>@c AnalyticsParameterCurrency (String) (optional)</li>
  190. /// <li>@c AnalyticsParameterEndDate (String) (optional)</li>
  191. /// <li>@c AnalyticsParameterItemID (String) (optional)</li>
  192. /// <li>@c AnalyticsParameterItems ([[String: Any]]) (optional)</li>
  193. /// <li>@c AnalyticsParameterShipping (Double) (optional)</li>
  194. /// <li>@c AnalyticsParameterStartDate (String) (optional)</li>
  195. /// <li>@c AnalyticsParameterTax (Double) (optional)</li>
  196. /// <li>@c AnalyticsParameterTransactionID (String) (optional)</li>
  197. /// <li>@c AnalyticsParameterValue (Double) (optional)</li>
  198. /// </ul>
  199. static NSString *const kFIREventPurchase NS_SWIFT_NAME(AnalyticsEventPurchase) = @"purchase";
  200. /// E-Commerce Refund event. This event signifies that a refund was issued. Note: If you supply the
  201. /// @c AnalyticsParameterValue parameter, you must also supply the @c AnalyticsParameterCurrency
  202. /// parameter so that revenue metrics can be computed accurately. Params:
  203. ///
  204. /// <ul>
  205. /// <li>@c AnalyticsParameterAffiliation (String) (optional)</li>
  206. /// <li>@c AnalyticsParameterCoupon (String) (optional)</li>
  207. /// <li>@c AnalyticsParameterCurrency (String) (optional)</li>
  208. /// <li>@c AnalyticsParameterItems ([[String: Any]]) (optional)</li>
  209. /// <li>@c AnalyticsParameterShipping (Double) (optional)</li>
  210. /// <li>@c AnalyticsParameterTax (Double) (optional)</li>
  211. /// <li>@c AnalyticsParameterTransactionID (String) (optional)</li>
  212. /// <li>@c AnalyticsParameterValue (Double) (optional)</li>
  213. /// </ul>
  214. static NSString *const kFIREventRefund NS_SWIFT_NAME(AnalyticsEventRefund) = @"refund";
  215. /// E-Commerce Remove from Cart event. This event signifies that an item(s) was removed from a cart.
  216. /// Note: If you supply the @c AnalyticsParameterValue parameter, you must also supply the @c
  217. /// AnalyticsParameterCurrency parameter so that revenue metrics can be computed accurately. Params:
  218. ///
  219. /// <ul>
  220. /// <li>@c AnalyticsParameterCurrency (String) (optional)</li>
  221. /// <li>@c AnalyticsParameterItems ([[String: Any]]) (optional)</li>
  222. /// <li>@c AnalyticsParameterValue (Double) (optional)</li>
  223. /// </ul>
  224. static NSString *const kFIREventRemoveFromCart NS_SWIFT_NAME(AnalyticsEventRemoveFromCart) =
  225. @"remove_from_cart";
  226. /// Screen View event. This event signifies a screen view. Use this when a screen transition occurs.
  227. /// This event can be logged irrespective of whether automatic screen tracking is enabled. Params:
  228. ///
  229. /// <ul>
  230. /// <li>@c AnalyticsParameterScreenClass (String) (optional)</li>
  231. /// <li>@c AnalyticsParameterScreenName (String) (optional)</li>
  232. /// </ul>
  233. static NSString *const kFIREventScreenView NS_SWIFT_NAME(AnalyticsEventScreenView) = @"screen_view";
  234. /// Search event. Apps that support search features can use this event to contextualize search
  235. /// operations by supplying the appropriate, corresponding parameters. This event can help you
  236. /// identify the most popular content in your app. Params:
  237. ///
  238. /// <ul>
  239. /// <li>@c AnalyticsParameterSearchTerm (String)</li>
  240. /// <li>@c AnalyticsParameterStartDate (String) (optional)</li>
  241. /// <li>@c AnalyticsParameterEndDate (String) (optional)</li>
  242. /// <li>@c AnalyticsParameterNumberOfNights (Int) (optional) for hotel bookings</li>
  243. /// <li>@c AnalyticsParameterNumberOfRooms (Int) (optional) for hotel bookings</li>
  244. /// <li>@c AnalyticsParameterNumberOfPassengers (Int) (optional) for travel bookings</li>
  245. /// <li>@c AnalyticsParameterOrigin (String) (optional)</li>
  246. /// <li>@c AnalyticsParameterDestination (String) (optional)</li>
  247. /// <li>@c AnalyticsParameterTravelClass (String) (optional) for travel bookings</li>
  248. /// </ul>
  249. static NSString *const kFIREventSearch NS_SWIFT_NAME(AnalyticsEventSearch) = @"search";
  250. /// Select Content event. This general purpose event signifies that a user has selected some content
  251. /// of a certain type in an app. The content can be any object in your app. This event can help you
  252. /// identify popular content and categories of content in your app. Params:
  253. ///
  254. /// <ul>
  255. /// <li>@c AnalyticsParameterContentType (String)</li>
  256. /// <li>@c AnalyticsParameterItemID (String)</li>
  257. /// </ul>
  258. static NSString *const kFIREventSelectContent NS_SWIFT_NAME(AnalyticsEventSelectContent) =
  259. @"select_content";
  260. /// Select Item event. This event signifies that an item was selected by a user from a list. Use the
  261. /// appropriate parameters to contextualize the event. Use this event to discover the most popular
  262. /// items selected. Params:
  263. ///
  264. /// <ul>
  265. /// <li>@c AnalyticsParameterItems ([[String: Any]]) (optional)</li>
  266. /// <li>@c AnalyticsParameterItemListID (String) (optional)</li>
  267. /// <li>@c AnalyticsParameterItemListName (String) (optional)</li>
  268. /// </ul>
  269. static NSString *const kFIREventSelectItem NS_SWIFT_NAME(AnalyticsEventSelectItem) = @"select_item";
  270. /// Select promotion event. This event signifies that a user has selected a promotion offer. Use the
  271. /// appropriate parameters to contextualize the event, such as the item(s) for which the promotion
  272. /// applies. Params:
  273. ///
  274. /// <ul>
  275. /// <li>@c AnalyticsParameterCreativeName (String) (optional)</li>
  276. /// <li>@c AnalyticsParameterCreativeSlot (String) (optional)</li>
  277. /// <li>@c AnalyticsParameterItems ([[String: Any]]) (optional)</li>
  278. /// <li>@c AnalyticsParameterLocationID (String) (optional)</li>
  279. /// <li>@c AnalyticsParameterPromotionID (String) (optional)</li>
  280. /// <li>@c AnalyticsParameterPromotionName (String) (optional)</li>
  281. /// </ul>
  282. static NSString *const kFIREventSelectPromotion NS_SWIFT_NAME(AnalyticsEventSelectPromotion) =
  283. @"select_promotion";
  284. /// Share event. Apps with social features can log the Share event to identify the most viral
  285. /// content. Params:
  286. ///
  287. /// <ul>
  288. /// <li>@c AnalyticsParameterContentType (String)</li>
  289. /// <li>@c AnalyticsParameterItemID (String)</li>
  290. /// </ul>
  291. static NSString *const kFIREventShare NS_SWIFT_NAME(AnalyticsEventShare) = @"share";
  292. /// Sign Up event. This event indicates that a user has signed up for an account in your app. The
  293. /// parameter signifies the method by which the user signed up. Use this event to understand the
  294. /// different behaviors between logged in and logged out users. Params:
  295. ///
  296. /// <ul>
  297. /// <li>@c AnalyticsParameterMethod (String)</li>
  298. /// </ul>
  299. static NSString *const kFIREventSignUp NS_SWIFT_NAME(AnalyticsEventSignUp) = @"sign_up";
  300. /// Spend Virtual Currency event. This event tracks the sale of virtual goods in your app and can
  301. /// help you identify which virtual goods are the most popular objects of purchase. Params:
  302. ///
  303. /// <ul>
  304. /// <li>@c AnalyticsParameterItemName (String)</li>
  305. /// <li>@c AnalyticsParameterVirtualCurrencyName (String)</li>
  306. /// <li>@c AnalyticsParameterValue (Int or Double)</li>
  307. /// </ul>
  308. static NSString *const kFIREventSpendVirtualCurrency
  309. NS_SWIFT_NAME(AnalyticsEventSpendVirtualCurrency) = @"spend_virtual_currency";
  310. /// Tutorial Begin event. This event signifies the start of the on-boarding process in your app. Use
  311. /// this in a funnel with @c AnalyticsEventTutorialComplete to understand how many users complete
  312. /// this process and move on to the full app experience.
  313. static NSString *const kFIREventTutorialBegin NS_SWIFT_NAME(AnalyticsEventTutorialBegin) =
  314. @"tutorial_begin";
  315. /// Tutorial End event. Use this event to signify the user's completion of your app's on-boarding
  316. /// process. Add this to a funnel with @c AnalyticsEventTutorialBegin to gauge the completion rate
  317. /// of your on-boarding process.
  318. static NSString *const kFIREventTutorialComplete NS_SWIFT_NAME(AnalyticsEventTutorialComplete) =
  319. @"tutorial_complete";
  320. /// Unlock Achievement event. Log this event when the user has unlocked an achievement in your
  321. /// game. Since achievements generally represent the breadth of a gaming experience, this event can
  322. /// help you understand how many users are experiencing all that your game has to offer. Params:
  323. ///
  324. /// <ul>
  325. /// <li>@c AnalyticsParameterAchievementID (String)</li>
  326. /// </ul>
  327. static NSString *const kFIREventUnlockAchievement NS_SWIFT_NAME(AnalyticsEventUnlockAchievement) =
  328. @"unlock_achievement";
  329. /// E-commerce View Cart event. This event signifies that a user has viewed their cart. Use this to
  330. /// analyze your purchase funnel. Note: If you supply the @c AnalyticsParameterValue parameter, you
  331. /// must also supply the @c AnalyticsParameterCurrency parameter so that revenue metrics can be
  332. /// computed accurately. Params:
  333. ///
  334. /// <ul>
  335. /// <li>@c AnalyticsParameterCurrency (String) (optional)</li>
  336. /// <li>@c AnalyticsParameterItems ([[String: Any]]) (optional)</li>
  337. /// <li>@c AnalyticsParameterValue (Double) (optional)</li>
  338. /// </ul>
  339. static NSString *const kFIREventViewCart NS_SWIFT_NAME(AnalyticsEventViewCart) = @"view_cart";
  340. /// View Item event. This event signifies that a user has viewed an item. Use the appropriate
  341. /// parameters to contextualize the event. Use this event to discover the most popular items viewed
  342. /// in your app. Note: If you supply the @c AnalyticsParameterValue parameter, you must also supply
  343. /// the @c AnalyticsParameterCurrency parameter so that revenue metrics can be computed accurately.
  344. /// Params:
  345. ///
  346. /// <ul>
  347. /// <li>@c AnalyticsParameterCurrency (String) (optional)</li>
  348. /// <li>@c AnalyticsParameterItems ([[String: Any]]) (optional)</li>
  349. /// <li>@c AnalyticsParameterValue (Double) (optional)</li>
  350. /// </ul>
  351. static NSString *const kFIREventViewItem NS_SWIFT_NAME(AnalyticsEventViewItem) = @"view_item";
  352. /// View Item List event. Log this event when a user sees a list of items or offerings. Params:
  353. ///
  354. /// <ul>
  355. /// <li>@c AnalyticsParameterItems ([[String: Any]]) (optional)</li>
  356. /// <li>@c AnalyticsParameterItemListID (String) (optional)</li>
  357. /// <li>@c AnalyticsParameterItemListName (String) (optional)</li>
  358. /// </ul>
  359. static NSString *const kFIREventViewItemList NS_SWIFT_NAME(AnalyticsEventViewItemList) =
  360. @"view_item_list";
  361. /// View Promotion event. This event signifies that a promotion was shown to a user. Add this event
  362. /// to a funnel with the @c AnalyticsEventAddToCart and @c AnalyticsEventPurchase to gauge your
  363. /// conversion process. Params:
  364. ///
  365. /// <ul>
  366. /// <li>@c AnalyticsParameterCreativeName (String) (optional)</li>
  367. /// <li>@c AnalyticsParameterCreativeSlot (String) (optional)</li>
  368. /// <li>@c AnalyticsParameterItems ([[String: Any]]) (optional)</li>
  369. /// <li>@c AnalyticsParameterLocationID (String) (optional)</li>
  370. /// <li>@c AnalyticsParameterPromotionID (String) (optional)</li>
  371. /// <li>@c AnalyticsParameterPromotionName (String) (optional)</li>
  372. /// </ul>
  373. static NSString *const kFIREventViewPromotion NS_SWIFT_NAME(AnalyticsEventViewPromotion) =
  374. @"view_promotion";
  375. /// View Search Results event. Log this event when the user has been presented with the results of a
  376. /// search. Params:
  377. ///
  378. /// <ul>
  379. /// <li>@c AnalyticsParameterSearchTerm (String)</li>
  380. /// </ul>
  381. static NSString *const kFIREventViewSearchResults NS_SWIFT_NAME(AnalyticsEventViewSearchResults) =
  382. @"view_search_results";