Questions fréquentes

Comment créer une pièce jointe efficace ?

La fonctionnalité Notifications de proximité affiche les messages dans la section "À proximité" des paramètres Google, affiche la fenêtre de configuration rapide à proximité sur les appareils compatibles et fait la promotion des pièces jointes les plus performantes en tant que notifications.

Pour une efficacité maximale, les pièces jointes doivent:

  • Dirigez les utilisateurs vers des applications ou des sites Web que certains utilisateurs consultent déjà à cet emplacement.
  • Attirez l'attention de la plupart des utilisateurs qui recevront la notification.
  • L'optimisation de la position de la balise peut vous aider à ne cibler que les utilisateurs intéressés.
  • Ajoutez une incitation à l'action directe et évitez de surprendre l'utilisateur.
  • Efforcez-vous d'identifier les messages qui suscitent un engagement utilisateur positif.
  • Respectez le Règlement sur les notifications à proximité afin de garantir une expérience positive pour les utilisateurs.

Ma pièce jointe n'apparaît pas dans la section "À proximité" des paramètres Google. Pourquoi ?

  • Nous appliquons quelques contraintes aux messages que nous affichons, par exemple en autorisant uniquement les URL HTTPS et en interdisant les contenus qui ne respectent pas nos règles.
  • Les liens vers play.google.com ne sont pas acceptés. Utilisez plutôt des rattachements d'intents à l'application pour offrir une expérience basée sur une application.

Mon message ne s'affiche pas sous forme de notification. Pourquoi ?

Une notification peut ne pas s'afficher pour plusieurs raisons.

  1. Aucune notification ne s'affichera si les utilisateurs ne reçoivent pas la pièce jointe correctement. Vous trouverez ci-dessus des conseils pour créer une pièce jointe efficace.
  2. Les notifications de Nearby recherchent en général des balises pendant quelques secondes après l'allumage de l'écran. Si l'écran n'est pas allumé depuis un certain temps, l'appareil ne détectera pas les nouvelles balises.
  3. Une pièce jointe en mode débogage ne s'affiche que sur les appareils en mode débogage. Consultez également l'article Mode débogage.
  4. Si la notification a été fermée récemment sur un appareil, il est possible qu'aucune autre notification ne s'affiche pendant un certain temps. L'intervalle entre les tentatives est également réinitialisé si l'utilisateur ouvre la section "À proximité" des paramètres Google.
  5. Une notification peut ne pas s'afficher si elle ne respecte pas les Règles de Nearby Notifications.

Quelles sont les versions d'Android compatibles avec les notifications Nearby ?

Les notifications Nearby sont compatibles avec Android 4.4 (KitKat) et les versions ultérieures.

Quel est le lien entre les notifications de proximité et l'URL Eddystone ou le Web physique ?

Nearby Notifications fonctionne en parallèle avec Eddystone-URL et Physical Web, avec le comportement exact en fonction de vos cas d'utilisation et de vos capacités. Par exemple, si un cas d'utilisation est disponible sur votre site Web, vous pouvez utiliser une balise Eddystone-URL. Si le cas d'utilisation est disponible dans votre application, vous pouvez utiliser les notifications de proximité avec un intent.

Quel est le format requis pour les pièces jointes Nearby Notifications dans l'API Proximity Beacon ?

Pour en savoir plus, consultez la page Format des données de la pièce jointe. En résumé, les pièces jointes doivent se présenter sous la forme suivante:

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

Comment est utilisé le titre des notifications de Nearby Notifications ?

Le titre apparaîtra dans les notifications et les listes affichées par "Notifications à proximité". Par exemple, si votre titre est défini sur "Exemple d'action sur place", le texte de la notification apparaîtra sous la forme "Example action at place" en plus du nom ou de l'URL de l'application.

L'application Nearby Notifications installe-t-elle l'application en arrière-plan ?

Non. La fonctionnalité Notifications de proximité redirige les utilisateurs vers le Google Play Store pour qu'ils l'installent.

Comment savoir si un utilisateur a accédé à mon application via les notifications à proximité ?

Les liens Nearby Notifications sont des liens profonds Android standards. Toutefois, si vous souhaitez fournir des tags supplémentaires (pour les métriques ou les analyses, par exemple), vous pouvez ajouter des paramètres de chaîne de requête dans le composant de chemin de l'URL d'intent.

Les notifications de Nearby sont-elles compatibles avec iBeacon ?

Oui, à condition que la balise ait un ID iBeacon statique. Ces ID peuvent être enregistrés dans l'API Proximity Beacon et peuvent avoir des pièces jointes Nearby Notifications.

Où et quand l'analyse aura-t-elle lieu, si ce n'est pas dans mon application ?

L'analyse est effectuée par les services Google Play et uniquement lors d'événements "à l'écran".

Qui est responsable de l'enregistrement des balises dans l'API Proximity Beacon ?

Tout le monde peut enregistrer la balise, à condition que le rattachement dispose de l'espace de noms et du type appropriés. Dans la plupart des cas, il s'agit du propriétaire de la balise, mais il peut s'agir de l'OEM de la balise si vous avez conclu un contrat avec elle.

Quel est le format de l'URI d'intent de l'application ?

Tout d'abord, avec le tableau de bord des balises, vous pouvez laisser l'interface Web créer un URI valide, à condition de bien comprendre les parties de schéma, d'hôte et de chemin d'accès de l'URI. Exemple :

Si vous souhaitez que Nearby Notifications lance l'activité dans votre application ayant le filtre d'intent suivant:

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

L'URI intent:// correspondant est alors:

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

Autrement dit, l'URI peut être divisé comme suit:

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

Si votre activité nécessite des bonus d'intents, ceux-ci doivent être ajoutés juste avant ;end:

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

Les types suivants peuvent être utilisés dans les bonus:

  • Booléen
  • Byte
  • Caractère
  • Double
  • Nombre à virgule flottante
  • Int
  • Long
  • Short

Voir également Intent.java#parseUri() et Intent.java#toUri(int) dans le contexte de URI_INTENT_SCHEME pour plus d'informations sur cette URL d'intent.

Qu'en est-il de la localisation du titre Nearby Notifications ?

Les rattachements de notification de proximité doivent inclure la langue ou les paramètres régionaux dans l'espace de noms ou le type. Les notifications de proximité n'affichent que ces pièces jointes qui correspondent aux paramètres régionaux de l'utilisateur.