אפשרויות של מודעות מותאמות

הפרמטר האחרון הכלול ביצירת GADAdLoader הוא מערך אובייקטים אופציונלי. בקטע הזה מפורטות האפשרויות האלה.

Swift

adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

Objective-C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:rootViewController
               adTypes:@[ ... ad type constants ... ]
               options:@[ ... ad loader options objects ... ]];

אפשרויות GADNativeAdImageAdLoader

GADNativeAdImageAdLoaderOptions מכילה מאפיינים הקשורים לתמונות במודעות מותאמות. אפליקציות יכולות לשלוט באופן שבו GADAdLoader מטפל בנכסי תמונות על ידי יצירת אובייקט GADNativeAdImageAdLoaderOptions, הגדרת המאפיינים שלו (disableImageLoading, preferredImageOrientation ו-shouldRequestMultipleImages) והעברתו במהלך האתחול.

ל-GADNativeAdImageAdLoaderOptions יש את המאפיינים הבאים:

disableImageLoading

נכסי תמונות של מודעות מותאמות מוחזרים באמצעות מופעים של GADNativeAdImage, שמכילים image וimageURL נכסים. אם המדיניות disableImageLoading מוגדרת לערך false, שהוא ברירת המחדל (NO ב-Target-C), ה-SDK ישלוף באופן אוטומטי נכסי תמונות וי לאכלס את הנכסים image וגם imageURL. אם המאפיין מוגדר כ-true (או YES ב-Target-C), ערכת ה-SDK תאכלס רק את imageURL, כך שתוכלו להוריד את התמונות בפועל לפי שיקול דעתכם. המאפיין mainImage של GADMediaContent משמש להגדרת התמונה של תצוגת המדיה כשמורידים תמונות באופן ידני.

preferredImageOrientation

לקריאייטיבים מסוימים יש כמה תמונות שזמינות להתאים לכיוונים שונים של מכשירים. אפליקציות יכולות לבקש תמונות לקבלת כיוון מסוים על ידי הגדרת המאפיין הזה לאחד מהקבועים הבאים:

• GADNativeAdImageAdLoaderOptionsOrientationAny
• GADNativeAdImageAdLoaderOptionsOrientationLandscape

• GADNativeAdImageAdLoaderOptionsOrientationPortrait

  אם משתמשים ב-preferredImageOrientation לציון העדפה של תצוגת תמונות לאורך או לרוחב, ערכת ה-SDK תציב תחילה תמונות שתואמות לכיוון הזה במערכי הנכסים של התמונות ותציב תמונות שאינן תואמות אחרי התמונות. מאחר שלמודעות מסוימות יהיה רק כיוון אחד זמין, בעלי האתרים צריכים לוודא שהאפליקציות שלהם יכולות לטפל בתמונות בפריסה לרוחב וגם בתצוגה לאורך.

  אם לא תתבצע קריאה לשיטה הזו, המערכת תשתמש בערך ברירת המחדל GADNativeAdImageAdLoaderOptionsOrientationAny.

shouldRequestMultipleImages

חלק מנכסי התמונות יכילו סדרת תמונות, ולא רק תמונה אחת. על ידי הגדרת הערך הזה כ-True, האפליקציה מציינת שהיא מוכנה להצגת כל התמונות של כל נכס שכולל יותר מנכס אחד. אם מגדירים את המאפיין false (ברירת המחדל), ה-SDK מורה ל-SDK לספק רק את התמונה הראשונה של כל נכס שמכיל סדרה.

אם לא מועברים אובייקטים GADAdLoaderOptions בזמן ההפעלה של GADAdLoader, המערכת תשתמש בערך ברירת המחדל של כל אפשרות.

אפשרויות GADNativeAdViewAd

GADNativeAdViewAdOptions אובייקטים משמשים כדי לציין העדפות לייצוג של מודעות מותאמות. לכל נכס יש מאפיין אחד: preferredAdChoicesPosition, שבו אפשר להשתמש כדי לציין את המיקום של הסמל של AdChoices. הסמל יכול להופיע בכל פינה במודעה, וברירת המחדל שלו היא GADAdChoicesPositionTopRightCorner. הערכים האפשריים לנכס הזה הם:

• GADAdChoicesPositionTopRightCorner
• GADAdChoicesPositionTopLeftCorner
• GADAdChoicesPositionBottomRightCorner
• GADAdChoicesPositionBottomLeftCorner

לפניכם דוגמה שמראה איך למקם את הסמל של AdChoices בפינה הימנית העליונה של מודעה:

Swift

let adViewOptions = GADNativeAdViewAdOptions()
adViewOptions.preferredAdChoicesPosition = .topLeftCorner
adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

Objective-C

GADNativeAdViewAdOptions *adViewOptions = [[GADNativeAdViewAdOptions alloc] init];
adViewOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopLeftCorner;
self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:self
               adTypes:@[ ... ad type constants ...  ]
               options:@[ ... ad loader options objects ... ]];

אפשרויות GADVideo

GADVideoOptions אובייקטים משמשים כדי לציין איך נכסי וידאו מותאמים צריכים להופיע.

הערך הבוליאני startMuted מציין אם נכסי הווידאו צריכים להתחיל לפעול במצב מושתק. ערך ברירת המחדל הוא true.

Swift

let videoOptions = GADVideoOptions()
// Ads start muted by default. Set to false to start video ads with sound.
videoOptions.startMuted = false
adLoader = GADAdLoader(
    adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [videoOptions])

Objective-C

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
// Ads start muted by default. Set to NO to start video ads with sound.
videoOptions.startMuted = NO;
self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:self
               adTypes:@[ ... ad type constants ... ]
               options:@[videoOptions]];

אפשרויות GADMultipleAdsAdLoader

אובייקטים של GADMultipleAdsAdLoaderOptions מאפשרים לבעלי תוכן דיגיטלי להנחות טוען מודעות לטעון מודעות מרובות בבקשה אחת. כדי להבטיח שמודעות ייטענו בצורה הזאת, הן מובטחות כייחודיות. GADMultipleAdsAdLoaderOptions כולל נכס יחיד, numberOfAds, שמייצג את מספר המודעות שטוען המודעות צריך לנסות להחזיר עבור הבקשה. כברירת מחדל, הערך הזה הוא אחד והוא מוגבל לחמש לכל היותר (גם אם אפליקציה מבקשת עוד מודעות, תוחזר עד חמש). מספר המודעות שיוחזרו בפועל אינו מובטח, אך הוא יהיה בין אפס ל-numberOfAds.

אפשרויות GADNativeAdMediaAdLoader

כדי להשתמש בתכונה הזו, צריך לכלול את הסיווג GADNativeAdMediaAdLoaderOptions במערך אפשרויות המודעות המותאמות באתחול של GADAdLoader.

האובייקטים של GADNativeAdMediaAdLoaderOptions מאפשרים לבחור העדפות יחס גובה-רוחב של מדיה. האפשרות חלה גם על תמונה וגם על סרטון. למחלקה הזו יש מאפיין אחד: mediaAspectRatio, שבו אפשר להשתמש כדי לציין את יחסי הגובה-רוחב הנתמכים במדיה. הערכים האפשריים לנכס הזה הם:

Objective-C	Swift
GADMediaAspectRatioAny	.any
GADMediaAspectRatioLandscape	.landscape
GADMediaAspectRatioPortrait	.portrait
GADMediaAspectRatioSquare	.square

הגדרת mediaAspectRatio לאחת מהאפשרויות האלה תחזיר רק מודעות עם מדיה עם יחס גובה-רוחב שצוין. אם הנכס הזה לא יוגדר באופן מפורש, הערך יוגדר כברירת מחדל ל-GADMediaAspectRatioUnknown ולא יחולו הגבלות על יחסי גובה-רוחב.