Play のインストール リファラー API

このドキュメントでは、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 回だけ呼び出します。