เครื่องมือจัดการการวัด
public
class
MeasurementManager
extends Object
java.lang.Object | |
↳ | android.adservices.measurement.MeasurementManager |
MeasurementManager มี API สำหรับจัดการแหล่งที่มาและทริกเกอร์การลงทะเบียน
สรุป
ค่าคงที่ | |
---|---|
int |
MEASUREMENT_API_STATE_DISABLED
สถานะนี้บ่งบอกว่า Measurement API ไม่พร้อมใช้งาน |
int |
MEASUREMENT_API_STATE_ENABLED
สถานะนี้บ่งบอกว่ามีการเปิดใช้ Measurement API |
วิธีการสาธารณะ | |
---|---|
void
|
deleteRegistrations(DeletionRequest deletionRequest, Executor executor, OutcomeReceiver<Object, Exception> callback)
ลบการจดทะเบียนก่อนหน้า |
static
MeasurementManager
|
get(Context context)
วิธีสร้างอินสแตนซ์ของ MeasurementManager จากโรงงาน |
void
|
getMeasurementApiStatus(Executor executor, OutcomeReceiver<Integer, Exception> callback)
ดูสถานะ Measurement API |
void
|
registerSource(Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver<Object, Exception> callback)
ลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา (คลิกหรือดู) |
void
|
registerSource(SourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
ลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา(คลิกหรือดู) จากบริบทของแอป |
void
|
registerTrigger(Uri trigger, Executor executor, OutcomeReceiver<Object, Exception> callback)
บันทึกทริกเกอร์ (Conversion) |
void
|
registerWebSource(WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
ลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา(คลิกหรือดู) จากบริบทเว็บ |
void
|
registerWebTrigger(WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
ลงทะเบียนทริกเกอร์การระบุแหล่งที่มา(คลิกหรือดู) จากบริบทเว็บ |
วิธีการที่รับมา | |
---|---|
ค่าคงที่
MEASUREMENT_API_สถานะ_ปิดใช้
public static final int MEASUREMENT_API_STATE_DISABLED
สถานะนี้บ่งบอกว่า Measurement API ไม่พร้อมใช้งาน การเรียกใช้จะส่งผลให้เกิด
UnsupportedOperationException
มูลค่าคงที่: 0 ครั้ง (0x00000000)
MEASUREMENT_API_STATE_Enabled
public static final int MEASUREMENT_API_STATE_ENABLED
สถานะนี้บ่งบอกว่ามีการเปิดใช้ Measurement API
มูลค่าคงที่: 1 ครั้ง (0x00000001)
วิธีการสาธารณะ
ลบการจดทะเบียน
public void deleteRegistrations (DeletionRequest deletionRequest, Executor executor, OutcomeReceiver<Object, Exception> callback)
ลบการจดทะเบียนก่อนหน้า หากลบสำเร็จ OutcomeReceiver.onResult(R)
ของ Callback จะเรียกใช้โดยมีค่า Null ในกรณีที่ไม่สำเร็จ Exception
จะเป็น
ที่ส่งผ่าน OutcomeReceiver#onError
ของ Callback ทั้งสำเร็จและล้มเหลว
ระบบจะดำเนินการตาม Executor
ที่ให้ไว้
พารามิเตอร์ | |
---|---|
deletionRequest |
DeletionRequest : คำขอลบข้อมูล
ค่านี้ต้องไม่เป็น null |
executor |
Executor : ผู้ดำเนินการที่จะเรียกใช้ Callback
ค่านี้ต้องไม่เป็น null
ระบบจะส่งเหตุการณ์ Callback และ Listener ผ่านสิ่งนี้
Executor มอบวิธีง่ายๆ ในการควบคุมชุดข้อความที่
ในการส่งกิจกรรมผ่านชุดข้อความหลักของ
คุณสามารถใช้
Context.getMainExecutor()
หรือระบุ Executor ที่ส่งไปยังชุดข้อความที่เหมาะสม |
callback |
OutcomeReceiver : มีไว้เพื่อแจ้งผลลัพธ์ API แบบไม่พร้อมกัน
ค่านี้ต้องไม่เป็น null |
รับ
public static MeasurementManager get (Context context)
วิธีสร้างอินสแตนซ์ของ MeasurementManager จากโรงงาน
พารามิเตอร์ | |
---|---|
context |
Context : Context ที่จะใช้
ค่านี้ต้องไม่เป็น null |
คิกรีเทิร์น | |
---|---|
MeasurementManager |
อินสแตนซ์ MeasurementManager
ค่านี้ต้องไม่เป็น null |
getMeasurementApiStatus
public void getMeasurementApiStatus (Executor executor, OutcomeReceiver<Integer, Exception> callback)
ดูสถานะ Measurement API
ค่า Integer
ของ Callback คือหนึ่งใน MeasurementApiState
ต้องใช้ AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION
พารามิเตอร์ | |
---|---|
executor |
Executor : ใช้โดย Callback เพื่อส่งผลลัพธ์
ค่านี้ต้องไม่เป็น null
ระบบจะส่งเหตุการณ์ Callback และ Listener ผ่านสิ่งนี้
Executor มอบวิธีง่ายๆ ในการควบคุมชุดข้อความที่
ในการส่งกิจกรรมผ่านชุดข้อความหลักของ
คุณสามารถใช้
Context.getMainExecutor()
หรือระบุ Executor ที่ส่งไปยังชุดข้อความที่เหมาะสม |
callback |
OutcomeReceiver : มีไว้เพื่อแจ้งผลลัพธ์ API แบบไม่พร้อมกัน
ค่านี้ต้องไม่เป็น null |
ซอร์สการลงทะเบียน
public void registerSource (Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver<Object, Exception> callback)
ลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา (คลิกหรือดู)
ต้องใช้ AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION
พารามิเตอร์ | |
---|---|
attributionSource |
Uri : แพลตฟอร์มจะออกคำขอไปยัง URI นี้เพื่อดึงข้อมูลข้อมูลเมตา
ซึ่งเชื่อมโยงกับแหล่งที่มาของการระบุแหล่งที่มา ข้อมูลเมตาของแหล่งที่มาจัดเก็บอยู่บนอุปกรณ์ ทำให้
ส่วนขยายนั้นมีสิทธิ์ที่จะจับคู่กับทริกเกอร์ในอนาคตได้
ค่านี้ต้องไม่เป็น null |
inputEvent |
InputEvent : ออบเจ็กต์ InputEvent (สำหรับเหตุการณ์การคลิก) หรือค่าว่าง (สำหรับข้อมูลพร็อพเพอร์ตี้
เหตุการณ์) |
executor |
Executor : ใช้โดย Callback เพื่อส่งผลลัพธ์
ค่านี้อาจเป็น null
ระบบจะส่งเหตุการณ์ Callback และ Listener ผ่านสิ่งนี้
Executor มอบวิธีง่ายๆ ในการควบคุมชุดข้อความที่
ในการส่งกิจกรรมผ่านชุดข้อความหลักของ
คุณสามารถใช้
Context.getMainExecutor()
หรือระบุ Executor ที่ส่งไปยังชุดข้อความที่เหมาะสม |
callback |
OutcomeReceiver : มีไว้เพื่อแจ้งผลลัพธ์ API แบบไม่พร้อมกัน
ค่านี้อาจเป็น null |
การขว้าง | |
---|---|
IllegalArgumentException |
หากรูปแบบสำหรับ attributionSource ไม่ใช่ HTTPS |
ซอร์สการลงทะเบียน
public void registerSource (SourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
ลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา(คลิกหรือดู) จากบริบทของแอป API นี้จะไม่ประมวลผล
การเปลี่ยนเส้นทางทั้งหมด URL การลงทะเบียนทั้งหมดควรมาพร้อมกับคำขอ
ต้องใช้ AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION
พารามิเตอร์ | |
---|---|
request |
SourceRegistrationRequest : คำขอลงทะเบียนแหล่งที่มาของแอป
ค่านี้ต้องไม่เป็น null |
executor |
Executor : ใช้โดย Callback เพื่อส่งผลลัพธ์
ค่านี้อาจเป็น null
ระบบจะส่งเหตุการณ์ Callback และ Listener ผ่านสิ่งนี้
Executor มอบวิธีง่ายๆ ในการควบคุมชุดข้อความที่
ในการส่งกิจกรรมผ่านชุดข้อความหลักของ
คุณสามารถใช้
Context.getMainExecutor()
หรือระบุ Executor ที่ส่งไปยังชุดข้อความที่เหมาะสม |
callback |
OutcomeReceiver : มีไว้เพื่อแจ้งเตือนผลลัพธ์ API แบบไม่พร้อมกัน
ค่านี้อาจเป็น null |
ทริกเกอร์รีจิสเตอร์
public void registerTrigger (Uri trigger, Executor executor, OutcomeReceiver<Object, Exception> callback)
บันทึกทริกเกอร์ (Conversion)
ต้องใช้ AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION
พารามิเตอร์ | |
---|---|
trigger |
Uri : API จะส่งคำขอไปยัง URI นี้เพื่อดึงข้อมูลเมตาที่เชื่อมโยงกับ
ทริกเกอร์ ข้อมูลเมตาของทริกเกอร์จัดเก็บอยู่ในอุปกรณ์และมีสิทธิ์จับคู่กับ
ในระหว่างกระบวนการระบุแหล่งที่มา
ค่านี้ต้องไม่เป็น null |
executor |
Executor : ใช้โดย Callback เพื่อส่งผลลัพธ์
ค่านี้อาจเป็น null
ระบบจะส่งเหตุการณ์ Callback และ Listener ผ่านสิ่งนี้
Executor มอบวิธีง่ายๆ ในการควบคุมชุดข้อความที่
ในการส่งกิจกรรมผ่านชุดข้อความหลักของ
คุณสามารถใช้
Context.getMainExecutor()
หรือระบุ Executor ที่ส่งไปยังชุดข้อความที่เหมาะสม |
callback |
OutcomeReceiver : มีไว้เพื่อแจ้งผลลัพธ์ API แบบไม่พร้อมกัน
ค่านี้อาจเป็น null |
การขว้าง | |
---|---|
IllegalArgumentException |
หากรูปแบบสำหรับ trigger ไม่ใช่ HTTPS |
ลงทะเบียนเว็บซอร์ส
public void registerWebSource (WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
ลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา(คลิกหรือดู) จากบริบทเว็บ API นี้จะไม่ประมวลผล
เปลี่ยนเส้นทาง URL การลงทะเบียนทั้งหมดควรมาพร้อมกับคำขอ อย่างน้อย 1
ต้องระบุพารามิเตอร์ appDestination หรือ webDestination หากการจดทะเบียน
สำเร็จแล้ว OutcomeReceiver#onResult
ของ callback
ถูกเรียกใช้โดยมีค่าว่าง ใน
ในกรณีที่ไม่สำเร็จ ระบบจะส่ง Exception
ผ่าน OutcomeReceiver.onError(E)
ของ callback
ทั้งการส่งความคิดเห็นว่าสำเร็จและล้มเหลวจะมีการดำเนินการตาม
Executor
ต้องใช้ AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION
พารามิเตอร์ | |
---|---|
request |
WebSourceRegistrationRequest : คำขอลงทะเบียนแหล่งที่มา
ค่านี้ต้องไม่เป็น null |
executor |
Executor : ใช้โดย Callback เพื่อส่งผลลัพธ์
ค่านี้อาจเป็น null |
callback |
OutcomeReceiver : มีไว้เพื่อแจ้งผลลัพธ์ API แบบไม่พร้อมกัน
ค่านี้อาจเป็น null |
ลงทะเบียนเว็บทริกเกอร์
public void registerWebTrigger (WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
ลงทะเบียนทริกเกอร์การระบุแหล่งที่มา(คลิกหรือดู) จากบริบทเว็บ API นี้จะไม่ประมวลผล
การเปลี่ยนเส้นทางทั้งหมด URL การลงทะเบียนทั้งหมดควรมาพร้อมกับคำขอ หากการจดทะเบียน
สำเร็จแล้ว OutcomeReceiver#onResult
ของ callback
ถูกเรียกใช้โดยมีค่าว่าง ใน
ในกรณีที่ไม่สำเร็จ ระบบจะส่ง Exception
ผ่าน OutcomeReceiver.onError(E)
ของ callback
ทั้งการส่งความคิดเห็นว่าสำเร็จและล้มเหลวจะมีการดำเนินการตาม
Executor
ต้องใช้ AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION
พารามิเตอร์ | |
---|---|
request |
WebTriggerRegistrationRequest : เรียกคำขอลงทะเบียน
ค่านี้ต้องไม่เป็น null |
executor |
Executor : ใช้โดย Callback เพื่อส่งผลลัพธ์
ค่านี้อาจเป็น null |
callback |
OutcomeReceiver : มีไว้เพื่อแจ้งเตือนผลลัพธ์ API แบบไม่พร้อมกัน
ค่านี้อาจเป็น null |