Domande frequenti

Come si crea un allegato efficace?

La funzionalità Notifiche nelle vicinanze mostra i messaggi nella sezione Nelle vicinanze di Impostazioni Google, illumina il riquadro Impostazioni rapide nelle vicinanze sui dispositivi supportati e promuoverà gli allegati con il rendimento migliore come notifiche.

Per la massima efficacia, gli allegati devono:

  • Indirizza gli utenti ad app o siti web già visitati da alcuni utenti in ogni località.
  • Presentare un ricorso interessante alla maggior parte degli utenti che riceveranno la notifica.
  • L'ottimizzazione della posizione del beacon può aiutarti a scegliere come target solo gli utenti interessati.
  • Usare un invito all'azione diretto ed evitare di sorprendere l'utente.
  • Cerca di ricevere messaggi che ricevano un coinvolgimento positivo degli utenti.
  • Rispettare le norme relative alle notifiche nelle vicinanze per garantire un'esperienza positiva ai nostri utenti.

Il mio allegato non viene visualizzato nella sezione Nelle vicinanze delle Impostazioni Google. Perché?

  • Esistono alcuni vincoli sui messaggi che mostriamo, ad esempio consentire solo l'accesso tramite HTTPS URL e non consentire contenuti che violano le nostre norme.
  • I link che rimandano a play.google.com non sono supportati. Usa invece Allegati per intent di app per consentire un'esperienza basata su app.

Il mio messaggio non viene visualizzato come notifica. Perché?

Una notifica potrebbe non essere visualizzata per diversi motivi.

  1. Se l'allegato non viene accolto correttamente dagli utenti, non verrà visualizzata alcuna notifica. Trovi qui sopra alcuni suggerimenti per creare un allegato efficace.
  2. La funzionalità Notifiche nelle vicinanze in genere esegue la scansione di beacon per alcuni secondi dopo che che lo schermo sia acceso. Se lo schermo non è acceso da un po' di tempo, Il dispositivo non rileverà nuovi beacon.
  3. Un allegato in modalità di debug verrà visualizzato solo per il debug dispositivi con modalità schermo. Vedi anche Modalità di debug
  4. Se la notifica è stata ignorata su un dispositivo di recente, il dispositivo potrebbe non mostrare un'altra notifica per un determinato periodo di tempo. Viene reimpostato anche il criterio di backoff se l'utente apre la sezione Nelle vicinanze di Impostazioni Google.
  5. Una notifica potrebbe non essere visualizzata se viola le Notifiche nelle vicinanze .

Quali versioni di Android supportano le notifiche nelle vicinanze?

La funzionalità Notifiche nelle vicinanze è supportata su Android 4.4 (KitKat) e versioni successive.

Qual è la relazione tra Notifiche nelle vicinanze e Eddystone-URL o Physical Web?

Notifiche nelle vicinanze funziona in parallelo con Eddystone-URL e Physical Web con comportamento esatto a seconda dei casi d'uso e delle capacità. Ad esempio, se un caso d'uso disponibile sul tuo sito web, potresti utilizzare Beaconing URL Eddystone. Se il caso d'uso è disponibile nella tua app, potresti usare Notifiche nelle vicinanze con un intent di app.

Qual è il formato richiesto per gli allegati delle notifiche nelle vicinanze nell'API Proximity Beacon?

Consulta Formato dei dati degli allegati per i dettagli. In breve, gli allegati devono avere il seguente formato:

    {
      "title": "Example",
      "url": "https://www.example.com"
    }

Negli allegati delle notifiche nelle vicinanze, come viene utilizzato il titolo?

Il titolo verrà visualizzato nelle notifiche e negli elenchi visualizzati Notifiche nelle vicinanze. Ad esempio, se il titolo è impostato su "Esempio di azione nel luogo", il testo della notifica verrà visualizzato come "Example action at place" oltre al nome o all'URL dell'app.

La funzionalità Notifiche nelle vicinanze installa l'app in background?

No. La funzionalità Notifiche nelle vicinanze reindirizza gli utenti al Google Play Store per l'installazione da lì.

Come faccio a sapere se un utente è arrivato alla mia app tramite Notifiche nelle vicinanze?

I link Notifiche nelle vicinanze sono link diretti standard di Android, ma se vuoi fornire tag aggiuntivi, ad esempio per metriche o analisi, puoi aggiungere query nel componente del percorso dell'URL di intent.

Notifiche nelle vicinanze supporta iBeacon?

Sì, purché il beacon abbia un ID iBeacon statico. Questi ID possono essere registrati nell'API Proximity Beacon e possono avere allegati Notifiche nelle vicinanze.

Dove e quando viene eseguita l'analisi, se non nella mia app?

L'analisi viene eseguita da Google Play Services e soltanto quando lo schermo è attivo eventi.

Chi è responsabile della registrazione dei beacon nell'API Proximity Beacon?

Chiunque può registrare il beacon, purché l'allegato abbia il diritto di accesso e il tipo di spazio dei nomi. Nella maggior parte dei casi l'utente sarà il proprietario del beacon, ma potrebbe essere l'OEM del beacon se hai un contratto con loro.

Qual è il formato dell'URI dell'intent dell'app?

Innanzitutto, con la dashboard di Beacon puoi consentire al frontend web di creare un URI valido fornito comprendere lo schema, l'host e il percorso dell'URI. Ecco un esempio:

Se vuoi che Notifiche nelle vicinanze avvii l'attività nella tua app che presenta seguente filtro per intent:

    <data android:host="item"
          android:pathPrefix="/scanner"
          android:scheme="myapp" />

L'URI intent:// corrispondente sarebbe:

    intent://item/scanner#Intent;scheme=myapp;package=com.myapp;end

Ciò significa che l'URI può essere suddiviso come segue:

    intent://<host>/<path>#Intent;scheme=<scheme>;package=<package name>;end

Se la tua attività richiede ulteriori intent, questi devono essere aggiunti poco prima ;end:

    intent://item/scanner#Intent;scheme=myapp;package=com.myapp;S.string_extra=value%20one;B.bool_extra=true;end

Negli extra si possono utilizzare i seguenti tipi:

  • Booleano
  • Byte
  • Carattere
  • Doppio
  • Float
  • Int
  • Lungo
  • Breve

Vedi anche Intent.java#parseUri() e Intent.java#toUri(int) nel contesto di URI_INTENT_SCHEME per maggiori dettagli su questo URL per intent.

E per quanto riguarda la localizzazione del titolo di Notifiche nelle vicinanze?

Gli allegati di Notifiche nelle vicinanze devono includere la lingua e le impostazioni internazionali dell'attributo spazio dei nomi/tipo e Notifiche nelle vicinanze mostreranno solo gli allegati che corrispondono alle impostazioni internazionali dell'utente.