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

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

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

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

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

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

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

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

התקשרות אל NativeAdOptions.Builder.setMediaAspectRatio() עם NativeAdOptions.MediaAspectRatio עם ערך מסוים.

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

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

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

NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
                              .setMediaAspectRatio(NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
                              .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

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

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

התקשרות אל NativeAdOptions.Builder.setReturnUrlsForImageAssets() עם ערך boolean.

• כברירת מחדל, הכלי להורדת תמונות מושבת.

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

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

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

NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
                                                     .setReturnUrlsForImageAssets(true)
                                                     .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .forNativeAd(nativeAd -> {
                                List<Uri> imageUris = new ArrayList<>();
                                for (Image image : nativeAd.getImages()) {
                                  imageUris.add(image.getUri());
                                }
                              })
                              .build();

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

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

התקשרות אל NativeAdOptions.Builder.setRequestMultipleImages() עם ערך boolean.

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

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

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

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

NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
                                                     .setRequestMultipleImages(true)
                                                     .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

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

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

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

התקשרות אל NativeAdOptions.Builder.setAdChoicesPlacement() עם NativeAdOption.AdChoicesPlacement עם ערך מסוים.

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

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

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

NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
                                                     .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
                                                     .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

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

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

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

התקשרות אל NativeAdView.setAdChoicesView() עם AdChoicesView עם ערך מסוים.

הדוגמה הבאה ממחישה איך להגדיר תצוגה מותאמת אישית של AdChoices, עם סמל AdChoices מוצג בתוך AdChoicesView.

public void onNativeAdLoaded(NativeAd ad) {
    NativeAdView nativeAdView = new NativeAdView(getApplicationContext());
    AdChoicesView adChoicesView = new AdChoicesView(this);
    nativeAdView.setAdChoicesView(adChoicesView);
}

פקדי סרטונים

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

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

התקשרות אל VideoOptions.Builder.setStartMuted() עם ערך boolean.

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

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

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

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

VideoOptions videoOptions = new VideoOptions.Builder()
                                            .setStartMuted(false)
                                            .build();

NativeAdOptions adOptions = new NativeAdOptions.Builder()
                                               .setVideoOptions(videoOptions)
                                               .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(adOptions).build();

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

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

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

התקשרות אל VideoOptions.Builder.setCustomControlsRequested() עם ערך boolean.

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

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

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

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

VideoOptions videoOptions = new VideoOptions.Builder()
                                            .setCustomControlsRequested(true)
                                            .build();

NativeAdOptions adOptions = new NativeAdOptions.Builder()
                                               .setVideoOptions(videoOptions)
                                               .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(adOptions).build();

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

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

Java

@Override
public void onNativeAdLoaded(NativeAd nativeAd) {
  MediaContent mediaContent = nativeAd.getMediaContent();
  if (mediaContent != null) {
    VideoController videoController = mediaContent.getVideoController();
    boolean canShowCustomControls = videoController.isCustomControlsEnabled();
  }
}

Kotlin

NativeAd.OnNativeAdLoadedListener { ad ->
  val mediaContent = ad.mediaContent
  if (mediaContent != null) {
    val videoController = mediaContent.videoController
    val canShowCustomControls = videoController.isCustomControlsEnabled
  }
}

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

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

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

התקשרות אל NativeAdOptions.Builder.enableCustomClickGestureDirection() עם NativeAdOptions.SwipeGestureDirection ו-boolean כדי לציין אם אתם רוצים לאפשר קליקים בתור קליקים.

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

• כשהתכונה מושבתת, האפליקציה תתמוך בהתנהגות קליקים רגילה.

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

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

NativeAdOptions adOptions = new NativeAdOptions
    .Builder()
    .enableCustomClickGestureDirection(NativeAdOptions.SWIPE_GESTURE_DIRECTION_RIGHT,
            /* tapsAllowed= */ true)
    .build();

// The following sample ad unit ID has been enabled for custom click gestures
// and can be used for testing.
AdLoader.Builder builder = new AdLoader
    .Builder(this, 'ca-app-pub-3940256099942544/2247696110')
    .withNativeAdOptions(adOptions);

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

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

כאשר מתועד קליק על תנועת החלקה, Google Mobile Ads SDK מפעיל את השיטה onAdSwipeGestureClicked() ב-AdListener, בנוסף לשיטה הקיימת אמצעי תשלום אחד (onAdClicked()).

AdLoader adLoader = builder
    .withAdListener(
      new AdListener() {
        // Called when a swipe gesture click is recorded.
        @Override
        public void onAdSwipeGestureClicked() {
          Log.d(TAG, "A swipe gesture click has occurred.")
        }

        // Called when a swipe gesture click or a tap click is recorded, as
        // configured in NativeAdOptions.
        @Override
        public void onAdClicked() {
          Log.d(TAG, "A swipe gesture click or a tap click has occurred.")
        }
      })
    .build();

גישור

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