這份文件提供有關使用 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 所述的金鑰對應的欄位中。
參數 | 類型 | 說明 |
---|---|---|
package_name
|
String
|
呼叫端的套件名稱,用於去除混淆。 |
金鑰 | 類型 | 說明 |
---|---|---|
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 一次。