NativeAd

abstract fun cancelUnconfirmedClick(): Unit

تلغي هذه السمة نقرة غير مؤكَّدة تم تسجيلها سابقًا للإعلان.

abstract fun destroy(): Unit

تدمّر هذه الطريقة عنصر الإعلان. يجب عدم استدعاء أي طرق أخرى في عنصر الإعلان بعد استدعاء destroy.

abstract fun enableCustomClickGesture(): Unit

يتيح هذا الخيار للناشرين إعداد تقارير عن النقرات باستخدام إيماءات مخصّصة لهذا NativeAd. يجب إدراج الوحدة الإعلانية في القائمة المسموح بها لتتمكّن من استخدام هذه الطريقة.

تتتبّع حزمة تطوير البرامج (SDK) تلقائيًا النقرات على طرق عرض مواد العرض. في حال استدعاء هذه الطريقة، لن تتتبّع حزمة تطوير البرامج (SDK) النقرات على NativeAd هذا. يجب استدعاء هذه الطريقة قبل عرض الإعلان.

abstract fun getAdChoicesInfo(): NativeAd.AdChoicesInfo?

تعرض هذه السمة معلومات عن شارة "خيارات الإعلان".

abstract fun getAdvertiser(): String?

تعرض هذه السمة نصًا يحدّد المعلِن. لا يُشترط أن تعرض التطبيقات مادة العرض هذه، ولكن يُنصح بذلك.

abstract fun getBody(): String?

تعرض هذه السمة النص الأساسي. يجب أن تعرض التطبيقات مادة العرض هذه.

abstract fun getCallToAction(): String?

تعرض هذه السمة عبارة الحث على اتّخاذ إجراء في الإعلان (مثل "شراء" أو "تثبيت"). لا يُشترط أن تعرض التطبيقات مادة العرض هذه، ولكن يُنصح بذلك.

abstract fun getExtras(): Bundle!

تعرض هذه السمة حِزمة من مواد العرض الإضافية المرتبطة بالإعلان المدمج مع المحتوى. إذا كان إعلان أحد شركاء التوسّط يتضمّن مواد عرض غير المواد العادية (السعر والمتجر وما إلى ذلك)، يمكن ضبطها من خلال استدعاء الطريقة في setExtras، ويمكن استردادها من خلال هذه الطريقة. بالنسبة إلى سير العمل غير المرتبط بالتوسّط، يعرض حزمة فارغة.

abstract fun getHeadline(): String?

تعرض هذه السمة عنوان النص الأساسي. يجب أن تعرض التطبيقات مادة العرض هذه.

abstract fun getIcon(): NativeAd.Image?

تعرِض هذه السمة صورة صغيرة تحدّد هوية المعلِن. لا يُشترط أن تعرض التطبيقات مادة العرض هذه، ولكن يُنصح بذلك.

abstract fun getImages(): (Mutable)List<NativeAd.Image!>!

تعرض هذه السمة قائمة بالصور الكبيرة. لا يُشترط أن تعرض التطبيقات مادة العرض هذه، ولكن يُنصح بذلك.

abstract fun getMediaContent(): MediaContent?

تعرِض هذه السمة MediaContent المرتبطة بهذا الإعلان.

abstract fun getMuteThisAdReasons(): (Mutable)List<MuteThisAdReason!>!

تعرض هذه السمة أسباب توفّر ميزة "تجاهل هذا الإعلان" لهذا الإعلان. استخدِم الوصف النصي من الفئة لعرضه للمستخدم.

abstract fun getPlacementId(): Long

تعرِض هذه السمة معرّف موضع الإعلان الخاص بـ NativeAd.

abstract fun getPrice(): String?

بالنسبة إلى الإعلانات حول التطبيقات، تعرض هذه السمة سلسلة تمثّل تكلفة التطبيق. لا يُشترط أن تعرض التطبيقات مادة العرض هذه، ولكن يُنصح بذلك.

abstract fun getResponseInfo(): ResponseInfo?

تعرِض هذه الطريقة العنصر ResponseInfo للإعلان الذي تم تحميله. تعرض null إلى أن يتم تحميل الإعلان بنجاح.

abstract fun getStarRating(): Double?

بالنسبة إلى الإعلانات عن التطبيقات، تعرض هذه السمة تقييمًا بالنجوم من 0 إلى 5 يمثّل عدد النجوم التي حصل عليها التطبيق في المتجر الذي يقدّمه. لا يُشترط أن تعرض التطبيقات مادة العرض هذه، ولكن يُنصح بذلك.

abstract fun getStore(): String?

بالنسبة إلى الإعلانات عن التطبيقات، تعرض هذه السمة اسم المتجر الذي يوفّر التطبيق للتنزيل. على سبيل المثال، "Google Play". لا يُشترط أن تعرض التطبيقات مادة العرض هذه، ولكن يُنصح بذلك.

abstract fun isCustomClickGestureEnabled(): Boolean

يشير إلى ما إذا كان يمكن تسجيل النقرات باستخدام إيماءات نقر مخصّصة. يُرجى التواصل مع مدير حسابك لإضافة وحدة إعلانية إلى القائمة المسموح بها لهذه الميزة.

abstract fun isCustomMuteThisAdEnabled(): Boolean

تعرض القيمة true إذا كان يمكن كتم صوت هذا الإعلان آليًا. استخدِم setRequestCustomMuteThisAd لطلب تنفيذ مخصّص لميزة "إخفاء هذا الإعلان".

abstract fun muteThisAd(muteThisAdReason: MuteThisAdReason!): Unit

تتجاهل هذه الميزة الإعلان آليًا.

abstract fun performClick(clickData: Bundle!): Unit

يجب طلبها عندما ينقر المستخدم على الإعلان. يجب إدراج الوحدة الإعلانية في القائمة المسموح بها لتتمكّن من استخدام واجهة برمجة التطبيقات هذه. يجب أن يستخدم هذه الطريقة ناشرو المكوّنات الإضافية في Unity فقط.

abstract fun recordCustomClickGesture(): Unit

تسجّل هذه السمة النقرات على NativeAd باستخدام إيماءة نقر مخصّصة. يجب إدراج الوحدة الإعلانية في القائمة المسموح بها لتتمكّن من استخدام هذه الطريقة.

يجب استدعاء enableCustomClickGesture قبل استدعاء هذه الطريقة.

abstract fun recordImpression(impressionData: Bundle!): Boolean

يجب استدعاء هذه الدالة عند عرض الإعلان لأول مرة. يجب إدراج الوحدة الإعلانية في القائمة المسموح بها لتتمكّن من استخدام واجهة برمجة التطبيقات هذه.

abstract fun reportTouchEvent(touchEventData: Bundle!): Unit

يجب استدعاء هذه الطريقة عند حدوث حدث لمس على الإعلان. يجب إدراج الوحدة الإعلانية في القائمة المسموح بها لتتمكّن من استخدام واجهة برمجة التطبيقات هذه. إذا كنت مهتمًا باستخدام هذه الميزة، يُرجى التواصل مع مدير حسابك.

  {    "x": "100",  // The x-coordinate of the touch event relative to the window.    "y": "50",  // The y-coordinate of the touch event relative to the window.    "duration_millis": "500",  // The amount of milliseconds the user pressed on the asset.  }

abstract fun setMuteThisAdListener(listener: MuteThisAdListener!): Unit

تضبط هذه السمة قيمة MuteThisAdListener للإعلان.

abstract fun setOnPaidEventListener(listener: OnPaidEventListener?): Unit

تسجيل دالّة ردّ اتصال سيتم استدعاؤها عندما يُقدّر أنّ هذا الإعلان قد حقّق أرباحًا

abstract fun setPlacementId(placementId: Long): Unit

تضبط هذه السمة معرّف موضع الإعلان المدمج مع المحتوى.

لضمان تضمين رقم تعريف موضع الإعلان هذا في التقارير، عليك استدعاء هذه الطريقة قبل ربط الإعلان بـ NativeAdView.

abstract fun setUnconfirmedClickListener(
    listener: NativeAd.UnconfirmedClickListener!
): Unit

تضبط هذه السمة UnconfirmedClickListener للإعلان.