這份文件提供有關使用 Play Install Referrer API 的技術參考資料。Play Install Referrer API 是一種 AIDL 服務介面，主要供非 Java 程式設計師使用。
注意：Play Install Referrer 程式庫提供 Play Install Referrer API 的包裝函式，旨在協助 Java 程式設計師使用這個 API。
getInstallReferrer() 方法
這個方法傳回與透過 Bundle (表 1 中對應的金鑰) 傳送的指定套件名稱相對應的應用程式安裝參照資訊。在 Google Play 傳送的 Bundle 回應中，參照資訊儲存在與表 2 所述的金鑰對應的欄位中。
表 1. getInstallReferrer() bundle 資料要求。
| 參數 | 類型 | 說明 |
|---|---|---|
package_name
|
String
|
呼叫端的套件名稱，用於去除混淆。 |
表 2. 來自 getInstallReferrer() 要求的回應資料。
| 金鑰 | 類型 | 說明 |
|---|---|---|
install_referrer
|
String
|
已安裝套件的參照網址。 |
referrer_click_timestamp_seconds
|
long
|
參照網址點選事件發生時的用戶端時間戳記 (以秒為單位)。 |
install_begin_timestamp_seconds
|
long
|
應用程式安裝開始時的用戶端時間戳記 (以秒為單位)。 |
referrer_click_timestamp_server_seconds
|
long
|
參照網址點選事件發生時的伺服器端時間戳記 (以秒為單位)。 |
install_begin_timestamp_server_seconds
|
long
|
應用程式安裝開始時的伺服器端時間戳記 (以秒為單位)。 |
install_version
|
string
|
首次安裝應用程式時的應用程式版本。 |
google_play_instant
|
boolean
|
指出應用程式免安裝體驗是否在過去 7 天內推出。 |
注意：安裝參照資訊的有效期為 90 天，而且除非使用者重新安裝應用程式，否則不會發生變化。為避免應用程式中發出不必要的 API 呼叫，在安裝完成後首次執行期間，應僅叫用 API 一次。