Perguntas frequentes

Como faço para criar um ótimo anexo?

O recurso "Notificações por perto" exibe mensagens na seção "Próximo" das Configurações do Google, acende o bloco "Configurações rápidas por perto" em dispositivos compatíveis e promove os anexos de melhor desempenho como notificações.

Para garantir a eficácia máxima, os anexos:

• direcionar os usuários a apps ou sites que alguns usuários já acessaram naquele local.
• Atraia a maioria dos usuários que receberão a notificação.
• Otimizar a localização do beacon pode ajudar a segmentar apenas usuários interessados.
• Tenha uma call-to-action direta e evite surpreender o usuário.
• Busque mensagens que tenham engajamento positivo do usuário.
• Siga as políticas de notificações de proximidade para manter uma experiência positiva para nossos usuários.

Meu anexo não aparece na seção "Próximo" das Configurações do Google. Por quê?

• Há algumas restrições para mensagens que mostramos, como permitir apenas URLs HTTPS e proibir conteúdo que viole nossas políticas.
• Não há suporte para links para play.google.com. Em vez disso, use anexos de intent de app para ativar uma experiência desenvolvida por um app.

Minha mensagem não está sendo exibida como uma notificação. Por quê?

Há várias razões para uma notificação não ser exibida.

1. Uma notificação não será exibida se o anexo não for bem recebido pelos usuários. Veja acima dicas para criar um ótimo anexo.
2. O recurso Notificações por perto geralmente verifica os sensores por alguns segundos depois de ativar a tela. Se a tela não ficar ativa por algum tempo, o dispositivo não vai detectar novos beacons.
3. Um anexo no modo de depuração só é exibido em dispositivos no modo de depuração. Consulte também Modo de depuração.
4. Se a notificação tiver sido dispensada recentemente em um dispositivo, é possível que ele não mostre outra notificação durante um período. A política de espera também será redefinida se o usuário abrir a seção "Próximo" nas Configurações do Google.
5. Uma notificação não será exibida se violar as políticas de notificações de proximidade.

Quais versões do Android oferecem suporte ao recurso Notificações por perto?

O recurso Notificações por perto é compatível com o Android 4.4 (KitKat) e versões mais recentes.

Qual é a relação das notificações de proximidade com o URL Eddystone ou a Web física?

O recurso "Notificações por perto" funciona em paralelo com o URL Eddystone e a Web física com o comportamento exato, dependendo dos casos de uso e dos recursos. Por exemplo, se você tiver um caso de uso disponível no seu site, poderá usar um beacon de URL Eddystone. Se o caso de uso estiver disponível no seu app, use as Notificações por perto com uma intent de app.

Qual é o formato exigido para anexos de Notificações de proximidade na API de proximidade de sensor?

Consulte Formato de dados de anexo para mais detalhes. Em resumo, os anexos devem ter o seguinte formato:

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

Nos anexos de Notificações próximas, como o título é usado?

O título será exibido nas notificações e listas exibidas pelas Notificações por perto. Por exemplo, se o título estiver definido como "Exemplo de ação no local", o texto da notificação vai aparecer como "Example action at place", além do nome ou URL do app.

O recurso "Notificações por perto" instala o app em segundo plano?

Não. O recurso "Notificações por perto" redireciona os usuários para a Google Play Store.

Como saber se um usuário acessou meu app usando o recurso Notificações por perto?

Os links do recurso "Notificações por perto" são links diretos padrão do Android, mas se você quiser fornecer tags adicionais, como para métricas ou análises, adicione parâmetros de string de consulta ao componente do caminho do URL da intent.

O recurso Notificações por perto é compatível com iBeacon?

Sim, desde que o sensor tenha um ID iBeacon estático. Esses IDs podem ser registrados na API Nearby Beacons e podem ter anexos de Notificações por perto.

Onde e quando a verificação acontece, se não no meu app?

A verificação é realizada pelo Google Play Services e somente em eventos "screen-in".

Quem é responsável por registrar os sensores na API Nearby Beacon?

Qualquer pessoa pode registrar o sensor, desde que o anexo tenha o namespace e o tipo corretos. Na maioria dos casos, ele será o proprietário do sensor, mas poderá ser o OEM do sensor se você tiver um contrato com ele.

Qual é o formato do URI da intent do app?

Primeiro, com o Painel de beacon, é possível permitir que o front-end da Web crie um URI válido, desde que você entenda as partes do esquema, do host e do caminho do URI. Veja um exemplo:

Se você quiser que o recurso Notificações por perto inicie a atividade no seu app que tenha o seguinte filtro de intent:

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

O URI intent:// correspondente seria:

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

Ou seja, o URI pode ser dividido da seguinte maneira:

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

Se a atividade exigir extras de intent, elas precisarão ser adicionadas antes de ;end:

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

Os seguintes tipos podem ser usados em extras:

• Booleano
• Byte
• (65 caracteres)
• Dobro
• Ponto flutuante
• Int.
• Longo
• Short

Consulte também Intent.java#parseUri() e Intent.java#toUri(int) no contexto de URI_INTENT_SCHEME para mais detalhes sobre esse URL de intent.

E quanto à localização do título Notificações próximas?

Os anexos de notificações por perto precisam incluir o idioma/localidade como parte do namespace/tipo. O recurso só mostra esses anexos que correspondem às configurações de localidade do usuário.