Show Menu
ARGOMENTI×

Messaggistica in-app

Puoi fornire messaggi in-app attivati da qualsiasi dato o evento di analisi. Dopo l'implementazione, i messaggi vengono inviati in modo dinamico all'app e non richiedono un aggiornamento del codice.

Nuova versione di Adobe Experience Cloud SDK

Stai cercando informazioni e documentazione sull’SDK per dispositivi mobili di Adobe Experience Platform? Fai clic qui per la documentazione più recente.
A settembre 2018 è stata rilasciata una nuova versione principale dell'SDK. Questi nuovi SDK per dispositivi mobili di Adobe Experience Platform sono configurabili tramite Experience Platform Launch .
Se utilizzi gli SDK per dispositivi mobili di Adobe Experience Platform con Adobe Launch, devi anche installare l'estensione Adobe Analytics Mobile Services per utilizzare le funzioni di Adobe Mobile Services, ad esempio la messaggistica in-app e le notifiche push. Per ulteriori informazioni, consulta Adobe Analytics - Mobile Services . Per ulteriori informazioni sull'uso dei messaggi push e in-app con gli SDK Experience Cloud, consulta Configurare i messaggi push e Configurare la messaggistica in-app .
Per usare la funzione per messaggi in-app, devi disporre della versione SDK 4.2 o successiva.
Puoi creare messaggi e regole in Adobe Mobile Services per definire il momento in cui vengono visualizzati i messaggi. Per ulteriori informazioni, consulta Creare un messaggio in-app . Per visualizzare messaggi in-app, occorre effettuare aggiornamenti all'SDK. Puoi completare questi passaggi anche se non hai ancora definito messaggi. Una volta definiti, i messaggi verranno inviati in modo dinamico all'app e visualizzati senza che sia necessario un aggiornamento dell'App Store.

Abilitazione dei 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 IntelliJ IDEA o Eclipse in Implementazione e ciclo di vita di base .
  2. Aggiorna il file AndroidManifest.xml per dichiarare l'attività a schermo intero e abilita il gestore di notifica dei messaggi:
    <activity  
    android:name="com.adobe.mobile.MessageFullScreenActivity"  
    android:theme="@android:style/Theme.Translucent.NoTitleBar" /> 
    <receiver android:name="com.adobe.mobile.MessageNotificationHandler" />
    
    
    Se hai selezionato un layout modale, seleziona uno dei seguenti temi per il messaggio:
    • Theme.Translucent.NoTitleBar.Fullscreen
    • Theme.Translucent.NoTitleBar
    • Theme.Translucent Ad esempio:
    <activity 
    android:name="com.adobe.mobile.MessageFullScreenActivity" 
    android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen" 
    android:windowSoftInputMode="adjustUnspecified|stateHidden" /> 
    <receiver android:name="com.adobe.mobile.MessageNotificationHandler" />
    
    
  3. Importa la libreria:
    import com.adobe.mobile.*;
    
    
  4. In ciascuna chiamata collectLifecycleData , passa this per fornire un riferimento all'attività corrente:
    @Override 
    public void onResume() { 
        Config.collectLifecycleData(this); 
    }
    
    
  5. Verifica che il file ADBMobileConfig.json contenga le impostazioni richieste per la messaggistica in-app.
    messages o remotes è obbligatorio.
    Affinché i messaggi in-app vengano aggiornati dinamicamente all'avvio, 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” 
    }
    
    
    Se questo oggetto non è configurato, scarica un file ADBMobileConfig.json aggiornato da Adobe Mobile Services. Per ulteriori informazioni, consulta Prima di iniziare .

Tracciamento dei messaggi in-app

Gli SDK per dispositivi mobili Android tengono traccia delle metriche seguenti per i messaggi in-app:
  • Per messaggi in-app a schermo intero e in stile 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 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

Immagine di fallback locale

Quando crei un messaggio a schermo intero, puoi specificare facoltativamente un'immagine di fallback. Se il tuo messaggio non riesce a recuperare l'immagine prevista dal web, l'SDK tenta di caricare l'immagine con lo stesso nome dalla cartella assets dell'applicazione. In questo modo puoi mostrare il messaggio nella sua forma originale, anche se l'utente è offline o se l'immagine prestabilita non è raggiungibile.
Il nome della risorsa dell'immagine di fallback è specificato quando configuri il messaggio in Adobe Mobile Services; assicurati che la risorsa specificata sia disponibile.

Configurare le icone di notifica

I seguenti metodi di consentono di configurare l'icona piccola e l'icona grande che appaiono nell'area di notifica, nonché l'icona grande visualizzata quando le notifiche appaiono nel riquadro delle notifiche.
  • Config.setSmallIconResourceId(int resourceId)
    Imposta l'icona piccola che verrà utilizzata per le notifiche create dall'SDK. Questa icona compare sulla barra di stato e sarà l'immagine secondaria visualizzata quando l'utente visualizza la notifica completa nel Centro notifiche.
    • Di seguito è riportata la sintassi per questo metodo:
      public static void setSmallIconResourceId(final int resourceId); 
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      Config.setSmallIconResourceId(R.drawable.appIcon);
      
      
  • Config.setLargeIconResourceId(int resourceId)
    Imposta l'icona grande che verrà utilizzata per le notifiche create dall'SDK. Questa icona è l'immagine principale visualizzata dall'utente nella notifica completa all'interno del Centro notifiche.
    • Di seguito è riportata la sintassi per questo metodo:
      public static void setLargeIconResourceId(final int resourceId); 
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      Config.setLargeIconResourceId(R.drawable.appIcon);