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

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

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

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

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

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

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

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

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

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

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

בקרה להורדת תמונה

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

מגדירים את 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:@"ca-app-pub-3940256099942544/3986624511"
                                           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:@"ca-app-pub-3940256099942544/3986624511"
                                           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:@"ca-app-pub-3940256099942544/3986624511"
                                           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:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

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

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

הגדרה של GADVideoOptions customControlsRequested עם ערך BOOL.

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

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

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

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

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           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
}

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

אפשר להשתמש בשיטות המומלצות הבאות כדי ליצור רכיבי UI בהתאמה אישית של פקדי וידאו:

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

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

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

מאתחלים מופע של 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:@"ca-app-pub-3940256099942544/3986624511"
      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 של צד שלישי בשביל הם לא מגיבים להגדרה של מסלול קליקים מותאם אישית.