این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

بومی پیشرفته

نمایش NativeAd

وقتی یک تبلیغ بومی بارگیری می‌شود، Google Mobile Ads SDK شنونده را برای قالب آگهی مربوطه فراخوانی می‌کند. سپس برنامه شما مسئول نمایش آگهی است، اگرچه لزوماً نباید فوراً این کار را انجام دهد. برای آسان‌تر کردن نمایش قالب‌های تبلیغاتی تعریف‌شده توسط سیستم، SDK منابع مفیدی را ارائه می‌دهد که در زیر توضیح داده شده است.

کلاس `NativeAdView`

برای قالب NativeAd ، کلاس NativeAdView مربوطه وجود دارد. این کلاس یک ViewGroup است که ناشران باید از آن به عنوان ریشه NativeAd استفاده کنند. یک NativeAdView منفرد با یک تبلیغ بومی منفرد مطابقت دارد. هر نمای مورد استفاده برای نمایش دارایی های آن تبلیغ (مثلاً ImageView که دارایی اسکرین شات را نمایش می دهد) باید فرزند شی NativeAdView باشد.

سلسله مراتب مشاهده برای یک آگهی بومی که از LinearLayout برای نمایش نماهای دارایی خود استفاده می کند ممکن است به این صورت باشد:

<com.google.android.gms.ads.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>


         // Other assets such as image or media view, call to action, etc follow.
         ...
    </LinearLayout>
</com.google.android.gms.ads.nativead.NativeAdView>

در اینجا یک مثال است که یک NativeAdView ایجاد می کند و آن را با یک NativeAd پر می کند:

جاوا

AdLoader.Builder builder = new AdLoader.Builder(this, "AD_UNIT_ID")
    .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
        @Override
        public void onNativeAdLoaded(NativeAd nativeAd) {
            // Assumes you have a placeholder FrameLayout in your View layout
            // (with id fl_adplaceholder) where the ad is to be placed.
            FrameLayout frameLayout =
                findViewById(R.id.fl_adplaceholder);
            // Assumes that your ad layout is in a file call native_ad_layout.xml
            // in the res/layout folder
            NativeAdView adView = (NativeAdView) getLayoutInflater()
                .inflate(R.layout.native_ad_layout, null);
            // This method sets the text, images and the native ad, etc into the ad
            // view.
            populateNativeAdView(nativeAd, adView);
            frameLayout.removeAllViews();
            frameLayout.addView(adView);
        }
});

کاتلین

val builder = AdLoader.Builder(this, "AD_UNIT_ID")
    .forNativeAd { nativeAd ->
        // Assumes that your ad layout is in a file call native_ad_layout.xml
        // in the res/layout folder
        val adView = layoutInflater
                .inflate(R.layout.native_ad_layout, null) as NativeAdView
        // This method sets the text, images and the native ad, etc into the ad
        // view.
        populateNativeAdView(nativeAd, adView)
        // Assumes you have a placeholder FrameLayout in your View layout
        // (with id ad_frame) where the ad is to be placed.
        ad_frame.removeAllViews()
        ad_frame.addView(adView)
    }

توجه داشته باشید که همه دارایی‌های یک آگهی بومی معین باید در طرح NativeAdView ارائه شوند. وقتی دارایی‌های بومی خارج از طرح‌بندی نمای تبلیغاتی بومی ارائه می‌شوند، Google Mobile Ads SDK سعی می‌کند هشداری را ثبت کند.

کلاس‌های ad view همچنین روش‌هایی را ارائه می‌دهند که برای ثبت نمای مورد استفاده برای هر دارایی جداگانه و یکی برای ثبت خود شی NativeAd استفاده می‌شوند. ثبت نماها به این روش به SDK اجازه می دهد تا به طور خودکار وظایفی مانند:

ضبط کلیک ها
ضبط برداشت زمانی که اولین پیکسل روی صفحه قابل مشاهده است
نمایش همپوشانی AdChoices برای خلاقیت های پشتیبان بومی — در حال حاضر محدود به گروه منتخبی از ناشران

همپوشانی AdChoices

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

تخصیص آگهی برای تبلیغات بومی برنامه‌ریزی‌شده

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

نمونه کد

این مراحل برای نمایش یک آگهی بومی است:

یک نمونه از کلاس NativeAdView ایجاد کنید.
برای هر دارایی تبلیغاتی که باید نمایش داده شود:
1. نمای دارایی را با دارایی موجود در شیء تبلیغ پر کنید.
2. نمای دارایی را با کلاس ViewGroup ثبت کنید.
اگر طرح‌بندی تبلیغات بومی شما دارای دارایی رسانه بزرگ است، MediaView را ثبت کنید.
شیء تبلیغ را با کلاس ViewGroup ثبت کنید.

در اینجا یک تابع مثال است که یک NativeAd را نمایش می دهد:

جاوا

private void displayNativeAd(ViewGroup parent, NativeAd ad) {

    // Inflate a layout and add it to the parent ViewGroup.
    LayoutInflater inflater = (LayoutInflater) parent.getContext()
            .getSystemService(Context.LAYOUT_INFLATER_SERVICE);
    NativeAdView adView = (NativeAdView) inflater
            .inflate(R.layout.ad_layout_file, parent);

    // Locate the view that will hold the headline, set its text, and call the
    // NativeAdView's setHeadlineView method to register it.
    TextView headlineView = adView.findViewById<TextView>(R.id.ad_headline);
    headlineView.setText(ad.getHeadline());
    adView.setHeadlineView(headlineView);

    ...
    // Repeat the above process for the other assets in the NativeAd
    // using additional view objects (Buttons, ImageViews, etc).
    ...

    // If the app is using a MediaView, it should be
    // instantiated and passed to setMediaView. This view is a little different
    // in that the asset is populated automatically, so there's one less step.
    MediaView mediaView = (MediaView) adView.findViewById(R.id.ad_media);
    adView.setMediaView(mediaView);

    // Call the NativeAdView's setNativeAd method to register the
    // NativeAdObject.
    adView.setNativeAd(ad);

    // Ensure that the parent view doesn't already contain an ad view.
    parent.removeAllViews();

    // Place the AdView into the parent.
    parent.addView(adView);
}

کاتلین

fun displayNativeAd(parent: ViewGroup, ad: NativeAd) {

    // Inflate a layout and add it to the parent ViewGroup.
    val inflater = parent.getContext().getSystemService(Context.LAYOUT_INFLATER_SERVICE)
            as LayoutInflater
    val adView = inflater.inflate(R.layout.ad_layout_file, parent) as NativeAdView

    // Locate the view that will hold the headline, set its text, and use the
    // NativeAdView's headlineView property to register it.
    val headlineView = adView.findViewById<TextView>(R.id.ad_headline)
    headlineView.text = ad.headline
    adView.headlineView = headlineView

    ...
    // Repeat the above process for the other assets in the NativeAd using
    // additional view objects (Buttons, ImageViews, etc).
    ...

    val mediaView = adView.findViewById<MediaView>(R.id.ad_media)
    adView.mediaView = mediaView

    // Call the NativeAdView's setNativeAd method to register the
    // NativeAdObject.
    adView.setNativeAd(ad)

    // Ensure that the parent view doesn't already contain an ad view.
    parent.removeAllViews()

    // Place the AdView into the parent.
    parent.addView(adView)
}

در اینجا وظایف فردی وجود دارد:

طرح را باد کنید
جاوا
```
LayoutInflater inflater = (LayoutInflater) parent.getContext()
        .getSystemService(Context.LAYOUT_INFLATER_SERVICE);
NativeAdView adView = (NativeAdView) inflater
        .inflate(R.layout.ad_layout_file, parent);
```
کاتلین
```
val inflater = parent.getContext().getSystemService(Context.LAYOUT_INFLATER_SERVICE)
        as LayoutInflater
val adView = inflater.inflate(R.layout.ad_layout_file, parent) as NativeAdView
```
این کد یک طرح بندی XML را که حاوی نماهایی برای نمایش یک آگهی بومی است و سپس مکان مرجعی به NativeAdView را افزایش می دهد. توجه داشته باشید که اگر NativeAdView موجود در قطعه یا فعالیت شما وجود دارد، می‌توانید مجدداً استفاده کنید، یا حتی یک نمونه را به صورت پویا بدون استفاده از فایل طرح‌بندی ایجاد کنید.
نماهای دارایی را پر و ثبت کنید
این کد نمونه، نمای مورد استفاده برای نمایش عنوان را تعیین می کند، متن آن را با استفاده از دارایی رشته ارائه شده توسط شی آگهی تنظیم می کند و آن را با شی NativeAdView ثبت می کند:
جاوا
```
TextView headlineView = adView.findViewById<TextView>(R.id.ad_headline);
headlineView.setText(ad.getHeadline());
adView.setHeadlineView(headlineView);
```
کاتلین
```
val headlineView = adView.findViewById<TextView>(R.id.ad_headline)
headlineView.text = ad.headline
adView.headlineView = headlineView
```
این فرآیند مکان یابی نما، تنظیم مقدار آن، و ثبت آن در کلاس نمای آگهی باید برای هر یک از دارایی های ارائه شده توسط شیء تبلیغاتی بومی که برنامه نمایش می دهد تکرار شود.
رسیدگی به کلیک ها
هیچ کنترل کننده کلیک سفارشی را روی هیچ نمایی در داخل یا در نمای تبلیغاتی بومی اجرا نکنید. برای مشاهده رویدادهای کلیک خودتان، از شنونده آگهی استفاده کنید .
کلیک‌ها روی دارایی‌های مشاهده آگهی توسط SDK انجام می‌شود تا زمانی که بازدیدهای دارایی را به درستی پر کرده و ثبت کنید، همانطور که در بخش قبل بحث شد.
در اینجا مثالی وجود دارد که از شنونده تبلیغات برای مشاهده رویدادهای کلیک استفاده می کند:
جاوا
```
AdLoader adLoader = new AdLoader.Builder(context, "/6499/example/native")
    ...
    .withAdListener(new AdListener() {
        @Override
        public void onAdFailedToLoad(LoadAdError adError) {
            // Handle the failure by logging, altering the UI, and so on.
        }
        @Override
        public void onAdClicked() {
            // Log the click event or other custom behavior.
        }
    })
    .build();
```
کاتلین
```
val adLoader = AdLoader.Builder(this, "/6499/example/native")
    ...
    .withAdListener(object : AdListener() {
        override fun onAdFailedToLoad(adError: LoadAdError) {
            // Handle the failure by logging, altering the UI, and so on.
        }
    })
    .build()
```
MediaView را ثبت کنید
اگر می‌خواهید یک دارایی تصویر اصلی را در طرح‌بندی آگهی بومی خود بگنجانید، باید از دارایی MediaView به جای دارایی ImageView استفاده کنید.
MediaView یک View ویژه است که برای نمایش دارایی رسانه اصلی، ویدیو یا تصویر طراحی شده است.
MediaView می توان در یک طرح XML تعریف کرد یا به صورت پویا ساخته شد. باید در سلسله مراتب view یک NativeAdView قرار گیرد، درست مانند هر نمای دارایی دیگر. برنامه هایی که از MediaView استفاده می کنند باید آن را در NativeAdView ثبت کنند:
جاوا
```
MediaView mediaView = adView.findViewById(R.id.ad_media);
adView.setMediaView(mediaView);
```
کاتلین
```
adView.mediaView = adView.findViewById<MediaView>(R.id.ad_media)
```
مانند همه نماهای دارایی، نمای رسانه باید محتوای آن پر شود. این کار با استفاده از متد getMediaContent() برای بازیابی محتوای رسانه ای که می تواند به MediaView ارسال شود انجام می شود. در اینجا یک قطعه کد است که محتوای رسانه را برای نمای رسانه تنظیم می کند:
جاوا
```
mediaView.setMediaContent(nativeAd.getMediaContent());
```
کاتلین
```
mediaView.mediaContent = nativeAd.mediaContent
```
ImageScaleType
کلاس MediaView دارای ویژگی ImageScaleType هنگام نمایش تصاویر است. اگر می خواهید نحوه مقیاس بندی یک تصویر را در MediaView تغییر دهید، ImageView.ScaleType مربوطه را با استفاده از متد setImageScaleType() MediaView تنظیم کنید:
جاوا
```
mediaView.setImageScaleType(ImageView.ScaleType.CENTER_CROP);
```
کاتلین
```
mediaView.imageScaleType = ImageView.ScaleType.CENTER_CROP
```
محتوای رسانه
کلاس MediaContent داده های مربوط به محتوای رسانه ای تبلیغ بومی را نگه می دارد که با استفاده از کلاس MediaView نمایش داده می شود. هنگامی که ویژگی MediaView mediaContent با یک نمونه MediaContent تنظیم می شود:
- اگر دارایی ویدیویی در دسترس باشد، بافر شده و در MediaView شروع به پخش می‌کند. با بررسی hasVideoContent() می‌توانید متوجه شوید که یک دارایی ویدیو در دسترس است.
- اگر تبلیغ حاوی دارایی ویدیو نباشد، دارایی mainImage دانلود شده و در داخل MediaView قرار می گیرد.
به طور پیش فرض، mainImage اولین دارایی تصویر دانلود شده است. اگر setReturnUrlsForImageAssets(true) استفاده شود، mainImage null است و باید ویژگی mainImage را روی تصویر دانلود شده دستی خود تنظیم کنید. توجه داشته باشید که این تصویر تنها زمانی استفاده خواهد شد که هیچ دارایی ویدیویی در دسترس نباشد.
شیء تبلیغاتی بومی را ثبت کنید
این مرحله نهایی، شیء تبلیغاتی بومی را با نمایی که مسئول نمایش آن است، ثبت می‌کند:
جاوا
```
adView.setNativeAd(ad);
```
کاتلین
```
adView.setNativeAd(ad)
```

تبلیغ را نابود کنید

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

جاوا

nativeAd.destroy();
        .inflate(R.layout.ad_layout_file, parent);

کاتلین

nativeAd.destroy()

کد تبلیغات بومی را تست کنید

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

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

/6499/example/native

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

عنوان (متن)
تصویر اصلی (تصویر)
عنوان (متن)

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

تبلیغات پشتیبان بومی

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

/6499/example/native-backfill

این نمونه تبلیغات نصب برنامه و محتوایی را ارائه می دهد که شامل پوشش AdChoices است.

به یاد داشته باشید قبل از پخش زنده، کد خود را برای مراجعه به واحد تبلیغات واقعی و شناسه های الگو به روز کنید.

نمونه هایی در GitHub

مثال اجرای کامل تبلیغات بومی:

جاوا کاتلین

مراحل بعدی

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

بومی پیشرفته

نمایش NativeAd

کلاس NativeAdView

جاوا

کاتلین

همپوشانی AdChoices

تخصیص آگهی برای تبلیغات بومی برنامه‌ریزی‌شده

نمونه کد

جاوا

کاتلین

جاوا

کاتلین

جاوا

کاتلین

جاوا

کاتلین

جاوا

کاتلین

جاوا

کاتلین

ImageScaleType

جاوا

کاتلین

محتوای رسانه

جاوا

کاتلین

تبلیغ را نابود کنید

جاوا

کاتلین

کد تبلیغات بومی را تست کنید

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

تبلیغات پشتیبان بومی

نمونه هایی در GitHub

مراحل بعدی

کلاس `NativeAdView`