常見問題

如何製作出色的附件?

「鄰近分享」通知會在 Google 設定的「鄰近分享」部分顯示訊息,在支援的裝置上為「鄰近快捷設定」設定方塊亮起,並以最佳方式執行附件通知。

為了達到最大效能,附件應符合以下條件:

  • 將使用者導向某些地點已經造訪過的應用程式或網站。
  • 吸引大多數會收到通知的使用者。
  • 最佳化信標位置,有助於只指定感興趣的使用者。
  • 引導使用者直接採取行動,避免讓使用者感到驚訝。
  • 因此,如果訊息對使用者產生正面影響,請特別小心。
  • 遵守鄰近通知政策,為使用者提供良好體驗。

我的附件並未顯示在 Google 設定的「鄰近分享」部分。為什麼?

  • 我們對顯示的訊息設有幾項限制,例如只允許使用 HTTPS 網址,以及禁止違反 Google 政策的內容。
  • 不支援 play.google.com 的連結。請改用應用程式意圖附件,以提供應用程式提供的體驗。

系統沒有顯示通知。為什麼?

通知未顯示的可能原因如下。

  1. 如果使用者未收到附件,就不會顯示通知。 您可以在上方找到建立優質附件的訣竅。
  2. 開啟通知後,「鄰近分享」功能通常會在螢幕開啟後掃描幾秒鐘。如果螢幕已有一段時間未開啟,裝置就無法偵測到新的信標。
  3. 偵錯模式下的附件只會顯示在偵錯模式裝置上。另請參閱偵錯模式
  4. 如果最近在裝置上關閉了通知,該裝置在一段時間內可能不會顯示其他通知。如果使用者開啟 Google 設定的「鄰近地區」部分,也會重設輪詢政策。
  5. 如果通知違反鄰近分享政策,則可能不會顯示。

哪些 Android 版本支援鄰近分享功能?

Android 4.4 (KitKat) 以上版本支援「鄰近分享」功能。

「鄰近分享」通知與 Eddystone-URL 或實體化網路有何關聯?

「鄰近分享」功能會與 Eddystone-URL 和「實體化網路」搭配運作,並根據您的用途和功能提供正確的行為。舉例來說,假設您的網站有一種使用案例,則可使用 Eddystone-URL 信標。如果您的應用程式有適用的用途,您可以使用 Nearby Notifications 搭配應用程式意圖。

Proximity Beacon API 中 Nearby Notifications 附件的格式為何?

詳情請參閱附件資料格式。簡單來說,附件應採用以下形式:

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

在鄰近分享通知附件中,標題的用途為何?

標題會顯示在鄰近通知顯示的通知和清單中。例如,如果您的標題設為「Example action at place」(在位置執行範例動作),除了應用程式名稱或網址以外,通知文字也會顯示為 "Example action at place"

「鄰近分享」通知會在背景安裝應用程式嗎?

不會。「鄰近分享」功能會將使用者重新導向 Google Play 商店,以便從該處安裝。

如何得知使用者是否透過「鄰近分享通知」前往我的應用程式?

Nearby Notifications 連結是標準的 Android 深層連結,但如果您想提供其他標記 (例如用於指標或數據分析),您可以在查詢字串網址的路徑元件中新增查詢字串參數。

鄰近分享是否支援 iBeacon?

可以,只要信標有靜態 iBeacon ID 即可。這些 ID 可在 Proximity Beacon API 中註冊,並且具有 Nearby Notifications 附件。

如果不在我的應用程式中,掃描作業會在何時進行?在何時?

掃描作業是由 Google Play 服務執行,而且只適用於「螢幕開啟」事件。

誰負責在 Proximity Beacon API 中註冊信標?

只要附件具有正確的命名空間和類型,任何人都可以註冊信標。在大多數情況下,這應該是信標的擁有者,但如果你與該合約有簽訂合約,或許就是 原始設備製造商 (OEM)。

應用程式意圖 URI 的格式為何?

首先,您可以透過信標資訊主頁讓網路前端為您建構有效的 URI,前提是您必須瞭解 URI 的配置、主機和路徑部分。範例如下:

如果您希望鄰近通知在您的應用程式中啟動具有下列意圖篩選器的活動:

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

對應的意圖:// 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
  • 圖表
  • 雙人床
  • 浮點值
  • Int
  • Shorts

另請參閱 URI_INTENT_SCHEME 的內容中的 Intent.java#parseUri()Intent.java#toUri(int) 以進一步瞭解這項意圖網址。

「鄰近分享」通知使用的標題本地化方式為何?

鄰近通知附件必須包含該語言/語言代碼做為命名空間/類型的一部分,而鄰近通知僅會顯示符合使用者語言代碼設定的附件。