| commit | author | age | ||
| a6c014 | 1 | /// @file FIRParameterNames.h |
| L | 2 | /// |
| 3 | /// Predefined event parameter names. | |
| 4 | /// | |
| 5 | /// Params supply information that contextualize Events. You can associate up to 25 unique Params | |
| 6 | /// with each Event type. Some Params are suggested below for certain common Events, but you are | |
| 7 | /// not limited to these. You may supply extra Params for suggested Events or custom Params for | |
| 8 | /// Custom events. Param names can be up to 40 characters long, may only contain alphanumeric | |
| 9 | /// characters and underscores ("_"), and must start with an alphabetic character. Param values can | |
| 10 | /// be up to 100 characters long. The "firebase_", "google_", and "ga_" prefixes are reserved and | |
| 11 | /// should not be used. | |
| 12 | ||
| 13 | #import <Foundation/Foundation.h> | |
| 14 | ||
| 15 | /// Game achievement ID (NSString). | |
| 16 | /// <pre> | |
| 17 | /// NSDictionary *params = @{ | |
| 18 | /// kFIRParameterAchievementID : @"10_matches_won", | |
| 19 | /// // ... | |
| 20 | /// }; | |
| 21 | /// </pre> | |
| 22 | static NSString *const kFIRParameterAchievementID NS_SWIFT_NAME(AnalyticsParameterAchievementID) = | |
| 23 | @"achievement_id"; | |
| 24 | ||
| 25 | /// Ad Network Click ID (NSString). Used for network-specific click IDs which vary in format. | |
| 26 | /// <pre> | |
| 27 | /// NSDictionary *params = @{ | |
| 28 | /// kFIRParameterAdNetworkClickID : @"1234567", | |
| 29 | /// // ... | |
| 30 | /// }; | |
| 31 | /// </pre> | |
| 32 | static NSString *const kFIRParameterAdNetworkClickID | |
| 33 | NS_SWIFT_NAME(AnalyticsParameterAdNetworkClickID) = @"aclid"; | |
| 34 | ||
| 35 | /// A product affiliation to designate a supplying company or brick and mortar store location | |
| 36 | /// (NSString). <pre> | |
| 37 | /// NSDictionary *params = @{ | |
| 38 | /// kFIRParameterAffiliation : @"Google Store", | |
| 39 | /// // ... | |
| 40 | /// }; | |
| 41 | /// </pre> | |
| 42 | static NSString *const kFIRParameterAffiliation NS_SWIFT_NAME(AnalyticsParameterAffiliation) = | |
| 43 | @"affiliation"; | |
| 44 | ||
| 45 | /// The individual campaign name, slogan, promo code, etc. Some networks have pre-defined macro to | |
| 46 | /// capture campaign information, otherwise can be populated by developer. Highly Recommended | |
| 47 | /// (NSString). | |
| 48 | /// <pre> | |
| 49 | /// NSDictionary *params = @{ | |
| 50 | /// kFIRParameterCampaign : @"winter_promotion", | |
| 51 | /// // ... | |
| 52 | /// }; | |
| 53 | /// </pre> | |
| 54 | static NSString *const kFIRParameterCampaign NS_SWIFT_NAME(AnalyticsParameterCampaign) = | |
| 55 | @"campaign"; | |
| 56 | ||
| 57 | /// Character used in game (NSString). | |
| 58 | /// <pre> | |
| 59 | /// NSDictionary *params = @{ | |
| 60 | /// kFIRParameterCharacter : @"beat_boss", | |
| 61 | /// // ... | |
| 62 | /// }; | |
| 63 | /// </pre> | |
| 64 | static NSString *const kFIRParameterCharacter NS_SWIFT_NAME(AnalyticsParameterCharacter) = | |
| 65 | @"character"; | |
| 66 | ||
| 67 | /// The checkout step (1..N) (unsigned 64-bit integer as NSNumber). | |
| 68 | /// <pre> | |
| 69 | /// NSDictionary *params = @{ | |
| 70 | /// kFIRParameterCheckoutStep : @"1", | |
| 71 | /// // ... | |
| 72 | /// }; | |
| 73 | /// </pre> | |
| 74 | /// <b>This constant has been deprecated.</b> | |
| 75 | static NSString *const kFIRParameterCheckoutStep NS_SWIFT_NAME(AnalyticsParameterCheckoutStep) = | |
| 76 | @"checkout_step"; | |
| 77 | ||
| 78 | /// Some option on a step in an ecommerce flow (NSString). | |
| 79 | /// <pre> | |
| 80 | /// NSDictionary *params = @{ | |
| 81 | /// kFIRParameterCheckoutOption : @"Visa", | |
| 82 | /// // ... | |
| 83 | /// }; | |
| 84 | /// </pre> | |
| 85 | /// <b>This constant has been deprecated.</b> | |
| 86 | static NSString *const kFIRParameterCheckoutOption | |
| 87 | NS_SWIFT_NAME(AnalyticsParameterCheckoutOption) = @"checkout_option"; | |
| 88 | ||
| 89 | /// Campaign content (NSString). | |
| 90 | static NSString *const kFIRParameterContent NS_SWIFT_NAME(AnalyticsParameterContent) = @"content"; | |
| 91 | ||
| 92 | /// Type of content selected (NSString). | |
| 93 | /// <pre> | |
| 94 | /// NSDictionary *params = @{ | |
| 95 | /// kFIRParameterContentType : @"news article", | |
| 96 | /// // ... | |
| 97 | /// }; | |
| 98 | /// </pre> | |
| 99 | static NSString *const kFIRParameterContentType NS_SWIFT_NAME(AnalyticsParameterContentType) = | |
| 100 | @"content_type"; | |
| 101 | ||
| 102 | /// Coupon code used for a purchase (NSString). | |
| 103 | /// <pre> | |
| 104 | /// NSDictionary *params = @{ | |
| 105 | /// kFIRParameterCoupon : @"SUMMER_FUN", | |
| 106 | /// // ... | |
| 107 | /// }; | |
| 108 | /// </pre> | |
| 109 | static NSString *const kFIRParameterCoupon NS_SWIFT_NAME(AnalyticsParameterCoupon) = @"coupon"; | |
| 110 | ||
| 111 | /// Campaign custom parameter (NSString). Used as a method of capturing custom data in a campaign. | |
| 112 | /// Use varies by network. | |
| 113 | /// <pre> | |
| 114 | /// NSDictionary *params = @{ | |
| 115 | /// kFIRParameterCP1 : @"custom_data", | |
| 116 | /// // ... | |
| 117 | /// }; | |
| 118 | /// </pre> | |
| 119 | static NSString *const kFIRParameterCP1 NS_SWIFT_NAME(AnalyticsParameterCP1) = @"cp1"; | |
| 120 | ||
| 121 | /// The name of a creative used in a promotional spot (NSString). | |
| 122 | /// <pre> | |
| 123 | /// NSDictionary *params = @{ | |
| 124 | /// kFIRParameterCreativeName : @"Summer Sale", | |
| 125 | /// // ... | |
| 126 | /// }; | |
| 127 | /// </pre> | |
| 128 | static NSString *const kFIRParameterCreativeName NS_SWIFT_NAME(AnalyticsParameterCreativeName) = | |
| 129 | @"creative_name"; | |
| 130 | ||
| 131 | /// The name of a creative slot (NSString). | |
| 132 | /// <pre> | |
| 133 | /// NSDictionary *params = @{ | |
| 134 | /// kFIRParameterCreativeSlot : @"summer_banner2", | |
| 135 | /// // ... | |
| 136 | /// }; | |
| 137 | /// </pre> | |
| 138 | static NSString *const kFIRParameterCreativeSlot NS_SWIFT_NAME(AnalyticsParameterCreativeSlot) = | |
| 139 | @"creative_slot"; | |
| 140 | ||
| 141 | /// Currency of the purchase or items associated with the event, in 3-letter | |
| 142 | /// <a href="http://en.wikipedia.org/wiki/ISO_4217#Active_codes"> ISO_4217</a> format (NSString). | |
| 143 | /// <pre> | |
| 144 | /// NSDictionary *params = @{ | |
| 145 | /// kFIRParameterCurrency : @"USD", | |
| 146 | /// // ... | |
| 147 | /// }; | |
| 148 | /// </pre> | |
| 149 | static NSString *const kFIRParameterCurrency NS_SWIFT_NAME(AnalyticsParameterCurrency) = | |
| 150 | @"currency"; | |
| 151 | ||
| 152 | /// Flight or Travel destination (NSString). | |
| 153 | /// <pre> | |
| 154 | /// NSDictionary *params = @{ | |
| 155 | /// kFIRParameterDestination : @"Mountain View, CA", | |
| 156 | /// // ... | |
| 157 | /// }; | |
| 158 | /// </pre> | |
| 159 | static NSString *const kFIRParameterDestination NS_SWIFT_NAME(AnalyticsParameterDestination) = | |
| 160 | @"destination"; | |
| 161 | ||
| 162 | /// The arrival date, check-out date or rental end date for the item. This should be in | |
| 163 | /// YYYY-MM-DD format (NSString). | |
| 164 | /// <pre> | |
| 165 | /// NSDictionary *params = @{ | |
| 166 | /// kFIRParameterEndDate : @"2015-09-14", | |
| 167 | /// // ... | |
| 168 | /// }; | |
| 169 | /// </pre> | |
| 170 | static NSString *const kFIRParameterEndDate NS_SWIFT_NAME(AnalyticsParameterEndDate) = @"end_date"; | |
| 171 | ||
| 172 | /// Flight number for travel events (NSString). | |
| 173 | /// <pre> | |
| 174 | /// NSDictionary *params = @{ | |
| 175 | /// kFIRParameterFlightNumber : @"ZZ800", | |
| 176 | /// // ... | |
| 177 | /// }; | |
| 178 | /// </pre> | |
| 179 | static NSString *const kFIRParameterFlightNumber NS_SWIFT_NAME(AnalyticsParameterFlightNumber) = | |
| 180 | @"flight_number"; | |
| 181 | ||
| 182 | /// Group/clan/guild ID (NSString). | |
| 183 | /// <pre> | |
| 184 | /// NSDictionary *params = @{ | |
| 185 | /// kFIRParameterGroupID : @"g1", | |
| 186 | /// // ... | |
| 187 | /// }; | |
| 188 | /// </pre> | |
| 189 | static NSString *const kFIRParameterGroupID NS_SWIFT_NAME(AnalyticsParameterGroupID) = @"group_id"; | |
| 190 | ||
| 191 | /// The index of the item in a list (signed 64-bit integer as NSNumber). | |
| 192 | /// <pre> | |
| 193 | /// NSDictionary *params = @{ | |
| 194 | /// kFIRParameterIndex : @(5), | |
| 195 | /// // ... | |
| 196 | /// }; | |
| 197 | /// </pre> | |
| 198 | static NSString *const kFIRParameterIndex NS_SWIFT_NAME(AnalyticsParameterIndex) = @"index"; | |
| 199 | ||
| 200 | /// Item brand (NSString). | |
| 201 | /// <pre> | |
| 202 | /// NSDictionary *params = @{ | |
| 203 | /// kFIRParameterItemBrand : @"Google", | |
| 204 | /// // ... | |
| 205 | /// }; | |
| 206 | /// </pre> | |
| 207 | static NSString *const kFIRParameterItemBrand NS_SWIFT_NAME(AnalyticsParameterItemBrand) = | |
| 208 | @"item_brand"; | |
| 209 | ||
| 210 | /// Item category (context-specific) (NSString). | |
| 211 | /// <pre> | |
| 212 | /// NSDictionary *params = @{ | |
| 213 | /// kFIRParameterItemCategory : @"pants", | |
| 214 | /// // ... | |
| 215 | /// }; | |
| 216 | /// </pre> | |
| 217 | static NSString *const kFIRParameterItemCategory NS_SWIFT_NAME(AnalyticsParameterItemCategory) = | |
| 218 | @"item_category"; | |
| 219 | ||
| 220 | /// Item ID (context-specific) (NSString). | |
| 221 | /// <pre> | |
| 222 | /// NSDictionary *params = @{ | |
| 223 | /// kFIRParameterItemID : @"SKU_12345", | |
| 224 | /// // ... | |
| 225 | /// }; | |
| 226 | /// </pre> | |
| 227 | static NSString *const kFIRParameterItemID NS_SWIFT_NAME(AnalyticsParameterItemID) = @"item_id"; | |
| 228 | ||
| 229 | /// The Google <a href="https://developers.google.com/places/place-id">Place ID</a> (NSString) that | |
| 230 | /// corresponds to the associated item. Alternatively, you can supply your own custom Location ID. | |
| 231 | /// <pre> | |
| 232 | /// NSDictionary *params = @{ | |
| 233 | /// kFIRParameterItemLocationID : @"ChIJiyj437sx3YAR9kUWC8QkLzQ", | |
| 234 | /// // ... | |
| 235 | /// }; | |
| 236 | /// </pre> | |
| 237 | /// <b>This constant has been deprecated. Use @c kFIRParameterLocationID constant instead.</b> | |
| 238 | static NSString *const kFIRParameterItemLocationID | |
| 239 | NS_SWIFT_NAME(AnalyticsParameterItemLocationID) = @"item_location_id"; | |
| 240 | ||
| 241 | /// Item Name (context-specific) (NSString). | |
| 242 | /// <pre> | |
| 243 | /// NSDictionary *params = @{ | |
| 244 | /// kFIRParameterItemName : @"jeggings", | |
| 245 | /// // ... | |
| 246 | /// }; | |
| 247 | /// </pre> | |
| 248 | static NSString *const kFIRParameterItemName NS_SWIFT_NAME(AnalyticsParameterItemName) = | |
| 249 | @"item_name"; | |
| 250 | ||
| 251 | /// The list in which the item was presented to the user (NSString). | |
| 252 | /// <pre> | |
| 253 | /// NSDictionary *params = @{ | |
| 254 | /// kFIRParameterItemList : @"Search Results", | |
| 255 | /// // ... | |
| 256 | /// }; | |
| 257 | /// </pre> | |
| 258 | /// <b>This constant has been deprecated. Use @c kFIRParameterItemListName constant instead.</b> | |
| 259 | static NSString *const kFIRParameterItemList NS_SWIFT_NAME(AnalyticsParameterItemList) = | |
| 260 | @"item_list"; | |
| 261 | ||
| 262 | /// Item variant (NSString). | |
| 263 | /// <pre> | |
| 264 | /// NSDictionary *params = @{ | |
| 265 | /// kFIRParameterItemVariant : @"Black", | |
| 266 | /// // ... | |
| 267 | /// }; | |
| 268 | /// </pre> | |
| 269 | static NSString *const kFIRParameterItemVariant NS_SWIFT_NAME(AnalyticsParameterItemVariant) = | |
| 270 | @"item_variant"; | |
| 271 | ||
| 272 | /// Level in game (signed 64-bit integer as NSNumber). | |
| 273 | /// <pre> | |
| 274 | /// NSDictionary *params = @{ | |
| 275 | /// kFIRParameterLevel : @(42), | |
| 276 | /// // ... | |
| 277 | /// }; | |
| 278 | /// </pre> | |
| 279 | static NSString *const kFIRParameterLevel NS_SWIFT_NAME(AnalyticsParameterLevel) = @"level"; | |
| 280 | ||
| 281 | /// Location (NSString). The Google <a href="https://developers.google.com/places/place-id">Place ID | |
| 282 | /// </a> that corresponds to the associated event. Alternatively, you can supply your own custom | |
| 283 | /// Location ID. | |
| 284 | /// <pre> | |
| 285 | /// NSDictionary *params = @{ | |
| 286 | /// kFIRParameterLocation : @"ChIJiyj437sx3YAR9kUWC8QkLzQ", | |
| 287 | /// // ... | |
| 288 | /// }; | |
| 289 | /// </pre> | |
| 290 | static NSString *const kFIRParameterLocation NS_SWIFT_NAME(AnalyticsParameterLocation) = | |
| 291 | @"location"; | |
| 292 | ||
| 293 | /// The advertising or marketing medium, for example: cpc, banner, email, push. Highly recommended | |
| 294 | /// (NSString). | |
| 295 | /// <pre> | |
| 296 | /// NSDictionary *params = @{ | |
| 297 | /// kFIRParameterMedium : @"email", | |
| 298 | /// // ... | |
| 299 | /// }; | |
| 300 | /// </pre> | |
| 301 | static NSString *const kFIRParameterMedium NS_SWIFT_NAME(AnalyticsParameterMedium) = @"medium"; | |
| 302 | ||
| 303 | /// Number of nights staying at hotel (signed 64-bit integer as NSNumber). | |
| 304 | /// <pre> | |
| 305 | /// NSDictionary *params = @{ | |
| 306 | /// kFIRParameterNumberOfNights : @(3), | |
| 307 | /// // ... | |
| 308 | /// }; | |
| 309 | /// </pre> | |
| 310 | static NSString *const kFIRParameterNumberOfNights | |
| 311 | NS_SWIFT_NAME(AnalyticsParameterNumberOfNights) = @"number_of_nights"; | |
| 312 | ||
| 313 | /// Number of passengers traveling (signed 64-bit integer as NSNumber). | |
| 314 | /// <pre> | |
| 315 | /// NSDictionary *params = @{ | |
| 316 | /// kFIRParameterNumberOfPassengers : @(11), | |
| 317 | /// // ... | |
| 318 | /// }; | |
| 319 | /// </pre> | |
| 320 | static NSString *const kFIRParameterNumberOfPassengers | |
| 321 | NS_SWIFT_NAME(AnalyticsParameterNumberOfPassengers) = @"number_of_passengers"; | |
| 322 | ||
| 323 | /// Number of rooms for travel events (signed 64-bit integer as NSNumber). | |
| 324 | /// <pre> | |
| 325 | /// NSDictionary *params = @{ | |
| 326 | /// kFIRParameterNumberOfRooms : @(2), | |
| 327 | /// // ... | |
| 328 | /// }; | |
| 329 | /// </pre> | |
| 330 | static NSString *const kFIRParameterNumberOfRooms NS_SWIFT_NAME(AnalyticsParameterNumberOfRooms) = | |
| 331 | @"number_of_rooms"; | |
| 332 | ||
| 333 | /// Flight or Travel origin (NSString). | |
| 334 | /// <pre> | |
| 335 | /// NSDictionary *params = @{ | |
| 336 | /// kFIRParameterOrigin : @"Mountain View, CA", | |
| 337 | /// // ... | |
| 338 | /// }; | |
| 339 | /// </pre> | |
| 340 | static NSString *const kFIRParameterOrigin NS_SWIFT_NAME(AnalyticsParameterOrigin) = @"origin"; | |
| 341 | ||
| 342 | /// Purchase price (double as NSNumber). | |
| 343 | /// <pre> | |
| 344 | /// NSDictionary *params = @{ | |
| 345 | /// kFIRParameterPrice : @(1.0), | |
| 346 | /// kFIRParameterCurrency : @"USD", // e.g. $1.00 USD | |
| 347 | /// // ... | |
| 348 | /// }; | |
| 349 | /// </pre> | |
| 350 | static NSString *const kFIRParameterPrice NS_SWIFT_NAME(AnalyticsParameterPrice) = @"price"; | |
| 351 | ||
| 352 | /// Purchase quantity (signed 64-bit integer as NSNumber). | |
| 353 | /// <pre> | |
| 354 | /// NSDictionary *params = @{ | |
| 355 | /// kFIRParameterQuantity : @(1), | |
| 356 | /// // ... | |
| 357 | /// }; | |
| 358 | /// </pre> | |
| 359 | static NSString *const kFIRParameterQuantity NS_SWIFT_NAME(AnalyticsParameterQuantity) = | |
| 360 | @"quantity"; | |
| 361 | ||
| 362 | /// Score in game (signed 64-bit integer as NSNumber). | |
| 363 | /// <pre> | |
| 364 | /// NSDictionary *params = @{ | |
| 365 | /// kFIRParameterScore : @(4200), | |
| 366 | /// // ... | |
| 367 | /// }; | |
| 368 | /// </pre> | |
| 369 | static NSString *const kFIRParameterScore NS_SWIFT_NAME(AnalyticsParameterScore) = @"score"; | |
| 370 | ||
| 371 | /// Current screen class, such as the class name of the UIViewController, logged with screen_view | |
| 372 | /// event and added to every event (NSString). <pre> | |
| 373 | /// NSDictionary *params = @{ | |
| 374 | /// kFIRParameterScreenClass : @"LoginViewController", | |
| 375 | /// // ... | |
| 376 | /// }; | |
| 377 | /// </pre> | |
| 378 | static NSString *const kFIRParameterScreenClass NS_SWIFT_NAME(AnalyticsParameterScreenClass) = | |
| 379 | @"screen_class"; | |
| 380 | ||
| 381 | /// Current screen name, such as the name of the UIViewController, logged with screen_view event and | |
| 382 | /// added to every event (NSString). <pre> | |
| 383 | /// NSDictionary *params = @{ | |
| 384 | /// kFIRParameterScreenName : @"LoginView", | |
| 385 | /// // ... | |
| 386 | /// }; | |
| 387 | /// </pre> | |
| 388 | static NSString *const kFIRParameterScreenName NS_SWIFT_NAME(AnalyticsParameterScreenName) = | |
| 389 | @"screen_name"; | |
| 390 | ||
| 391 | /// The search string/keywords used (NSString). | |
| 392 | /// <pre> | |
| 393 | /// NSDictionary *params = @{ | |
| 394 | /// kFIRParameterSearchTerm : @"periodic table", | |
| 395 | /// // ... | |
| 396 | /// }; | |
| 397 | /// </pre> | |
| 398 | static NSString *const kFIRParameterSearchTerm NS_SWIFT_NAME(AnalyticsParameterSearchTerm) = | |
| 399 | @"search_term"; | |
| 400 | ||
| 401 | /// Shipping cost associated with a transaction (double as NSNumber). | |
| 402 | /// <pre> | |
| 403 | /// NSDictionary *params = @{ | |
| 404 | /// kFIRParameterShipping : @(5.99), | |
| 405 | /// kFIRParameterCurrency : @"USD", // e.g. $5.99 USD | |
| 406 | /// // ... | |
| 407 | /// }; | |
| 408 | /// </pre> | |
| 409 | static NSString *const kFIRParameterShipping NS_SWIFT_NAME(AnalyticsParameterShipping) = | |
| 410 | @"shipping"; | |
| 411 | ||
| 412 | /// Sign up method (NSString). | |
| 413 | /// <pre> | |
| 414 | /// NSDictionary *params = @{ | |
| 415 | /// kFIRParameterSignUpMethod : @"google", | |
| 416 | /// // ... | |
| 417 | /// }; | |
| 418 | /// </pre> | |
| 419 | /// | |
| 420 | /// <b>This constant has been deprecated. Use Method constant instead.</b> | |
| 421 | static NSString *const kFIRParameterSignUpMethod NS_SWIFT_NAME(AnalyticsParameterSignUpMethod) = | |
| 422 | @"sign_up_method"; | |
| 423 | ||
| 424 | /// A particular approach used in an operation; for example, "facebook" or "email" in the context | |
| 425 | /// of a sign_up or login event. (NSString). | |
| 426 | /// <pre> | |
| 427 | /// NSDictionary *params = @{ | |
| 428 | /// kFIRParameterMethod : @"google", | |
| 429 | /// // ... | |
| 430 | /// }; | |
| 431 | /// </pre> | |
| 432 | static NSString *const kFIRParameterMethod NS_SWIFT_NAME(AnalyticsParameterMethod) = @"method"; | |
| 433 | ||
| 434 | /// The origin of your traffic, such as an Ad network (for example, google) or partner (urban | |
| 435 | /// airship). Identify the advertiser, site, publication, etc. that is sending traffic to your | |
| 436 | /// property. Highly recommended (NSString). | |
| 437 | /// <pre> | |
| 438 | /// NSDictionary *params = @{ | |
| 439 | /// kFIRParameterSource : @"InMobi", | |
| 440 | /// // ... | |
| 441 | /// }; | |
| 442 | /// </pre> | |
| 443 | static NSString *const kFIRParameterSource NS_SWIFT_NAME(AnalyticsParameterSource) = @"source"; | |
| 444 | ||
| 445 | /// The departure date, check-in date or rental start date for the item. This should be in | |
| 446 | /// YYYY-MM-DD format (NSString). | |
| 447 | /// <pre> | |
| 448 | /// NSDictionary *params = @{ | |
| 449 | /// kFIRParameterStartDate : @"2015-09-14", | |
| 450 | /// // ... | |
| 451 | /// }; | |
| 452 | /// </pre> | |
| 453 | static NSString *const kFIRParameterStartDate NS_SWIFT_NAME(AnalyticsParameterStartDate) = | |
| 454 | @"start_date"; | |
| 455 | ||
| 456 | /// Tax cost associated with a transaction (double as NSNumber). | |
| 457 | /// <pre> | |
| 458 | /// NSDictionary *params = @{ | |
| 459 | /// kFIRParameterTax : @(2.43), | |
| 460 | /// kFIRParameterCurrency : @"USD", // e.g. $2.43 USD | |
| 461 | /// // ... | |
| 462 | /// }; | |
| 463 | /// </pre> | |
| 464 | static NSString *const kFIRParameterTax NS_SWIFT_NAME(AnalyticsParameterTax) = @"tax"; | |
| 465 | ||
| 466 | /// If you're manually tagging keyword campaigns, you should use utm_term to specify the keyword | |
| 467 | /// (NSString). | |
| 468 | /// <pre> | |
| 469 | /// NSDictionary *params = @{ | |
| 470 | /// kFIRParameterTerm : @"game", | |
| 471 | /// // ... | |
| 472 | /// }; | |
| 473 | /// </pre> | |
| 474 | static NSString *const kFIRParameterTerm NS_SWIFT_NAME(AnalyticsParameterTerm) = @"term"; | |
| 475 | ||
| 476 | /// The unique identifier of a transaction (NSString). | |
| 477 | /// <pre> | |
| 478 | /// NSDictionary *params = @{ | |
| 479 | /// kFIRParameterTransactionID : @"T12345", | |
| 480 | /// // ... | |
| 481 | /// }; | |
| 482 | /// </pre> | |
| 483 | static NSString *const kFIRParameterTransactionID NS_SWIFT_NAME(AnalyticsParameterTransactionID) = | |
| 484 | @"transaction_id"; | |
| 485 | ||
| 486 | /// Travel class (NSString). | |
| 487 | /// <pre> | |
| 488 | /// NSDictionary *params = @{ | |
| 489 | /// kFIRParameterTravelClass : @"business", | |
| 490 | /// // ... | |
| 491 | /// }; | |
| 492 | /// </pre> | |
| 493 | static NSString *const kFIRParameterTravelClass NS_SWIFT_NAME(AnalyticsParameterTravelClass) = | |
| 494 | @"travel_class"; | |
| 495 | ||
| 496 | /// A context-specific numeric value which is accumulated automatically for each event type. This is | |
| 497 | /// a general purpose parameter that is useful for accumulating a key metric that pertains to an | |
| 498 | /// event. Examples include revenue, distance, time and points. Value should be specified as signed | |
| 499 | /// 64-bit integer or double as NSNumber. Notes: Values for pre-defined currency-related events | |
| 500 | /// (such as @c kFIREventAddToCart) should be supplied using double as NSNumber and must be | |
| 501 | /// accompanied by a @c kFIRParameterCurrency parameter. The valid range of accumulated values is | |
| 502 | /// [-9,223,372,036,854.77, 9,223,372,036,854.77]. Supplying a non-numeric value, omitting the | |
| 503 | /// corresponding @c kFIRParameterCurrency parameter, or supplying an invalid | |
| 504 | /// <a href="https://goo.gl/qqX3J2">currency code</a> for conversion events will cause that | |
| 505 | /// conversion to be omitted from reporting. | |
| 506 | /// <pre> | |
| 507 | /// NSDictionary *params = @{ | |
| 508 | /// kFIRParameterValue : @(3.99), | |
| 509 | /// kFIRParameterCurrency : @"USD", // e.g. $3.99 USD | |
| 510 | /// // ... | |
| 511 | /// }; | |
| 512 | /// </pre> | |
| 513 | static NSString *const kFIRParameterValue NS_SWIFT_NAME(AnalyticsParameterValue) = @"value"; | |
| 514 | ||
| 515 | /// Name of virtual currency type (NSString). | |
| 516 | /// <pre> | |
| 517 | /// NSDictionary *params = @{ | |
| 518 | /// kFIRParameterVirtualCurrencyName : @"virtual_currency_name", | |
| 519 | /// // ... | |
| 520 | /// }; | |
| 521 | /// </pre> | |
| 522 | static NSString *const kFIRParameterVirtualCurrencyName | |
| 523 | NS_SWIFT_NAME(AnalyticsParameterVirtualCurrencyName) = @"virtual_currency_name"; | |
| 524 | ||
| 525 | /// The name of a level in a game (NSString). | |
| 526 | /// <pre> | |
| 527 | /// NSDictionary *params = @{ | |
| 528 | /// kFIRParameterLevelName : @"room_1", | |
| 529 | /// // ... | |
| 530 | /// }; | |
| 531 | /// </pre> | |
| 532 | static NSString *const kFIRParameterLevelName NS_SWIFT_NAME(AnalyticsParameterLevelName) = | |
| 533 | @"level_name"; | |
| 534 | ||
| 535 | /// The result of an operation. Specify 1 to indicate success and 0 to indicate failure (unsigned | |
| 536 | /// integer as NSNumber). | |
| 537 | /// <pre> | |
| 538 | /// NSDictionary *params = @{ | |
| 539 | /// kFIRParameterSuccess : @(1), | |
| 540 | /// // ... | |
| 541 | /// }; | |
| 542 | /// </pre> | |
| 543 | static NSString *const kFIRParameterSuccess NS_SWIFT_NAME(AnalyticsParameterSuccess) = @"success"; | |
| 544 | ||
| 545 | /// Indicates that the associated event should either extend the current session | |
| 546 | /// or start a new session if no session was active when the event was logged. | |
| 547 | /// Specify YES to extend the current session or to start a new session; any | |
| 548 | /// other value will not extend or start a session. | |
| 549 | /// <pre> | |
| 550 | /// NSDictionary *params = @{ | |
| 551 | /// kFIRParameterExtendSession : @YES, | |
| 552 | /// // ... | |
| 553 | /// }; | |
| 554 | /// </pre> | |
| 555 | static NSString *const kFIRParameterExtendSession NS_SWIFT_NAME(AnalyticsParameterExtendSession) = | |
| 556 | @"extend_session"; | |
| 557 | ||
| 558 | /// Monetary value of discount associated with a purchase (double as NSNumber). | |
| 559 | /// <pre> | |
| 560 | /// NSDictionary *params = @{ | |
| 561 | /// kFIRParameterDiscount : @(2.0), | |
| 562 | /// kFIRParameterCurrency : @"USD", // e.g. $2.00 USD | |
| 563 | /// // ... | |
| 564 | /// }; | |
| 565 | /// </pre> | |
| 566 | static NSString *const kFIRParameterDiscount NS_SWIFT_NAME(AnalyticsParameterDiscount) = | |
| 567 | @"discount"; | |
| 568 | ||
| 569 | /// Item Category (context-specific) (NSString). | |
| 570 | /// <pre> | |
| 571 | /// NSDictionary *params = @{ | |
| 572 | /// kFIRParameterItemCategory2 : @"pants", | |
| 573 | /// // ... | |
| 574 | /// }; | |
| 575 | /// </pre> | |
| 576 | static NSString *const kFIRParameterItemCategory2 NS_SWIFT_NAME(AnalyticsParameterItemCategory2) = | |
| 577 | @"item_category2"; | |
| 578 | ||
| 579 | /// Item Category (context-specific) (NSString). | |
| 580 | /// <pre> | |
| 581 | /// NSDictionary *params = @{ | |
| 582 | /// kFIRParameterItemCategory3 : @"pants", | |
| 583 | /// // ... | |
| 584 | /// }; | |
| 585 | /// </pre> | |
| 586 | static NSString *const kFIRParameterItemCategory3 NS_SWIFT_NAME(AnalyticsParameterItemCategory3) = | |
| 587 | @"item_category3"; | |
| 588 | ||
| 589 | /// Item Category (context-specific) (NSString). | |
| 590 | /// <pre> | |
| 591 | /// NSDictionary *params = @{ | |
| 592 | /// kFIRParameterItemCategory4 : @"pants", | |
| 593 | /// // ... | |
| 594 | /// }; | |
| 595 | /// </pre> | |
| 596 | static NSString *const kFIRParameterItemCategory4 NS_SWIFT_NAME(AnalyticsParameterItemCategory4) = | |
| 597 | @"item_category4"; | |
| 598 | ||
| 599 | /// Item Category (context-specific) (NSString). | |
| 600 | /// <pre> | |
| 601 | /// NSDictionary *params = @{ | |
| 602 | /// kFIRParameterItemCategory5 : @"pants", | |
| 603 | /// // ... | |
| 604 | /// }; | |
| 605 | /// </pre> | |
| 606 | static NSString *const kFIRParameterItemCategory5 NS_SWIFT_NAME(AnalyticsParameterItemCategory5) = | |
| 607 | @"item_category5"; | |
| 608 | ||
| 609 | /// The ID of the list in which the item was presented to the user (NSString). | |
| 610 | /// <pre> | |
| 611 | /// NSDictionary *params = @{ | |
| 612 | /// kFIRParameterItemListID : @"ABC123", | |
| 613 | /// // ... | |
| 614 | /// }; | |
| 615 | /// </pre> | |
| 616 | static NSString *const kFIRParameterItemListID NS_SWIFT_NAME(AnalyticsParameterItemListID) = | |
| 617 | @"item_list_id"; | |
| 618 | ||
| 619 | /// The name of the list in which the item was presented to the user (NSString). | |
| 620 | /// <pre> | |
| 621 | /// NSDictionary *params = @{ | |
| 622 | /// kFIRParameterItemListName : @"Related products", | |
| 623 | /// // ... | |
| 624 | /// }; | |
| 625 | /// </pre> | |
| 626 | static NSString *const kFIRParameterItemListName NS_SWIFT_NAME(AnalyticsParameterItemListName) = | |
| 627 | @"item_list_name"; | |
| 628 | ||
| 629 | /// The list of items involved in the transaction. (NSArray). | |
| 630 | /// <pre> | |
| 631 | /// NSDictionary *params = @{ | |
| 632 | /// kFIRParameterItems : @[ | |
| 633 | /// @{kFIRParameterItemName : @"jeggings", kFIRParameterItemCategory : @"pants"}, | |
| 634 | /// @{kFIRParameterItemName : @"boots", kFIRParameterItemCategory : @"shoes"}, | |
| 635 | /// ], | |
| 636 | /// }; | |
| 637 | /// </pre> | |
| 638 | static NSString *const kFIRParameterItems NS_SWIFT_NAME(AnalyticsParameterItems) = @"items"; | |
| 639 | ||
| 640 | /// The location associated with the event. Preferred to be the Google | |
| 641 | /// <a href="https://developers.google.com/places/place-id">Place ID</a> that corresponds to the | |
| 642 | /// associated item but could be overridden to a custom location ID string.(NSString). <pre> | |
| 643 | /// NSDictionary *params = @{ | |
| 644 | /// kFIRParameterLocationID : @"ChIJiyj437sx3YAR9kUWC8QkLzQ", | |
| 645 | /// // ... | |
| 646 | /// }; | |
| 647 | /// </pre> | |
| 648 | static NSString *const kFIRParameterLocationID NS_SWIFT_NAME(AnalyticsParameterLocationID) = | |
| 649 | @"location_id"; | |
| 650 | ||
| 651 | /// The chosen method of payment (NSString). | |
| 652 | /// <pre> | |
| 653 | /// NSDictionary *params = @{ | |
| 654 | /// kFIRParameterPaymentType : @"Visa", | |
| 655 | /// // ... | |
| 656 | /// }; | |
| 657 | /// </pre> | |
| 658 | static NSString *const kFIRParameterPaymentType NS_SWIFT_NAME(AnalyticsParameterPaymentType) = | |
| 659 | @"payment_type"; | |
| 660 | ||
| 661 | /// The ID of a product promotion (NSString). | |
| 662 | /// <pre> | |
| 663 | /// NSDictionary *params = @{ | |
| 664 | /// kFIRParameterPromotionID : @"ABC123", | |
| 665 | /// // ... | |
| 666 | /// }; | |
| 667 | /// </pre> | |
| 668 | static NSString *const kFIRParameterPromotionID NS_SWIFT_NAME(AnalyticsParameterPromotionID) = | |
| 669 | @"promotion_id"; | |
| 670 | ||
| 671 | /// The name of a product promotion (NSString). | |
| 672 | /// <pre> | |
| 673 | /// NSDictionary *params = @{ | |
| 674 | /// kFIRParameterPromotionName : @"Summer Sale", | |
| 675 | /// // ... | |
| 676 | /// }; | |
| 677 | /// </pre> | |
| 678 | static NSString *const kFIRParameterPromotionName NS_SWIFT_NAME(AnalyticsParameterPromotionName) = | |
| 679 | @"promotion_name"; | |
| 680 | ||
| 681 | /// The shipping tier (e.g. Ground, Air, Next-day) selected for delivery of the purchased item | |
| 682 | /// (NSString). | |
| 683 | /// <pre> | |
| 684 | /// NSDictionary *params = @{ | |
| 685 | /// kFIRParameterShippingTier : @"Ground", | |
| 686 | /// // ... | |
| 687 | /// }; | |
| 688 | /// </pre> | |
| 689 | static NSString *const kFIRParameterShippingTier NS_SWIFT_NAME(AnalyticsParameterShippingTier) = | |
| 690 | @"shipping_tier"; | |
