AdRequest

Kotlin |Java

public class AdRequest

الفئات الفرعية المباشرة المعروفة

AdManagerAdRequest

AdManagerAdRequest

يحتوي AdManagerAdRequest على معلومات استهداف المستخدَمة لجلب إعلان من "مدير إعلانات Google".

---

يحتوي AdRequest على معلومات استهداف تُستخدَم لجلب إعلان. يتم إنشاء طلبات الإعلانات باستخدام AdRequest.Builder.

على الناشرين الذين يستخدمون "مدير إعلانات Google" استخدام com.google.android.gms.ads.admanager.AdManagerAdRequest.

ملخّص

الأنواع المتداخلة
public class AdRequest.Builder extends AbstractAdRequestBuilder إنشاء AdRequest

الثوابت
static final String	DEVICE_ID_EMULATOR = "B3EEABB8EE11C2BE770B684D95219ECB" deviceId للمحاكيات التي سيتم استخدامها مع setTestDeviceIds
static final int	ERROR_CODE_APP_ID_MISSING = 8 لم يتم تقديم طلب الإعلان بسبب عدم توفّر معرّف التطبيق.
static final int	ERROR_CODE_INTERNAL_ERROR = 0 حدثت مشكلة ما داخليًا، على سبيل المثال، تم تلقي استجابة غير صالحة من خادم الإعلانات.
static final int	ERROR_CODE_INVALID_AD_STRING = 11 سلسلة الإعلان غير صالحة.
static final int	ERROR_CODE_INVALID_REQUEST = 1 كان طلب الإعلان غير صالح، على سبيل المثال، كان رقم تعريف الوحدة الإعلانية غير صحيح.
static final int	ERROR_CODE_MEDIATION_NO_FILL = 9 لم يُعبّئ محوِّل التوسّط طلب الإعلان.
static final int	ERROR_CODE_NETWORK_ERROR = 2 تعذّر عرض الإعلان بسبب عدم توفّر اتصال بالشبكة.
static final int	ERROR_CODE_NO_FILL = 3 تم إرسال طلب الإعلان بنجاح، ولكن لم يتم عرض أي إعلان بسبب عدم توفّر مستودع إعلاني.
static final int	ERROR_CODE_REQUEST_ID_MISMATCH = 10 لم يتم العثور على معرّف الطلب في سلسلة الإعلان.
static final int	MAX_CONTENT_URL_LENGTH = 512 الحد الأقصى لطول عنوان URL للمحتوى

الطرق العامة
@Nullable String	getAdString() تحصل على سلسلة الإعلان.
String	getContentUrl() تعرِض هذه السمة معلومات استهداف عنوان URL للمحتوى.
@Nullable Bundle	<T extends CustomEvent> getCustomEventExtrasBundle(Class<T> adapterClass) تم إيقاف هذه الطريقة نهائيًا. استخدِم getNetworkExtrasBundle بدلاً من ذلك.
Set<String>	getKeywords() تعرِض هذه السمة الكلمات الرئيسية لمعلومات الاستهداف.
List<String>	getNeighboringContentUrls() تعرِض هذه السمة قائمة عناوين URL للمحتوى المجاور أو قائمة فارغة إذا لم يتم ضبط أي عناوين URL.
@Nullable Bundle	<T extends MediationExtrasReceiver> getNetworkExtrasBundle(     Class<T> adapterClass ) تعرِض هذه السمة مَعلمات إضافية لنقلها إلى محوِّل شبكة إعلانات معيّن.
String	getRequestAgent() تعرِض سلسلة وكيل الطلب لتحديد مصدر طلب الإعلان.
boolean	isTestDevice(Context context) تعرِض هذه السمة القيمة true إذا كان هذا الجهاز سيتلقّى إعلانات اختبارية.

الثوابت

DEVICE_ID_EMULATOR

public static final String DEVICE_ID_EMULATOR = "B3EEABB8EE11C2BE770B684D95219ECB"

deviceId للمحاكيات التي سيتم استخدامها مع setTestDeviceIds

ERROR_CODE_APP_ID_MISSING

public static final int ERROR_CODE_APP_ID_MISSING = 8

لم يتم تقديم طلب الإعلان بسبب عدم توفّر معرّف التطبيق.

ERROR_CODE_INTERNAL_ERROR

public static final int ERROR_CODE_INTERNAL_ERROR = 0

حدثت مشكلة ما داخليًا، على سبيل المثال، تم تلقي استجابة غير صالحة من خادم الإعلانات.

ERROR_CODE_INVALID_AD_STRING

public static final int ERROR_CODE_INVALID_AD_STRING = 11

سلسلة الإعلان غير صالحة. على سبيل المثال، لا يتوفّر معرّف طلب في سلسلة الإعلان.

ERROR_CODE_INVALID_REQUEST

public static final int ERROR_CODE_INVALID_REQUEST = 1

كان طلب الإعلان غير صالح، على سبيل المثال، كان رقم تعريف الوحدة الإعلانية غير صحيح.

ERROR_CODE_MEDIATION_NO_FILL

public static final int ERROR_CODE_MEDIATION_NO_FILL = 9

لم يُعبّئ محوِّل التوسّط طلب الإعلان. إذا تم عرض هذا الخطأ من getCode، تحقّق من getCause لمعرفة السبب الأساسي.

ERROR_CODE_NETWORK_ERROR

public static final int ERROR_CODE_NETWORK_ERROR = 2

تعذّر عرض الإعلان بسبب عدم توفّر اتصال بالشبكة.

ERROR_CODE_NO_FILL

public static final int ERROR_CODE_NO_FILL = 3

تم إرسال طلب الإعلان بنجاح، ولكن لم يتم عرض أي إعلان بسبب عدم توفّر مستودع إعلاني.

ERROR_CODE_REQUEST_ID_MISMATCH

public static final int ERROR_CODE_REQUEST_ID_MISMATCH = 10

لم يتم العثور على معرّف الطلب في سلسلة الإعلان.

MAX_CONTENT_URL_LENGTH

public static final int MAX_CONTENT_URL_LENGTH = 512

الحد الأقصى لطول عنوان URL للمحتوى

الطرق العامة

getAdString

public @Nullable String getAdString()

تحصل على سلسلة الإعلان.

getContentUrl

public String getContentUrl()

تعرِض هذه السمة معلومات استهداف عنوان URL للمحتوى. تعرِض القيمة null في حال عدم ضبط contentUrl.

getCustomEventExtrasBundle

public @Nullable Bundle <T extends CustomEvent> getCustomEventExtrasBundle(Class<T> adapterClass)

تم إيقاف هذه الطريقة نهائيًا.

استخدِم getNetworkExtrasBundle بدلاً من ذلك.

تعرِض هذه السمة مَعلمات إضافية لنقلها إلى محوِّل حدث مخصّص محدّد. تعرِض القيمة null إذا لم يتم ضبط أيّ إضافات للأحداث المخصّصة من النوع المقدَّم.

getKeywords

public Set<String> getKeywords()

تعرِض هذه السمة الكلمات الرئيسية لمعلومات الاستهداف. تعرِض قيمة فارغة Set إذا لم تتم إضافة أي كلمات رئيسية.

getNeighboringContentUrls

public List<String> getNeighboringContentUrls()

تعرِض هذه السمة قائمة عناوين URL للمحتوى المجاور أو قائمة فارغة إذا لم يتم ضبط أي عناوين URL.

getNetworkExtrasBundle

public @Nullable Bundle <T extends MediationExtrasReceiver> getNetworkExtrasBundle(
    Class<T> adapterClass
)

تعرِض هذه السمة مَعلمات إضافية لنقلها إلى محوِّل شبكة إعلانات معيّن. تعرِض القيمة null إذا لم يتم ضبط أيّ إضافات شبكة من النوع المقدَّم.

getRequestAgent

public String getRequestAgent()

تعرِض سلسلة وكيل الطلب لتحديد مصدر طلب الإعلان.

isTestDevice

public boolean isTestDevice(Context context)

تعرِض هذه السمة القيمة true إذا كان هذا الجهاز سيتلقّى إعلانات اختبارية.