เอกสารประกอบนี้ให้ข้อมูลอ้างอิงทางเทคนิคสําหรับการใช้ Play Install Referrer API Play Install Referrer API เป็นAIDL Service Interface ที่ใช้โดยโปรแกรมเมอร์ที่ไม่ใช่ Java เป็นหลัก
หมายเหตุ: ไลบรารี Play Install Referrer มี Wrapper สำหรับ Play Install Referrer API และออกแบบมาเพื่อช่วยโปรแกรมเมอร์ Java ใช้ API
เมธอด getInstallReferrer()
วิธีนี้จะแสดงผลข้อมูลอ้างอิงการติดตั้งแอปซึ่งสอดคล้องกับชื่อแพ็กเกจที่ระบุซึ่งส่งผ่าน Bundle (คีย์ที่แมปในตารางที่ 1) ในคําตอบ Bundle ที่ Google Play ส่งมา ระบบจะจัดเก็บข้อมูลอ้างอิงในช่องที่แมปกับคีย์ที่ระบุไว้ในตาราง 2
ตารางที่ 1 getInstallReferrer() ข้อมูลแพ็กเกจ
คำขอ
| พารามิเตอร์ | ประเภท | คำอธิบาย |
|---|---|---|
package_name
|
String
|
ชื่อแพ็กเกจของผู้เรียกใช้ ซึ่งใช้เพื่อคลายความกำกวม |
ตารางที่ 2 ข้อมูลการตอบกลับจากgetInstallReferrer()คำขอ
| คีย์ | ประเภท | คำอธิบาย |
|---|---|---|
install_referrer
|
String
|
URL ที่มาของแพ็กเกจที่ติดตั้ง |
referrer_click_timestamp_seconds
|
long
|
การประทับเวลาฝั่งไคลเอ็นต์เป็นวินาทีเมื่อเกิดการคลิก URL ที่มา |
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 ที่ไม่จำเป็นในแอป