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",
  // ...
]