เครื่องมือจัดการการวัด

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<ObjectException> callback)

ลบการจดทะเบียนก่อนหน้า

static MeasurementManager get(Context context)

วิธีสร้างอินสแตนซ์ของ MeasurementManager จากโรงงาน

void getMeasurementApiStatus(Executor executor, OutcomeReceiver<IntegerException> callback)

ดูสถานะ Measurement API

void registerSource(Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver<ObjectException> callback)

ลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา (คลิกหรือดู)

void registerSource(SourceRegistrationRequest request, Executor executor, OutcomeReceiver<ObjectException> callback)

ลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา(คลิกหรือดู) จากบริบทของแอป

void registerTrigger(Uri trigger, Executor executor, OutcomeReceiver<ObjectException> callback)

บันทึกทริกเกอร์ (Conversion)

void registerWebSource(WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<ObjectException> callback)

ลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา(คลิกหรือดู) จากบริบทเว็บ

void registerWebTrigger(WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<ObjectException> callback)

ลงทะเบียนทริกเกอร์การระบุแหล่งที่มา(คลิกหรือดู) จากบริบทเว็บ

วิธีการที่รับมา

Object clone()

สร้างและแสดงผลสำเนาของออบเจ็กต์นี้

boolean equals(Object obj)

ระบุว่าออบเจ็กต์อื่นบางรายการเป็น "เท่ากับ" หรือไม่ อันนี้

void finalize()

เรียกใช้โดยผู้เก็บขยะในออบเจ็กต์เมื่อเก็บรวบรวมขยะ ทำให้ทราบว่าไม่มีการอ้างอิงไปยังออบเจ็กต์นั้นแล้ว

final Class<?> getClass()

แสดงผลคลาสรันไทม์ของ Object นี้

int hashCode()

แสดงผลค่ารหัสแฮชสำหรับออบเจ็กต์

final void notify()

สร้างชุดข้อความเดียวที่รออยู่ในออบเจ็กต์นี้ จอภาพ

final void notifyAll()

ปลุกชุดข้อความทั้งหมดที่รออยู่บนจอภาพของออบเจ็กต์นี้

String toString()

แสดงผลตัวแทนสตริงของออบเจ็กต์

final void wait(long timeoutMillis, int nanos)

ทำให้เทรดปัจจุบันต้องรอจนกว่าจะมีการปลุก ซึ่งโดยปกติแล้ว ด้วยการแจ้งหรือรบกวน หรือจนกว่า เวลาแบบเรียลไทม์ผ่านไปแล้ว

final void wait(long timeoutMillis)

ทำให้เทรดปัจจุบันต้องรอจนกว่าจะมีการปลุก ซึ่งโดยปกติแล้ว ด้วยการแจ้งหรือรบกวน หรือจนกว่า เวลาแบบเรียลไทม์ผ่านไปแล้ว

final void wait()

ทำให้เทรดปัจจุบันต้องรอจนกว่าจะมีการปลุก ซึ่งโดยปกติแล้ว ด้วยการแจ้งหรือรบกวน

ค่าคงที่

MEASUREMENT_API_สถานะ_ปิดใช้

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย
public static final int MEASUREMENT_API_STATE_DISABLED

สถานะนี้บ่งบอกว่า Measurement API ไม่พร้อมใช้งาน การเรียกใช้จะส่งผลให้เกิด UnsupportedOperationException

มูลค่าคงที่: 0 ครั้ง (0x00000000)

MEASUREMENT_API_STATE_Enabled

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย
public static final int MEASUREMENT_API_STATE_ENABLED

สถานะนี้บ่งบอกว่ามีการเปิดใช้ Measurement API

มูลค่าคงที่: 1 ครั้ง (0x00000001)

วิธีการสาธารณะ

ลบการจดทะเบียน

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย
public void deleteRegistrations (DeletionRequest deletionRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> 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

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย
public void getMeasurementApiStatus (Executor executor, 
                OutcomeReceiver<IntegerException> callback)

ดูสถานะ Measurement API

ค่า Integer ของ Callback คือหนึ่งใน MeasurementApiState
ต้องใช้ AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

พารามิเตอร์
executor Executor: ใช้โดย Callback เพื่อส่งผลลัพธ์ ค่านี้ต้องไม่เป็น null ระบบจะส่งเหตุการณ์ Callback และ Listener ผ่านสิ่งนี้ Executor มอบวิธีง่ายๆ ในการควบคุมชุดข้อความที่ ในการส่งกิจกรรมผ่านชุดข้อความหลักของ คุณสามารถใช้ Context.getMainExecutor() หรือระบุ Executor ที่ส่งไปยังชุดข้อความที่เหมาะสม

callback OutcomeReceiver: มีไว้เพื่อแจ้งผลลัพธ์ API แบบไม่พร้อมกัน ค่านี้ต้องไม่เป็น null

ซอร์สการลงทะเบียน

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย
public void registerSource (Uri attributionSource, 
                InputEvent inputEvent, 
                Executor executor, 
                OutcomeReceiver<ObjectException> 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<ObjectException> callback)

ลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา(คลิกหรือดู) จากบริบทของแอป API นี้จะไม่ประมวลผล การเปลี่ยนเส้นทางทั้งหมด URL การลงทะเบียนทั้งหมดควรมาพร้อมกับคำขอ
ต้องใช้ AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

พารามิเตอร์
request SourceRegistrationRequest: คำขอลงทะเบียนแหล่งที่มาของแอป ค่านี้ต้องไม่เป็น null

executor Executor: ใช้โดย Callback เพื่อส่งผลลัพธ์ ค่านี้อาจเป็น null ระบบจะส่งเหตุการณ์ Callback และ Listener ผ่านสิ่งนี้ Executor มอบวิธีง่ายๆ ในการควบคุมชุดข้อความที่ ในการส่งกิจกรรมผ่านชุดข้อความหลักของ คุณสามารถใช้ Context.getMainExecutor() หรือระบุ Executor ที่ส่งไปยังชุดข้อความที่เหมาะสม

callback OutcomeReceiver: มีไว้เพื่อแจ้งเตือนผลลัพธ์ API แบบไม่พร้อมกัน ค่านี้อาจเป็น null

ทริกเกอร์รีจิสเตอร์

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย
public void registerTrigger (Uri trigger, 
                Executor executor, 
                OutcomeReceiver<ObjectException> 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

ลงทะเบียนเว็บซอร์ส

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย
public void registerWebSource (WebSourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> 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

ลงทะเบียนเว็บทริกเกอร์

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย
public void registerWebTrigger (WebTriggerRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> 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