Analytics Parameters
Predefined event parameter names.
Summary
Params supply information that contextualize Events. You can associate up to 25 unique Params with each Event type. Some Params are suggested below for certain common Events, but you are not limited to these. You may supply extra Params for suggested Events or custom Params for Custom events. Param names can be up to 40 characters long, may only contain alphanumeric characters and underscores ("_"), and must start with an alphabetic character. Param values can be up to 100 characters long for standard Google Analytics properties and up to 500 characters long for Google Analytics 360 properties. The "firebase_", "google_", and "ga_" prefixes are reserved and should not be used.
Variables | |
---|---|
kParameterAchievementID = "achievement_id" | const char *const Game achievement ID (String). |
kParameterAdFormat = "ad_format" | const char *const The ad format (e.g. |
kParameterAdNetworkClickID = "aclid" | const char *const Ad Network Click ID (String). |
kParameterAdPlatform = "ad_platform" | const char *const The ad platform (e.g. |
kParameterAdSource = "ad_source" | const char *const The ad source (e.g. |
kParameterAdUnitName = "ad_unit_name" | const char *const The ad unit name (e.g. |
kParameterAffiliation = "affiliation" | const char *const A product affiliation to designate a supplying company or brick and mortar store location (String). |
kParameterCP1 = "cp1" | const char *const Campaign custom parameter (String). |
kParameterCampaign = "campaign" | const char *const The individual campaign name, slogan, promo code, etc. |
kParameterCampaignID = "campaign_id" | const char *const Campaign ID (String). |
kParameterCharacter = "character" | const char *const Character used in game (String). |
kParameterContent = "content" | const char *const Campaign content (String). |
kParameterContentType = "content_type" | const char *const Type of content selected (String). |
kParameterCoupon = "coupon" | const char *const Coupon code used for a purchase (String). |
kParameterCreativeFormat = "creative_format" | const char *const Creative Format (String). |
kParameterCreativeName = "creative_name" | const char *const The name of a creative used in a promotional spot (String). |
kParameterCreativeSlot = "creative_slot" | const char *const The name of a creative slot (String). |
kParameterCurrency = "currency" | const char *const Currency of the purchase or items associated with the event, in 3-letter ISO_4217 format (String). |
kParameterDestination = "destination" | const char *const Flight or Travel destination (String). |
kParameterDiscount = "discount" | const char *const Monetary value of discount associated with a purchase (Double). |
kParameterEndDate = "end_date" | const char *const The arrival date, check-out date or rental end date for the item. |
kParameterExtendSession = "extend_session" | const char *const Indicates that the associated event should either extend the current session or start a new session if no session was active when the event was logged. |
kParameterFlightNumber = "flight_number" | const char *const Flight number for travel events (String). |
kParameterGroupID = "group_id" | const char *const Group/clan/guild ID (String). |
kParameterIndex = "index" | const char *const The index of the item in a list (Int). |
kParameterItemBrand = "item_brand" | const char *const Item brand (String). |
kParameterItemCategory = "item_category" | const char *const Item category (context-specific) (String). |
kParameterItemCategory2 = "item_category2" | const char *const Item Category (context-specific) (String). |
kParameterItemCategory3 = "item_category3" | const char *const Item Category (context-specific) (String). |
kParameterItemCategory4 = "item_category4" | const char *const Item Category (context-specific) (String). |
kParameterItemCategory5 = "item_category5" | const char *const Item Category (context-specific) (String). |
kParameterItemID = "item_id" | const char *const Item ID (context-specific) (String). |
kParameterItemListID = "item_list_id" | const char *const The ID of the list in which the item was presented to the user (String). |
kParameterItemListName = "item_list_name" | const char *const The name of the list in which the item was presented to the user (String). |
kParameterItemName = "item_name" | const char *const Item Name (context-specific) (String). |
kParameterItemVariant = "item_variant" | const char *const Item variant (String). |
kParameterItems = "items" | const char *const The list of items involved in the transaction expressed as [[String: Any]] . |
kParameterLevel = "level" | const char *const Level in game (Int). |
kParameterLevelName = "level_name" | const char *const The name of a level in a game (String). |
kParameterLocation = "location" | const char *const Location (String). |
kParameterLocationID = "location_id" | const char *const The location associated with the event. |
kParameterMarketingTactic = "marketing_tactic" | const char *const Marketing Tactic (String). |
kParameterMedium = "medium" | const char *const The advertising or marParameter(keting, cpc, banner, email), push. |
kParameterMethod = "method" | const char *const A particular approach used in an operation; for example, "facebook" or "email" in the context of a sign_up or login event. |
kParameterNumberOfNights = "number_of_nights" | const char *const Number of nights staying at hotel (Int). |
kParameterNumberOfPassengers = "number_of_passengers" | const char *const Number of passengers traveling (Int). |
kParameterNumberOfRooms = "number_of_rooms" | const char *const Number of rooms for travel events (Int). |
kParameterOrigin = "origin" | const char *const Flight or Travel origin (String). |
kParameterPaymentType = "payment_type" | const char *const The chosen method of payment (String). |
kParameterPrice = "price" | const char *const Purchase price (Double). |
kParameterPromotionID = "promotion_id" | const char *const The ID of a product promotion (String). |
kParameterPromotionName = "promotion_name" | const char *const The name of a product promotion (String). |
kParameterQuantity = "quantity" | const char *const Purchase quantity (Int). |
kParameterScore = "score" | const char *const Score in game (Int). |
kParameterScreenClass = "screen_class" | const char *const Current screen class, such as the class name of the UIViewController, logged with screen_view event and added to every event (String). |
kParameterScreenName = "screen_name" | const char *const Current screen name, such as the name of the UIViewController, logged with screen_view event and added to every event (String). |
kParameterSearchTerm = "search_term" | const char *const The search string/keywords used (String). |
kParameterShipping = "shipping" | const char *const Shipping cost associated with a transaction (Double). |
kParameterShippingTier = "shipping_tier" | const char *const The shipping tier (e.g. |
kParameterSource = "source" | const char *const The origin of your traffic, such as an Ad network (for example, google) or partner (urban airship). |
kParameterSourcePlatform = "source_platform" | const char *const Source Platform (String). |
kParameterStartDate = "start_date" | const char *const The departure date, check-in date or rental start date for the item. |
kParameterSuccess = "success" | const char *const The result of an operation. |
kParameterTax = "tax" | const char *const Tax cost associated with a transaction (Double). |
kParameterTerm = "term" | const char *const If you're manually tagging keyword campaigns, you should use utm_term to specify the keyword (String). |
kParameterTransactionID = "transaction_id" | const char *const The unique identifier of a transaction (String). |
kParameterTravelClass = "travel_class" | const char *const Travel class (String). |
kParameterValue = "value" | const char *const A context-specific numeric value which is accumulated automatically for each event type. |
kParameterVirtualCurrencyName = "virtual_currency_name" | const char *const Name of virtual currency type (String). |
Variables
kParameterAchievementID
const char *const kParameterAchievementID = "achievement_id"
Game achievement ID (String).
let params = [ AnalyticsParameterAchievementID : "10_matches_won", // ... ]
kParameterAdFormat
const char *const kParameterAdFormat = "ad_format"
The ad format (e.g.
Banner, Interstitial, Rewarded, Native, Rewarded Interstitial, Instream). (String).
let params = [ AnalyticsParameterAdFormat : "Banner", // ... ]
kParameterAdNetworkClickID
const char *const kParameterAdNetworkClickID = "aclid"
Ad Network Click ID (String).
Used for network-specific click IDs which vary in format.
let params = [ AnalyticsParameterAdNetworParameter(kClickID, "1234567"), // ... ]
kParameterAdPlatform
const char *const kParameterAdPlatform = "ad_platform"
The ad platform (e.g.
MoPub, IronSource) (String).
let params = [ AnalyticsParameterAdPlatform : "MoPub", // ... ]
kParameterAdSource
const char *const kParameterAdSource = "ad_source"
The ad source (e.g.
AdColony) (String).
let params = [ AnalyticsParameterAdSource : "AdColony", // ... ]
kParameterAdUnitName
const char *const kParameterAdUnitName = "ad_unit_name"
The ad unit name (e.g.
Banner_03) (String).
let params = [ AnalyticsParameterAdUnitName : "Banner_03", // ... ]
kParameterAffiliation
const char *const kParameterAffiliation = "affiliation"
A product affiliation to designate a supplying company or brick and mortar store location (String).
let params = [ AnalyticsParameterAffiliation : "Google Store", // ... ]
kParameterCP1
const char *const kParameterCP1 = "cp1"
Campaign custom parameter (String).
Used as a method of capturing custom data in a campaign. Use varies by network.
let params = [ AnalyticsParameterCP1 : "custom_data", // ... ]
kParameterCampaign
const char *const kParameterCampaign = "campaign"
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 (String).
let params = [ AnalyticsParameterCampaign : "winter_promotion", // ... ]
kParameterCampaignID
const char *const kParameterCampaignID = "campaign_id"
Campaign ID (String).
Used for keyword analysis to identify a specific product promotion or strategic campaign. This is a required key for GA4 data import.
let params = [ AnalyticsParameterCampaignID : "7877652710", // ... ]
kParameterCharacter
const char *const kParameterCharacter = "character"
Character used in game (String).
let params = [ AnalyticsParameterCharacter : "beat_boss", // ... ]
kParameterContent
const char *const kParameterContent = "content"
Campaign content (String).
kParameterContentType
const char *const kParameterContentType = "content_type"
Type of content selected (String).
let params = [ AnalyticsParameterContentType : "news article", // ... ]
kParameterCoupon
const char *const kParameterCoupon = "coupon"
Coupon code used for a purchase (String).
let params = [ AnalyticsParameterCoupon : "SUMMER_FUN", // ... ]
kParameterCreativeFormat
const char *const kParameterCreativeFormat = "creative_format"
Creative Format (String).
Used to identify the high-level classification of the type of ad served by a specific campaign.
let params = [ AnalyticsParameterCreativeFormat : "display", // ... ]
kParameterCreativeName
const char *const kParameterCreativeName = "creative_name"
The name of a creative used in a promotional spot (String).
let params = [ AnalyticsParameterCreativeName : "Summer Sale", // ... ]
kParameterCreativeSlot
const char *const kParameterCreativeSlot = "creative_slot"
The name of a creative slot (String).
let params = [ AnalyticsParameterCreativeSlot : "summer_banner2", // ... ]
kParameterCurrency
const char *const kParameterCurrency = "currency"
Currency of the purchase or items associated with the event, in 3-letter ISO_4217 format (String).
let params = [ AnalyticsParameterCurrency : "USD", // ... ]
kParameterDestination
const char *const kParameterDestination = "destination"
Flight or Travel destination (String).
let params = [ AnalyticsParameterDestination : "Mountain View, CA", // ... ]
kParameterDiscount
const char *const kParameterDiscount = "discount"
Monetary value of discount associated with a purchase (Double).
let params = [ AnalyticsParameterDiscount : 2.0, AnalyticsParameterCurrency : "USD", // e.g. $2.00 USD // ... ]
kParameterEndDate
const char *const kParameterEndDate = "end_date"
The arrival date, check-out date or rental end date for the item.
This should be in YYYY-MM-DD format (String).
let params = [ AnalyticsParameterEndDate : "2015-09-14", // ... ]
kParameterExtendSession
const char *const kParameterExtendSession = "extend_session"
Indicates that the associated event should either extend the current session or start a new session if no session was active when the event was logged.
Specify 1 to extend the current session or to start a new session; any other value will not extend or start a session.
let params = [ AnalyticsParameterExtendSession : 1, // ... ]
kParameterFlightNumber
const char *const kParameterFlightNumber = "flight_number"
Flight number for travel events (String).
let params = [ AnalyticsParameterFlightNumber : "ZZ800", // ... ]
kParameterGroupID
const char *const kParameterGroupID = "group_id"
Group/clan/guild ID (String).
let params = [ AnalyticsParameterGroupID : "g1", // ... ]
kParameterIndex
const char *const kParameterIndex = "index"
The index of the item in a list (Int).
let params = [ AnalyticsParameterIndex : 5, // ... ]
kParameterItemBrand
const char *const kParameterItemBrand = "item_brand"
Item brand (String).
let params = [ AnalyticsParameterItemBrand : "Google", // ... ]
kParameterItemCategory
const char *const kParameterItemCategory = "item_category"
Item category (context-specific) (String).
let params = [ AnalyticsParameterItemCategory : "pants", // ... ]
kParameterItemCategory2
const char *const kParameterItemCategory2 = "item_category2"
Item Category (context-specific) (String).
let params = [ AnalyticsParameterItemCategory2 : "pants", // ... ]
kParameterItemCategory3
const char *const kParameterItemCategory3 = "item_category3"
Item Category (context-specific) (String).
let params = [ AnalyticsParameterItemCategory3 : "pants", // ... ]
kParameterItemCategory4
const char *const kParameterItemCategory4 = "item_category4"
Item Category (context-specific) (String).
let params = [ AnalyticsParameterItemCategory4 : "pants", // ... ]
kParameterItemCategory5
const char *const kParameterItemCategory5 = "item_category5"
Item Category (context-specific) (String).
let params = [ AnalyticsParameterItemCategory5 : "pants", // ... ]
kParameterItemID
const char *const kParameterItemID = "item_id"
Item ID (context-specific) (String).
let params = [ AnalyticsParameterItemID : "SKU_12345", // ... ]
kParameterItemListID
const char *const kParameterItemListID = "item_list_id"
The ID of the list in which the item was presented to the user (String).
let params = [ AnalyticsParameterItemListID : "ABC123", // ... ]
kParameterItemListName
const char *const kParameterItemListName = "item_list_name"
The name of the list in which the item was presented to the user (String).
let params = [ AnalyticsParameterItemListName : "Related products", // ... ]
kParameterItemName
const char *const kParameterItemName = "item_name"
Item Name (context-specific) (String).
let params = [ AnalyticsParameterItemName : "jeggings", // ... ]
kParameterItemVariant
const char *const kParameterItemVariant = "item_variant"
Item variant (String).
let params = [ AnalyticsParameterItemVariant : "Black", // ... ]
kParameterItems
const char *const kParameterItems = "items"
The list of items involved in the transaction expressed as [[String: Any]]
.
let params = [ AnalyticsParameterItems : [ [AnalyticsParameterItemName : "jeggings", AnalyticsParameterItemCategory : "pants"], [AnalyticsParameterItemName : "boots", AnalyticsParameterItemCategory : "shoes"], ], ]
kParameterLevel
const char *const kParameterLevel = "level"
Level in game (Int).
let params = [ AnalyticsParameterLevel : 42, // ... ]
kParameterLevelName
const char *const kParameterLevelName = "level_name"
The name of a level in a game (String).
let params = [ AnalyticsParameterLevelName : "room_1", // ... ]
kParameterLocation
const char *const kParameterLocation = "location"
Location (String).
The Google Place ID that corresponds to the associated event. Alternatively, you can supply your own custom Location ID.
let params = [ AnalyticsParameterLocation : "ChIJiyj437sx3YAR9kUWC8QkLzQ", // ... ]
kParameterLocationID
const char *const kParameterLocationID = "location_id"
The location associated with the event.
Preferred to be the Google Place ID that corresponds to the associated item but could be overridden to a custom location ID string.(String).
let params = [ AnalyticsParameterLocationID : "ChIJiyj437sx3YAR9kUWC8QkLzQ", // ... ]
kParameterMarketingTactic
const char *const kParameterMarketingTactic = "marketing_tactic"
Marketing Tactic (String).
Used to identify the targeting criteria applied to a specific campaign.
let params = [ AnalyticsParameterMarParameter(ketingTactic, "Remarketing"), // ... ]
kParameterMedium
const char *const kParameterMedium = "medium"
The advertising or marParameter(keting, cpc, banner, email), push.
Highly recommended (String).
let params = [ AnalyticsParameterMedium : "email", // ... ]
kParameterMethod
const char *const kParameterMethod = "method"
A particular approach used in an operation; for example, "facebook" or "email" in the context of a sign_up or login event.
(String).
let params = [ AnalyticsParameterMethod : "google", // ... ]
kParameterNumberOfNights
const char *const kParameterNumberOfNights = "number_of_nights"
Number of nights staying at hotel (Int).
let params = [ AnalyticsParameterNumberOfNights : 3, // ... ]
kParameterNumberOfPassengers
const char *const kParameterNumberOfPassengers = "number_of_passengers"
Number of passengers traveling (Int).
let params = [ AnalyticsParameterNumberOfPassengers : 11, // ... ]
kParameterNumberOfRooms
const char *const kParameterNumberOfRooms = "number_of_rooms"
Number of rooms for travel events (Int).
let params = [ AnalyticsParameterNumberOfRooms : 2, // ... ]
kParameterOrigin
const char *const kParameterOrigin = "origin"
Flight or Travel origin (String).
let params = [ AnalyticsParameterOrigin : "Mountain View, CA", // ... ]
kParameterPaymentType
const char *const kParameterPaymentType = "payment_type"
The chosen method of payment (String).
let params = [ AnalyticsParameterPaymentType : "Visa", // ... ]
kParameterPrice
const char *const kParameterPrice = "price"
Purchase price (Double).
let params = [ AnalyticsParameterPrice : 1.0, AnalyticsParameterCurrency : "USD", // e.g. $1.00 USD // ... ]
kParameterPromotionID
const char *const kParameterPromotionID = "promotion_id"
The ID of a product promotion (String).
let params = [ AnalyticsParameterPromotionID : "ABC123", // ... ]
kParameterPromotionName
const char *const kParameterPromotionName = "promotion_name"
The name of a product promotion (String).
let params = [ AnalyticsParameterPromotionName : "Summer Sale", // ... ]
kParameterQuantity
const char *const kParameterQuantity = "quantity"
Purchase quantity (Int).
let params = [ AnalyticsParameterQuantity : 1, // ... ]
kParameterScore
const char *const kParameterScore = "score"
Score in game (Int).
let params = [ AnalyticsParameterScore : 4200, // ... ]
kParameterScreenClass
const char *const kParameterScreenClass = "screen_class"
Current screen class, such as the class name of the UIViewController, logged with screen_view event and added to every event (String).
let params = [ AnalyticsParameterScreenClass : "LoginViewController", // ... ]
kParameterScreenName
const char *const kParameterScreenName = "screen_name"
Current screen name, such as the name of the UIViewController, logged with screen_view event and added to every event (String).
let params = [ AnalyticsParameterScreenName : "LoginView", // ... ]
kParameterSearchTerm
const char *const kParameterSearchTerm = "search_term"
The search string/keywords used (String).
let params = [ AnalyticsParameterSearchTerm : "periodic table", // ... ]
kParameterShipping
const char *const kParameterShipping = "shipping"
Shipping cost associated with a transaction (Double).
let params = [ AnalyticsParameterShipping : 5.99, AnalyticsParameterCurrency : "USD", // e.g. $5.99 USD // ... ]
kParameterShippingTier
const char *const kParameterShippingTier = "shipping_tier"
The shipping tier (e.g.
Ground, Air, Next-day) selected for delivery of the purchased item (String).
let params = [ AnalyticsParameterShippingTier : "Ground", // ... ]
kParameterSource
const char *const kParameterSource = "source"
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 (String).
let params = [ AnalyticsParameterSource : "InMobi", // ... ]
kParameterSourcePlatform
const char *const kParameterSourcePlatform = "source_platform"
Source Platform (String).
Used to identify the platform responsible for directing traffic to a given Analytics property (e.g., a buying platform where budgets, targeting criteria, etc. are set, a platform for managing organic traffic data, etc.).
let params = [ AnalyticsParameterSourcePlatform : "sa360", // ... ]
kParameterStartDate
const char *const kParameterStartDate = "start_date"
The departure date, check-in date or rental start date for the item.
This should be in YYYY-MM-DD format (String).
let params = [ AnalyticsParameterStartDate : "2015-09-14", // ... ]
kParameterSuccess
const char *const kParameterSuccess = "success"
The result of an operation.
Specify 1 to indicate success and 0 to indicate failure (Int).
let params = [ AnalyticsParameterSuccess : 1, // ... ]
kParameterTax
const char *const kParameterTax = "tax"
Tax cost associated with a transaction (Double).
let params = [ AnalyticsParameterTax : 2.43, AnalyticsParameterCurrency : "USD", // e.g. $2.43 USD // ... ]
kParameterTerm
const char *const kParameterTerm = "term"
If you're manually tagging keyword campaigns, you should use utm_term to specify the keyword (String).
let params = [ AnalyticsParameterTerm : "game", // ... ]
kParameterTransactionID
const char *const kParameterTransactionID = "transaction_id"
The unique identifier of a transaction (String).
let params = [ AnalyticsParameterTransactionID : "T12345", // ... ]
kParameterTravelClass
const char *const kParameterTravelClass = "travel_class"
Travel class (String).
let params = [ AnalyticsParameterTravelClass : "business", // ... ]
kParameterValue
const char *const kParameterValue = "value"
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 Int or Double. Notes: Values for pre-defined currency-related events (such as AnalyticsEventAddToCart
) should be supplied using Double and must be accompanied by a AnalyticsParameterCurrency
parameter. The valid range of accumulated values is [-9,223,372,036,854.77, 9,223,372,036,854.77]. Supplying a non-numeric value, omitting the corresponding AnalyticsParameterCurrency
parameter, or supplying an invalid currency code for conversion events will cause that conversion to be omitted from reporting.
let params = [ AnalyticsParameterValue : 3.99, AnalyticsParameterCurrency : "USD", // e.g. $3.99 USD // ... ]
kParameterVirtualCurrencyName
const char *const kParameterVirtualCurrencyName = "virtual_currency_name"
Name of virtual currency type (String).
let params = [ AnalyticsParameterVirtualCurrencyName : "virtual_currency_name", // ... ]