אתם מוזמנים לשתף את המשוב שלכם על GMA Next-Gen SDK בערוץ #gma-next-gen-sdk בשרת של קהילת הפרסום והמדידה של Google ב-Discord.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

מודעות מותאמות

בחירת פלטפורמה: Android iOS Android (גרסה קודמת)

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

הגדרת הכיתה `NativeAdView`

הגדרת כיתה NativeAdView. הכיתה הזו היא כיתה מסוג ViewGroup והיא מאגר ברמה העליונה לכיתה מסוג NativeAdView. כל תצוגה של מודעה מותאמת מכילה נכסים של מודעות מותאמות, כמו רכיב התצוגה MediaView או רכיב התצוגה Title, שחייב להיות צאצא של אובייקט NativeAdView.

פריסת XML

מוסיפים קובץ XML‏ NativeAdView לפרויקט:

<com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">
    <LinearLayout
    android:orientation="vertical">
        <LinearLayout
        android:orientation="horizontal">
          <ImageView
          android:id="@+id/ad_app_icon" />
          <TextView
            android:id="@+id/ad_headline" />
        </LinearLayout>
        <!--Add remaining assets such as the image and media view.-->
    </LinearLayout>
</com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView>

Jetpack פיתוח נייטיב

כוללים את התיקייה JetpackCompose Utilities ‎. התיקייה הזו כוללת רכיבי עזר ליצירת האובייקט NativeAdView והנכסים.

כתיבת NativeAdView:

  import com.google.android.gms.compose_util.NativeAdAttribution
  import com.google.android.gms.compose_util.NativeAdView

  @Composable
  /** Display a native ad with a user defined template. */
  fun DisplayNativeAdView(nativeAd: NativeAd) {
      NativeAdView {
          // Display the ad attribution.
          NativeAdAttribution(text = context.getString("Ad"))
          // Add remaining assets such as the image and media view.
        }
    }

טיפול במודעה מותאמת שנטענה

כשמודעה מותאמת נטענת, צריך לטפל באירוע הקריאה החוזרת, ליצור אוביקט תצוגה (inflate) של התצוגה במודעה ולהוסיף אותה להיררכיית התצוגה:

Kotlin

// Build an ad request with native ad options to customize the ad.
val adTypes = listOf(NativeAd.NativeAdType.NATIVE)
val adRequest = NativeAdRequest
  .Builder("ca-app-pub-3940256099942544/2247696110", adTypes)
  .build()

val adCallback =
  object : NativeAdLoaderCallback {
    override fun onNativeAdLoaded(nativeAd: NativeAd) {
      activity?.runOnUiThread {

        val nativeAdBinding = NativeAdBinding.inflate(layoutInflater)
        val adView = nativeAdBinding.root
        val frameLayout = myActivityLayout.nativeAdPlaceholder

        // Populate and register the native ad asset views.
        displayNativeAd(nativeAd, nativeAdBinding)

        // Remove all old ad views and add the new native ad
        // view to the view hierarchy.
        frameLayout.removeAllViews()
        frameLayout.addView(adView)
      }
    }
  }

// Load the native ad with our request and callback.
NativeAdLoader.load(adRequest, adCallback)

Java

// Build an ad request with native ad options to customize the ad.
List<NativeAd.NativeAdType> adTypes = Arrays.asList(NativeAd.NativeAdType.NATIVE);
NativeAdRequest adRequest = new NativeAdRequest
                                .Builder("ca-app-pub-3940256099942544/2247696110", adTypes)
                                .build();

NativeAdLoaderCallback adCallback = new NativeAdLoaderCallback() {
    @Override
    public void onNativeAdLoaded(NativeAd nativeAd) {
      if (getActivity() != null) {
        getActivity()
          .runOnUiThread(() -> {
            // Inflate the native ad view and add it to the view hierarchy.
            NativeAdBinding nativeAdBinding = NativeAdBinding.inflate(getLayoutInflater());
            NativeAdView adView = (NativeAdView) nativeAdBinding.getRoot();
            FrameLayout frameLayout = myActivityLayout.nativeAdPlaceholder;

            // Populate and register the native ad asset views.
            displayNativeAd(nativeAd, nativeAdBinding);

            // Remove all old ad views and add the new native ad
            // view to the view hierarchy.
            frameLayout.removeAllViews();
            frameLayout.addView(adView);
        });
      }
    }
};

// Load the native ad with our request and callback.
NativeAdLoader.load(adRequest, adCallback);

חשוב לזכור שכל הנכסים של מודעה מותאמת מסוימת צריכים להיות מוצגים בתוך התג NativeAdView layout. ‫GMA Next-Gen SDK מנסה לרשום אזהרה ביומן כשהנכסים המותאמים מוצגים מחוץ לפריסת התצוגה של המודעה המותאמת.

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

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

הצגת המודעה המותאמת

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

Kotlin

private fun displayNativeAd(nativeAd: NativeAd, nativeAdBinding : NativeAdBinding) {
  // Set the native ad view elements.
  val nativeAdView = nativeAdBinding.root
  nativeAdView.advertiserView = nativeAdBinding.adAdvertiser
  nativeAdView.bodyView = nativeAdBinding.adBody
  nativeAdView.callToActionView = nativeAdBinding.adCallToAction
  nativeAdView.headlineView = nativeAdBinding.adHeadline
  nativeAdView.iconView = nativeAdBinding.adAppIcon
  nativeAdView.priceView = nativeAdBinding.adPrice
  nativeAdView.starRatingView = nativeAdBinding.adStars
  nativeAdView.storeView = nativeAdBinding.adStore

  // Set the view element with the native ad assets.
  nativeAdBinding.adAdvertiser.text = nativeAd.advertiser
  nativeAdBinding.adBody.text = nativeAd.body
  nativeAdBinding.adCallToAction.text = nativeAd.callToAction
  nativeAdBinding.adHeadline.text = nativeAd.headline
  nativeAdBinding.adAppIcon.setImageDrawable(nativeAd.icon?.drawable)
  nativeAdBinding.adPrice.text = nativeAd.price
  nativeAd.starRating?.toFloat().let { value ->
    nativeAdBinding.adStars.rating = value
  }
  nativeAdBinding.adStore.text = nativeAd.store

  // Hide views for assets that don't have data.
  nativeAdBinding.adAdvertiser.visibility = getAssetViewVisibility(nativeAd.advertiser)
  nativeAdBinding.adBody.visibility = getAssetViewVisibility(nativeAd.body)
  nativeAdBinding.adCallToAction.visibility = getAssetViewVisibility(nativeAd.callToAction)
  nativeAdBinding.adHeadline.visibility = getAssetViewVisibility(nativeAd.headline)
  nativeAdBinding.adAppIcon.visibility = getAssetViewVisibility(nativeAd.icon)
  nativeAdBinding.adPrice.visibility = getAssetViewVisibility(nativeAd.price)
  nativeAdBinding.adStars.visibility = getAssetViewVisibility(nativeAd.starRating)
  nativeAdBinding.adStore.visibility = getAssetViewVisibility(nativeAd.store)

  // Inform GMA Next-Gen SDK that you have finished populating
  // the native ad views with this native ad.
  nativeAdView.registerNativeAd(nativeAd, nativeAdBinding.adMedia)
}

/**
* Determines the visibility of an asset view based on the presence of its asset.
*
* @param asset The native ad asset to check for nullability.
* @return [View.VISIBLE] if the asset is not null, [View.INVISIBLE] otherwise.
*/
private fun getAssetViewVisibility(asset: Any?): Int {
  return if (asset == null) View.INVISIBLE else View.VISIBLE
}

Java

private void displayNativeAd(ad: NativeAd, nativeAdBinding : NativeAdBinding) {
  // Set the native ad view elements.
  NativeAdView nativeAdView = nativeAdBinding.getRoot();
  nativeAdView.setAdvertiserView(nativeAdBinding.adAdvertiser);
  nativeAdView.setBodyView(nativeAdBinding.adBody);
  nativeAdView.setCallToActionView(nativeAdBinding.adCallToAction);
  nativeAdView.setHeadlineView(nativeAdBinding.adHeadline);
  nativeAdView.setIconView(nativeAdBinding.adAppIcon);
  nativeAdView.setPriceView(nativeAdBinding.adPrice);
  nativeAdView.setStarRatingView(nativeAdBinding.adStars);
  nativeAdView.setStoreView(nativeAdBinding.adStore);

  // Set the view element with the native ad assets.
  nativeAdBinding.adAdvertiser.setText(nativeAd.getAdvertiser());
  nativeAdBinding.adBody.setText(nativeAd.getBody());
  nativeAdBinding.adCallToAction.setText(nativeAd.getCallToAction());
  nativeAdBinding.adHeadline.setText(nativeAd.getHeadline());
  if (nativeAd.getIcon() != null) {
      nativeAdBinding.adAppIcon.setImageDrawable(nativeAd.getIcon().getDrawable());
  }
  nativeAdBinding.adPrice.setText(nativeAd.getPrice());
  if (nativeAd.getStarRating() != null) {
      nativeAdBinding.adStars.setRating(nativeAd.getStarRating().floatValue());
  }
  nativeAdBinding.adStore.setText(nativeAd.getStore());

  // Hide views for assets that don't have data.
  nativeAdBinding.adAdvertiser.setVisibility(getAssetViewVisibility(nativeAd.getAdvertiser()));
  nativeAdBinding.adBody.setVisibility(getAssetViewVisibility(nativeAd.getBody()));
  nativeAdBinding.adCallToAction.setVisibility(getAssetViewVisibility(nativeAd.getCallToAction()));
  nativeAdBinding.adHeadline.setVisibility(getAssetViewVisibility(nativeAd.getHeadline()));
  nativeAdBinding.adAppIcon.setVisibility(getAssetViewVisibility(nativeAd.getIcon()));
  nativeAdBinding.adPrice.setVisibility(getAssetViewVisibility(nativeAd.getPrice()));
  nativeAdBinding.adStars.setVisibility(getAssetViewVisibility(nativeAd.getStarRating()));
  nativeAdBinding.adStore.setVisibility(getAssetViewVisibility(nativeAd.getStore()));

  // Inform GMA Next-Gen SDK that you have finished populating
  // the native ad views with this native ad.
  nativeAdView.registerNativeAd(nativeAd, nativeAdBinding.adMedia);
}

/**
* Determines the visibility of an asset view based on the presence of its asset.
*
* @param asset The native ad asset to check for nullability.
* @return {@link View#VISIBLE} if the asset is not null, {@link View#INVISIBLE} otherwise.
*/
private int getAssetViewVisibility(Object asset) {
    return (asset == null) ? View.INVISIBLE : View.VISIBLE;
}

שכבת-על של AdChoices

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

סימן למודעה

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

טיפול בקליקים

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

כדי להאזין לקליקים, מטמיעים GMA Next-Gen SDK קריאה חוזרת (callback) לקליקים:

Kotlin

private fun setEventCallback(nativeAd: NativeAd) {
  nativeAd.adEventCallback =
    object : NativeAdEventCallback {
      override fun onAdClicked() {
        Log.d(Constant.TAG, "Native ad recorded a click.")
      }
    }
}

Java

private void setEventCallback(NativeAd nativeAd) {
  nativeAd.setAdEventCallback(new NativeAdEventCallback() {
      @Override
      public void onAdClicked() {
        Log.d(Constant.TAG, "Native ad recorded a click.");
      }
  });
}

ImageScaleType

למחלקת MediaView יש מאפיין ImageScaleType כשמוצגים תמונות. אם רוצים לשנות את האופן שבו תמונה משנה את הגודל שלה ב-MediaView, צריך להגדיר את ImageView.ScaleType המתאים באמצעות השיטה setImageScaleType() של MediaView:

Kotlin

nativeAdViewBinding.mediaView.imageScaleType = ImageView.ScaleType.CENTER_CROP

Java

nativeAdViewBinding.mediaView.setImageScaleType(ImageView.ScaleType.CENTER_CROP);

MediaContent

הנתונים שקשורים לתוכן המדיה של המודעה המותאמת מוצגים באמצעות המחלקה MediaView, ונשמרים במחלקה MediaContent. כשהמאפיין MediaView mediaContent מוגדר עם מופע MediaContent:

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

הוספת סיכום קריאייטיב

באפליקציות צ'אט מבוססות-AI ושיחות, GMA Next-Gen SDK מספק נכס סיכום קריאייטיב (creativeSummary) לקריאייטיב של המודעה. אתם יכולים לשלב מודעות בזרימות הצ'אט של האפליקציה שלכם באמצעות הודעת פתיחה.

הוספת תצוגת הטקסט לפריסה

מוסיפים TextView לנכס של סיכום הקריאייטיב בתוך פריסת מאגר התגים NativeAdView:

<TextView
    android:id="@+id/ad_creative_summary"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:textSize="13sp" />

איכלוס התצוגה ורישום שלה

מאכלסים את TextView ב-creativeSummary ורושמים אותו בנכס creativeSummaryView באובייקט NativeAdView. רישום התצוגה מאפשר מעקב אוטומטי אחר קליקים בנכס סיכום הקריאייטיב.

Kotlin

private fun populateCreativeSummary(
  nativeAd: NativeAd,
  nativeAdBinding: NativeAdBinding,
  nativeAdView: NativeAdView,
) {
  val summary = nativeAd.creativeSummary
  if (summary == null) {
    nativeAdBinding.adCreativeSummary.visibility = View.GONE
    return
  }

  nativeAdBinding.adCreativeSummary.text = summary
  nativeAdBinding.adCreativeSummary.visibility = View.VISIBLE
  nativeAdView.creativeSummaryView = nativeAdBinding.adCreativeSummary
}

Java

private void populateCreativeSummary(
    NativeAd nativeAd, NativeAdBinding nativeAdBinding, NativeAdView nativeAdView) {
  String summary = nativeAd.getCreativeSummary();
  if (summary == null) {
    nativeAdBinding.adCreativeSummary.setVisibility(View.GONE);
    return;
  }

  nativeAdBinding.adCreativeSummary.setText(summary);
  nativeAdBinding.adCreativeSummary.setVisibility(View.VISIBLE);
  nativeAdView.setCreativeSummaryView(nativeAdBinding.adCreativeSummary);
}

מעקב אחר קליקים וטקסט שעבר שינוי

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

כיבוי סופי של מודעה

אחרי שמציגים מודעה מותאמת, צריך להשמיד את המודעה. בדוגמה הבאה מוצגת השמדה של מודעה מקורית:

Kotlin

nativeAd.destroy()

Java

nativeAd.destroy();

השלבים הבאים

כדאי לעיין בנושאים הבאים:

פרטיות המשתמשים

דוגמה

מורידים ומריצים את האפליקציה לדוגמה שמדגימה את השימוש ב-GMA Next-Gen SDK.

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

הגדרת הכיתה NativeAdView

פריסת XML

Jetpack פיתוח נייטיב

טיפול במודעה מותאמת שנטענה

Kotlin

Java

הצגת המודעה המותאמת

Kotlin

Java

שכבת-על של AdChoices

סימן למודעה

טיפול בקליקים

Kotlin

Java

ImageScaleType

Kotlin

Java

MediaContent

הוספת סיכום קריאייטיב

הוספת תצוגת הטקסט לפריסה

איכלוס התצוגה ורישום שלה

Kotlin

Java

מעקב אחר קליקים וטקסט שעבר שינוי

כיבוי סופי של מודעה

Kotlin

Java

השלבים הבאים

דוגמה

מודעות מותאמות

הגדרת הכיתה `NativeAdView`