Constants

The following constants are available globally.

  • Game achievement ID (NSString).

        NSDictionary *params = @{
          kFIRParameterAchievementID : @10_matches_won,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterAchievementID = @"achievement_id"
  • Ad Network Click ID (NSString). Used for network-specific click IDs which vary in format.

        NSDictionary *params = @{
          kFIRParameterAdNetworkClickID : @1234567,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterAdNetworkClickID = @"aclid"
  • The individual campaign name, slogan, promo code, etc. Some networks have pre-defined macro to capture campaign information, otherwise can be populated by developer. Highly Recommended (NSString).

        NSDictionary *params = @{
          kFIRParameterCampaign : @winter_promotion,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterCampaign = @"campaign"
  • Character used in game (NSString).

        NSDictionary *params = @{
          kFIRParameterCharacter : @beat_boss,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterCharacter = @"character"
  • Campaign content (NSString).

    Declaration

    Objective-C

    static NSString *const kFIRParameterContent = @"content"
  • Type of content selected (NSString).

        NSDictionary *params = @{
          kFIRParameterContentType : @news article,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterContentType = @"content_type"
  • Coupon code for a purchasable item (NSString).

        NSDictionary *params = @{
          kFIRParameterCoupon : @zz123,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterCoupon = @"coupon"
  • Campaign custom parameter (NSString). Used as a method of capturing custom data in a campaign. Use varies by network.

        NSDictionary *params = @{
          kFIRParameterCP1 : @custom_data,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterCP1 = @"cp1"
  • Purchase currency in 3-letter ISO_4217 format (NSString).

        NSDictionary *params = @{
          kFIRParameterCurrency : @USD,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterCurrency = @"currency"
  • Flight or Travel destination (NSString).

        NSDictionary *params = @{
          kFIRParameterDestination : @Mountain View, CA,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterDestination = @"destination"
  • The arrival date, check-out date or rental end date for the item. This should be in YYYY-MM-DD format (NSString).

        NSDictionary *params = @{
          kFIRParameterEndDate : @2015-09-14,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterEndDate = @"end_date"
  • Flight number for travel events (NSString).

        NSDictionary *params = @{
          kFIRParameterFlightNumber : @ZZ800,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterFlightNumber = @"flight_number"
  • Group/clan/guild ID (NSString).

        NSDictionary *params = @{
          kFIRParameterGroupID : @g1,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterGroupID = @"group_id"
  • Item category (NSString).

        NSDictionary *params = @{
          kFIRParameterItemCategory : @t-shirts,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterItemCategory = @"item_category"
  • Item ID (NSString).

        NSDictionary *params = @{
          kFIRParameterItemID : @p7654,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterItemID = @"item_id"
  • The Google Place ID (NSString) that corresponds to the associated item. Alternatively, you can supply your own custom Location ID.

        NSDictionary *params = @{
          kFIRParameterItemLocationID : @ChIJiyj437sx3YAR9kUWC8QkLzQ,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterItemLocationID = @"item_location_id"
  • Item name (NSString).

        NSDictionary *params = @{
          kFIRParameterItemName : @abc,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterItemName = @"item_name"
  • Level in game (signed 64-bit integer as NSNumber).

        NSDictionary *params = @{
          kFIRParameterLevel : @(42),
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterLevel = @"level"
  • Location (NSString). The Google Place ID that corresponds to the associated event. Alternatively, you can supply your own custom Location ID.

        NSDictionary *params = @{
          kFIRParameterLocation : @ChIJiyj437sx3YAR9kUWC8QkLzQ,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterLocation = @"location"
  • The advertising or marketing medium, for example: cpc, banner, email, push. Highly recommended (NSString).

        NSDictionary *params = @{
          kFIRParameterMedium : @email,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterMedium = @"medium"
  • Number of nights staying at hotel (signed 64-bit integer as NSNumber).

        NSDictionary *params = @{
          kFIRParameterNumberOfNights : @(3),
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterNumberOfNights = @"number_of_nights"
  • Number of passengers traveling (signed 64-bit integer as NSNumber).

        NSDictionary *params = @{
          kFIRParameterNumberOfPassengers : @(11),
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterNumberOfPassengers = @"number_of_passengers"
  • Number of rooms for travel events (signed 64-bit integer as NSNumber).

        NSDictionary *params = @{
          kFIRParameterNumberOfRooms : @(2),
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterNumberOfRooms = @"number_of_rooms"
  • Flight or Travel origin (NSString).

        NSDictionary *params = @{
          kFIRParameterOrigin : @Mountain View, CA,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterOrigin = @"origin"
  • Purchase price (double as NSNumber).

        NSDictionary *params = @{
          kFIRParameterPrice : @(1.0),
          kFIRParameterCurrency : @USD,  // e.g. $1.00 USD
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterPrice = @"price"
  • Purchase quantity (signed 64-bit integer as NSNumber).

        NSDictionary *params = @{
          kFIRParameterQuantity : @(1),
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterQuantity = @"quantity"
  • Score in game (signed 64-bit integer as NSNumber).

        NSDictionary *params = @{
          kFIRParameterScore : @(4200),
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterScore = @"score"
  • The search string/keywords used (NSString).

        NSDictionary *params = @{
          kFIRParameterSearchTerm : @periodic table,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterSearchTerm = @"search_term"
  • Shipping cost (double as NSNumber).

        NSDictionary *params = @{
          kFIRParameterShipping : @(9.50),
          kFIRParameterCurrency : @USD,  // e.g. $9.50 USD
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterShipping = @"shipping"
  • Sign up method (NSString).

        NSDictionary *params = @{
          kFIRParameterSignUpMethod : @google,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterSignUpMethod = @"sign_up_method"
  • The origin of your traffic, such as an Ad network (for example, google) or partner (urban airship). Identify the advertiser, site, publication, etc. that is sending traffic to your property. Highly recommended (NSString).

        NSDictionary *params = @{
          kFIRParameterSource : @InMobi,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterSource = @"source"
  • The departure date, check-in date or rental start date for the item. This should be in YYYY-MM-DD format (NSString).

        NSDictionary *params = @{
          kFIRParameterStartDate : @2015-09-14,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterStartDate = @"start_date"
  • Tax amount (double as NSNumber).

        NSDictionary *params = @{
          kFIRParameterTax : @(1.0),
          kFIRParameterCurrency : @USD,  // e.g. $1.00 USD
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterTax = @"tax"
  • If you’re manually tagging keyword campaigns, you should use utm_term to specify the keyword (NSString).

        NSDictionary *params = @{
          kFIRParameterTerm : @game,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterTerm = @"term"
  • A single ID for a ecommerce group transaction (NSString).

        NSDictionary *params = @{
          kFIRParameterTransactionID : @ab7236dd9823,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterTransactionID = @"transaction_id"
  • Travel class (NSString).

        NSDictionary *params = @{
          kFIRParameterTravelClass : @business,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterTravelClass = @"travel_class"
  • A context-specific numeric value which is accumulated automatically for each event type. This is a general purpose parameter that is useful for accumulating a key metric that pertains to an event. Examples include revenue, distance, time and points. Value should be specified as signed 64-bit integer or double as NSNumber. Notes: Values for pre-defined currency-related events (such as kFIREventAddToCart) should be supplied using double as NSNumber and must be accompanied by a kFIRParameterCurrency parameter. The valid range of accumulated values is [-9,223,372,036,854.77, 9,223,372,036,854.77].

        NSDictionary *params = @{
          kFIRParameterValue : @(3.99),
          kFIRParameterCurrency : @USD,  // e.g. $3.99 USD
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterValue = @"value"
  • Name of virtual currency type (NSString).

        NSDictionary *params = @{
          kFIRParameterVirtualCurrencyName : @virtual_currency_name,
          // ...
        };
    

    Declaration

    Objective-C

    static NSString *const kFIRParameterVirtualCurrencyName =
        @"virtual_currency_name"
  • The method used to sign in. For example, google, facebook or twitter.

    Declaration

    Objective-C

    static NSString *const kFIRUserPropertySignUpMethod = @"sign_up_method"