כדי לפתור את הבעיה, מערכת AdMob מספקת את התכונה "הפעלה של מתאם שניתן להגדרה". התכונה הזו מאפשרת לכם לקבוע אילו מתאמים יופעלו בחשיפה הראשונה של המודעה, וכך לצמצם את זמן האחזור של החשיפה הזו.
המדריך הזה עוסק בנושאים הבאים שקשורים להפעלה של מתאם שניתן להגדרה:
דרישות מוקדמות
- מייבאים את Google Mobile Ads SDK בגרסה 13.4.0 ואילך.
- מגדירים את Google Mobile Ads SDK.
כדי להביע הסכמה לשימוש בתכונה הזו, מוסיפים את
#import <GoogleMobileAds/GoogleMobileAds_Beta.h>ב-Objective-C או אתimport GoogleMobileAds_Privateב-Swift.Swift
import GoogleMobileAds import GoogleMobileAds_PrivateObjective-C
#import <GoogleMobileAds/GoogleMobileAds.h> #import <GoogleMobileAds/GoogleMobileAds_Beta.h>
יצירת הגדרות אישיות של מתאם
הגדרת אתחול של מתאם מורה ל-Google Mobile Ads SDK לאתחל רק את המתאמים הנדרשים. כך אפשר למנוע ממתאמים מיותרים לחסום את הבקשה הראשונה להצגת מודעה, לחסוך במשאבי מחשוב ולקצר משמעותית את זמן האחזור של החשיפה הראשונה של המודעה.
כדי לשפר את ביצועי האפליקציה, כדאי להביא בחשבון את האסטרטגיות הבאות כשיוצרים הגדרת אתחול של מתאם:
לתת עדיפות לפורמט מודעה או ליחידת מודעות ספציפיים
כדי לשפר את הביצועים של אפליקציות שמציגות מודעה מיד עם ההפעלה, כמו מודעה בפתיחת האפליקציה, צריך להצהיר על פורמט המודעה או על יחידת המודעות הספציפיים בהגדרות האישיות של המתאם.
בדוגמה הבאה נוצרת הגדרת אתחול של מתאם, שמאתחלת רק את המתאמים הנדרשים של תהליך בחירת הרשת בשביל יחידת מודעות להצגה בפתיחת אפליקציה ספציפית, עם זמן קצוב לתפוגה של חמש שניות:
Swift
let adapterConfig = MediationInitializationConfiguration()
adapterConfig.includedAdUnitIDs = [adUnitID]
adapterConfig.initializationTimeout = 5.0
Objective-C
GADMediationInitializationConfiguration *adapterConfig =
[[GADMediationInitializationConfiguration alloc] init];
adapterConfig.includedAdUnitIDs = [NSSet setWithArray:@[ kTestAdUnitID ]];
adapterConfig.initializationTimeout = 5.0;
בדוגמה הבאה נוצרת הגדרת אתחול של מתאם שמאתחלת רק את המתאמים הנדרשים של תהליך בחירת הרשת (Mediation) לכל המודעות בפתיחת האפליקציה, ומגדירה זמן קצוב לתפוגה של חמש שניות:
Swift
let adapterConfig = MediationInitializationConfiguration()
adapterConfig.includedAdFormats = [AdFormat.appOpen.rawValue as NSNumber]
adapterConfig.initializationTimeout = 5.0
Objective-C
GADMediationInitializationConfiguration *adapterConfig =
[[GADMediationInitializationConfiguration alloc] init];
adapterConfig.includedAdFormats = [NSSet setWithArray:@[ @(GADAdFormatAppOpen) ]];
adapterConfig.initializationTimeout = 5.0;
אתחול של מתאמים ספציפיים לתהליך בחירת הרשת (Mediation)
אם אתם יודעים בדיוק אילו שותפים בתהליך בחירת הרשת בדרך כלל ממלאים את החשיפה הראשונה של המודעה, אתם יכולים להפעיל רק את המתאם הספציפי הזה על ידי ציון שם המחלקה של המתאם בהגדרת ההפעלה של המתאם. כדי לא להמתין למתאמים הנותרים שלא אותחלו במהלך המכרז, כדאי לשלב את זה עם דילוג מפורש על המתאמים שלא אותחלו והגדרת זמן קצוב לתפוגה של Google Mobile Ads SDK.
בדוגמה הבאה נוצרת הגדרת אתחול של מתאם, שמאתחלת מתאם ספציפי של תהליך בחירת הרשת ומגדירה זמן קצוב לתפוגה של חמש שניות:
Swift
let adapterConfig = MediationInitializationConfiguration()
adapterConfig.includedAdapterClasses = [adapterClassName]
adapterConfig.initializationTimeout = 5.0
Objective-C
GADMediationInitializationConfiguration *adapterConfig =
[[GADMediationInitializationConfiguration alloc] init];
adapterConfig.includedAdapterClasses = [NSSet setWithArray:@[ kTestAdapterClassName ]];
adapterConfig.initializationTimeout = 5.0;
החרגה של מתאמי גישור ספציפיים
אם אתם מבחינים שמתאמים מסוימים של תהליך בחירת הרשת (Mediation) גורמים באופן עקבי לזמן אחזור ארוך, אתם יכולים להחריג את המתאמים האלה ולהפעיל אותם בשלב מאוחר יותר.
בדוגמה הבאה נוצרת הגדרת אתחול של מתאם, שמונעת אתחול של מתאמים ספציפיים ומגדירה זמן קצוב לתפוגה של חמש שניות:
Swift
let adapterConfig = MediationInitializationConfiguration()
adapterConfig.excludedAdapterClasses = [adapterClassName]
adapterConfig.initializationTimeout = 5.0
Objective-C
GADMediationInitializationConfiguration *adapterConfig =
[[GADMediationInitializationConfiguration alloc] init];
adapterConfig.excludedAdapterClasses = [NSSet setWithArray:@[ kTestAdapterClassName ]];
adapterConfig.initializationTimeout = 5.0;
דילוג על מתאמים שלא אותחלו
אם אתם מתכננים להפעיל או להחריג מתאמים ספציפיים של תהליך בחירת הרשת, אתם יכולים להגדיר את הבקשה להצגת מודעה כך שתדלג על מתאמים שלא הופעלו ועדיין נמצאים ב-Waterfall.
אם לא יוצרים הגדרת מתאם, עדיין אפשר להגדיר את הבקשה להצגת מודעה כך שתדלג על מתאמים שלא אותחלו. Google Mobile Ads SDK שולח בקשה להצגת מודעה בלי לחכות שהמתאמים יגיעו לזמן הקצוב לתפוגה או ייכשלו בהפעלה.
בדוגמה הבאה, ה-SDK מאותחל עם הגדרת אתחול של מתאם, ונוצרת בקשה להצגת מודעה בפתיחת האפליקציה שמדלגת על מתאמים שלא אותחלו:
Swift
await MobileAds.shared.start(with: adapterInitializationConfig)
// Make your ad request after adapter initialization completes.
let request = Request()
// Set this to guarantee that the ad request
// doesn't wait for any other uninitialized adapters.
request.skipUninitializedAdapters = true
do {
let _ = try await AppOpenAd.load(with: adUnitID, request: request)
} catch {
print("Failed to load app open ad with error: \(error.localizedDescription)")
// TODO: Handle error
}
// Handle non time-sensitive tasks after the ad has loaded regardless of whether ad load
// succeeded.
performPostLaunchSetup()
Objective-C
[[GADMobileAds sharedInstance]
startWithMediationInitializationConfiguration:adapterInitializationConfig
completionHandler:^(GADInitializationStatus *_Nonnull status) {
// Make your ad request after adapter initialization
// completes.
GADRequest *request = [GADRequest request];
// Set this to guarantee that the ad request
// doesn't wait for any other uninitialized adapters
request.shouldSkipUninitializedAdapters = YES;
[GADAppOpenAd
loadWithAdUnitID:adUnitID
request:request
completionHandler:^(GADAppOpenAd *_Nullable ad,
NSError *_Nullable error) {
if (error) {
NSLog(@"Failed to load app open ad with error: %@",
error.localizedDescription);
}
// Handle non time-sensitive tasks after the
// ad has loaded regardless of whether ad load succeeded.
[self performPostLaunchSetup];
}];
}];
אתחול של שאר המתאמים
אחרי שההזדמנויות להצגת מודעות שרגישות לזמן נטענו, צריך להפעיל את שאר המתאמים כדי לוודא כיסוי מלא של שותפים בתהליך בחירת הרשת בשאר הסשן באפליקציה.
בדוגמה הבאה, שאר המתאמים מאותחלים באמצעות הגדרה ריקה:
Swift
// Provide start with nil to initialize any adapters
// not initialized with configurable initialization.
MobileAds.shared.start(with: nil) { status in
// Remaining adapters are now initialized.
}
Objective-C
// Call start with nil to initialize any adapters not initialized via configurable initialization.
[[GADMobileAds sharedInstance]
startWithMediationInitializationConfiguration:nil
completionHandler:^(GADInitializationStatus *_Nonnull status) {
// Remaining adapters are now initialized.
}];