よくある質問

効果的な添付ファイルを作成するにはどうすればよいですか?

Nearby Notifications は、Google 設定の [Nearby] セクションにメッセージを表示します。サポートされているデバイスでは、[Nearby Quick Settings] タイルが点灯し、最もパフォーマンスが高い添付ファイルが通知としてプロモートされます。

効果を最大限に高めるために、添付ファイルで次のことを行う必要があります。

  • ある地域ですでに訪問しているアプリやウェブサイトにユーザーを誘導します。
  • 通知を受け取っているほとんどのユーザーにアピールします。
  • ビーコンの位置を最適化することで、関心のあるユーザーのみをターゲットにすることができます。
  • ユーザーを驚かせることなく、行動を促す直接的なフレーズを提示します。
  • ユーザーの反応が良いメッセージを受け取るようにします。
  • ニアバイシェアのポリシーを遵守して、ユーザーが快適に利用できるようにします。

Google 設定の [周辺] セクションに添付ファイルが表示されない。理由は、

  • 表示されるメッセージにはいくつかの制約があります。たとえば、HTTPS URL のみを許可する、ポリシーに違反するコンテンツを許可しない、などです。
  • play.google.com へのリンクはサポートされていません。代わりに、App Intent の添付ファイルを使用すると、アプリを利用するエクスペリエンスを有効にできます。

メッセージが通知として表示されない。理由は、

通知が表示されない場合は、いくつかの理由が考えられます。

  1. 添付ファイルが適切に受信されなかった場合、通知は表示されません。 効果的な添付ファイルを作成するためのヒントをご確認ください。
  2. Nearby Notifications は通常、画面がオンの後、数秒間ビーコンをスキャンします。画面がしばらくオンになっていないと、デバイスは新しいビーコンを検出しません。
  3. デバッグモードの添付ファイルは、デバッグモードのデバイスにのみ表示されます。デバッグモードもご覧ください。
  4. あるデバイスで通知が最近閉じられた場合、そのデバイスにしばらくの間別の通知が表示されないことがあります。ユーザーが Google 設定の [Nearby] セクションを開くと、バックオフ ポリシーもリセットされます。
  5. Nearby の通知ポリシーに違反している場合、通知が表示されないことがあります。

Nearby 通知に対応している Android のバージョンを教えてください。

Nearby Notifications は、Android 4.4(KitKat)以降でサポートされています。

Nearby Notifications は Eddystone-URL またはフィジカル ウェブとどのように関係していますか?

Nearby Notifications は、Eddystone-URL やフィジカル ウェブと連動して、ユースケースと機能に応じて正確な動作を行います。たとえば、ウェブサイトで利用可能なユースケースが 1 つある場合、Eddystone-URL ビーコンを使用できます。アプリでユースケースが利用可能な場合は、アプリのインテントを指定して付近の通知を使用できます。

Proximity Beacon API で Nearby 通知の添付ファイルに必要なフォーマットは次のうちどれですか。

詳しくは、添付ファイルのデータ形式をご覧ください。つまり、添付ファイルは次の形式になります。

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

付近の通知の添付ファイルにおけるタイトルの使用方法

このタイトルは、付近の通知に表示される通知とリストに表示されます。たとえば、タイトルが「サンプル操作の位置」に設定されている場合、通知テキストはアプリ名または URL に加えて "Example action at place" として表示されます。

Nearby Notifications はバックグラウンドでアプリをインストールしますか?

いいえ。付近の通知は、そこからインストールするように Google Play ストアにリダイレクトします。

ユーザーが Nearby 通知からアプリにアクセスしたかどうかを確認するにはどうすればよいですか?

Nearby Notifications リンクは標準の Android ディープリンクですが、指標や分析などの追加のタグを提供する場合は、インテント URL のパス コンポーネントにクエリ文字列パラメータを追加できます。

Nearby 通知は iBeacon に対応していますか?

はい。ただし、ビーコンに静的 iBeacon ID があれば適用されます。これらの ID は Proximity Beacon API に登録可能で、Nearby Notifications アタッチメントを含めることができます。

アプリにない場合、スキャンはどこで、どのように行われますか?

スキャンは Google Play 開発者サービスによって、「画面オン」イベントでのみ実行されます。

Proximity Beacon API でのビーコンの登録を担当するのは誰ですか。

ビーコンが適切な名前空間と型を持っていれば、誰でもビーコンを登録できます。ほとんどの場合は、これがビーコンの所有者になりますが、契約している場合はビーコン OEM になる場合があります。

アプリのインテント URI の形式は何ですか。

まず、ビーコン ダッシュボードを使用して、URI のスキーム、ホスト、パスの部分を理解すれば、ウェブ フロントエンドで有効な URI を構築できます。次に例を示します。

Nearby Notifications で、次のインテント フィルタを持つアプリ内のアクティビティを起動するとします。

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

対応する intent:// URI は次のようになります。

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

つまり、URI を次のように分割できます。

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

アクティビティにインテント エクストラが必要な場合は、;end の直前に追加する必要があります。

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

ボーナス コンテンツには次のタイプを使用できます。

  • ブール値
  • Byte
  • Char
  • Double
  • フローティング
  • Int
  • 長い
  • ショート動画

このインテント URL について詳しくは、URI_INTENT_SCHEME のコンテキスト内で Intent.java#parseUri()Intent.java#toUri(int) をご覧ください。

Nearby Notifications で使用されているタイトルのローカライズについてはどうですか?

Nearby Notifications 添付ファイルには、Namespace / type の一部として言語 / 地域を含める必要があります。また、Nearby Notifications は、ユーザーの言語 / 地域設定と一致する添付ファイルのみを表示します。