NativeAd

public abstract void cancelUnconfirmedClick()

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

public abstract void destroy()

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

public abstract void enableCustomClickGesture()

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

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

public abstract @Nullable NativeAd.AdChoicesInfo getAdChoicesInfo()

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

public abstract @Nullable String getAdvertiser()

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

public abstract @Nullable String getBody()

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

public abstract @Nullable String getCallToAction()

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

public abstract Bundle getExtras()

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

public abstract @Nullable String getHeadline()

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

public abstract @Nullable NativeAd.Image getIcon()

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

public abstract List<NativeAd.Image> getImages()

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

public abstract @Nullable MediaContent getMediaContent()

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

public abstract List<MuteThisAdReason> getMuteThisAdReasons()

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

public abstract long getPlacementId()

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

public abstract @Nullable String getPrice()

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

public abstract @Nullable ResponseInfo getResponseInfo()

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

public abstract @Nullable Double getStarRating()

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

public abstract @Nullable String getStore()

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

public abstract boolean isCustomClickGestureEnabled()

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

public abstract boolean isCustomMuteThisAdEnabled()

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

public abstract void muteThisAd(MuteThisAdReason muteThisAdReason)

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

public abstract void performClick(Bundle clickData)

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

public abstract void recordCustomClickGesture()

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

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

public abstract boolean recordImpression(Bundle impressionData)

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

public abstract void reportTouchEvent(Bundle touchEventData)

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

  {    "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.  }

public abstract void setMuteThisAdListener(MuteThisAdListener listener)

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

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

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

public abstract void setPlacementId(long placementId)

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

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

public abstract void setUnconfirmedClickListener(
    NativeAd.UnconfirmedClickListener listener
)

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