このドキュメントでは、Play Install Referrer API の使用に関するテクニカル情報を紹介します。Play Install Referrer API は AIDL サービス インターフェースで、主に Java 以外のプログラマーによって使用されます。
注: Play Install Referrer Library は Play Install Referrer API のラッパーを提供し、Java プログラマーはこのライブラリを通じて Play Install Referrer API を使用できます。
getInstallReferrer() メソッド
このメソッドは、Bundle（表 1 にマッピングされているキー）で送信される特定のパッケージ名に対応する、アプリのインストール リファラー情報を返します。Google Play から送信されるレスポンスの Bundle では、キー（表 2 を参照）にマッピングされているフィールドにリファラー情報が格納されます。
表 1. getInstallReferrer() によるバンドルデータのリクエスト
| パラメータ | 型 | 説明 |
|---|---|---|
package_name
|
String
|
呼び出し元のパッケージ名。曖昧さの回避に使用されます。 |
表 2. getInstallReferrer() リクエストに対するレスポンス データ
| キー | 型 | 説明 |
|---|---|---|
install_referrer
|
String
|
インストール済みパッケージのリファラー URL。 |
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 日間にアプリの Instant エクスペリエンスが起動されたかどうかを示します。 |
注意: インストール リファラー情報の使用可能期間は 90 日です。この情報は、アプリが再インストールされない限り変更されません。アプリで不要な API 呼び出しが行われないようにするには、インストール後の最初の実行時に API を 1 回だけ呼び出します。