GA4 - iOS - Swift - view_promotion

// Products can be instrumented as an array of items that can be added to prescribed ecommerce events.

//Ecommerce includes support for measuring impressions and clicks of internal promotions, such as banners displayed to promote a sale. Promotion impressions are typically measured with the initial screen view by logging the view_promotion event with an items parameter to specify the promoted product.

// A pair of jeggings (product1)
var jeggings: [String: Any] = [
  AnalyticsParameterItemID: "SKU_123",                      //Item ID (context-specific) (NSString).
  AnalyticsParameterItemName: "jeggings",                   //Item Name (context-specific) (NSString).
  AnalyticsParameterItemCategory: "pants",                  //Item category (context-specific) (NSString).
  AnalyticsParameterItemCategory2: "sub-cat1",              //Item sub-category (context-specific) (NSString).
  AnalyticsParameterItemCategory3: "sub-cat2",              //Item sub-category (context-specific) (NSString).
  AnalyticsParameterItemCategory4: "sub-cat3",              //Item sub-category (context-specific) (NSString).
  AnalyticsParameterItemCategory5: "sub-cat4",              //Item sub-category (context-specific) (NSString).
  AnalyticsParameterItemVariant: "black",                   //Item variant (NSString).
  AnalyticsParameterItemBrand: "Google",                    //Item brand(NSString).
  AnalyticsParameterPrice: 9.99,                            //Product price (double as NSNumber).

// Prepare promotion parameters
var promoParams: [String: Any] = [
  AnalyticsParameterPromotionID: "T12345",                      //The ID of a product promotion (NSString).
  AnalyticsParameterPromotionName:"Summer Sale",                //The name of a product promotion (NSString).
  AnalyticsParameterCreativeName: "summer2020_promo.jpg",       //The name of a creative used in a promotional spot (NSString).
  AnalyticsParameterCreativeSlot: "featured_app_1",             //The name of a creative slot (NSString).
  AnalyticsParameterLocationID: "HERO_BANNER",                  //The banner location.(NSString).
]

// Add items
promoParams[AnalyticsParameterItems] = [jeggings]

// Log event when promotion is displayed
Analytics.logEvent(AnalyticsEventViewPromotion, parameters: promoParams)