המדריך הזה מיועד לבעלי אפליקציות שמשלבים מטא-נתונים של מודעות עם Google Mobile Ads SDK ל-iOS.
דרישות מוקדמות
- גרסה מינימלית 7.41.0 של Google Mobile Ads SDK.
- פועלים לפי השלבים באחד מהמדריכים הבאים:
אחזור מטא-נתונים של מודעות
כדי שהאפליקציה תקבל מידע נוסף על המודעות שמוצגות בה, צריך להגדיר את המודעה כGADAdMetadataDelegate. לאחר מכן, אפשר להאזין לשינויים במטא-נתונים של המודעות על ידי הטמעה של השיטה adMetadataDidChange: ב-GADAdMetadataDelegate. אחרי שקוראים לפונקציית ה-delegate הזו, בודקים את המאפיין adMetadata במודעה.
הפונקציה adMetadataDidChange: נקראת מיד אחרי שמודעה נטענת או כשמטא-נתונים של מודעה משתנים באופן אסינכרוני אחרי שהיא נטענת. אין ערובה לכך שהמטא-נתונים של המודעה יהיו זמינים בזמן הטעינה, ולכן מומלץ להמתין לקריאה החוזרת הזו לפני שתיגשו למטא-נתונים של המודעה.
בדוגמה הבאה מוצג הקוד שנדרש כדי לאחזר את מטא-נתוני המודעה של מודעה מתגמלת:
@interface ViewController () <GADFullScreenContentDelegate, GADAdMetadataDelegate>
@end
@implementation ViewController
- (void)loadRewardedAd {
*request = [ request];
[GADRewardedAd
loadWithAdUnitID:@"ca-app-pub-3940256099942544/4806952744"
request:request
completionHandler:^(GADRewardedAd *ad, NSError *error) {
if (error) {
NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
return;
}
self.rewardedAd = ad;
self.rewardedAd.fullScreenContentDelegate = self;
/// Set the ad to be the delegate of its ad metadata.
self.rewardedAd.adMetadataDelegate = self;
NSLog(@"Rewarded ad loaded.");
}];
}
/#pragma mark GADAdMetadataDelegate implementation
- (void)adMetadataDidChange:(id<GADAdMetadataProvider>)ad {
NSDictionary<NSString*, id> *adMetadata = _rewardedAd.adMetadata;
NSString *adId = adMetadata[@"AdId"];
}
אחרי אחזור המטא-נתונים, אפשר לבדוק את החבילה כדי למצוא את המפתחות שחשובים לכם. לסוגים שונים של מודעות יכולים להיות משויכים מפתחות שונים של מטא-נתונים של מודעות. למודעות וידאו ב-VAST יש את המפתחות הבאים:
| מפתח | סוג | תיאור |
|---|---|---|
AdId |
מחרוזת | המזהה של המודעה, או מחרוזת ריקה אם המזהה לא זמין. |
AdTitle |
מחרוזת | השם, ריק אם לא צוין. |
CreativeDurationMs |
מספר שלם | משך הקריאייטיב שנבחר באלפיות השנייה, -1 אם מדובר בקריאייטיב לא ליניארי. |
TraffickingParameters |
מחרוזת | פרמטרים של ניהול תנועה, או מחרוזת ריקה אם אין פרמטרים כאלה. |
DealId |
מחרוזת | מזהה העסקה הראשון שמופיע בשרשרת העטיפה של המודעה הנוכחית, החל מהחלק העליון, או המחרוזת הריקה אם המידע הזה לא זמין. |
AdSystem |
מחרוזת | שרת המודעות של המקור, ריק אם לא זמין. |
CreativeId |
מחרוזת | המזהה של הקריאייטיב שנבחר למודעה. אם המזהה לא זמין, הערך יהיה ריק. |
MediaURL |
מחרוזת | כתובת ה-URL של המדיה שנבחרה. |
Wrappers |
מערך |
המערך מתמלא ברכיבים שמתחילים במודעת ה-Wrapper הפנימית ביותר (קרוב למודעה בתוך הטקסט) ומתקדמים החוצה למודעת ה-Wrapper החיצונית ביותר. כל
רכיב במערך הוא מילון שמכיל את המפתחות והערכים הבאים.
|