Notifiche push

Abilitare le notifiche push.

Configurare le notifiche push in iOS

Esistono tre passaggi per abilitare le notifiche push:

Configurare le notifiche push sull’account Apple Developer

Abilitare le notifiche push in xCode

Attiva la funzionalità di notifica push nel progetto xCode.

Abilitare le notifiche push in app con Marketo SDK

Aggiungi il seguente codice a AppDelegate.m per inviare notifiche push ai dispositivi del cliente.

Nota - Se si utilizza Adobe Launch estensione, utilizzo ALMarketo come classname

Importa in AppDelegate.h.

#import <UserNotifications/UserNotifications.h>

import UserNotifications

Aggiungi UNUserNotificationCenterDelegate a AppDelegate come mostrato di seguito.

@interface AppDelegate : UIResponder <UIApplicationDelegate, UNUserNotificationCenterDelegate>

class AppDelegate: UIResponder, UIApplicationDelegate , UNUserNotificationCenterDelegate

Avvia il servizio di notifica push. Per abilitare la notifica push, aggiungi il codice seguente.

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
}

Chiama questo metodo per avviare il processo di registrazione con il servizio push di Apple. Se la registrazione ha esito positivo, l’app chiama l’oggetto delegato dell’app application:didRegisterForRemoteNotificationsWithDeviceToken: e gli trasmette un token di dispositivo.

Se la registrazione non riesce, l’app chiama il delegato dell’app application:didFailToRegisterForRemoteNotificationsWithError: al suo posto.

Registrare il token di push con Marketo. Per ricevere le notifiche push da Marketo è necessario registrare il token del dispositivo con 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)
}

È inoltre possibile annullare la registrazione del token quando l’utente si disconnette.

[[Marketo sharedInstance] unregisterPushDeviceToken];

Marketo.sharedInstance().unregisterPushDeviceToken

Per registrare nuovamente il token push, estrai il codice dal passaggio 3 in un metodo AppDelegate e chiama dal metodo di accesso ViewController.

Gestisce le notifiche push. Per ricevere le notifiche push da Marketo è necessario registrare il token del dispositivo con Marketo.

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

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

Aggiungi il seguente metodo in AppDelegate

Utilizzando questo metodo puoi presentare un avviso, un suono o un contrassegno in aumento mentre l’app è in primo piano. In questo metodo è necessario chiamare completionHandler desiderato.

-(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])
}

Gestire le notifiche push appena ricevute in AppDelegate

Il metodo verrà richiamato sul delegato quando l'utente ha risposto alla notifica aprendo l'applicazione, ignorando la notifica o scegliendo un UNNotificationAction. È necessario impostare il delegato prima che l'applicazione venga restituita da 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)
}

Tracciare le notifiche push

Se l'app è in esecuzione in background (o non è attiva), il dispositivo riceverà una notifica push come mostrato di seguito. Marketo tiene traccia di quando l’utente tocca la notifica.

Se il dispositivo riceve una notifica push, questa viene trasmessa a application:didReceiveRemoteNotification: callback sul delegato dell'app.

Di seguito è riportato un registro attività di Marketo da Marketo che mostra gli eventi dell’app e gli eventi di notifica push.

Configurare le notifiche push su Android

Dispositivi di prova Android

Aggiungi l’attività Marketo nel file manifesto all’interno del tag dell’applicazione.

<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/>

Registra servizio push Marketo

NOTA: l’SDK FCM aggiunge automaticamente tutte le autorizzazioni necessarie e la funzionalità di ricezione richiesta. Assicurati di rimuovere i seguenti elementi obsoleti (e potenzialmente dannosi, in quanto potrebbero causare la duplicazione dei messaggi) dal manifesto dell'app se hai utilizzato versioni precedenti dell'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"/>

Risoluzione dei problemi

La configurazione dei messaggi push per dispositivi mobili prevede molti passaggi e il coordinamento di sviluppatori e addetti al marketing. Se stai incontrando delle difficoltà, ci sono alcune cose semplici che puoi controllare.

Dopo aver verificato che le cose semplici siano corrette, puoi approfondire i dettagli di programmazione.

Il messaggio push non viene visualizzato

Innanzitutto, verifica se i messaggi push sono disabilitati sul ricevitore. Gli utenti di dispositivi mobili possono controllare se ricevere o meno messaggi per una particolare app. Spesso gli sviluppatori (e gli esperti di marketing) disabilitano questi messaggi ad un certo punto durante lo sviluppo. Pertanto, la prima cosa da verificare è se il destinatario ha disabilitato i messaggi push per l’app.

In secondo luogo, l’app è già aperta e attiva sul dispositivo? Quando l’app è attiva sul dispositivo, i messaggi push mobili non compaiono sullo schermo. Vengono invece visualizzate nell’area "Notifiche locali" dell’app.

Visualizzare i registri attività in Marketo

La prima posizione da controllare quando si tiene traccia di un errore è nei registri attività di Marketo. Puoi utilizzare i registri attività per verificare che un messaggio sia stato inviato.

Nel registro attività esaminare i record attività relativi a una persona che avrebbe dovuto ricevere un messaggio. Se il messaggio è stato inviato, sarà presente un record nel registro attività. In caso contrario, il problema è probabilmente dovuto alla configurazione del certificato iOS o della chiave API Android in Marketo.

Certificato o chiave non valida

Controlla nuovamente la configurazione per assicurarti di aver caricato il certificato corretto per Sandbox o Produzione. A volte è meglio chiedere allo sviluppatore di riesportare i certificati (iOS) o le chiavi (Android) e quindi ricaricarli in Marketo per assicurarsi che siano corretti.

Il file .p12 non dispone di un certificato o di una chiave (iOS)

Quando esporti il certificato, accertati di esportare la chiave e il certificato.

Provisioning dei profili non aggiornato (iOS)

Ogni volta che aggiungi un nuovo dispositivo, devi aggiornare i profili di provisioning e generare nuovi certificati. Assicurati che il progetto Xcode punti quindi ai profili e ai certificati corretti e importa tali certificati in Marketo.

Impossibile caricare il certificato iOS (IOS)

Assicurati che la password utilizzata durante l’esportazione del certificato non contenga spazi.  Ad esempio, invece di:

Hello World 123

utilizza questo:

HelloWorld123

Risoluzione dei problemi dei certificati iOS

Per le applicazioni sandbox, puoi utilizzare un certificato "sviluppatore" o "universale". Tuttavia, per le applicazioni di produzione è necessario caricare un certificato di "distribuzione" o "universale" valido.

Notifica di mancato recapito push/Token non valido

Un token di registrazione esistente potrebbe non essere più valido in diversi casi, tra cui: