Product Labelizer script: bucket conditions

Product Labelizer script: bucket conditions

Reference for the exact conditions the Product Labelizer script uses to assign each performance bucket.

Looking for the Labelizer app? This page is a technical reference for the standalone Product Labelizer script, not the in-app Labelizer feature.

This guide explains the exact conditions the Product Labelizer script uses to assign each product to a performance bucket. It's the reference to check if you want to understand precisely why a given product landed in a particular label.

Over-index condition

A product is labeled over-index when it performs significantly above target. All of the following must be true:

  • config.addToOverIndex is enabled, this setting allows products to be classified as over-index at all.
  • The product has enough clicks: productData.clicks > ((100 * config.clickMultiplier) / averageConversionRate). This uses the account's average conversion rate together with a configurable multiplier to decide what counts as "enough" traffic.
  • Its ROAS clears the target by a margin: convValuePerCost >= config.targetRoas + (config.percentageDifferenceTarget / 100 * config.targetRoas).

Index condition

A product is labeled index when it's performing at or slightly above target:

  • It has enough clicks: productData.clicks >= (100 / averageConversionRate).
  • Its ROAS meets the target: convValuePerCost >= config.targetRoas.

Near-index condition

A product is labeled near-index when it's performing slightly below target:

  • Its ROAS is at least the target minus a configurable margin: convValuePerCost >= (config.targetRoas - (config.percentageDifferenceTarget / 100 * config.targetRoas)).

Under-index condition

A product is labeled under-index when it has enough data to judge but doesn't meet any of the labels above:

  • It has more than one conversion, or enough clicks (productData.conversions > 1 || productData.clicks > (100 / averageConversionRate)), but its ROAS doesn't satisfy the index or near-index conditions.

No-index condition

If a product meets none of the conditions above, it's labeled no-index. This typically means it has very low clicks and conversions, so there isn't enough data yet to judge its performance.