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

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)

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

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

ค่าคงที่

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