Endpoint - Reglas de curacion

Las reglas de curacion permiten forzar que ciertos productos aparezcan (o no) cuando el cliente busca ciertos terminos. Es la palanca manual del merchant cuando el ranking automatico no encaja con su estrategia.

Dos modos:

• pin: fija un producto en un puesto concreto del ranking (e.g. "para regalo el item A va en la posicion 1").
• override: reemplaza completamente los resultados del motor con una lista curada (e.g. "para oferta semanal muestra exactamente estos 8 productos en este orden").

GET /v1/{tenant}/rules

curl https://api.mibizum.io/v1/tu-tienda/rules \
  -H "Authorization: Bearer mb_sk_live_..."

Respuesta

{
  "rows": [
    {
      "id": 7,
      "terms": ["regalo", "regalos"],
      "match_type": "exact",
      "mode": "pin",
      "items": [
        { "item_type": "product", "item_id": "sku-099", "position": 1, "weight": 1.0 }
      ],
      "enabled": true,
      "valid_from": null,
      "valid_until": null,
      "notes": "Promo navidad"
    }
  ]
}

Campos

• terms: lista de palabras que disparan la regla. Multiples terminos = la regla aplica para cualquiera de ellos.
• match_type: exact / contains / starts_with / regex. Por defecto exact (mas seguro).
• mode: pin o override.
• items: lista de items afectados. position es el puesto deseado (1-indexed). weight solo aplica en override.
• valid_from/valid_until: ventana temporal opcional (ISO 8601). Util para campanas estacionales.

POST /v1/{tenant}/rules

curl -X POST https://api.mibizum.io/v1/tu-tienda/rules \
  -H "Authorization: Bearer mb_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "terms": ["regalo"],
    "match_type": "exact",
    "mode": "pin",
    "items": [{ "item_type": "product", "item_id": "sku-099", "position": 1, "weight": 1.0 }]
  }'

Estadisticas

Cada regla acumula impresiones y clicks. Las puedes ver con ?period=day|week|month:

curl "https://api.mibizum.io/v1/tu-tienda/rules?period=week" \
  -H "Authorization: Bearer mb_sk_live_..."

Cada regla devuelta lleva stats: { impressions, clicks, ctr }.