הגדרה של תכונות מותאמות מתקדמות

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

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

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

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

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

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

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

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

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

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

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

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

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

Java

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

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();
NativeAdOptionsSnippets.java

Kotlin

val nativeAdOptions =
  NativeAdOptions.Builder()
    .setMediaAspectRatio(NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
    .build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()
NativeAdOptionsSnippets.kt

מחליפים את AD_UNIT_ID במזהה יחידת המודעות.

אמצעי בקרה להורדת תמונות

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

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

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

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

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

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

Java

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

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID")
        .withNativeAdOptions(nativeAdOptions)
        .forNativeAd(
            nativeAd -> {
              List<Uri> imageUris = new ArrayList<>();
              for (Image image : nativeAd.getImages()) {
                imageUris.add(image.getUri());
              }
            })
        .build();
NativeAdOptionsSnippets.java

Kotlin

val nativeAdOptions = NativeAdOptions.Builder().setReturnUrlsForImageAssets(true).build()

val loader =
  AdLoader.Builder(context, "AD_UNIT_ID")
    .withNativeAdOptions(nativeAdOptions)
    .forNativeAd { nativeAd ->
      val imageUris = nativeAd.images.mapNotNull { it.uri }
    }
    .build()
NativeAdOptionsSnippets.kt

אמצעי בקרה על מטען ייעודי (payload) של תמונות

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

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

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

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

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

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

Java

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

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();
NativeAdOptionsSnippets.java

Kotlin

val nativeAdOptions = NativeAdOptions.Builder().setRequestMultipleImages(true).build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()
NativeAdOptionsSnippets.kt

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

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

אמצעי בקרה על המיקום של AdChoices

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

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

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

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

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

Java

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

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();
NativeAdOptionsSnippets.java

Kotlin

val nativeAdOptions =
  NativeAdOptions.Builder()
    .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
    .build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()
NativeAdOptionsSnippets.kt

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

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

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

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

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

Java

NativeAdView nativeAdView = new NativeAdView(context);
AdChoicesView adChoicesView = new AdChoicesView(context);
nativeAdView.setAdChoicesView(adChoicesView);
NativeAdOptionsSnippets.java

Kotlin

val nativeAdView = NativeAdView(context)
val adChoicesView = AdChoicesView(context)
nativeAdView.adChoicesView = adChoicesView
NativeAdOptionsSnippets.kt

פקדי סרטונים

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

התנהגות השתקה ראשונית

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

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

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

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

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

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

Java

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

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

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();
NativeAdOptionsSnippets.java

Kotlin

val videoOptions = VideoOptions.Builder().setStartMuted(false).build()

val nativeAdOptions = NativeAdOptions.Builder().setVideoOptions(videoOptions).build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()
NativeAdOptionsSnippets.kt

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

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

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

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

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

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

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

VideoController.

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

Java

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

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

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();
NativeAdOptionsSnippets.java

Kotlin

val videoOptions = VideoOptions.Builder().setCustomControlsRequested(true).build()

val nativeAdOptions = NativeAdOptions.Builder().setVideoOptions(videoOptions).build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()
NativeAdOptionsSnippets.kt

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

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

Java

MediaContent mediaContent = nativeAd.getMediaContent();
if (mediaContent != null) {
  VideoController videoController = mediaContent.getVideoController();
  boolean canShowCustomControls = videoController.isCustomControlsEnabled();
}
NativeAdOptionsSnippets.java

Kotlin

val mediaContent = nativeAd.mediaContent
if (mediaContent != null) {
  val videoController = mediaContent.videoController
  val canShowCustomControls = videoController.isCustomControlsEnabled
}
NativeAdOptionsSnippets.kt

הצגת אמצעי בקרה מותאמים אישית של סרטונים

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

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

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