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

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

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

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

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

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

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

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

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

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

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

• כשהתכונה מושבתת, האפליקציה מורה ל-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: 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 ]];

פקדי הפעלה בהתאמה אישית

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

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

מגדירים את GADVideoOptions customControlsRequested ערכה של BOOL.

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

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

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

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

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: AdLoader, didReceive nativeAd: NativeAd) {
  let videoController = nativeAd.mediaContent.videoController
  let canShowCustomControls = videoController?.customControlsEnabled() == true
}

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

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

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

הערה: מידע על ספקי מדידה ואימות שהתחייבו לפתח את תקן הניראות הפתוח למדידת מודעות זמין בקבוצת העבודה של Open Measurement.

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

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

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

מאתחלים מופע של 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 של צד שלישי לצורך רינדור לא מגיבים להגדרה של הוראות מותאמות אישית לקליק.