Messaggistica in-app

Informazioni utili per gestire i messaggi all’interno delle app iOS.

Per usare la funzione per messaggi in-app, è necessaria la versione 4.2 o successiva dell’SDK.

Alcune informazioni da tenere a mente:

  • I messaggi e le regole che definiscono quando questi verranno visualizzati vengono creati in Adobe Mobile Services. Per ulteriori informazioni, consulta Creare un messaggio in-app.

  • Per visualizzare i messaggi in-app, è necessario apportare all’SDK gli aggiornamenti descritti in questa sezione.

    SUGGERIMENTO

    Puoi completare questi passaggi anche in assenza di messaggi definiti. Una volta definiti, i messaggi verranno inviati in modo dinamico all'app e visualizzati senza che sia necessario un aggiornamento dell'App Store.

Abilitare i messaggi in-app

  1. Aggiungi la libreria al tuo progetto e implementa le funzioni di ciclo di vita (lifecycle).

    Per ulteriori informazioni, consulta Aggiungere l’SDK e il file di configurazione al progetto in Implementazione e ciclo di vita di base.

  2. Importa la libreria:

    #import "ADBMobile.h"
    
  3. Verifica che il file ADBMobileConfig.json contenga le impostazioni richieste per la messaggistica in-app.

  4. Affinché i messaggi in-app possano essere aggiornati all'avvio in modo dinamico, l'oggetto remotes deve essere presente e configurato correttamente:

    "messages": [ 
        { 
            "messageId": "de45c43c-37bf-441f-8cbd-cc3ba3469ebe", 
            "template": "fullscreen", 
            "showOffline": false, 
            "showRule": "always", 
            "endDate": 2524730400, 
            "startDate": 0, 
            "audiences": [], 
            "triggers": [], 
            "payload": { // contents change depending on template 
                "html": "<html>html code goes here</html>" 
            }, 
        }, 
        … 
    ] 
    "remotes" : { 
        "analytics.poi": "https://assets.adobedtm.com/…/yourfile.json", 
        "messages": "https://assets.adobedtm.com/…/yourfile.json" 
    }
    
    SUGGERIMENTO

    messages o remotes è obbligatorio.

    Se tali oggetti non sono configurati, scarica un file ADBMobileConfig.json aggiornato da Adobe Mobile Services. Per ulteriori informazioni, vedi Implementazione e ciclo di vita di base.

Tracciamento dei messaggi in-app

Gli SDK di iOS Mobile Services tengono traccia delle metriche seguenti per i messaggi in-app.

  • Per messaggi in-app a schermo intero e di tipo avviso:

    • Impression: quando l’utente attiva un messaggio in-app.
    • Click-through: quando l’utente preme il pulsante Click-through.
    • Annulla: quando l’utente preme il pulsante Annulla.
  • Per i messaggi in-app personalizzati a schermo intero, nel contenuto HTML del messaggio deve essere presente il codice corretto per trasmettere informazioni alla funzione di tracciamento dell'SDK per i seguenti pulsanti:

    • Esempio di tracciamento Click-through (reindirizzamento): adbinapp://confirm/?url=https://www.yoursite.com
    • Esempio di tracciamento per annullamento (chiusura): adbinapp://cancel
  • Per le notifiche locali (remote):

    • Impression: quando l’utente attiva la notifica.
    • Aperture: quando l’utente apre l’app da una notifica.

    Esempio di come includere il tracciamento delle operazioni di apertura:

    - (BOOL) application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { 
      // handle local notification click-throughs for iOS 10 and older 
      NSDictionary *localNotificationDictionary = launchOptions[UIApplicationLaunchOptionsLocalNotificationKey]; 
      if ([localNotificationDictionary isKindOfClass:[NSDictionary class]]) { 
           [ADBMobile trackLocalNotificationClickThrough:localNotificationDictionary]; 
      } 
    } 
    - (void) application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification { 
       [ADBMobile trackLocalNotificationClickThrough:notification.userInfo]; 
    }
    

Immagine di fallback locale

Quando crei un messaggio a schermo intero in Adobe Mobile Services, puoi facoltativamente specificare un’immagine di fallback. Se il messaggio non è in grado di recuperare dal web l’immagine prevista, l’SDK tenta di caricare l’immagine con lo stesso nome dal pacchetto dell’applicazione. Questo consente di visualizzare il messaggio nella sua forma originale anche se l’utente è offline o se l’immagine prevista non è raggiungibile.

Il nome della risorsa dell’immagine di fallback viene specificato al momento della configurazione del messaggio in Adobe Mobile Services.

IMPORTANTE

Assicurati che la risorsa specificata sia disponibile.

In questa pagina