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

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

דרישות מוקדמות

אמצעי בקרה לנכסים

אמצעי בקרה ליחס גובה-רוחב מועדף למדיה

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

הגדרה של GADNativeAdMediaAdLoaderOptions mediaAspectRatio עם GADMediaAspectRatio.

  • אם המדיניות לא מוגדרת, למודעה שמוחזרת יכול להיות כל יחס גובה-רוחב של מדיה.

  • אחרי ההגדרה תוכלו לשפר את חוויית המשתמש על ידי ציון הסוג המועדף של יחס גובה-רוחב.

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

GADNativeAdMediaAdLoaderOptions *nativeOption = [[GADNativeAdMediaAdLoaderOptions alloc] init];
nativeOption.mediaAspectRatio = GADMediaAspectRatioAny;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

שליטה בהורדת תמונות

האפשרות להורדת תמונות מאפשרת לכם להחליט אם נכסי תמונות או רק מזהי URI שהוחזרו על ידי ה-SDK.

הגדרה של GADNativeAdImageAdLoaderOptions disableImageLoading עם ערך BOOL.
  • כברירת מחדל, הכלי להורדת תמונות מושבת.

  • כשההשבתה מושבתת, Google Mobile Ads SDK מאכלס גם את התמונה וגם את ה-URI בשבילכם.

  • כשהאפשרות הזו מופעלת, ה-SDK מאכלס רק את ה-URI, וכך אפשר להוריד בין התמונות, לפי שיקול דעתכם.

הדוגמה הבאה מורה ל-SDK להחזיר רק את ה-URI.

GADNativeAdImageAdLoaderOptions *nativeOption = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOption.disableImageLoading = YES;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

פקדי מטען ייעודי של תמונות

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

הגדרה של GADNativeAdImageAdLoaderOptions shouldRequestMultipleImages עם ערך BOOL.
  • כברירת מחדל, הפקדים של המטען הייעודי (payload) של התמונות מושבתים.

  • כשהתכונה מושבתת, האפליקציה מורה ל-SDK לספק רק את את התמונה הראשונה של כל נכס שמכיל סדרה.

  • כשהאפשרות מופעלת, האפליקציה מציינת שהיא מוכנה להצגת כל התמונות לכל נכס שיש לו יותר מנכס אחד.

הדוגמה הבאה מורה ל-SDK להחזיר כמה נכסי תמונות.

GADNativeAdImageAdLoaderOptions *nativeOption = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOption.shouldRequestMultipleImages = YES;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

מיקומי מודעות ב-AdChoices

פקדי מיקום של AdChoices

פקדי המיקום של AdChoices מאפשרים לך לבחור איזו פינה להציג סמל AdChoices.

הגדרה של GADNativeAdViewAdOptions preferredAdChoicesPosition עם GADAdChoicesPosition עם ערך מסוים.

  • אם המדיניות לא מוגדרת, המיקום של סמל AdChoices מוגדר בפינה השמאלית העליונה.

  • אם היא מוגדרת, המערכת תמקם את AdChoices במיקום המותאם אישית בהתאם לבקשה.

הדוגמה הבאה ממחישה איך להגדיר מיקום מותאם אישית של תמונה ב-AdChoices.

GADNativeAdViewAdOptions *nativeOptions = [[GADNativeAdViewAdOptions alloc] init];
nativeOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopLeftCorner;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

תצוגה מותאמת אישית של AdChoices

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

מגדירים את GADNativeAd.adChoicesView נכס עם GADAdChoicesView לפני העיבוד והתוכן של AdChoices יוצג GADAdChoicesView

הדוגמה הבאה ממחישה איך להגדיר תצוגה מותאמת אישית של AdChoices. סמל AdChoices יוצג בתוך GADAdChoicesView.

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader didReceiveNativeAd:(GADNativeAd *)nativeAd {

    ...

    
    GADAdChoicesView *customAdChoicesView =
        [[GADAdChoicesView alloc] initWithFrame: CGRectMake(..., ..., ..., ...)];

    [nativeAdView addSubview:customAdChoicesView];
    nativeAdView.adChoicesView = customAdChoicesView;

    // Associate the native ad view with the native ad object. This is
    // required to make the ad clickable.
    // Note: this should always be done after populating the ad views.
    nativeAdView.nativeAd = nativeAd;
}

Swift

func adLoader(_ adLoader: GADAdLoader, didReceive nativeAd: GADNativeAd) {
    refreshAdButton.isEnabled = true

    ...
    // Define a custom position for the AdChoices icon.
    let customRect = CGRect(x: 100, y: 100, width: 15, height: 15)
    let customAdChoicesView = GADAdChoicesView(frame: customRect)
    nativeAdView.addSubview(customAdChoicesView)
    nativeAdView.adChoicesView = customAdChoicesView

    // Associate the native ad view with the native ad object. This is
    // required to make the ad clickable.
    // Note: this should always be done after populating the ad views.
    nativeAdView.nativeAd = nativeAd;
}

פקדי סרטונים

התחלת ההתנהגות של ההשתקה

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

הגדרה של GADVideoOptions startMuted עם ערך BOOL.
  • ההתנהגות של הפעלת השתקה מופעלת כברירת מחדל.

  • כשהתכונה מושבתת, האפליקציה מבקשת שהסרטון צריך להתחיל ב- אודיו.

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

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

GADVideoOptions *nativeOptions = [[GADVideoOptions alloc] init];
nativeOptions.startMuted = NO;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

רכיבי ממשק בהתאמה אישית להפעלה

כך תוכלו לבקש פקדי קלט וידאו בהתאמה אישית להפעלה, להשהיה או להשתקה של וידאו.

הגדרה של GADVideoOptions customControlsRequested עם ערך BOOL.
  • כברירת מחדל, בקרת ההפעלה בהתאמה אישית מושבתת.

  • כשהאפשרות מושבתת, בסרטון יוצגו פקדי קלט שעברו רינדור SDK.

  • אם המודעה מכילה תוכן וידאו ובקרות מותאמות אישית מופעלות, עליך תציג את הפקדים המותאמים אישית ביחד עם המודעה, כי המודעה לא תציג שולטת בעצמה. לאחר מכן, הפקדים יוכלו להפעיל את השיטות הרלוונטיות GADVideoController

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

GADVideoOptions *nativeOptions = [[GADVideoOptions alloc] init];
nativeOptions.customControlsRequested = YES;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

איך בודקים אם אמצעי הבקרה בהתאמה אישית מופעלים

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

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveNativeAd:(GADNativeAd*)nativeAd {

  GADVideoController *videoController = nativeAd.mediaContent.videoController;
  BOOL canShowCustomControls = videoController.customControlsEnabled;

}

Swift

func adLoader(_ adLoader: GADAdLoader, didReceive nativeAd: GADNativeAd) {
        let videoController = nativeAd.mediaContent.videoController
        let canShowCustomControls = videoController?.customControlsEnabled() == true
}

תנועות קליקים בהתאמה אישית

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

אתחול GADNativeAdCustomClickGestureOptions עם כיוון ההחלקה שבחרתם. צריך גם לציין אם שאתם רוצים שנאשר את השימוש בהקשות בתור קליקים.

  • תנועות קליק בהתאמה אישית מושבתות כברירת מחדל.

  • כשההגדרה מושבתת, רק הקשות ייחשבו כקליקים.

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

הדוגמה הבאה מראה איך להטמיע תנועת החלקה מותאמת אישית ימינה ושומר על ההתנהגות הרגילה של ההקשה.

GADNativeAdCustomClickGestureOptions *swipeGestureOptions = [[GADNativeAdCustomClickGestureOptions alloc]
        initWithSwipeGestureDirection:UISwipeGestureRecognizerDirectionRight
                          tapsAllowed:YES];

// The following sample ad unit ID has been enabled for custom click gestures
// and can be used for testing.
self.adLoader = [[GADAdLoader alloc]
        initWithAdUnitID:@"/21775744923/example/native"
      rootViewController:self
                 adTypes:@[ GADAdLoaderAdTypeNative ]
                 options:@[ swipeGestureOptions ]];

האזנה לאירועים של תנועות החלקה

כאשר מתועד קליק על תנועת החלקה, Google Mobile Ads SDK מפעיל את nativeAdDidRecordSwipeGestureClick: שיטת הענקת גישה ב-GADNativeAdDelegate , בנוסף לקובץ nativeAdDidRecordClick: הקיים להענקת גישה.

#pragma mark - GADNativeAdDelegate implementation

// Called when a swipe gesture click is recorded.
- (void)nativeAdDidRecordSwipeGestureClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click has occurred.");
}

// Called when a swipe gesture click or a tap click is recorded, as configured in
// GADNativeAdCustomClickGestureOptions.
- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click or tap click has occurred.");
}

גישור

תנועות קליק בהתאמה אישית פועלות רק במודעות מותאמות ש-Google Mobile רינדור Ads SDK. מקורות של מודעות לחייב ערכות SDK של צד שלישי בשביל הם לא מגיבים להגדרה של מסלול קליקים מותאם אישית.