Reglas de Acceso

PayWL ofrece 8 tipos de reglas para controlar el acceso a tu contenido. Combínalas para crear estrategias de monetización sofisticadas.

Tipos de Reglas

🔒 Paywall Duro

Bloquea completamente el acceso a categorías específicas. Solo suscriptores pueden ver el contenido.

ParámetroDescripción
categoriesCategorías que aplican (ej: "premium", "investigaciones")
plansPlanes que tienen acceso

Uso ideal: Contenido exclusivo de alto valor, investigaciones periodísticas.

📊 Medido (Metered)

Permite N vistas gratis por período antes de requerir suscripción.

ParámetroDescripción
free_viewsNúmero de vistas gratis (ej: 5)
periodPeríodo de reset: day, week, month
require_auth_afterDespués de N vistas, requiere login

Uso ideal: Balance entre alcance y monetización, contenido de análisis.

📧 Muro de Leads

Requiere registro de email antes de dar acceso. Captura leads para tu CRM.

ParámetroDescripción
fieldsCampos a capturar: email, name, phone
sync_to_crmSincronizar automáticamente a HubSpot

Uso ideal: Contenido especial, reportes, primeros pasos del funnel.

📱 Móvil

Límites específicos por plataforma para usuarios de dispositivos móviles/tablet.

ParámetroDescripción
mobile_limitLímite para móviles
tablet_limitLímite para tablets
desktop_limitLímite para desktop

Uso ideal: Diferenciación de experiencia por dispositivo.

❤️ Lealtad

Recompensa a suscriptores de largo plazo con acceso premium especial.

ParámetroDescripción
min_monthsMeses mínimos de suscripción
bonus_contentCategorías adicionales desbloqueadas

Uso ideal: Retención, reducir churn, premiar fidelidad.

🔗 Referente

Controla acceso según la fuente de tráfico. Bloquea o permite referentes específicos.

ParámetroDescripción
allowed_referrersDominios permitidos (ej: google.com)
blocked_referrersDominios bloqueados
actionallow_listed o block_listed

Uso ideal: Partnerships, tráfico de Google News, redes sociales.

🌎 Geográfico

Control de acceso por país o región. Restringe o abre contenido geográficamente.

ParámetroDescripción
allowed_countriesPaíses con acceso (ISO codes)
blocked_countriesPaíses bloqueados

Uso ideal: Contenido regional, restricciones legales, pricing por región.

⏰ Temporal

Acceso libre durante ventanas de tiempo específicas.

ParámetroDescripción
free_daysDías de la semana libres (ej: [0, 6] = fines de semana)
free_hoursHoras del día libres (ej: {start: 6, end: 9})
timezoneZona horaria (ej: America/Bogota)

Uso ideal: Promociones de fin de semana, happy hours, eventos especiales.

Prioridad de Reglas

Cuando múltiples reglas aplican al mismo contenido, se evalúan en orden de prioridad:

  1. Suscriptor activo: Siempre tiene acceso (bypass de reglas)
  2. Geográfico: Si está bloqueado por país, se deniega
  3. Referente: Si viene de fuente bloqueada, se deniega
  4. Temporal: Si está en ventana libre, se permite
  5. Paywall Duro: Si aplica, requiere suscripción
  6. Medido: Cuenta vistas, bloquea al límite
  7. Muro de Leads: Requiere registro

Crear una Regla

curl -X POST https://engine.paywl.io/rules \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Metered Premium",
    "type": "metered",
    "config": {
      "free_views": 5,
      "period": "month",
      "require_auth_after": 2
    },
    "categories": ["premium", "analisis"],
    "priority": 10,
    "enabled": true
  }'