تمت الإضافة في المستوى 34 لواجهة برمجة التطبيقات
أيضًا في إضافات خدمات الإعلانات 4

ملخص: الثابت | الطُرق | الطرق المكتسبة

مدير القياس

public class MeasurementManager
extends Object

java.lang.Object
↳	android.adservices.measurement.MeasurementManager

---

يوفّر MeasurementManager واجهات برمجة التطبيقات لإدارة المصدر وتشغيل عمليات التسجيل.

ملخّص

الثوابت
int	MEASUREMENT_API_STATE_DISABLED تشير هذه الحالة إلى عدم توفّر واجهات برمجة التطبيقات Measurement API.
int	MEASUREMENT_API_STATE_ENABLED تشير هذه الحالة إلى أنّه تم تفعيل Measurement APIs.

الطرق العامة
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) سجِّل مشغِّل (إحالة ناجحة).
void	registerWebSource(WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback) سجِّل مصدر إحالة(نقرة أو عرض) من سياق الويب.
void	registerWebTrigger(WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback) تسجيل عامل تشغيل لتحديد المصدر(النقر أو العرض) من سياق الويب

الطرق المكتسبة

من الصف java.lang.Object 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_state_DISABLED

تمت الإضافة في المستوى 34 لواجهة برمجة التطبيقات
أيضًا في إضافات خدمات الإعلانات 4

public static final int MEASUREMENT_API_STATE_DISABLED

تشير هذه الحالة إلى عدم توفّر واجهات برمجة التطبيقات Measurement API. سيؤدي استدعاؤها إلى UnsupportedOperationException

القيمة الثابتة: 0 (0x00000000)

MEASUREMENT_API_state_enabled

تمت الإضافة في المستوى 34 لواجهة برمجة التطبيقات
أيضًا في إضافات خدمات الإعلانات 4

public static final int MEASUREMENT_API_STATE_ENABLED

تشير هذه الحالة إلى أنّه تم تفعيل Measurement APIs.

القيمة الثابتة: 1 (0x00000001)

الطرق العامة

حذف التسجيلات

تمت الإضافة في المستوى 34 لواجهة برمجة التطبيقات
أيضًا في إضافات خدمات الإعلانات 4

public void deleteRegistrations (DeletionRequest deletionRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

حذف التسجيلات السابقة إذا تم الحذف بنجاح، يتم استدعاء OutcomeReceiver.onResult(R) لمعاودة الاتصال باستخدام قيمة فارغة. في حال تعذُّر ذلك، يتم ضبط Exception يتم إرساله من خلال OutcomeReceiver#onError الخاص بمعاودة الاتصال. كل من النجاح والفشل يتم تنفيذ الملاحظات على Executor المقدَّم.

المعلمات
deletionRequest	DeletionRequest: طلب حذف البيانات لا يمكن أن تكون هذه القيمة null.
executor	Executor: المنفّذ المطلوب من خلاله تنفيذ معاودة الاتصال. لا يمكن أن تكون هذه القيمة null. يتم إرسال أحداث معاودة الاتصال والمستمعين من خلال هذا Executor، ما يوفّر طريقة سهلة للتحكّم في سلسلة المحادثات استخدام البيانات المختلفة. لإرسال الأحداث من خلال سلسلة التعليمات الرئيسية التطبيق، فيمكنك استخدام Context.getMainExecutor() وبخلاف ذلك، يُرجى توفير Executor يتم إرسالها إلى سلسلة محادثات مناسبة.
callback	OutcomeReceiver: الغرض منه إرسال إشعار بنتيجة واجهة برمجة التطبيقات بشكل غير متزامن. لا يمكن أن تكون هذه القيمة null.

احصل على

تمت الإضافة في المستوى 34 لواجهة برمجة التطبيقات
أيضًا في إضافات خدمات الإعلانات 6

public static MeasurementManager get (Context context)

طريقة المصنع لإنشاء مثيل لـ MeasurementManager.

المعلمات
context	Context: السمة Context المطلوب استخدامها لا يمكن أن تكون هذه القيمة null.

المرتجعات
MeasurementManager	مثال MeasurementManager لا يمكن أن تكون هذه القيمة null.

أمر getMeasurementApiStatus

تمت الإضافة في المستوى 34 لواجهة برمجة التطبيقات
أيضًا في إضافات خدمات الإعلانات 4

public void getMeasurementApiStatus (Executor executor, 
                OutcomeReceiver<Integer, Exception> callback)

الاطّلاع على حالة Measurement API

قيمة Integer لمعاودة الاتصال هي واحدة من MeasurementApiState.
يتطلب AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

المعلمات
executor	Executor: يُستخدم بواسطة معاودة الاتصال لإرسال النتائج. لا يمكن أن تكون هذه القيمة null. يتم إرسال أحداث معاودة الاتصال والمستمعين من خلال هذا Executor، ما يوفّر طريقة سهلة للتحكّم في سلسلة المحادثات استخدام البيانات المختلفة. لإرسال الأحداث من خلال سلسلة التعليمات الرئيسية التطبيق، فيمكنك استخدام Context.getMainExecutor() وبخلاف ذلك، يُرجى توفير Executor يتم إرسالها إلى سلسلة محادثات مناسبة.
callback	OutcomeReceiver: الغرض منه إرسال إشعار بنتيجة واجهة برمجة التطبيقات بشكل غير متزامن. لا يمكن أن تكون هذه القيمة null.

مصدر التسجيل

تمت الإضافة في المستوى 34 لواجهة برمجة التطبيقات
أيضًا في إضافات خدمات الإعلانات 4

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: يُستخدم بواسطة معاودة الاتصال لإرسال النتائج. قد تكون هذه القيمة null. يتم إرسال أحداث معاودة الاتصال والمستمعين من خلال هذا Executor، ما يوفّر طريقة سهلة للتحكّم في سلسلة المحادثات استخدام البيانات المختلفة. لإرسال الأحداث من خلال سلسلة التعليمات الرئيسية التطبيق، فيمكنك استخدام Context.getMainExecutor() وبخلاف ذلك، يُرجى توفير Executor يتم إرسالها إلى سلسلة محادثات مناسبة.
callback	OutcomeReceiver: الغرض منه إرسال إشعار بنتيجة واجهة برمجة التطبيقات بشكل غير متزامن. قد تكون هذه القيمة null.

الرميات
IllegalArgumentException	إذا لم يكن مخطَّط attributionSource HTTPS

مصدر التسجيل

تمت الإضافة في Android UpsideDownCakePrivacySandbox
في إضافات الخدمات الإعلانية 4 أيضًا

public void registerSource (SourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

تسجيل مصادر الإحالة(النقر أو العرض) من سياق التطبيق. لن تعالج واجهة برمجة التطبيقات هذه أي عمليات إعادة توجيه، يجب تقديم جميع عناوين URL للتسجيل مع الطلب.
يتطلب AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

المعلمات
request	SourceRegistrationRequest: طلب تسجيل مصدر التطبيق لا يمكن أن تكون هذه القيمة null.
executor	Executor: يُستخدم بواسطة معاودة الاتصال لإرسال نتائج قد تكون هذه القيمة null. يتم إرسال أحداث معاودة الاتصال والمستمعين من خلال هذا Executor، ما يوفّر طريقة سهلة للتحكّم في سلسلة المحادثات استخدام البيانات المختلفة. لإرسال الأحداث من خلال سلسلة التعليمات الرئيسية التطبيق، فيمكنك استخدام Context.getMainExecutor() وبخلاف ذلك، يُرجى توفير Executor يتم إرسالها إلى سلسلة محادثات مناسبة.
callback	OutcomeReceiver: الغرض منه إرسال إشعار بنتيجة واجهة برمجة التطبيقات بشكل غير متزامن قد تكون هذه القيمة null.

عامل تشغيل التسجيل

تمت الإضافة في المستوى 34 لواجهة برمجة التطبيقات
أيضًا في إضافات خدمات الإعلانات 4

public void registerTrigger (Uri trigger, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

سجِّل مشغِّل (إحالة ناجحة).
يتطلب AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

المعلمات
trigger	Uri: تصدر واجهة برمجة التطبيقات طلبًا إلى معرّف الموارد المنتظم (URI) هذا لجلب البيانات الوصفية المرتبطة . يتم تخزين البيانات الوصفية للعامل المشغِّل على الجهاز، وتكون مؤهَّلة للمطابقة مع المصادر أثناء عملية تحديد المصدر. لا يمكن أن تكون هذه القيمة null.
executor	Executor: يُستخدم بواسطة معاودة الاتصال لإرسال النتائج. قد تكون هذه القيمة null. يتم إرسال أحداث معاودة الاتصال والمستمعين من خلال هذا Executor، ما يوفّر طريقة سهلة للتحكّم في سلسلة المحادثات استخدام البيانات المختلفة. لإرسال الأحداث من خلال سلسلة التعليمات الرئيسية التطبيق، فيمكنك استخدام Context.getMainExecutor() وبخلاف ذلك، يُرجى توفير Executor يتم إرسالها إلى سلسلة محادثات مناسبة.
callback	OutcomeReceiver: الغرض منه إرسال إشعار بنتيجة واجهة برمجة التطبيقات بشكل غير متزامن. قد تكون هذه القيمة null.

الرميات
IllegalArgumentException	إذا لم يكن مخطَّط trigger HTTPS

تسجيل WebSource

تمت الإضافة في المستوى 34 لواجهة برمجة التطبيقات
أيضًا في إضافات خدمات الإعلانات 4

public void registerWebSource (WebSourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

سجِّل مصدر إحالة(نقرة أو عرض) من سياق الويب. لن تعالج واجهة برمجة التطبيقات هذه أيًا عمليات إعادة التوجيه، يجب تقديم جميع عناوين URL للتسجيل مع الطلب. واحد على الأقل من يجب تقديم مَعلمتَي appDestination أو webDestination. إذا لم يكن التسجيل تم بنجاح، تم استدعاء OutcomeReceiver#onResult لـ callback باستخدام قيمة فارغة. ضِمن حالة إخفاق، يتم إرسال Exception من خلال OutcomeReceiver.onError(E) لـ callback. يتم تنفيذ ملاحظات النجاح والفشل على المقدمة Executor
يتطلب AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

المعلمات
request	WebSourceRegistrationRequest: طلب تسجيل المصدر لا يمكن أن تكون هذه القيمة null.
executor	Executor: يُستخدم بواسطة معاودة الاتصال لإرسال النتائج. قد تكون هذه القيمة null.
callback	OutcomeReceiver: الغرض منه إرسال إشعار بنتيجة واجهة برمجة التطبيقات بشكل غير متزامن. قد تكون هذه القيمة null.

تسجيل WebTrigger

تمت الإضافة في المستوى 34 لواجهة برمجة التطبيقات
أيضًا في إضافات خدمات الإعلانات 4

public void registerWebTrigger (WebTriggerRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

تسجيل عامل تشغيل لتحديد المصدر(النقر أو العرض) من سياق الويب لن تعالج واجهة برمجة التطبيقات هذه أي عمليات إعادة توجيه، يجب تقديم جميع عناوين URL للتسجيل مع الطلب. إذا لم يكن التسجيل تم بنجاح، تم استدعاء OutcomeReceiver#onResult لـ callback باستخدام قيمة فارغة. ضِمن حالة إخفاق، يتم إرسال Exception من خلال OutcomeReceiver.onError(E) لـ callback. يتم تنفيذ ملاحظات النجاح والفشل على المقدمة Executor
يتطلب AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

المعلمات
request	WebTriggerRegistrationRequest: تشغيل طلب التسجيل لا يمكن أن تكون هذه القيمة null.
executor	Executor: يُستخدم بواسطة معاودة الاتصال لإرسال نتائج قد تكون هذه القيمة null.
callback	OutcomeReceiver: الغرض منه إرسال إشعار بنتيجة واجهة برمجة التطبيقات بشكل غير متزامن قد تكون هذه القيمة null.