Domande frequenti

Come faccio a creare un ottimo allegato?

La funzionalità Notifiche nelle vicinanze mostrerà 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 migliore rendimento sotto forma di notifiche.

Per la massima efficacia, gli allegati devono:

  • Indirizza gli utenti ad app o siti web che alcuni utenti visitano già in quella posizione.
  • Coinvolgi la maggior parte degli utenti che riceveranno la notifica.
  • L'ottimizzazione della posizione del beacon può aiutarti a scegliere come target solo gli utenti interessati.
  • Avere un invito all'azione diretto ed evitare di sorprendere l'utente.
  • Cerca di ottenere messaggi che ricevano un riscontro positivo dagli utenti.
  • Rispetta le norme sulle notifiche nelle vicinanze per mantenere un'esperienza positiva per i nostri utenti.

Il mio allegato non viene visualizzato nella sezione Nelle vicinanze di Impostazioni Google. Come mai?

  • I messaggi che mostriamo sono soggetti ad alcune limitazioni, ad esempio il fatto di consentire solo gli URL HTTPS e di impedire la pubblicazione di contenuti che violano le nostre norme.
  • I link a play.google.com non sono supportati. Utilizza invece gli allegati intent app per abilitare un'esperienza basata su un'app.

Il mio messaggio non viene visualizzato sotto forma di notifica. Come mai?

Le notifiche potrebbero non essere visualizzate per diversi motivi.

  1. Se la risposta non è ben ricevuta dagli utenti, non verrà visualizzata una notifica. I suggerimenti per creare un ottimo allegato si trovano sopra.
  2. In genere, Notifiche nelle vicinanze cerca i beacon per qualche secondo dopo l'attivazione dello schermo. Se lo schermo non si accende da un po' di tempo, il dispositivo non rileva i nuovi beacon.
  3. Un allegato in modalità di debug verrà visualizzato solo sui dispositivi in modalità di debug. Vedi anche Modalità debug
  4. Se una notifica è stata ignorata di recente su un dispositivo, nel dispositivo potrebbe non essere visualizzata un'altra notifica per un determinato periodo di tempo. Il criterio di backoff viene reimpostato anche se l'utente apre la sezione Nelle vicinanze di Impostazioni Google.
  5. Le notifiche potrebbero non essere mostrate se violano le norme della funzionalità Notifiche nelle vicinanze.

Quali versioni di Android supportano la funzionalità Notifiche nelle vicinanze?

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

Qual è la relazione tra Notifiche nelle vicinanze di Eddystone-URL o Material Web?

La funzionalità Notifiche nelle vicinanze funziona in parallelo con Eddystone-URL e Material Web con il comportamento esatto in base ai casi d'uso e alle funzionalità. Ad esempio, se hai un caso d'uso disponibile sul tuo sito web, potresti utilizzare un beacon URL Eddystone. Se il caso d'uso è disponibile nella tua app, potresti utilizzare la funzionalità Notifiche nelle vicinanze con un intent dell'app.

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

Per maggiori dettagli, consulta Formato dei dati allegati. In breve, gli allegati devono assumere il seguente formato:

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

Come viene utilizzato il titolo negli allegati di Notifiche nelle vicinanze?

Il titolo verrà visualizzato nelle notifiche e negli elenchi visualizzati dalla funzionalità Notifiche nelle vicinanze. Ad esempio, se il titolo è impostato su "Azione di esempio sul sito", il testo della notifica verrà visualizzato come "Example action at place" in aggiunta 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.

Come faccio a sapere se un utente è arrivato alla mia app tramite la funzionalità 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 dati di analisi, puoi aggiungere parametri della stringa di query nel componente del percorso dell'URL dell'intent.

Notifiche Qui vicino supporta iBeacon?

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

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

L'analisi viene eseguita da Google Play Services e soltanto in eventi "screen-on".

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

Chiunque può registrare il beacon, purché l'allegato abbia lo spazio dei nomi e il tipo corretti. Nella maggior parte dei casi, questo sarà il proprietario del beacon, ma potrebbe essere l'OEM del beacon se hai stipulato 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 per te, purché tu abbia compreso le parti dello schema, dell'host e del percorso dell'URI. Esempio:

Se vuoi che la funzionalità Notifiche nelle vicinanze avvii l'attività nella tua app con il 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 in questo modo:

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

Se la tua attività richiede extra per l'intenzione, devi aggiungerli prima del giorno ;end:

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

Nei servizi extra è possibile utilizzare i seguenti tipi:

  • Booleano
  • Byte
  • Char
  • Doppio
  • In virgola mobile
  • Int
  • Lungo
  • Short

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

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

Gli allegati di Notifiche nelle vicinanze devono includere la lingua/l'area geografica nello spazio dei nomi/tipo, mentre Notifiche nelle vicinanze mostrerà solo gli allegati che corrispondono alle impostazioni internazionali dell'utente.