How to Configure Android Push Strategy

À mesure que les fabricants d'appareils Android renforcent les limites de QPS et de quota de messages au niveau du fournisseur, le taux et la rapidité de livraison des notifications push peuvent être affectés. Pour améliorer l'efficacité de la livraison, EngageLab propose une stratégie de livraison push configurable. Vous pouvez personnaliser la priorité de livraison des différents canaux push à chaque envoi. Voir les détails ci-dessous.

🚪 Présentation des canaux

Les paramètres de stratégie de livraison ne sont effectifs que pour les appareils Android ayant intégré les canaux push des fabricants. Pour les instructions d'intégration, consultez le Guide d'intégration du SDK du canal fabricant.

Canal	Description	Types d'appareils pris en charge
Canal EngageLab	Canal propriétaire à connexion longue. Nécessite que l'appareil soit en ligne. Pas de livraison si hors ligne.	Tous les appareils ayant enregistré avec succès le canal EngageLab
Canaux fabricants	Canaux au niveau système prenant en charge la livraison hors ligne. Inclut Xiaomi, Huawei, OPPO, vivo, Meizu et FCM.	Xiaomi, Huawei, OPPO, vivo, Meizu, téléphones Google, etc.

⚙️ Instructions pour la stratégie de push Android

🔧 Configuration côté serveur

Configurez le champ third_party_channel.distribution_new dans l'objet options lors d'une requête push. S'il est omis, la valeur par défaut est pns_mtpush.

📌 Définition des champs

Champ	Type	Obligatoire	Signification	Remarques
distribution_new	String	✅ Oui	Définit la priorité de livraison entre les canaux EngageLab et fabricants	Doit être une chaîne non vide

🎯 Valeurs prises en charge

Valeur	Description
`mtpush`	Utilise toujours le canal EngageLab, sans recours aux canaux fabricants.
`pns_mtpush`	Privilégie les canaux fabricants (Xiaomi, Huawei, Meizu, OPPO, vivo, Honor). Bascule sur EngageLab en cas d'échec.
`mtpush_pns`	Privilégie EngageLab. En cas d'échec ou hors ligne, bascule sur le canal fabricant.
`fcm_mtpush`	Privilégie FCM. En cas d'échec, bascule sur EngageLab.
`mtpush_fcm`	Privilégie EngageLab. Bascule sur FCM si non en ligne.

⚠️ Remarque : Pour les stratégies pns_mtpush, fcm_mtpush, mtpush_pns et mtpush_fcm :

Si l'appareil ne prend en charge qu'un seul canal push (FCM ou fabricant), le système ignore la stratégie et utilise le canal valide disponible.

🧾 Exemple de requête

{ "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
        }
    }
}

Afficher ce bloc de code dans la fenêtre flottante

🖥 Configuration via la console

Accédez à :

AppPush → Créer un push → Message de notification → Plateforme Android → Paramètres avancés → Stratégie de livraison

Vous pouvez ici :

Choisir la stratégie de livraison préférée
Consulter l'état d'intégration actuel des canaux fabricants
Appliquer la stratégie uniquement aux appareils prenant en charge les canaux fabricants

texte alternatif

📊 Tableau des stratégies recommandées pour les canaux push Android (par région et capacités système)

Le tableau ci-dessous propose des stratégies de push recommandées selon le type d'appareil, la région géographique et la prise en charge des canaux. Il aide les développeurs à décider quand privilégier EngageLab, les canaux fabricants ou FCM.

Type d'appareil	Région	Accessibilité FCM	Accessibilité EngageLab et chemin	Remarques et recommandations
Téléphones version Chine continentale	Chine continentale	Toutes marques : Inaccessible.	Accessible.	Intégration fortement recommandée du service EngageLabAppPush (intégré avec les canaux fabricants principaux).
	Hong Kong, Chine	Toutes marques : Inaccessible.	Accessible ; Huawei, Honor, OPPO : Accessible via les canaux fabricants ou EngageLab ; Autres marques chinoises (Xiaomi, Meizu, vivo, etc.) : Accessible via les canaux EngageLab.	Intégration fortement recommandée du service EngageLabAppPush ; Les appareils Huawei, Honor et OPPO doivent privilégier leurs canaux fabricants.
Téléphones version Hong Kong	Hong Kong, Chine	Marques non chinoises (ex : Samsung) : Accessible ; Huawei version Hong Kong : Inaccessible ; Honor/OPPO version Hong Kong et autres versions chinoises Hong Kong : Accessible uniquement si l'appareil prend en charge FCM.	Accessible ; Huawei version Hong Kong : Accessible via les canaux fabricants ou EngageLab ; Honor/OPPO version Hong Kong : Accessible via les canaux fabricants ou EngageLab ; Autres versions chinoises Hong Kong/marques non chinoises : Accessible via les canaux EngageLab.	Intégration fortement recommandée du service EngageLabAppPush (intégré avec les canaux fabricants principaux). Huawei version Hong Kong doit utiliser les canaux fabricants ou EngageLab ; Honor/OPPO version Hong Kong peuvent choisir les canaux selon la prise en charge FCM de l'appareil ; Les autres marques doivent utiliser uniformément les canaux EngageLab.
	Chine continentale	Toutes marques : Inaccessible.	Accessible ; Huawei/Honor/OPPO version Hong Kong : Accessible via les canaux fabricants ou EngageLab ; Xiaomi/Meizu/vivo version Hong Kong et autres versions chinoises Hong Kong/marques non chinoises : Accessible via les canaux EngageLab.	Intégration fortement recommandée du service EngageLabAppPush ; Tous les appareils version Hong Kong en Chine continentale dépendent des canaux EngageLab ou fabricants pour recevoir les notifications push.

✅ Suggestions d'optimisation

✅ Pour tous les appareils ne pouvant pas intégrer FCM ou les canaux fabricants, il est recommandé d'utiliser le canal EngageLab.
✅ Pour les appareils ayant intégré avec succès les canaux fabricants, nous recommandons de paramétrer pns_mtpush (privilégier les canaux fabricants).
✅ Pour les appareils Android à l'étranger (notamment avec Android Google d'origine), privilégier FCM.
✅ Pour les utilisateurs en Chine continentale, il est fortement recommandé d'adopter une stratégie hybride combinant canaux fabricants + EngageLab.

Comment configurer la stratégie de push Android