[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2024-09-13 (世界標準時間)。"],[[["\u003cp\u003eThe \u003ccode\u003eitems\u003c/code\u003e array in ecommerce events describes products or services, using parameters defined by Google.\u003c/p\u003e\n"],["\u003cp\u003eYou can add up to 27 custom item-scoped parameters to the \u003ccode\u003eitems\u003c/code\u003e array to capture business-specific data.\u003c/p\u003e\n"],["\u003cp\u003eCustom item-scoped parameters can be added directly to the \u003ccode\u003eitems\u003c/code\u003e array within your ecommerce events, like the example showing the \u003ccode\u003ein_stock\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eTo analyze item-scoped custom parameters in your reports, you need to create corresponding item-scoped custom dimensions in Google Analytics.\u003c/p\u003e\n"]]],["The `items` array in ecommerce events allows for product/service descriptions, including required and recommended parameters. You can also add up to 27 custom item-scoped parameters, like `in_stock`, within this array. For standard properties, 10 item-scoped custom dimensions are configurable, and 25 for Analytics 360 properties. Adding a custom parameter involves including it in the `items` array. To analyze these parameters, an item-scoped custom dimension needs to be created.\n"],null,["# Create item-scoped custom parameters\n\nThe [`items` array](/analytics/devguides/collection/ga4/ecommerce#implementation) in ecommerce\nevents lets you describe the products or services on your ecommerce website.\nGoogle provides a [list of required and recommended parameters](/analytics/devguides/collection/ga4/reference/events)\nto include in the `items` array.\n\nIn addition to these parameters, you can include up to 27 custom parameters in\nthe `items` array. These custom parameters are called **custom item-scoped\nparameters** and they let you capture data that's useful to your\nbusiness. Of these 27 custom item parameters, you can configure:\n\n- 10 item-scoped custom dimensions for standard properties\n- 25 item-scoped custom dimensions for Analytics 360 properties\n\nMake sure to review the list of required and recommended parameters before\ncreating your own item-scoped custom parameters.\n\nAdd an item-scoped custom parameter\n-----------------------------------\n\nTo add an item-scoped custom parameter, include the parameter in the\n`items` array. For example, to capture whether a product is in stock, you can\nadd the following `in_stock` custom parameter to the event: \n\n items: [\n {\n item_id: \"SKU_12345\",\n item_name: \"Stan and Friends Tee\",\n affiliation: \"Google Merchandise Store\",\n coupon: \"SUMMER_FUN\",\n discount: 2.22,\n index: 0,\n item_brand: \"Google\",\n item_category: \"Apparel\",\n item_category2: \"Adult\",\n item_category3: \"Shirts\",\n item_category4: \"Crew\",\n item_category5: \"Short sleeve\",\n item_list_id: \"related_products\",\n item_list_name: \"Related Products\",\n item_variant: \"green\",\n in_stock: true, // The item-scoped custom parameter \"in_stock\"\n location_id: \"ChIJIQBpAG2ahYAR_6128GcTUEo\",\n price: 10.01,\n quantity: 3\n }\n ]\n\nNote that these steps apply to both gtag.js and Google Tag Manager\nimplementations.\n\nNext steps\n----------\n\nTo analyze item-scoped custom parameters, you must create an item-scoped custom\ndimension. For information about how to set up the item-scoped custom dimension,\nsee [Custom dimensions and metrics](//support.google.com/analytics/answer/10075209)."]]
