Endpoint - Reglas de curación

Las reglas de curación permiten forzar que ciertos productos aparezcan (o no) cuando el cliente busca ciertos terminos. Es la palanca manual del merchant cuando el ranking automático 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 posición 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. Múltiples terminos = la regla aplica para cualquiera de ellos.
• match_type: exact / contains / starts_with / regex. Por defecto exact (más 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). Útil 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 }.