How to Configure Android Push Strategy

A medida que los fabricantes de dispositivos Android endurecen los límites de QPS y de cuota de mensajes a nivel de proveedor, la tasa de entrega y la velocidad de las notificaciones push pueden verse afectadas. Para mejorar la eficacia de la entrega, EngageLab proporciona una estrategia de envío push configurable. Durante cada envío, se puede personalizar la prioridad de entrega de distintos canales push. Consulte los detalles a continuación.

🚪 Visión general de los canales

La configuración de la estrategia de entrega solo es efectiva en dispositivos Android que hayan integrado canales push del fabricante. Para obtener instrucciones de integración, consultar la Guía de integración del SDK del canal del fabricante.

Canal	Descripción	Tipos de dispositivos compatibles
Canal de EngageLab	Un canal de conexión persistente (long-connection) propio. Requiere que el dispositivo esté en línea. No se entrega si el dispositivo está sin conexión.	Todos los dispositivos que registren correctamente el canal de EngageLab
Canales del fabricante	Canales a nivel de sistema que admiten entrega sin conexión. Incluye Xiaomi, Huawei, OPPO, vivo, Meizu y FCM.	Xiaomi, Huawei, OPPO, vivo, Meizu, teléfonos Google, etc.

⚙️ Instrucciones de la estrategia de notificaciones push de Android

🔧 Configuración del lado del servidor

Configurar el campo third_party_channel.distribution_new en el objeto options durante una solicitud de push. Si se omite, el valor predeterminado es pns_mtpush.

📌 Definición del campo

Campo	Tipo	Obligatorio	Significado	Notas
distribution_new	String	✅ Sí	Define la prioridad de entrega entre EngageLab y los canales del fabricante	Debe ser una cadena no vacía

🎯 Valores compatibles

Valor	Descripción
`mtpush`	Usar siempre el canal de EngageLab, sin conmutación por error (fallback) a canales del fabricante.
`pns_mtpush`	Priorizar canales del fabricante (Xiaomi, Huawei, Meizu, OPPO, vivo, Honor). Si el canal del fabricante falla, conmutar al canal de EngageLab.
`mtpush_pns`	Priorizar EngageLab. Si está sin conexión o falla, conmutar al canal del fabricante.
`fcm_mtpush`	Priorizar FCM. Si falla, conmutar al canal de EngageLab.
`mtpush_fcm`	Priorizar EngageLab. Conmutar a FCM si no está en línea.

⚠️ Nota:
Para las estrategias pns_mtpush, fcm_mtpush, mtpush_pns y mtpush_fcm:

Si el dispositivo solo admite un canal push (FCM o fabricante), el sistema ignora la estrategia y utiliza el canal válido disponible.

🧾 Ejemplo de solicitud

{ "third_party_channel": { "distribution_new": "pns_mtpush", "xiaomi": { "channel_id": "*******", "small_icon_uri": "http://f6.market.xiaomi.com/download/MiPass/x/x.png", "small_icon_color": "#ABCDEF" }, "huawei": { "importance": "NORMAL", "small_icon_uri": "https://xx.com/xx.jpg", "only_use_vendor_style": true }, "oppo": { "channel_id": "*******", "large_icon": "3653918_5f92b5739ae676f5745bcbf4" }, "vivo": { "pushMode": 0 } } }

              
              {
    "third_party_channel": {
        "distribution_new": "pns_mtpush",
        "xiaomi": {
            "channel_id": "*******",
            "small_icon_uri": "http://f6.market.xiaomi.com/download/MiPass/x/x.png",
            "small_icon_color": "#ABCDEF"
        },
        "huawei": {
            "importance": "NORMAL",
            "small_icon_uri": "https://xx.com/xx.jpg",
            "only_use_vendor_style": true
        },
        "oppo": {
            "channel_id": "*******",
            "large_icon": "3653918_5f92b5739ae676f5745bcbf4"
        },
        "vivo": {
            "pushMode": 0
        }
    }
}

Este bloque de código se muestra en una ventana flotante

🖥 Configuración en la consola

Ir a:

AppPush → Create Push → Notification Message → Android Platform → Advanced Settings → Delivery Strategy

Aquí se puede:

Seleccionar la estrategia de entrega preferida
Ver el estado actual de integración de los canales del fabricante
Aplicar la estrategia solo a dispositivos compatibles con canales del fabricante

alt text

📊 Tabla recomendada de estrategia de canales push de Android (por región del dispositivo y capacidad de compatibilidad del sistema)

La tabla siguiente ofrece estrategias push recomendadas en función del tipo de dispositivo, la región geográfica y la compatibilidad de canales. Ayuda a los desarrolladores a decidir cuándo priorizar EngageLab, los canales del fabricante o FCM.

Tipo de dispositivo	Región	Alcance de FCM	Alcance y ruta de EngageLab	Observaciones y recomendaciones
Teléfonos móviles versión de China continental	China continental	Todas las marcas: no accesible.	Accesible.	Se recomienda encarecidamente integrar el servicio EngageLabAppPush (integrado con los canales de fabricante principales).
	Hong Kong, China	Todas las marcas: no accesible.	Accesible; Huawei, Honor, OPPO: accesible a través de canales del fabricante o de EngageLab; Otras marcas chinas (Xiaomi, Meizu, vivo, etc.): accesible a través de canales de EngageLab.	Se recomienda encarecidamente integrar el servicio EngageLabAppPush; Los dispositivos Huawei, Honor y OPPO deben priorizar el uso de sus canales del fabricante.
Teléfonos móviles versión de Hong Kong	Hong Kong, China	Marcas no chinas (como Samsung): accesible; Huawei versión de Hong Kong: no accesible; Honor/OPPO versión de Hong Kong y otras versiones de Hong Kong de marcas chinas: accesible solo si el dispositivo admite FCM.	Accesible; Huawei versión de Hong Kong: accesible a través de canales del fabricante o de EngageLab; Honor/OPPO versión de Hong Kong: accesible a través de canales del fabricante o de EngageLab; Otras versiones de Hong Kong de marcas chinas/marcas no chinas: accesible a través de canales de EngageLab.	Se recomienda encarecidamente integrar el servicio EngageLabAppPush (integrado con los canales de fabricante principales). Huawei versión de Hong Kong debe usar canales del fabricante o de EngageLab; Honor/OPPO versión de Hong Kong pueden elegir canales según la compatibilidad de FCM del dispositivo; Otras marcas deben usar de forma uniforme canales de EngageLab.
	China continental	Todas las marcas: no accesible.	Accesible; Huawei/Honor/OPPO versión de Hong Kong: accesible a través de canales del fabricante o de EngageLab; Xiaomi/Meizu/vivo versión de Hong Kong y otras versiones de Hong Kong de marcas chinas/marcas no chinas: accesible a través de canales de EngageLab.	Se recomienda encarecidamente integrar el servicio EngageLabAppPush; Todos los dispositivos versión de Hong Kong en China continental dependen de EngageLab o de canales del fabricante para habilitar notificaciones push.

✅ Sugerencias de optimización

✅ Para todos los dispositivos que no puedan integrar FCM ni canales del fabricante, se recomienda usar el canal de EngageLab.
✅ Para dispositivos con canales del fabricante integrados correctamente, se recomienda configurar pns_mtpush (priorizar canales del fabricante).
✅ Para dispositivos Android internacionales (especialmente con Android puro de Google), priorizar FCM.
✅ Para usuarios de China continental, se recomienda encarecidamente una estrategia híbrida que combine canales del fabricante + EngageLab.

Cómo configurar la estrategia de notificaciones push de Android