تمت إضافتها في المستوى 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_verify

تمت إضافتها في المستوى 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.

RecordWebTrigger

تمت إضافتها في المستوى 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.