‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

نمایش آگهی بومی

انتخاب پلاتفرم: Android iOS Android (قدیمی)

وقتی آگهی بومی بار می‌شود، GMA Next-Gen 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 Compose

پوشه برنامه‌های کمکی JetpackCompose را اضافه کنید. این پوشه شامل یاری‌رسان‌هایی برای نوشتن دارایی‌ها و شیء 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.
        }
    }

مدیریت آگهی بومی بارشده

وقتی آگهی بومی بار می‌شود، رویداد برگشتی را مدیریت کنید، نمای آگهی بومی را ازهم باز کنید، و آن را به سلسله‌مراتب نما اضافه کنید:

Kotlin

// Build an ad request with native ad options to customize the ad.
val adTypes = listOf(NativeAd.NativeAdType.NATIVE)
val adRequest = NativeAdRequest
  .Builder("/21775744923/example/native", 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)

جاوا

// 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("/21775744923/example/native", 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 پرداز شوند. ‫GMA Next-Gen SDK تلاش می‌کند وقتی دارایی‌های بومی خارج‌از چیدمان نمای آگهی بومی پرداز می‌شوند، هشداری ثبت کند.

کلاس‌های نمای آگهی همچنین روش‌هایی را برای ثبت نمای استفاده‌شده برای هر دارایی فردی و روشی برای ثبت خود شیء NativeAd ارائه می‌دهند. ثبت نماها به این روش به «کیت توسعه نرم‌افزار» اجازه می‌دهد تا به‌طور خودکار وظایفی مانند موارد زیر را انجام دهد:

درحال ضبط کلیک‌ها
ضبط ظهورها وقتی اولین پیکسل در صفحه‌نمایش نمایان می‌شود
پوشش «انتخاب‌های آگهی» برای خلاق‌های جای‌خالی بومی نمایش داده می‌شود—درحال‌حاضر به گروهی از ناشران منتخب محدود است

نمایش آگهی بومی

مثال زیر نحوه نمایش آگهی بومی را نشان می‌دهد:

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
}

جاوا

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

وقتی آگهی جای‌گزین برگردانده می‌شود، رونهاد AdChoices به‌عنوان نمای آگهی توسط «کیت توسعه نرم‌افزار» اضافه می‌شود. اگر برنامه شما از «فضای ذخیره آگهی‌های بومی» استفاده می‌کند، در گوشه ترجیحی نمای آگهی بومی خود فضایی برای نشان‌واره AdChoices که به‌طور خودکار درج می‌شود درنظر بگیرید. همچنین، مهم است که رونهاد AdChoices دیده شود، بنابراین رنگ‌های پس‌زمینه و تصاویر را به‌درستی انتخاب کنید. برای اطلاعات بیشتر درباره ظاهر و عملکرد رونهاد، به رهنمودهای پیاده‌سازی آگهی‌های بومی برنامه‌ریزی‌شده مراجعه کنید.

ارجاع آگهی برای آگهی‌های بومی برنامه‌ریزی‌شده

هنگام نمایش آگهی‌های بومی برنامه‌ریزی‌شده، باید یک اسناد آگهی نمایش دهید تا نشان دهید که نمای آگهی است. در خط‌مشی دستورالعمل‌های ما بیشتر بدانید.

کلیک‌های نام کاربری

هیچ‌گونه مدیریت‌کننده کلیک سفارشی را روی هیچ‌یک از نماهای بالای نمای آگهی بومی یا درون آن پیاده‌سازی نکنید. تا زمانی که نمای دارایی را به‌درستی تکمیل و ثبت کنید، کلیک‌های دارایی‌های نمای آگهی توسط «کیت توسعه نرم‌افزار» مدیریت می‌شود.

برای گوش دادن به کلیک‌ها، GMA Next-Gen SDK برگشت کلیک را پیاده‌سازی کنید:

Kotlin

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

جاوا

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

جاوا

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

MediaContent

کلاس MediaContent داده‌های مربوط به محتوای رسانه‌ای آگهی بومی را که بااستفاده از کلاس MediaView نمایش داده می‌شود دربرمی‌گیرد. وقتی خصوصیت MediaView mediaContent با نمونه MediaContent تنظیم می‌شود:

اگر دارایی ویدیویی دردسترس باشد، بافر می‌شود و در MediaView شروع به پخش می‌کند. می‌توانید با بررسی hasVideoContent() متوجه شوید که آیا یک دارایی ویدیویی دردسترس است یا خیر.
اگر آگهی دارایی ویدیویی نداشته باشد، دارایی mainImage بارگیری می‌شود و به‌جای آن در MediaView قرار می‌گیرد.

افزودن خلاصه طرح‌آگهی

در برنامه‌های گپ هوش مصنوعی و مکالمه‌ای، 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
}

جاوا

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 ارائه‌شده توسط کیت توسعه نرم‌افزار را پرداز می‌کنید، آن را در دارایی creativeSummaryView درون محفظه NativeAdView ثبت کنید تا مدیریت کلیک کیت توسعه نرم‌افزار فعال شود.
مقدمه‌های اصلاح‌شده: اگر برنامه شما نوشتار مکالمه سفارشی را به خلاصه عنصر خلاق اصلاح، خلاصه، یا اضافه می‌کند، نوشتار اصلاح‌شده را خارج از محتوی NativeAdView قرار دهید.

ازبین بردن آگهی

پس‌از نمایش آگهی بومی، آگهی را ازبین ببرید. مثال زیر آگهی بومی را ازبین می‌برد:

Kotlin

nativeAd.destroy()

جاوا

nativeAd.destroy();

کد آگهی بومی آزمایشی

آگهی‌های فروش مستقیم

اگر می‌خواهید آگهی‌های بومی فروش مستقیم را آزمایش کنید، می‌توانید از این شناسه واحد آگهی Ad Manager استفاده کنید:

/21775744923/example/native

پیکربندی شده است تا آگهی‌های نصب برنامه نمونه و محتوا، و همچنین قالب آگهی بومی سفارشی با دارایی‌های زیر را ارائه دهد:

عنوان (نوشتار)
MainImage (تصویر)
زیرنویس ناشنوایان (نوشتار)

شناسه الگوی قالب آگهی بومی سفارشی 10063170 است.

آگهی‌های بومی دوباره تکمیل‌شده

فضای ذخیره Ad Exchange به گروهی منتخب از ناشران محدود می‌شود. برای آزمایش رفتار آگهی‌های جای‌گزین بومی، از این واحد آگهی Ad Manager استفاده کنید:

/21775744923/example/native-backfill

آگهی‌های نصب برنامه نمونه و آگهی‌های محتوایی را که شامل رونهاد AdChoices است ارائه می‌کند.

به‌یاد داشته باشید که قبل‌از فعال کردن، کدتان را به‌روز کنید تا به واحد آگهی واقعی و شناسه‌های الگوی شما ارجاع دهد.

مراحل بعدی

موضوعات زیر را کاوش کنید:

حریم خصوصی کاربر

مثال

برنامه نمونه را که استفاده از GMA Next-Gen SDK را نشان می‌دهد بارگیری و اجرا کنید.

نمایش آگهی بومی با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

تعریف کردن کلاس NativeAdView

چیدمان XML

Jetpack Compose

مدیریت آگهی بومی بارشده

Kotlin

جاوا

نمایش آگهی بومی

Kotlin

جاوا

رونهاد AdChoices

ارجاع آگهی برای آگهی‌های بومی برنامه‌ریزی‌شده

کلیک‌های نام کاربری

Kotlin

جاوا

ImageScaleType

Kotlin

جاوا

MediaContent

افزودن خلاصه طرح‌آگهی

نمای نوشتار را به چیدمانتان اضافه کنید

پر کردن و ثبت کردن نما

Kotlin

جاوا

پیگیری کلیک و نوشتار اصلاح‌شده

ازبین بردن آگهی

Kotlin

جاوا

کد آگهی بومی آزمایشی

آگهی‌های فروش مستقیم

آگهی‌های بومی دوباره تکمیل‌شده

مراحل بعدی

مثال

نمایش آگهی بومی

تعریف کردن کلاس `NativeAdView`