Além desses parâmetros, você pode incluir até 27 parâmetros personalizados na matriz items. Esses parâmetros são chamados de parâmetros personalizados no escopo do item e permitem capturar dados úteis para seu negócio. Desses 27 parâmetros, você pode configurar:
10 dimensões personalizadas no escopo do item para propriedades padrão
25 dimensões personalizadas no escopo do item para propriedades do Analytics 360
Analise a lista de parâmetros obrigatórios e recomendados antes de criar seus parâmetros personalizados no escopo do item.
Adicionar um parâmetro personalizado no escopo do item
Para adicionar um parâmetro personalizado no escopo do item, inclua o parâmetro na matriz items. Por exemplo, para saber se um produto está em estoque, você pode:
Adicione o seguinte parâmetro personalizado in_stock ao evento:
Essas etapas são aplicadas às implementações do Gerenciador de tags do Google e gtag.js.
Próximas etapas
Para analisar parâmetros personalizados no escopo do item, é preciso criar uma dimensão personalizada no escopo do item. Para informações sobre como configurar essa dimensão, confira Dimensões e métricas personalizadas.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2024-09-13 UTC."],[[["\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)."]]
