כדי לדון במוצרים שלנו ולספק משוב, אתם יכולים להצטרף לערוץ הרשמי של AdMob ב-Discord בשרת Google Advertising and Measurement Community.

דף זה תורגם על ידי Cloud Translation API.

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

בחירת פלטפורמה: Android iOS

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

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

משלבים את פורמט המודעה המותאמת.

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

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

העדפות לגבי יחס גובה-רוחב של מדיה

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

מגדירים את 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 ]];

הפקדים של מטען הייעודי (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 מאפשרים לכם לבחור באיזו פינה יוצג סמל 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: AdLoader, didReceive nativeAd: NativeAd) {
    refreshAdButton.isEnabled = true

    ...
    // Define a custom position for the AdChoices icon.
    let customRect = CGRect(x: 100, y: 100, width: 15, height: 15)
    let customAdChoicesView = AdChoicesView(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 ]];

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

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

מגדירים את GADVideoOptions customControlsRequested עם ערך BOOL.

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

אחרי שמפעילים את התכונה, אפשר להשתמש בלחצנים GADVideoController play,‏ GADVideoController pause ו-GADVideoController setMute כדי לשלוט במודעת הווידאו.

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

GADVideoController.

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

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: AdLoader, didReceive nativeAd: NativeAd) {
  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:@"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 של צד שלישי לצורך הצגה, לא מגיבים להגדרה של כיווני לחיצה בהתאמה אישית.