Ön koşullar
Özel etkinlik ayarlarını tamamlayın.
Banner reklam isteme
Özel etkinlik satır öğesine şelale uyumlulaştırma zincirinde ulaşıldığında,
loadBanner:adConfiguration:completionHandler:
yöntemi
oluştururken belirttiğiniz sınıf adı
bakın. Böyle durumlarda
bu yöntem SampleCustomEvent
içindedir ve bu durumda
loadBanner:adConfiguration:completionHandler:
yöntemi
SampleCustomEventBanner
.
Banner reklam istemek için şunu uygulayan bir sınıf oluşturun veya değiştirin:
GADMediationAdapter
ve loadBanner:adConfiguration:completionHandler:
.
GADMediationAdapter
öğesini genişleten sınıf zaten var, uygulayın
loadBanner:adConfiguration:completionHandler:
burada. Ek olarak,
GADMediationBannerAd
öğesini uygulamak için yeni sınıf oluşturun.
Özel etkinlik örneğimizde,
SampleCustomEvent
uygular
GADMediationAdapter
arayüzünü kullanır ve ardından
SampleCustomEventBanner
.
Swift
import GoogleMobileAds class SampleCustomEvent: NSObject, GADMediationAdapter { fileprivate var bannerAd: SampleCustomEventBanner? ... func loadBanner( for adConfiguration: GADMediationBannerAdConfiguration, completionHandler: @escaping GADMediationBannerLoadCompletionHandler ) { self.bannerAd = SampleCustomEventBanner() self.bannerAd?.loadBanner( for: adConfiguration, completionHandler: completionHandler) } }
Objective-C
#import "SampleCustomEvent.h" @implementation SampleCustomEvent ... SampleCustomEventBanner *sampleBanner; - (void)loadBannerForAdConfiguration: (GADMediationBannerAdConfiguration *)adConfiguration completionHandler:(GADMediationBannerLoadCompletionHandler) completionHandler { sampleBanner = [[SampleCustomEventBanner alloc] init]; [sampleBanner loadBannerForAdConfiguration:adConfiguration completionHandler:completionHandler]; }
SampleCustomEventBanner
şu görevlerden sorumludur:
Banner reklamı yükleme ve Bir kez
GADMediationBannerLoadCompletionHandler
yöntemi yükleme tamamlandı.GADMediationBannerAd
protokolü uygulanıyor.Google Mobile Ads SDK'sına reklam etkinliği geri çağırmaları alma ve raporlama
AdMob kullanıcı arayüzünde tanımlanan isteğe bağlı parametre
dahil edilir.
Parametreye
adConfiguration.credentials.settings[@"parameter"]
Bu parametre
genellikle bir reklam ağı SDK'sının aşağıdaki durumlarda gerekli olan reklam birimi tanımlayıcısını
bir reklam nesnesini örneklendirmek için kullanılır.
Swift
class SampleCustomEventBanner: NSObject, GADMediationBannerAd { /// The Sample Ad Network banner ad. var bannerAd: SampleBanner? /// The ad event delegate to forward ad rendering events to the Google Mobile Ads SDK. var delegate: GADMediationBannerAdEventDelegate? /// Completion handler called after ad load var completionHandler: GADMediationBannerLoadCompletionHandler? func loadBanner( for adConfiguration: GADMediationBannerAdConfiguration, completionHandler: @escaping GADMediationBannerLoadCompletionHandler ) { // Create the bannerView with the appropriate size. let adSize = adConfiguration.adSize bannerAd = SampleBanner( frame: CGRect(x: 0, y: 0, width: adSize.size.width, height: adSize.size.height)) bannerAd?.delegate = self bannerAd?.adUnit = adConfiguration.credentials.settings["parameter"] as? String let adRequest = SampleAdRequest() adRequest.testMode = adConfiguration.isTestRequest self.completionHandler = completionHandler bannerAd?.fetchAd(adRequest) } }
Objective-C
#import "SampleCustomEventBanner.h" @interface SampleCustomEventBanner () <SampleBannerAdDelegate, GADMediationBannerAd> { /// The sample banner ad. SampleBanner *_bannerAd; /// The completion handler to call when the ad loading succeeds or fails. GADMediationBannerLoadCompletionHandler _loadCompletionHandler; /// The ad event delegate to forward ad rendering events to the Google Mobile /// Ads SDK. id <GADMediationBannerAdEventDelegate> _adEventDelegate; } @end @implementation SampleCustomEventBanner - (void)loadBannerForAdConfiguration: (GADMediationBannerAdConfiguration *)adConfiguration completionHandler:(GADMediationBannerLoadCompletionHandler) completionHandler { __block atomic_flag completionHandlerCalled = ATOMIC_FLAG_INIT; __block GADMediationBannerLoadCompletionHandler originalCompletionHandler = [completionHandler copy]; _loadCompletionHandler = ^id<GADMediationBannerAdEventDelegate>( _Nullable id<GADMediationBannerAd> ad, NSError *_Nullable error) { // Only allow completion handler to be called once. if (atomic_flag_test_and_set(&completionHandlerCalled)) { return nil; } id<GADMediationBannerAdEventDelegate> delegate = nil; if (originalCompletionHandler) { // Call original handler and hold on to its return value. delegate = originalCompletionHandler(ad, error); } // Release reference to handler. Objects retained by the handler will also // be released. originalCompletionHandler = nil; return delegate; }; NSString *adUnit = adConfiguration.credentials.settings[@"parameter"]; _bannerAd = [[SampleBanner alloc] initWithFrame:CGRectMake(0, 0, adConfiguration.adSize.size.width, adConfiguration.adSize.size.height)]; _bannerAd.adUnit = adUnit; _bannerAd.delegate = self; SampleAdRequest *adRequest = [[SampleAdRequest alloc] init]; adRequest.testMode = adConfiguration.isTestRequest; [_bannerAd fetchAd:adRequest]; }
Reklam başarılı bir şekilde getirildiğinde veya bir hatayla karşılaşıldığında
GADMediationBannerLoadCompletionHandler
araması yapar. Başarılı olmaları durumunda,
nil
değeriyle GADMediationBannerAd
öğesini uygulayan sınıfı geç
hata parametresi için; başarısız olması durumunda, kullandığınız hatayı
karşılaşılır.
Genellikle bu yöntemler
üçüncü taraf SDK'sı oluşturun. Bu örnekte, örnek SDK
alakalı geri çağırmaları içeren bir SampleBannerAdDelegate
içeriyor:
Swift
func bannerDidLoad(_ banner: SampleBanner) { if let handler = completionHandler { delegate = handler(self, nil) } } func banner( _ banner: SampleBanner, didFailToLoadAdWith errorCode: SampleErrorCode ) { let error = SampleCustomEventUtilsSwift.SampleCustomEventErrorWithCodeAndDescription( code: SampleCustomEventErrorCodeSwift .SampleCustomEventErrorAdLoadFailureCallback, description: "Sample SDK returned an ad load failure callback with error code: \(errorCode)" ) if let handler = completionHandler { delegate = handler(nil, error) } }
Objective-C
- (void)bannerDidLoad:(SampleBanner *)banner { _adEventDelegate = _loadCompletionHandler(self, nil); } - (void)banner:(SampleBanner *)banner didFailToLoadAdWithErrorCode:(SampleErrorCode)errorCode { NSError *error = SampleCustomEventErrorWithCodeAndDescription( SampleCustomEventErrorAdLoadFailureCallback, [NSString stringWithFormat:@"Sample SDK returned an ad load failure " @"callback with error code: %@", errorCode]); _adEventDelegate = _loadCompletionHandler(nil, error); }
GADMediationBannerAd
, bir UIView
özelliğinin uygulanmasını gerektirir:
Swift
var view: UIView { return bannerAd ?? UIView() }
Objective-C
- (nonnull UIView *)view { return _bannerAd; }
Uyumlulaştırma etkinliklerini Google Mobile Ads SDK'sına yönlendirme
Yüklenen reklamla GADMediationBannerLoadCompletionHandler
adlı öğeyi çağırdıktan sonra
döndürülen GADMediationBannerAdEventDelegate
delege nesnesi daha sonra
Bağdaştırıcı tarafından, üçüncü taraf SDK'sından sunu etkinliklerini iletmek için kullanılır.
Google Mobile Ads SDK'sı. SampleCustomEventBanner
sınıfı
Örnek reklamdan geri çağırmaları yönlendirmek için SampleBannerAdDelegate
protokolü
ağı Google Mobile Ads SDK'sına bağlamalısınız.
Özel etkinliğinizin bu geri çağırmalardan mümkün olduğunca çoğunu yönlendirmesi Böylece uygulamanız, Google Ads'den bu eşdeğer etkinlikleri Mobile Ads SDK'sı. Aşağıda, geri çağırma işlevinin kullanımına dair bir örnek verilmiştir:
Swift
func bannerWillLeaveApplication(_ banner: SampleBanner) { delegate?.reportClick() }
Objective-C
- (void)bannerWillLeaveApplication:(SampleBanner *)banner { [_adEventDelegate reportClick]; }
Böylece banner reklamlar için özel etkinlik uygulaması tamamlanır. Tam örnek şurada kullanılabilir: GitHub'a gidin. Bunu zaten desteklenen bir reklam ağıyla kullanabilir veya şuna göre değiştirebilirsiniz: görüntülü reklam ağı özel etkinlik banner reklamları.