NativeAdMapper

Kotlin |Java

public abstract class NativeAdMapper

---

فئة الربط للإعلانات المدمجة مع المحتوى من Google AdMob

يجب أن توسّع وسيطات التوسّط التي تحمّل إعلانًا مدمجًا مع المحتوى هذه الفئة لتوفير عملية ربط من عنصر الإعلان المدمج مع المحتوى في شبكة الإعلانات التي يتم التوسّط فيها إلى com.google.android.gms.ads.nativead.NativeAd.

ملخّص

الحقول العامة
View	adChoicesContent
String	advertiser
String	body
String	callToAction
Bundle	extras
String	headline
NativeAd.Image	icon
List<NativeAd.Image>	images
float	mediaContentAspectRatio
boolean	overrideClickHandling
boolean	overrideImpressionRecording
String	price
Double	starRating
String	store

الدوال الإنشائية العامة
NativeAdMapper()

الإجراءات العامة
void	destroy() يجب أن تنفّذ الفئات الفرعية هذه الطريقة إذا كانت حزمة SDK لشبكة التوسّط توفّر طريقة لإيقاف عرض عنصر الإعلان الأصلي.
View	getAdChoicesContent() تعرض هذه السمة طريقة العرض المستخدَمة كمحتوى AdChoices.
final String	getAdvertiser() تعرِض هذه السمة النص الذي يحدّد المعلِن.
final String	getBody() تعرض هذه السمة النص الأساسي.
final String	getCallToAction() تعرض هذه السمة النص الذي يشجّع المستخدم على اتّخاذ إجراء معيّن بشأن الإعلان.
float	getCurrentTime() تعرض هذه السمة الوقت الحالي للفيديو.
float	getDuration() تعرض هذه السمة مدة الفيديو.
final Bundle	getExtras() تعرض هذه السمة حزمة البيانات الإضافية التي تم تمريرها باستخدام طريقة setExtras.
final String	getHeadline() تعرض هذه السمة عنوان النص الأساسي.
final NativeAd.Image	getIcon() تعرِض هذه السمة صورة صغيرة تحدّد هوية المعلِن.
final List<NativeAd.Image>	getImages() تعرض هذه السمة قائمة بالصور الكبيرة.
float	getMediaContentAspectRatio() تعرض هذه السمة نسبة العرض إلى الارتفاع للوسائط التي سيتم عرضها في MediaView.
final boolean	getOverrideClickHandling() تعرِض القيمة "صحيح" إذا كانت الشبكة الإعلانية تعالج النقرات من تلقاء نفسها.
final boolean	getOverrideImpressionRecording() تعرِض القيمة "صحيح" إذا كانت شبكة الإعلانات تتتبّع مرات الظهور من تلقاء نفسها.
final String	getPrice() بالنسبة إلى الإعلانات حول التطبيقات، تعرض هذه السمة سلسلة تمثّل تكلفة التطبيق.
final Double	getStarRating() بالنسبة إلى الإعلانات عن التطبيقات، تعرض هذه السمة تقييمًا بالنجوم من 0 إلى 5 يمثّل عدد النجوم التي حصل عليها التطبيق في المتجر الذي يقدّمه.
final String	getStore() بالنسبة إلى الإعلانات عن التطبيقات، تعرض هذه السمة اسم المتجر الذي يوفّر التطبيق للتنزيل.
void	handleClick(View view) يجب أن تنفّذ الفئات الفرعية هذه الطريقة إذا كانت الشبكة تتطلّب من المطوّر التعامل بشكل صريح مع أحداث النقر على طرق العرض التي يتم عرضها على الشاشة.
boolean	hasVideoContent() تعرِض القيمة "صحيح" إذا كان الإعلان الحالي يتضمّن محتوى فيديو.
void	recordImpression() يجب أن تنفّذ الفئات الفرعية هذه الطريقة إذا كانت الشبكة تتطلّب من المطوّر تسجيل مرّة ظهور لعرض تمّ تقديمه على الشاشة بشكلٍ صريح.
void	setAdChoicesContent(View adChoicesContent) تضبط هذه الطريقة طريقة عرض ليتم استخدامها كمحتوى "خيارات الإعلان".
final void	setAdvertiser(String advertiser) تضبط هذه السمة نصًا يحدّد المعلِن.
final void	setBody(String body) تضبط هذه السمة النص الأساسي.
final void	setCallToAction(String callToAction) تضبط هذه السمة عبارة الحث على اتّخاذ إجراء في الإعلان (مثل "شراء" أو "تثبيت").
final void	setExtras(Bundle extras) تضبط هذه السمة حزمة من الإضافات التي تحتوي على مواد عرض أو سمات لا يتم ربطها مباشرةً بتلك المتوقّعة لكائن "إعلان مدمج مع المحتوى" من Google (العنوان والنص الأساسي وما إلى ذلك).
void	setHasVideoContent(boolean hasVideoContent) اضبط القيمة على "صحيح" إذا كان الإعلان الحالي يتضمّن محتوى فيديو.
final void	setHeadline(String headline) تضبط هذه السمة عنوان النص الأساسي.
final void	setIcon(NativeAd.Image icon) تضبط هذه السمة صورة صغيرة تحدّد هوية المعلِن.
final void	setImages(List<NativeAd.Image> images) تحدِّد هذه السياسة قائمة بالصور الكبيرة.
void	setMediaContentAspectRatio(float mediaContentAspectRatio) تضبط هذه السمة نسبة العرض إلى الارتفاع للوسائط التي سيتم عرضها في MediaView.
void	setMediaView(View mediaView) تضبط هذه السمة طريقة العرض المتوسّطة التي تعرض الوسائط.
final void	setOverrideClickHandling(boolean overrideClickHandling) يجب ضبط القيمة على "صحيح" إذا كانت شبكة الإعلانات تعالج النقرات بنفسها.
final void	setOverrideImpressionRecording(boolean overrideImpressionRecording) يجب ضبط القيمة على "صحيح" إذا كانت شبكة الإعلانات تتتبّع مرات الظهور من تلقاء نفسها.
final void	setPrice(String price) بالنسبة إلى الإعلانات عن التطبيقات، يضبط هذا المفتاح سلسلة تمثّل تكلفة التطبيق.
final void	setStarRating(Double starRating) بالنسبة إلى الإعلانات عن التطبيقات، يحدّد هذا الحقل تقييمًا بالنجوم من 0 إلى 5 يمثّل عدد النجوم التي حصل عليها التطبيق في المتجر الذي يقدّمه.
final void	setStore(String store) بالنسبة إلى الإعلانات عن التطبيقات، يحدّد هذا الحقل اسم المتجر الذي يوفّر التطبيق للتنزيل.
void	trackViews(     View containerView,     Map<String, View> clickableAssetViews,     Map<String, View> nonclickableAssetViews ) يجب أن تنفّذ الفئات الفرعية هذه الطريقة إذا كانت الشبكة تتطلّب من المطوّر إعداد حالة لتسجيل مرّة ظهور و/أو نقرة قبل عرض طريقة العرض على الشاشة.
void	untrackView(View view) يجب أن تنفّذ الفئات الفرعية هذه الطريقة إذا كانت حزمة SDK الخاصة بالشبكة التي يتم التوسط فيها توفّر طريقة لإيقاف تتبُّع مشاهدة إعلان أصلي للإعلان الذي يتم ربطه بهذا العنصر.

الحقول العامة

adChoicesContent

public View adChoicesContent

المعلن

public String advertiser

body

public String body

عبارة الحث على اتخاذ إجراء

public String callToAction

تطبيقات إضافية

public Bundle extras

العنوان

public String headline

رمز

public NativeAd.Image icon

صور

public List<NativeAd.Image> images

mediaContentAspectRatio

public float mediaContentAspectRatio

overrideClickHandling

public boolean overrideClickHandling

overrideImpressionRecording

public boolean overrideImpressionRecording

price

public String price

starRating

public Double starRating

متجر

public String store

الدوال الإنشائية العامة

NativeAdMapper

public NativeAdMapper()

الإجراءات العامة

إتلافه

public void destroy()

يجب أن تنفّذ الفئات الفرعية هذه الطريقة إذا كانت حزمة SDK لشبكة التوسّط توفّر طريقة لإيقاف عرض عنصر الإعلان الأصلي.

getAdChoicesContent

public View getAdChoicesContent()

تعرض هذه السمة طريقة العرض المستخدَمة كمحتوى AdChoices.

getAdvertiser

public final String getAdvertiser()

تعرِض هذه السمة النص الذي يحدّد المعلِن.

getBody

public final String getBody()

تعرض هذه السمة النص الأساسي.

getCallToAction

public final String getCallToAction()

تعرض هذه السمة النص الذي يشجّع المستخدم على اتّخاذ إجراء معيّن بشأن الإعلان.

getCurrentTime

public float getCurrentTime()

تعرض هذه السمة الوقت الحالي للفيديو. تعرض الدالة القيمة صفر تلقائيًا. يجب أن تتجاوز الفئات الفرعية هذه الطريقة لعرض وقت حالي غير صفري لإعلانات الفيديو.

getDuration

public float getDuration()

تعرض هذه السمة مدة الفيديو. تعرض الدالة القيمة صفر تلقائيًا. يجب أن تتجاوز الفئات الفرعية هذه الطريقة لعرض مدة غير صفرية لإعلانات الفيديو.

getExtras

public final Bundle getExtras()

تعرض هذه السمة حزمة البيانات الإضافية التي تم تمريرها باستخدام طريقة setExtras.

getHeadline

public final String getHeadline()

تعرض هذه السمة عنوان النص الأساسي.

getIcon

public final NativeAd.Image getIcon()

تعرِض هذه السمة صورة صغيرة تحدّد هوية المعلِن.

getImages

public final List<NativeAd.Image> getImages()

تعرض هذه السمة قائمة بالصور الكبيرة.

getMediaContentAspectRatio

public float getMediaContentAspectRatio()

تعرض هذه السمة نسبة العرض إلى الارتفاع للوسائط التي سيتم عرضها في MediaView. تعرِض هذه السمة القيمة صفر إذا لم تتوفّر نسبة العرض إلى الارتفاع.

getOverrideClickHandling

public final boolean getOverrideClickHandling()

تعرِض القيمة "صحيح" إذا كانت الشبكة الإعلانية تعالج النقرات من تلقاء نفسها.

getOverrideImpressionRecording

public final boolean getOverrideImpressionRecording()

تعرِض القيمة "صحيح" إذا كانت شبكة الإعلانات تتتبّع مرات الظهور من تلقاء نفسها.

getPrice

public final String getPrice()

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

getStarRating

public final Double getStarRating()

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

getStore

public final String getStore()

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

handleClick

public void handleClick(View view)

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

hasVideoContent

public boolean hasVideoContent()

تعرِض القيمة "صحيح" إذا كان الإعلان الحالي يتضمّن محتوى فيديو.

recordImpression

public void recordImpression()

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

setAdChoicesContent

public void setAdChoicesContent(View adChoicesContent)

تضبط هذه الطريقة طريقة عرض ليتم استخدامها كمحتوى "خيارات الإعلان".

setAdvertiser

public final void setAdvertiser(String advertiser)

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

المعلمات
String advertiser	النص المطلوب ضبطه

setBody

public final void setBody(String body)

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

المعلمات
String body	الوصف المطلوب ضبطه

setCallToAction

public final void setCallToAction(String callToAction)

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

المعلمات
String callToAction	النص المطلوب ضبطه

setExtras

public final void setExtras(Bundle extras)

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

setHasVideoContent

public void setHasVideoContent(boolean hasVideoContent)

اضبط القيمة على "صحيح" إذا كان الإعلان الحالي يتضمّن محتوى فيديو.

setHeadline

public final void setHeadline(String headline)

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

setIcon

public final void setIcon(NativeAd.Image icon)

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

setImages

public final void setImages(List<NativeAd.Image> images)

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

setMediaContentAspectRatio

public void setMediaContentAspectRatio(float mediaContentAspectRatio)

تضبط هذه السمة نسبة العرض إلى الارتفاع للوسائط التي سيتم عرضها في MediaView.

المعلمات
float mediaContentAspectRatio	نسبة العرض إلى الارتفاع المطلوب ضبطها

setMediaView

public void setMediaView(View mediaView)

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

setOverrideClickHandling

public final void setOverrideClickHandling(boolean overrideClickHandling)

يجب ضبط القيمة على "صحيح" إذا كانت شبكة الإعلانات تعالج النقرات بنفسها.

setOverrideImpressionRecording

public final void setOverrideImpressionRecording(boolean overrideImpressionRecording)

يجب ضبط القيمة على "صحيح" إذا كانت شبكة الإعلانات تتتبّع مرات الظهور من تلقاء نفسها.

setPrice

public final void setPrice(String price)

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

المعلمات
String price	السلسلة التي تمثّل تكلفة التطبيق.

setStarRating

public final void setStarRating(Double starRating)

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

setStore

public final void setStore(String store)

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

المعلمات
String store	اسم متجر التطبيقات المطلوب ضبطه

trackViews

public void trackViews(
    View containerView,
    Map<String, View> clickableAssetViews,
    Map<String, View> nonclickableAssetViews
)

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

المعلمات
View containerView	حاوية View الإعلان
Map<String, View> clickableAssetViews	Map أسماء مواد العرض القابلة للنقر على Map
Map<String, View> nonclickableAssetViews	Map أسماء مواد العرض غير القابلة للنقر إلى View المقابلة

untrackView

public void untrackView(View view)

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