Product categories

Last modified: 2. September 2022

Categorisation by product type attributes, up to 7 category levels possible

Product groups (‘ProductTypeGroup‘) are at the top of the 1st category level.

The 2nd category level contains the product categories (‘ProductType‘). Each ProductType is again assigned exactly one ProductTypeGroup.

Each product is now assigned to exactly one ProductType, and can have between zero and five specific product features (‘attributeValue1..5‘). If no product features exist, then a further categorisation other than ProductTypeGroup->ProductType is not advisable.

The location of the respective fields depends on the data format selection.

Fields for the category structure via ProductType Metadata

The metadata can be retrieved using the API product types method.

Category 1: ProductTypeGroup

  • category name: productTypeGroup->name
  • category ID: productTypeGroup->id

Category 2: ProductType

  • category name: productType->name
  • category ID: productType->id

Category 3 to 7 (optional):

  • category name: must be determined using the instructions described in the following two sections. Products->attributeValue1..5
  • category ID: productType->attributeTypeId1..5

Examples can be found further down.

Fields for category structure in standard data format

The product element/file can be used to form the category structure.

Category 1: ProductTypeGroup

  • category name: products->productTypeGroupName
  • category ID: products->productTypeGroupId

Category 2: ProductType

  • category name: products->productTypeName or productType->name
  • category ID: products->productTypeId or productType->id

Category 3: attributeValue1 (optional)

  • category name: products->attributeValue1
  • category ID: products->attributeTypeId1 or productType->attributeTypeId1

Category 4: attributeValue2 (optional)

  • category name: products->attributeValue2
  • category ID: products->attributeTypeId2 or productType->attributeTypeId2

Category 5: attributeValue3 (optional)

  • category name: products->attributeValue3
  • category ID: products->attributeTypeId3 or productType->attributeTypeId3

Category 6: attributeValue4 (optional)

  • category name: products->attributeValue4
  • category ID: products->attributeTypeId4 or productType->attributeTypeId4

Category 7: attributeValue5 (optional)

  • category name: products->attributeValue5
  • category ID: products->attributeTypeId5 or productType-> attributeTypeId5

Fields for category structure in developer data format

The category structure is formed using the product, product type and product type group elements/files.

Category 1: ProductTypeGroup

  • category name: productTypeGroup->name
  • category ID: productTypeGroup->id
  • productType reference to category: productType->productTypeGroup(Id)

Category 2: ProductType

  • category name: productType->name
  • category ID: productType->id
  • product reference to category: product->productType(Id)

Category 3: attributeValue1 (optional)

  • category name: products->attributeValue1
  • category ID: productType->attributeTypeId1

Category 4: attributeValue2 (optional)

  • category name: products->attributeValue2
  • category ID: productType->attributeTypeId2

Category 5: attributeValue3 (optional)

  • category name: products->attributeValue3
  • category ID: productType->attributeTypeId3

Category 6: attributeValue4 (optional)

  • category name: products->attributeValue4
  • category ID: productType->attributeTypeId4

Category 7: attributeValue5 (optional)

  • category name: products->attributeValue5
  • category ID: productType->attributeTypeId5

Examples

Example 1:

Product: Canon Pixma IP7200 (2371556000)

  <?xml> 
...
<productTypeGroupId>DRU</productTypeGroupId>
<productTypeGroupName>Printers, Scanners & Multifunction Devices </productTypeGroupName>
<productTypeId>140</productTypeId>
<productTypeName>Printer</productTypeName>
<attributeTypeId1>140250000</attributeTypeId1>
<attributeValue1>Inkjet printing</attributeValue1>
<attributeTypeId2>140240040</attributeTypeId2>
<attributeValue2>Colored</attributeValue2>
...

Would have the following category path
Printers, Scanners & Multifunction Devices -> Printers -> Inkjet printing -> Color

Example 2:

Product: Samsung SSD 850 EVO MZ-75 (3534638001)

  <? Xml> 
...
<productTypeGroupId>PCK</productTypeGroupId>
<productTypeGroupName>PC Components</productTypeGroupName>
<productTypeId>114</productTypeId>
<productTypeName>Hard Drives</productTypeName>
<attributeTypeId1>114113000</attributeTypeId1>
<attributeValue1>Intern</attributeValue1>
<attributeTypeId2>114010610</attributeTypeId2>
<attributeValue2>2.5"</attributeValue2>
<attributeTypeId3>114214010</attributeTypeId3>
<attributeValue3>Serial ATA</attributeValue3>
...

Would have the following category path
PC Components -> Hard Drives -> Internal -> 2.5 "-> Serial ATA
Was this article helpful?
Dislike 0
Views: 194