فئة GANSearchAdController

مرجع الفئة GANSearchAdController

نظرة عامة

يسترد الإعلانات على شبكة البحث ويجعلها متاحة لعميل حزمة تطوير البرامج (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
 رقم تعريف الإعدادات المُستخدَم لطلبات الإعلان. المزيد...
 
GANSearchAdControllerOptionsoptions
 الخيارات المستخدَمة لجميع طلبات الإعلان. المزيد...
 
GANExperimentVariantStatus experimentVariantStatus
 ما إذا كان أحدث نمط معروض عبارة عن صيغة تجربة أو عنصر تحكّم في التجربة أو لم يتم اختياره لتجربة. المزيد...
 

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

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

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

Parameters
publisherIDThe publisher id, e.g. "ms-app-pub-9616389000213823".
styleIDThe settings id for the template that will be used to render native ads.
optionsGANSearchAdControllerOptions, such as adTest, and adSafe, etc.
delegateGANSearchAdControllerDelegate for receiving notifications when ads are loaded and other events.
- (void) loadAds: (GANSearchAdRequest *)  adRequest

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

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

Parameters
adRequestThe 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
    viewThe GANAdView to populate.
    adIdentifierAn 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
    viewThe GANAdView to populate.
    adIdentifierAn 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.
    completionHandlerThe 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

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