Personnalisation du SDK iOS

Intégration

• Liens profonds
• Suivi des achats in-app
• Notifications push de géorepérage
• Création d’une file d’attente de Rich Media
• Lecture automatique d’une vidéo envoyée dans une notification riche avec Force Touch
• Son de notification push personnalisé
• Push provisoire iOS

Liens profonds

Dans votre fichier Info.plist, ajoutez un tableau URL types avec un URL Identifier et un URL Scheme.
Dans l’exemple ci-dessous, le URL Scheme est com.pushwoosh et l’URL Identifier est promotion.

Dans votre fichier App Delegate (généralement AppDelegate.m pour iOS 12 et versions antérieures, ou SceneDelegate.m pour iOS 13 et versions ultérieures), ajoutez la fonction déléguée openURL appropriée comme indiqué dans l’exemple ci-dessous. L’exemple vérifie la page correcte, analyse la valeur « id » de l’URL et ouvre PromoPageViewController en réponse.

AppDelegate.swift

Swift

func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    let components = URLComponents(url: url, resolvingAgainstBaseURL: false)
    let page = components?.host
    var promotionId: String?

    if page == "promotion" {
        return
    }

    let items = components?.queryItems ?? []

    for item in items {
        if item.name == "id" {
            promotionId = item.value
        }
    }

    //show PromoPageViewController
}

Objective-C

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
    NSURLComponents *components = [NSURLComponents componentsWithURL:url resolvingAgainstBaseURL:NO];
    NSString *page = components.host;
    NSString *promotionId = nil;

    //return if this is not a promotion deep link
    if(![page isEqualToString:@"promotion"])
        return NO;

    for(NSURLQueryItem *item in components.queryItems)
    {
        if([item.name isEqualToString:@"id"])
            promotionId = item.value;
    }

    PromoPageViewController *vc = [[PromoPageViewController alloc] init];
    vc.promotionId = promotionId
    [self presentViewController:vc animated:YES completion:nil];
}

SceneDelegate.swift

Swift

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let urlContext = URLContexts.first else { return }

    let components = URLComponents(url: urlContext.url, resolvingAgainstBaseURL: false)
    let page = components?.host
    var promotionId: String?

    guard page == "promotion" else {
        return
    }

    let items = components?.queryItems ?? []

    for item in items {
        if item.name == "id" {
            promotionId = item.value
        }
    }

    //show PromoPageViewController
}

Objective-C

- (void)scene:(UIWindowScene *)scene openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts {
    UIOpenURLContext *urlContext = URLContexts.anyObject;
    if (!urlContext) {
        return;
    }

    NSURLComponents *components = [NSURLComponents componentsWithURL:urlContext.URL resolvingAgainstBaseURL:NO];
    NSString *page = components.host;
    NSString *promotionId = nil;

    if (![page isEqualToString:@"promotion"]) {
        return;
    }

    for (NSURLQueryItem *item in components.queryItems) {
        if ([item.name isEqualToString:@"id"]) {
            promotionId = item.value;
        }
    }

    //show PromoPageViewController
}

Suivi des achats in-app

Par défaut, le suivi des achats in-app est désactivé. Si vous souhaitez suivre les achats in-app lors de la configuration des Customer Journeys, définissez l’indicateur Pushwoosh_PURCHASE_TRACKING_ENABLED sur true dans le fichier info.plist. Vous trouverez une liste des indicateurs disponibles dans le tableau.

Si vous souhaitez suivre les achats in-app manuellement, vous pouvez utiliser le code ci-dessous.

Dans la méthode déléguée paymentQueue:updatedTransactions:, appelez la méthode sendSKPaymentTransactions de PushManager

Swift

 func paymentQueue(_ queue: SKPaymentQueue, updatedTransactions transactions: [SKPaymentTransaction]) {
     // In-Apps Tracking Pushwoosh code here
     Pushwoosh.sharedInstance().sendSKPaymentTransactions(transactions)
     // the rest of the code, consume transactions, etc
 }

Objective-C

- (void)paymentQueue:(SKPaymentQueue *)queue updatedTransactions:(NSArray *)transactions {

  [[PushNotificationManager pushManager] sendSKPaymentTransactions:transactions];

  //the rest of the code, consume transactions, etc
}

Exemple

Notifications push de géorepérage

Les notifications push de géorepérage sont encapsulées dans un framework distinct PushwooshGeozones.

1. Ajoutez PushwooshGeozones.framework à votre projet

Pour ajouter PushwooshGeozones.framework à votre projet à l’aide d’un gestionnaire de dépendances, insérez les lignes suivantes dans votre podfile ou cartfile :

Podfile

pod 'PushwooshXCFramework/Geozones'

Carfile

github "Pushwoosh/pushwoosh-ios-sdk"

SwiftPM

Si vous voulez utiliser PushwooshGeozones.xcframework, entrez l’URL de package suivante :
PushwooshGeozones-XCFramework

Alternativement, vous pouvez simplement glisser-déposer le framework dans Link Binaries With Libraries dans les Build Phases de votre projet.

2. Ajoutez les clés suivantes à votre Info.plist :

• NSLocationWhenInUseUsageDescription – (requis) pour que l’application suive les géozones uniquement lorsqu’elle est exécutée en premier plan.
• NSLocationAlwaysAndWhenInUseUsageDescription – (requis) pour que l’application suive les géozones à la fois en premier plan et en arrière-plan et pour afficher une fenêtre de dialogue de demande d’autorisation.
• NSLocationAlwaysUsageDescription – (facultatif) pour que l’application suive les géozones à tout moment ; à utiliser si votre application cible iOS 10 et les versions antérieures.

<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>for app to track Geozones in both conditions and to show a permission request dialog</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>for app to track Geozones only while running in the foreground</string>

Exemple de Info.plist Pushwoosh

3. Importez le framework

Swift

import PushwooshGeozones

Objective-C

#import <PushwooshGeozones/PWGeozonesManager.h>

4. Démarrez le suivi des géozones

Swift

PWGeozonesManager.shared()?.startLocationTracking()

Référence GitHub

Objective-C

[[PWGeozonesManager sharedManager] startLocationTracking];

Référence GitHub

Exemple

Exemple Swift

override func viewDidLoad() {
    super.viewDidLoad()

    // Démarrez le suivi des géozones lorsque c'est nécessaire
    PWGeozonesManager.shared().startLocationTracking()
}

Exemple Objective-C

- (void)viewDidLoad {
    [super viewDidLoad];
    // Effectuez toute configuration supplémentaire après le chargement de la vue.

    // Démarrez le suivi des géozones lorsque c'est nécessaire
    [[PWGeozonesManager sharedManager] startLocationTracking];
}

Création d’une file d’attente de Rich Media

S’il y a plusieurs pages Rich Media à afficher simultanément (par exemple, des événements déclencheurs pour deux In-Apps ou plus ont lieu en même temps, ou une page Rich Media est déjà affichée au moment où un autre événement déclencheur se produit), vous pouvez configurer une file d’attente pour l’affichage des pages Rich Media. Pour créer une file d’attente, suivez les étapes décrites ci-dessous.

1. Créez une classe qui implémente PWRichMediaPresentingDelegate :

@interface ChainedRichMediaPresentingDelegate () <PWRichMediaPresentingDelegate>

@property (nonatomic) NSMutableArray *queue;

@property (nonatomic) BOOL inAppIsPresenting;

@end


@implementation ChainedRichMediaPresentingDelegate

- (instancetype)init {
    self = [super init];

    if (self) {
        _queue = [NSMutableArray new];
    }

    return self;
}

- (BOOL)richMediaManager:(PWRichMediaManager *)richMediaManager shouldPresentRichMedia:(PWRichMedia *)richMedia {
    [_queue addObject:richMedia];
    return !_inAppIsPresenting;
}

- (void)richMediaManager:(PWRichMediaManager *)richMediaManager didPresentRichMedia:(PWRichMedia *)richMedia {
    _inAppIsPresenting = YES;
}

- (void)richMediaManager:(PWRichMediaManager *)richMediaManager didCloseRichMedia:(PWRichMedia *)richMedia {
    _inAppIsPresenting = NO;

    [_queue removeObject:richMedia];

    if (_queue.count) {
        [[PWRichMediaManager sharedManager] presentRichMedia:_queue.firstObject];
    }
}

- (void)richMediaManager:(PWRichMediaManager *)richMediaManager presentingDidFailForRichMedia:(PWRichMedia *)richMedia withError:(NSError *)error {
    [self richMediaManager:richMediaManager didCloseRichMedia:richMedia];
}

@end

2. Définissez le délégué :

 [PWRichMediaManager sharedManager].delegate = [ChainedRichMediaPresentingDelegate new];

Swift (GitHub)

Exemple

Objective-C (GitHub)

Exemple

Lecture automatique d’une vidéo envoyée dans une notification riche avec Force Touch

Pour qu’une vidéo envoyée en tant que pièce jointe de notification riche soit lue automatiquement lorsque la notification est développée sans aucune interaction de l’utilisateur, suivez les étapes ci-dessous :

1. Ajoutez l’extension de contenu de notification à votre projet :

• Dans Xcode, sélectionnez File > New > Target.
• Choisissez Notification Content Extension.
• Donnez-lui un nom et terminez la configuration.

Si le message « Activer le schéma » s’affiche, choisissez Annuler.

2. Ajustez les propriétés et les méthodes dans l’extension de contenu comme suit :

import UIKit
import UserNotifications
import UserNotificationsUI
import AVKit


class NotificationViewController: UIViewController, UNNotificationContentExtension {
    var playerController: AVPlayerViewController!
    @IBOutlet weak var playerBackgroundView: UIView!

    override func viewDidLoad() {
        super.viewDidLoad()
        // Effectuez ici toute initialisation d'interface requise.
    }

    func didReceive(_ notification: UNNotification) {
        let attachment = notification.request.content.attachments.first

        playerController = AVPlayerViewController()
        // Définissez la hauteur par programmation
        // preferredContentSize.height = 250

        if let url = attachment?.url {
            setupVideoPlayer(url: url)
        } else {
            print("No valid URL...")
        }
    }

    private func setupVideoPlayer(url: URL) {
        guard let playerController = self.playerController else { return }
        let player = AVPlayer(url: url)
        playerController.player = player
        playerController.view.frame = self.playerBackgroundView.bounds
        playerBackgroundView.addSubview(playerController.view)
        addChild(playerController)
        playerController.didMove(toParent: self)
        player.play()
    }

3. Incorporez une UIView dans MainInterface.storyboard :

4. Liez l’IBOutlet playerBackgroundView à la UIView que vous venez d’ajouter :

5. Mettez à jour le fichier info.plist avec l’entrée suivante :

UNNotificationExtensionUserInteractionEnabled = true

Pour joindre une vidéo à votre notification, saisissez l’URL d’une vidéo dans le champ Media Attachment du Control Panel :

Lors de l’envoi d’une notification via la requête API /createMessage, incluez l’URL dans le paramètre « ios_attachment » et assurez-vous que l’indicateur « mutable-content » est défini sur `1`.

Note

Pour tester la fonctionnalité de lecture automatique, vous pouvez utiliser l’exemple de vidéo suivant : Exemple de vidéo Hello World.

Son de notification push personnalisé

Pour jouer un son personnalisé lors de la réception d’une notification push, placez d’abord le fichier audio dans le dossier racine de votre projet.

Ensuite, spécifiez le nom du fichier son dans les paramètres push – remplissez le champ Son des paramètres spécifiques à iOS de votre message ou spécifiez le nom du fichier comme valeur pour le paramètre « ios_sound » de la requête API createMessage.

Le fichier audio pour le son personnalisé iOS doit être dans l’un des formats suivants : .aif, .caf, .wav. Assurez-vous de spécifier le format dans le nom du fichier ; sinon, il sera ignoré par le SDK iOS de Pushwoosh.

Conseil

Tenez compte des limitations de l’App Store sur la taille du bundle lorsque vous ajoutez le fichier son à votre bundle.

Push provisoire iOS

Note

Pris en charge sur iOS 12 et versions ultérieures.

Comment ça marche

Les notifications push provisoires apparaissent silencieusement dans le Centre de notifications de l’utilisateur mais pas sur l’écran de verrouillage. Ce type de push n’a pas besoin d’être autorisé explicitement par un utilisateur : vous pouvez commencer à les envoyer dès qu’un utilisateur installe et lance votre application.

Cependant, les utilisateurs peuvent toujours s’abonner à vos notifications push proéminentes : en ouvrant le push provisoire, ils ont deux options pour choisir leur expérience – conserver les pushs dans le Centre de notifications sans alertes ni sons, ou vous autoriser à envoyer des pushs de manière proéminente afin qu’ils apparaissent sur l’écran de verrouillage.

Les pushs provisoires sont conçus pour permettre aux utilisateurs de prendre des décisions éclairées sur leur souhait de recevoir des notifications de votre application. Comme la demande d’abonnement native APN n’est montrée aux utilisateurs qu’une seule fois et que pour s’abonner plus tard, ils doivent se rendre dans les paramètres système de leur téléphone, certains utilisateurs pourraient ne pas s’abonner car ils ne sont pas conscients de la valeur qu’ils obtiennent avec vos pushs. Les pushs provisoires donnent aux utilisateurs cette compréhension : ils peuvent voir quel contenu vous livrez dans les notifications push et décider s’ils ont besoin d’être notifiés de ce contenu de manière proéminente.

Important

Veuillez noter que les pushs provisoires, lorsqu’ils sont mis en œuvre, remplacent l’invite native APN, ce qui signifie que les utilisateurs ne peuvent pas s’abonner aux notifications proéminentes tant qu’ils n’ont pas ouvert leur Centre de notifications et choisi de recevoir les pushs provisoires comme des pushs proéminents.

Comment mettre en œuvre

1. Intégrez le SDK iOS de Pushwoosh en suivant le guide.

2. Ajoutez la chaîne suivante à l’AppDelegate de votre projet avant d’appeler la méthode registerForPushNotifications() :

Swift

if #available(iOS 12.0, *) {
    Pushwoosh.sharedInstance().additionalAuthorizationOptions = UNAuthorizationOptions.provisional
}

Exemple

Objective-C

if (@available(iOS 12.0, *)) {
  [Pushwoosh sharedInstance].additionalAuthorizationOptions = UNAuthorizationOptionProvisional;
}

Exemple

C’est tout ! Les utilisateurs de l’application recevront des messages directement dans leur Centre de notifications une fois qu’ils auront installé l’application.

Partagez vos commentaires avec nous

Vos commentaires nous aident à créer une meilleure expérience, nous serions donc ravis d’avoir de vos nouvelles si vous rencontrez des problèmes lors du processus d’intégration du SDK. Si vous rencontrez des difficultés, n’hésitez pas à nous faire part de vos réflexions via ce formulaire.