Amorce de push iOS

Une amorce de push est une boîte de dialogue d’adhésion que vous affichez avant l’invite de permission push du système iOS. iOS n’affiche l’invite système qu’une seule fois par installation — si l’utilisateur appuie sur Ne pas autoriser, les notifications push sont perdues jusqu’à ce qu’il les réactive dans les Réglages. L’amorce vous permet d’expliquer d’abord la valeur et de demander au bon moment, afin que vous utilisiez l’unique invite système sur les utilisateurs qui ont déjà dit oui.

Disponible depuis la version 7.1.1. L’amorce fait partie de PushwooshFramework ; aucun module supplémentaire n’est requis.

Amorce de push affichée avant l’invite de permission système iOS

Comment ça marche

L’amorce est entièrement consciente de l’état. Elle lit l’état d’autorisation de notification actuel et décide quoi faire, il est donc sûr de l’appeler à chaque lancement :

• Non déterminé — affiche l’amorce ; en cas d’acceptation, elle déclenche l’invite de permission système.
• Autorisé ou provisoire — supprime silencieusement l’amorce (rien n’est affiché).
• Refusé — affiche l’amorce ; en cas d’acceptation, elle redirige l’utilisateur vers les réglages de notification de l’application (lorsque fallbackToSettings est activé).

Vous décidez quand appeler l’amorce (par exemple après l’intégration ou après une action clé). Le SDK n’impose aucun calendrier propre, à l’exception de la limitation optionnelle minInterval décrite ci-dessous.

Utilisation de base

Configurez l’amorce avec un constructeur fluent et appelez present. La configuration minimale nécessite un titre, un message et les titres des deux boutons.

Swift

import PushwooshFramework

Pushwoosh.configure.pushPrimer
    .title("Stay in the loop")
    .message("Get notified about deals and order updates first")
    .acceptButton("Enable notifications")
    .declineButton("Not now")
    .present()

Note

Appelez l’amorce après que l’interface utilisateur de l’application est à l’écran (par exemple, un court instant après le lancement, ou à une étape délibérée de votre flux), afin qu’elle puisse se présenter par-dessus votre interface.

Styles et positions

Utilisez style pour choisir entre une alerte système et une feuille personnalisée, et position pour placer la feuille personnalisée. Chaque position a son propre design par défaut.

Valeur	Description
.alert	UIAlertController système. La position est ignorée.
.sheet + .bottom	Feuille inférieure qui glisse vers le haut, avec une poignée et des boutons pleine largeur (par défaut).
.sheet + .top	Bannière compacte qui descend du haut, comme une notification.
.sheet + .center	Boîte de dialogue centrée qui s’agrandit et apparaît en fondu.

Swift

Pushwoosh.configure.pushPrimer
    .style(.sheet)
    .position(.top)
    .title("Stay in the loop")
    .message("Get notified about deals and order updates first")
    .acceptButton("Enable notifications")
    .declineButton("Not now")
    .present()

Personnalisation

Tous les paramètres visuels sont optionnels — omettez-les pour utiliser les valeurs par défaut natives qui s’adaptent aux modes clair et sombre.

Swift

Pushwoosh.configure.pushPrimer
    .style(.sheet)
    .position(.center)
    .title("Stay in the loop")
    .message("Get notified about deals and order updates first")
    .acceptButton("Enable notifications")
    .declineButton("Not now")
    .image(UIImage(named: "PrimerHero"))          // image locale, ou .imageURL("https://…")
    .backgroundColor(.systemBackground)
    .titleColor(.label)
    .messageColor(.secondaryLabel)
    .acceptButtonColor(.systemBlue)
    .acceptButtonTextColor(.white)
    .declineButtonColor(.clear)
    .declineButtonTextColor(.secondaryLabel)
    .cornerRadius(24)
    .buttonCornerRadius(14)
    .buttonBorderColor(.separator)
    .present()

Référence de personnalisation :

Setter	Description
image / imageURL	Une UIImage locale ou une URL distante. Affichée sous forme de cercle sur les mises en page centrale et inférieure, et comme icône sur la bannière supérieure. Une image locale a la priorité sur une URL.
backgroundColor	Couleur de fond unie de la carte.
backgroundGradient	Un tableau de couleurs rendu comme un dégradé doux multicolore. Remplace backgroundColor.
titleColor / messageColor	Couleurs du texte du titre et du message.
acceptButtonColor / acceptButtonTextColor	Couleurs de fond et de texte du bouton d’acceptation. La couleur d’acceptation teinte également l’icône par défaut.
declineButtonColor / declineButtonTextColor	Couleurs de fond et de texte du bouton de refus.
cornerRadius	Rayon des coins de la carte.
buttonCornerRadius / buttonBorderColor	Rayon des coins et couleur de la bordure des deux boutons.

Note

L’amorce affiche exactement les chaînes de caractères que vous passez. Pour plusieurs langues, passez des chaînes localisées (par exemple avec NSLocalizedString).

Paramètres de comportement

Comportement de repli vers les réglages

Par défaut, lorsque les notifications sont déjà refusées, l’amorce est affichée et le bouton d’acceptation emmène l’utilisateur vers les réglages de notification de l’application. Passez false pour supprimer entièrement l’amorce dans l’état refusé à la place.

.fallbackToSettings(false)

Fréquence d’affichage

Par défaut, l’amorce n’a pas de limitation intégrée — elle s’affiche chaque fois que vous appelez present (et est automatiquement supprimée une fois les notifications autorisées). Utilisez minInterval pour limiter la fréquence de réapparition de l’amorce. La dernière heure d’affichage est conservée entre les lancements.

.minInterval(7 * 24 * 60 * 60)   // afficher au maximum une fois par semaine

Gérer le résultat

Passez une complétion à present pour réagir au résultat.

Swift

Pushwoosh.configure.pushPrimer
    .title("Stay in the loop")
    .message("Get notified about deals and order updates first")
    .acceptButton("Enable notifications")
    .declineButton("Not now")
    .present { outcome in
        switch outcome {
        case .accepted:            break   // affichée, utilisateur a accepté, invite système demandée
        case .declined:            break   // affichée, utilisateur a refusé
        case .suppressed:          break   // non affichée (déjà autorisée, ou limitée)
        case .redirectedToSettings: break  // état refusé, utilisateur envoyé aux Réglages
        @unknown default:          break
        }
    }

Le résultat final de l’invite système (l’état accordé/refusé et le token de l’appareil) arrive via les rappels d’enregistrement réguliers — l’amorce réutilise registerForPushNotifications lors de l’acceptation et ne duplique pas cette chaîne.

Références

Référence de l'API du SDK iOS Documentation technique complète couvrant toutes les classes, méthodes et propriétés publiques.

Personnalisation du SDK iOS Autres façons d'adapter le SDK iOS de Pushwoosh à votre application.