NativeCustomFormatAd

public interface NativeCustomFormatAd

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

ملخّص

الأنواع المتداخلة

واجهة لقياس الأداء المفتوح في الإعلانات الصورية

تعريف واجهة للرجوع إليها عند النقر على شكل إعلان مخصّص مدمج مع المحتوى.

تعريف واجهة لردّ اتصال يتمّ استدعاؤه عند تحميل تنسيق إعلان مخصّص مدمج مع المحتوى بنجاح.

الثوابت
default static final String
ASSET_NAME_VIDEO = "_videoMediaView"

اسم مادة العرض المرتبط بمحتوى الفيديو الذي يعرضه getMediaContent

الطرق العامة
abstract void

تؤدي إلى إتلاف عنصر الإعلان.
abstract @Nullable List<String>

تُعيد هذه الدالة قائمة بجميع مواد العرض المتاحة.
abstract @Nullable String

تعرِض هذه الدالة رقم تعريف تنسيق الإعلانات المدمجة المخصّص كما هو محدّد في واجهة مستخدِم "مدير إعلانات Google".
abstract NativeCustomFormatAd.DisplayOpenMeasurement

تعرِض هذه السمة DisplayOpenMeasurement المرتبط بهذا الإعلان.
abstract @Nullable NativeAd.Image
getImage(String assetName)

تعرِض مادة عرض صورة.
abstract @Nullable MediaContent

تعرِض هذه السمة MediaContent المرتبط بهذا الإعلان.
abstract @Nullable CharSequence
getText(String assetName)

تعرِض مادة عرض سلسلة من الأرقام أو عناوين URL أو أنواع أخرى غير مواد عرض الصور.
abstract void
performClick(String assetName)

يُجري نقرة على الإعلان، ما يؤدي إلى تنفيذ سلوك النقر.
abstract void

تسجيل مرّة ظهور

الثوابت

ASSET_NAME_VIDEO

default static final String ASSET_NAME_VIDEO = "_videoMediaView"

اسم مادة العرض المرتبط بمحتوى الفيديو الذي يعرضه getMediaContent هذا هو اسم مادة العرض الذي سيتم الإبلاغ عنه في onCustomClick عندما ينقر المستخدم على MediaView الذي يحتوي على محتوى الفيديو الذي يعرضه getMediaContent.

الطرق العامة

إتلافه

abstract void destroy()

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

getAvailableAssetNames

abstract @Nullable List<String> getAvailableAssetNames()

تُعيد هذه الدالة قائمة بجميع مواد العرض المتاحة.

المرتجعات
@Nullable List<String>

قائمة بجميع مواد العرض المتاحة، أو قائمة فارغة إذا لم تكن هناك مادة عرض متاحة

getCustomFormatId

abstract @Nullable String getCustomFormatId()

تعرِض هذه الدالة رقم تعريف تنسيق الإعلانات المدمجة المخصّصة كما هو محدّد في واجهة مستخدِم "مدير إعلانات Google".

getDisplayOpenMeasurement

abstract NativeCustomFormatAd.DisplayOpenMeasurement getDisplayOpenMeasurement()

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

المرتجعات
NativeCustomFormatAd.DisplayOpenMeasurement

null إذا لم يكن قياس فتح الإعلانات الصورية متاحًا لهذا الإعلان.

getImage

abstract @Nullable NativeAd.Image getImage(String assetName)

تعرِض مادة عرض صورة.

المعلمات
String assetName

اسم مادة العرض التي سيتم استرجاعها.
المرتجعات
@Nullable NativeAd.Image

قيمة مادة العرض التي تتضمّن اسم مادة العرض، أو قيمة فارغة إذا لم يكن هناك اسم مادة عرض من هذا النوع

getMediaContent

abstract @Nullable MediaContent getMediaContent()

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

getText

abstract @Nullable CharSequence getText(String assetName)

تعرِض مادة عرض سلسلة من الأرقام أو عناوين URL أو أنواع أخرى غير مواد عرض الصور.

المعلمات
String assetName

اسم مادة العرض التي سيتم استرجاعها.
المرتجعات
@Nullable CharSequence

قيمة مادة العرض التي تتضمّن اسم مادة العرض، أو قيمة فارغة إذا لم يكن هناك اسم مادة عرض من هذا النوع

performClick

abstract void performClick(String assetName)

يُجري نقرة على الإعلان، ما يؤدي إلى تنفيذ سلوك النقر.

المعلمات
String assetName

اسم مادة العرض التي تم النقر عليها.

recordImpression

abstract void recordImpression()

تسجيل مرّة ظهور استخدِم هذه الطريقة عند عرض الإعلان للمستخدِم لأول مرّة.