It's all about SECURITY and SIMPLICITY. As the doc implies, you can use the Google Play Store's Install Referrer API to securely retrieve more accurate and reliable referral content from Google Play and also you can consider switch to Install Referrer API Client Library to simplify your development process. and as u mentioned in the query it returns ReferrerDetails object that hold extra info related to the install with the below three methods.
ReferrerDetails response = mReferrerClient.getInstallReferrer();
response.getInstallReferrer();
response.getReferrerClickTimestampSeconds();
response.getInstallBeginTimestampSeconds();
The API works only from Play Store version 8.3.73 onwards. Any developers that would like to begin using it can start right away, but a connection must be established between their app and the Play Store.
Also, check an article from Adjust that explains how new API can prevent click injection fraud for mobile ads.
P.S. You need to keep track with the latest API levels to be able to deliver the best solutions to the problems you face in your projects.