DocumentacionCobertura por idioma

Cobertura por idioma

GET /campaigns/:id/locale-coverage y fallback de variantes.

Antes de lanzar una campana multi-idioma, comprueba que cada segmento de audiencia tiene variante de plantilla disponible.

Consultar cobertura

curl "https://api.mailingcore.com/campaigns/clcampaignid/locale-coverage" \
  -H "Authorization: Bearer mc_live_xxxx" \
  -H "X-Tenant-Id: clxxxxxxxx"

Scope: campaigns:read.

Respuesta tipica (array por locale):

[
  { "locale": "es", "audienceCount": 1200, "hasVariant": true },
  { "locale": "en", "audienceCount": 340, "hasVariant": true },
  { "locale": "it", "audienceCount": 85, "hasVariant": false }
]
CampoSignificado
localeCodigo de idioma del contacto
audienceCountContactos con ese locale en el filtro de la campana
hasVariantExiste version de plantilla para ese idioma

Cadena de fallback al enviar

Cuando un contacto recibe la campana, MailingCore resuelve la plantilla en este orden:

  1. Locale del contacto (es, en, it, fr, ca, de)
  2. CAMPAIGN_FALLBACK_LOCALE del servidor (valor por defecto: es)
  3. Version base de la plantilla (sin variante de idioma)

Alinea el locale que guardas en Crear o actualizar contacto con las variantes que publicas en plantillas.

Flujo recomendado

  1. Importa contactos con locale

    Define locale en upsert o bulk import segun preferencia del usuario.

  2. Publica variantes

    Cada idioma activo necesita su version publicada de la plantilla.

  3. Llama locale-coverage

    Revisa hasVariant: false y audienceCount alto — son riesgo de contenido en idioma incorrecto.

  4. Ajusta o envia

    Anade variantes faltantes o limita audienceFilter.locale en Campanas.

Idiomas soportados

Contactos y paginas de baja comparten los mismos codigos: es, en, it, fr, ca, de. La pagina hosted de baja acepta ?lang= con esos valores — ver Bajas y GDPR.