نظرة عامة

يسترد الإعلانات على شبكة البحث ويجعلها متاحة لعميل حزمة تطوير البرامج (SDK).

تكتسب NSObject.

ملخّص طريقة المثيل
(instancetype)	- NS_UNAVAILABLE

(instancetype)	- initWithPublisherID:styleID:options:delegate:
	يعمل على إعداد وحدة التحكّم في الإعلانات. المزيد...

(void)	- loadAds:
	يعمل هذا الإجراء على استرداد الصفحة الأولى من الإعلانات الخاصة بسمة `adRequest` المحدّدة، وكذلك الصفحات اللاحقة، على نحو غير متزامن، حسب الحاجة. المزيد...

(void)	- loadMoreAds
	استرداد الصفحة التالية من الإعلانات للطلب السابق المحدّد من خلال المكالمة الأخيرة إلى `loadAds:` على نحو غير متزامن. المزيد...

(NSInteger)	- adCount
	تعرض إجمالي عدد الإعلانات التي تم تحميلها من آخر مكالمة إلى `loadAds:`. المزيد...

(GANAdView *)	- adView
	إنشاء adView فارغة المزيد...

(void)	- populateAdView:identifier:
	تعبئة adView بالإعلان المحدد بمعرّفه المزيد...

(void)	- populateAdView:identifier:completionHandler:
	تعبئة adView بالإعلان الذي حدّده المعرّف واستدعاء معالج الإكمال عندما يكون الإعلان جاهزًا للعرض. المزيد...

ملخّص الموقع
NSString *	publisherID
	الرقم التعريفي للناشر المُستخدَم لطلبات الإعلان. المزيد...

NSString *	styleID
	رقم تعريف الإعدادات المُستخدَم لطلبات الإعلان. المزيد...

GANSearchAdControllerOptions *	options
	الخيارات المستخدَمة لجميع طلبات الإعلان. المزيد...

GANExperimentVariantStatus	experimentVariantStatus
	ما إذا كان أحدث نمط معروض عبارة عن صيغة تجربة أو عنصر تحكّم في التجربة أو لم يتم اختياره لتجربة. المزيد...

تفاصيل الطريقة

- (instancetype) initWithPublisherID:	(NSString *)	publisherID
styleID:	(NSString *)	styleID
options:	(nullable GANSearchAdControllerOptions *)	options
delegate:	(nullable id< GANSearchAdControllerDelegate >)	delegate

يعمل على إعداد وحدة التحكّم في الإعلانات.

Parameters

publisherID	The publisher id, e.g. "ms-app-pub-9616389000213823".
styleID	The settings id for the template that will be used to render native ads.
options	GANSearchAdControllerOptions, such as adTest, and adSafe, etc.
delegate	GANSearchAdControllerDelegate for receiving notifications when ads are loaded and other events.

- (void) loadAds: (GANSearchAdRequest *) adRequest

يعمل هذا الإجراء على استرداد الصفحة الأولى من الإعلانات الخاصة بسمة adRequest المحدّدة، وكذلك الصفحات اللاحقة، على نحو غير متزامن، حسب الحاجة.

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

Parameters

adRequest The GANSearchAdRequest query.

- (void) loadMoreAds

استرداد الصفحة التالية من الإعلانات للطلب السابق المحدّد من خلال المكالمة الأخيرة إلى loadAds: على نحو غير متزامن.

إذا لم يتم استدعاء loadAds:، سيؤدي ذلك إلى عرض خطأ من خلال GANSearchAdControllerDelegate. وإذا كانت هناك صفحة كاملة تحتوي على إعلانات لم يتم عرضها، سيؤدي ذلك أيضًا إلى عرض رسالة خطأ للمفوّض.

- (NSInteger) adCount

تعرض إجمالي عدد الإعلانات التي تم تحميلها من آخر مكالمة إلى loadAds:.

- (GANAdView *) adView

إنشاء adView فارغة

- (void) populateAdView:	(GANAdView *)	view
identifier:	(NSString *)	adIdentifier

تعبئة adView بالإعلان المحدد بمعرّفه

إذا كان adIdentifier معرّفًا جديدًا، ستعرض طريقة العرض الإعلان المتاح التالي.

إذا تم استخدام adIdentifier من قبل، ستعرض المشاهدة الإعلان نفسه الذي تم عرضه في المرة الأولى التي تم فيها استدعاء هذه الطريقة باستخدام adIdentifier.

Parameters

view	The GANAdView to populate.
adIdentifier	An ad identifier used to identify this ad. This can be any NSString. Each unique string will be assigned to the next available ad until ads are exhausted.

- (void) populateAdView:	(GANAdView *)	view
identifier:	(NSString *)	adIdentifier
completionHandler:	(GANAdViewPopulatedCompletionHandler)	completionHandler

تعبئة adView بالإعلان الذي حدّده المعرّف واستدعاء معالج الإكمال عندما يكون الإعلان جاهزًا للعرض.

إذا كان adIdentifier معرّفًا جديدًا، ستعرض طريقة العرض الإعلان المتاح التالي.

إذا تم استخدام adIdentifier من قبل، ستعرض المشاهدة الإعلان نفسه الذي تم عرضه في المرة الأولى التي تم فيها استدعاء هذه الطريقة باستخدام adIdentifier.

Parameters

view	The GANAdView to populate.
adIdentifier	An ad identifier used to identify this ad. This can be any NSString. Each unique string will be assigned to the next available ad until ads are exhausted.
completionHandler	The completion handler to be called when the ad view is ready to be displayed. Ad specific data will provided such as the height of the ad view.

تفاصيل الموقع

- (NSString*) publisherID

readnonatomiccopy

الرقم التعريفي للناشر المُستخدَم لطلبات الإعلان.

- (NSString*) styleID

readnonatomiccopy

رقم تعريف الإعدادات المُستخدَم لطلبات الإعلان.

- (GANSearchAdControllerOptions*) options

readnonatomicstrong

الخيارات المستخدَمة لجميع طلبات الإعلان.

- (GANExperimentVariantStatus) experimentVariantStatus

readnonatomicassign

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

فئة GANSearchAdController

نظرة عامة

ملخّص طريقة المثيل

ملخّص الموقع

تفاصيل الطريقة

تفاصيل الموقع