このドキュメントでは、Play Install Referrer API の使用に関するテクニカル情報を紹介します。Play Install Referrer API は AIDL サービス インターフェースで、主に Java 以外のプログラマーによって使用されます。
注: Play Install Referrer Library は Play Install Referrer API のラッパーを提供し、Java プログラマーが API を利用しやすくするように設計されています。
getInstallReferrer() メソッド
このメソッドは、Bundle
(表 1 にマッピングされているキー)で送信される特定のパッケージ名に対応する、アプリのインストール リファラー情報を返します。Google Play から送信されるレスポンスの Bundle
では、キー(表 2 を参照)にマッピングされているフィールドにリファラー情報が格納されます。
パラメータ | タイプ | 説明 |
---|---|---|
package_name
|
String
|
呼び出し元のパッケージ名。曖昧さ回避に使用されます。 |
キー | タイプ | 説明 |
---|---|---|
install_referrer
|
String
|
インストールされたパッケージのリファラー URL。 |
referrer_click_timestamp_seconds
|
long
|
リファラー クリックが発生したときのクライアント側のタイムスタンプ(秒単位)。 |
install_begin_timestamp_seconds
|
long
|
アプリのインストールが開始されたときのクライアント側のタイムスタンプ(秒単位)。 |
referrer_click_timestamp_server_seconds
|
long
|
参照 URL のクリックが発生したときのサーバーサイドのタイムスタンプ(秒単位)。 |
install_begin_timestamp_server_seconds
|
long
|
アプリのインストールが開始されたときのサーバー側のタイムスタンプ(秒単位)。 |
install_version
|
string
|
アプリが最初にインストールされた時点でのアプリのバージョン。 |
google_play_instant
|
boolean
|
アプリの Instant エクスペリエンスが過去 7 日以内に起動されたかどうかを示します。 |
注意: インストール リファラー情報の使用可能期間は 90 日です。この情報は、アプリが再インストールされない限り変更されません。アプリで不要な API 呼び出しが行われないようにするには、インストール後の最初の実行時に API を 1 回だけ呼び出します。