Notifications push

Comment activer les notifications push.

Configurer les notifications push sur iOS

Il existe trois étapes pour activer les notifications push :

Configuration des notifications push sur le compte de développeur Apple

Activer les notifications push dans xCode

Activer la fonctionnalité de notification push dans le projet xCode.

Activation des notifications push dans l’application avec Marketo SDK

Ajoutez le code suivant AppDelegate.m fichier pour diffuser des notifications push sur les appareils de votre client.

Remarque - Si vous utilisez l’extension Adobe Launch, utilisez ALMarketo comme nom de classe

Importez les éléments suivants dans AppDelegate.h.

#import <UserNotifications/UserNotifications.h>

import UserNotifications

Ajoutez des UNUserNotificationCenterDelegate à AppDelegate, comme illustré ci-dessous.

@interface AppDelegate : UIResponder <UIApplicationDelegate, UNUserNotificationCenterDelegate>

class AppDelegate: UIResponder, UIApplicationDelegate , UNUserNotificationCenterDelegate

Lancez le service de notification push. Pour activer les notifications push, ajoutez le code ci-dessous.

BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
        center.delegate = self;
        [center requestAuthorizationWithOptions:(UNAuthorizationOptionSound | UNAuthorizationOptionAlert | UNAuthorizationOptionBadge) completionHandler:^(BOOL granted, NSError * _Nullable error){
            if(!error){
                dispatch_async(dispatch_get_main_queue(), ^{
                    [[UIApplication sharedApplication] registerForRemoteNotifications];
                });
            }
        }];

    return YES;
}

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

    UNUserNotificationCenter.current().requestAuthorization(options: [.alert, .sound,    .badge]) { granted, error in
            if let error = error {
                print("\(error.localizedDescription)")
            } else {
                DispatchQueue.main.async {
                    application.registerForRemoteNotifications()
                }
            }
        }

        return true
}

Appelez cette méthode pour lancer le processus d’enregistrement auprès du service Apple Push. Si l’enregistrement réussit, l’application appelle la méthode application:didRegisterForRemoteNotificationsWithDeviceToken: de votre objet délégué d’application et lui transmet un jeton d’appareil.

Si l’enregistrement échoue, l’application appelle la méthode application:didFailToRegisterForRemoteNotificationsWithError: de son délégué d’application à la place.

Enregistrer le jeton push avec Marketo. Pour recevoir des notifications push de Marketo, vous devez enregistrer le jeton d’appareil auprès de Marketo.

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    // Register the push token with Marketo
    [[Marketo sharedInstance] registerPushDeviceToken:deviceToken];
}

func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
    // Register the push token with Marketo
    Marketo.sharedInstance().registerPushDeviceToken(deviceToken)
}

Le jeton peut également être désenregistré lorsque l’utilisateur se déconnecte.

[[Marketo sharedInstance] unregisterPushDeviceToken];

Marketo.sharedInstance().unregisterPushDeviceToken

Pour réenregistrer le jeton push, extrayez le code de l’étape 3 dans une méthode AppDelegate et appelez de la méthode de connexion ViewController.

Gérer les notifications push. Pour recevoir des notifications push de Marketo, vous devez enregistrer le jeton d’appareil auprès de Marketo.

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo
{
    [[Marketo sharedInstance] handlePushNotification:userInfo];
}

func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) {
    Marketo.sharedInstance().handlePushNotification(userInfo)
}

Ajoutez la méthode suivante dans AppDelegate

En utilisant cette méthode, vous pouvez présenter une alerte, un son ou augmenter le badge lorsque l’application est en premier plan. Vous devez appeler completionHandler de votre choix dans cette méthode.

-(void)userNotificationCenter:(UNUserNotificationCenter *)center
    willPresentNotification:(UNNotification *)notification
        withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler{

    completionHandler(UNAuthorizationOptionSound | UNAuthorizationOptionAlert | UNAuthorizationOptionBadge);
}

func userNotificationCenter(_ center: UNUserNotificationCenter,
            willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (
    UNNotificationPresentationOptions) -> Void) {
    completionHandler([.alert, .sound,.badge])
}

Gérer les notifications push nouvellement reçues dans AppDelegate

La méthode est appelée sur le délégué lorsque l’utilisateur a répondu à la notification en ouvrant l’application, en ignorant la notification ou en choisissant une action UNNotificationAction. Le délégué doit être défini avant que l'application ne revienne de applicationDIDfinishLaunching :.

- (void)userNotificationCenter:(UNUserNotificationCenter *)center
didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void(^)(void))completionHandler {
    [[Marketo sharedInstance] userNotificationCenter:center didReceiveNotificationResponse:response withCompletionHandler:completionHandler];
}

func userNotificationCenter(_ center: UNUserNotificationCenter,
                                didReceive response: UNNotificationResponse,
                                withCompletionHandler
                                completionHandler: @escaping () -> Void) {
        Marketo.sharedInstance().userNotificationCenter(center, didReceive: response, withCompletionHandler: completionHandler)
}

Suivi des notifications push

Si votre application s’exécute en arrière-plan (ou n’est pas active), l’appareil reçoit une notification push comme illustré ci-dessous. Marketo effectue le suivi lorsque l’utilisateur appuie sur la notification.

Si l’appareil reçoit une notification push, elle sera transmise à application:didReceiveRemoteNotification: rappel sur votre délégué d’application.

Vous trouverez ci-dessous un journal des activités Marketo de Marketo qui affiche les événements d’application et les événements de notification push.

Configurer les notifications push sur Android

Appareils de test Android

Ajoutez l’activité Marketo dans le fichier manifeste à l’intérieur de la balise d’application.

<activity android:name="com.marketo.MarketoActivity"  android:configChanges="orientation|screenSize">
    <intent-filter android:label="MarketoActivity">
        <action  android:name="android.intent.action.VIEW"/>
        <category  android:name="android.intent.category.DEFAULT"/>
        <category  android:name="android.intent.category.BROWSABLE"/>
        <data android:host="add_test_device" android:scheme="mkto"/>
    </intent-filter/>
</activity/>

Enregistrer le service Marketo Push

REMARQUE : le SDK FCM ajoute automatiquement toutes les autorisations requises ainsi que la fonctionnalité de récepteur requise. Veillez à supprimer les éléments obsolètes (et potentiellement dangereux, car ils peuvent entraîner la duplication des messages) suivants du manifeste de votre application si vous avez utilisé des versions précédentes de SDK

<receiver android:name="com.marketo.MarketoBroadcastReceiver" android:permission="com.google.android.c2dm.permission.SEND">
    <intent-filter>
        <!‐‐Receives the actual messages.‐‐>
        <action android:name="com.google.android.c2dm.intent.RECEIVE"/>
        <!‐‐Register to enable push notification‐‐>
        <action android:name="com.google.android.c2dm.intent.REGISTRATION"/>
        <!‐‐‐Replace YOUR_PACKAGE_NAME with your own package name‐‐>
        <category android:name="YOUR_PACKAGE_NAME"/>
    </intent-filter>
</receiver>

<!‐‐Marketo service to handle push registration and notification‐‐>
<service android:name="com.marketo.MarketoIntentService"/>

Dépannage

La configuration des messages push mobiles implique de nombreuses étapes et la coordination des développeurs et des spécialistes marketing. Si vous rencontrez des difficultés, il y a des choses simples que vous pouvez vérifier.

Après vous être assuré que les éléments simples sont corrects, vous pouvez examiner plus en détail la programmation.

Le message push ne s’affiche pas

Tout d'abord, vérifiez si les messages push sont désactivés sur le combiné. Les utilisateurs d’appareils mobiles peuvent décider de recevoir ou non des messages pour une application spécifique. Souvent, les développeurs (et les marketeurs) désactivent ces messages à un moment donné au cours du développement. La première chose à vérifier est donc de savoir si le destinataire a désactivé les messages push pour votre application.

Deuxièmement, l’application est-elle déjà ouverte et active sur l’appareil ? Lorsque votre application est l’application active sur l’appareil, les messages push mobiles ne s’affichent pas à l’écran. Au lieu de cela, elles apparaissent dans la zone des « notifications locales » de votre application.

Affichage des journaux d’activité dans Marketo

Les journaux d’activité de Marketo sont le premier endroit à consulter lors du suivi d’une erreur. Vous pouvez utiliser les journaux d’activité pour vérifier qu’un message a été envoyé.

Dans le journal des activités, examinez les enregistrements d’activité d’une personne qui était censée recevoir un message. Si le message a été envoyé, un enregistrement est présent dans le journal d’activité. Dans le cas contraire, le problème est probablement dû à la configuration du certificat iOS ou de la clé API Android dans Marketo.

Certificat ou clé non valide

Vérifiez à nouveau votre configuration pour vous assurer que le certificat approprié est chargé pour la sandbox ou la production. Parfois, il est préférable que le développeur réexporte les certificats (iOS) ou les clés (Android), puis les recharge dans Marketo pour s’assurer qu’ils sont corrects.

Il manque un certificat ou une clé au fichier .p12 (iOS)

Lorsque vous exportez le certificat, veillez à exporter la clé et le certificat.

Profils d’approvisionnement obsolètes (iOS)

Chaque fois que vous ajoutez un nouvel appareil, vous devez mettre à jour vos profils d’approvisionnement et générer de nouveaux certificats. Assurez-vous que votre projet Xcode pointe ensuite vers les profils et certificats appropriés, puis importez ces certificats dans Marketo.

Impossible De Charger Le Certificat iOS (IOS)

Assurez-vous que le mot de passe utilisé lors de l’exportation du certificat ne contient pas d’espaces.  Par exemple, au lieu de cela :

Hello World 123

utilisez ce qui suit :

HelloWorld123

Résolution des problèmes liés aux certificats iOS

Pour les applications Sandbox, vous pouvez utiliser un certificat « développeur » ou « universel ». Mais pour les applications de production, vous devez télécharger un certificat « distribution » ou « universel » valide.

Bounce push / Jeton non valide

Un jeton d’enregistrement existant peut cesser d’être valide dans un certain nombre de scénarios, notamment :