Notifications push

Activez les notifications push pour les applications iOS ou Android qui utilisent Marketo Mobile SDK.

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

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

Activation des notifications push dans l’application avec Marketo SDK

Ajoutez le code suivant au fichier AppDelegate.m pour diffuser des notifications push sur les appareils des clients.

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

Ajoutez l’import suivant à 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

Ajoutez le code suivant pour initialiser le service de notification push.

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 démarrer l’enregistrement auprès du service de notifications push Apple. Si l’enregistrement réussit, l’application appelle la méthode application:didRegisterForRemoteNotificationsWithDeviceToken: de l’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.

Enregistrez le jeton push avec Marketo. Le jeton d’appareil doit être enregistré pour recevoir des notifications push 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)
}

Vous pouvez également annuler l’enregistrement du jeton 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. Appelez cette méthode à partir de la méthode de connexion ViewController.

Gérer la notification push après l’enregistrement du 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 à AppDelegate.

Utilisez cette méthode pour afficher une alerte, émettre un son ou augmenter le badge lorsque l’application est en premier plan. Appelez le completionHandler approprié 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érez les notifications push nouvellement reçues dans AppDelegate.

Le délégué appelle cette méthode lorsque l’utilisateur répond à une notification en ouvrant l’application, en ignorant la notification ou en choisissant une action UNNotificationAction. Définissez le délégué avant que l’application ne renvoie 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)
}

Effectuez le suivi des notifications push.

Si l’application est en arrière-plan ou inactive, l’appareil reçoit une notification push, comme illustré ci-dessous. Marketo effectue un suivi lorsque l’utilisateur sélectionne la notification.

Lorsque l’appareil reçoit une notification push, il transmet la notification au rappel application:didReceiveRemoteNotification: sur le délégué de l’application.

Le journal d’activité Marketo suivant 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 au fichier manifeste dans 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 les autorisations requises et la fonctionnalité de récepteur. Si vous avez utilisé une version précédente de SDK, supprimez les éléments obsolètes suivants, ce qui peut entraîner la duplication des messages.

<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

Si les messages push mobiles ne fonctionnent pas comme prévu, vérifiez les problèmes de configuration courants avant d’examiner les détails d’implémentation.

Le message push ne s’affiche pas

Vérifiez que les messages push sont désactivés sur l’appareil. Les utilisateurs mobiles peuvent contrôler s’ils reçoivent des messages pour chaque application, et les développeurs ou les spécialistes du marketing peuvent désactiver les messages pendant le développement.

Vérifiez si l’application est ouverte et active. Lorsque l’application est active, les messages push mobiles n’apparaissent pas à l’écran. Ils apparaissent à la place dans la zone des « notifications locales » de l’application.

Affichage des journaux d’activité dans Marketo

Utilisez les journaux d’activité de Marketo pour vérifier qu’un message a été envoyé.

Vérifiez les enregistrements d’activité d’une personne qui aurait dû recevoir le message. Si le message a été envoyé, le journal d’activité contient un enregistrement. S’il n’existe aucun enregistrement, vérifiez le certificat iOS ou la configuration de la clé API Android dans Marketo.

Certificat ou clé non valide

Vérifiez que le certificat correct est chargé pour Sandbox ou Production. Si nécessaire, réexportez les certificats iOS ou les clés Android et rechargez-les dans Marketo.

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

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

Profils d’approvisionnement obsolètes (iOS)

Après avoir ajouté un appareil, mettez à jour les profils d’approvisionnement et générez de nouveaux certificats. Pointez le projet Xcode sur les profils et certificats appropriés, puis importez les certificats dans Marketo.

Impossible De Charger Le Certificat iOS (IOS)

Assurez-vous que le mot de passe utilisé pour exporter le 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, utilisez un certificat « développeur » ou « universel ». Pour les applications de production, chargez un certificat « distribution » ou « universel » valide.

Bounce push / Jeton non valide

Un jeton d’enregistrement peut devenir non valide dans les scénarios suivants :