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

فرمت‌های تبلیغاتی بومی سفارشی

فرمت های تبلیغاتی بومی سفارشی

علاوه بر قالب‌های بومی تعریف‌شده توسط سیستم، ناشران Ad Manager این گزینه را دارند که با تعریف فهرست‌های سفارشی دارایی‌ها، قالب‌های تبلیغاتی بومی خود را ایجاد کنند. به این فرمت‌های تبلیغاتی بومی سفارشی می‌گویند و می‌توانند با تبلیغات رزرو شده استفاده شوند. این به ناشران امکان می‌دهد تا داده‌های ساختار یافته دلخواه را به برنامه‌های خود ارسال کنند. این تبلیغات توسط شی NativeCustomFormatAd نمایش داده می شوند.

قالب‌های تبلیغاتی بومی سفارشی را بارگیری کنید

این راهنما نحوه بارگیری و نمایش قالب‌های تبلیغات بومی سفارشی را توضیح می‌دهد.

یک AdLoader بسازید

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

جاوا

AdLoader adLoader = new AdLoader.Builder(context, "/21775744923/example/native")
    .forCustomFormatAd("10063170",
      new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() {
          @Override
          public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
              // Show the custom format and record an impression.
          }
      },
      new NativeCustomFormatAd.OnCustomClickListener() {
          @Override
          public void onCustomClick(NativeCustomFormatAd ad, String s) {
              // Handle the click action
          }
      })
    .withAdListener( ... )
    .withNativeAdOptions( ... )
    .build();

کاتلین

val adLoader = AdLoader.Builder(this, "/21775744923/example/native")
        .forCustomFormatAd("10063170",
            { ad ->
                // Show the custom format and record an impression.
            },
            { ad, s ->
            // Handle the click action
            })
        .withAdListener( ... )
        .withNativeAdOptions( ... )
        .build()

روش forCustomFormatAd AdLoader برای درخواست فرمت‌های تبلیغاتی بومی سفارشی پیکربندی می‌کند. سه پارامتر به متد ارسال می شود:

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

از آنجایی که می‌توان یک واحد آگهی را برای ارائه بیش از یک قالب خلاق تنظیم کرد، forCustomFormatAd می‌توان چندین بار با شناسه‌های فرمت منحصربه‌فرد فراخوانی کرد تا بارکننده آگهی برای بیش از یک قالب تبلیغات بومی سفارشی آماده شود.

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

شناسه قالبی که برای شناسایی یک قالب آگهی بومی سفارشی استفاده می‌شود را می‌توانید در رابط کاربری Ad Manager در بخش Native در منوی کشویی تحویل پیدا کنید:

هر شناسه فرمت تبلیغات بومی سفارشی در کنار نام آن ظاهر می شود. با کلیک بر روی یکی از نام ها به صفحه جزئیات نمایش داده می شود که اطلاعات مربوط به فیلدهای قالب را نشان می دهد:

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

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

قالب‌های تبلیغات بومی سفارشی با قالب‌های تعریف‌شده توسط سیستم از این نظر متفاوت است که ناشران این قدرت را دارند که فهرستی از دارایی‌های خود را که یک تبلیغ را تشکیل می‌دهند، تعریف کنند. بنابراین، روند نمایش یک با فرمت های تعریف شده توسط سیستم از چند جهت متفاوت است:

از آنجایی که کلاس NativeCustomFormatAd برای رسیدگی به هر یک از قالب‌های تبلیغاتی بومی سفارشی که در Ad Manager تعریف می‌کنید، طراحی شده است، نامی برای دارایی‌ها «getters» ندارد. در عوض، متدهایی مانند getText و getImage را ارائه می دهد که نام فیلد را به عنوان پارامتر در نظر می گیرند.
هیچ کلاس مشاهده آگهی اختصاصی مانند NativeAdView برای استفاده با NativeCustomFormatAd وجود ندارد. شما آزاد هستید که از هر چیدمانی که برای تجربه کاربری شما منطقی است استفاده کنید.
از آنجایی که هیچ کلاس ViewGroup اختصاصی وجود ندارد، نیازی به ثبت هیچ یک از نماهایی که برای نمایش دارایی های تبلیغات استفاده می کنید ندارید. این باعث صرفه جویی در چند خط کد هنگام نمایش آگهی می شود، اما همچنین به این معنی است که برای مدیریت کلیک ها بعداً باید کمی کار بیشتری انجام دهید.

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

جاوا

public void displayCustomFormatAd (ViewGroup parent,
                                     NativeCustomFormatAd customFormatAd) {
    // Inflate a layout and add it to the parent ViewGroup.
    LayoutInflater inflater = (LayoutInflater) parent.getContext()
            .getSystemService(Context.LAYOUT_INFLATER_SERVICE);
    View adView = inflater.inflate(R.layout.custom_format_ad, parent);

    // Locate the TextView that will hold the value for "Headline" and
    // set its text.
    TextView myHeadlineView = (TextView) adView.findViewById(R.id.headline);
    myHeadlineView.setText(customFormatAd.getText("Headline"));

    // Locate the ImageView that will hold the value for "MainImage" and
    // set its drawable.
    Button myMainImageView = (ImageView) adView.findViewById(R.id.main_image);
    myMainImageView.setImageDrawable(
            customFormatAd.getImage("MainImage").getDrawable());

    ...
    // Continue locating views and displaying assets until finished.
    ...
}

کاتلین

public fun displayCustomFormatAd (parent: ViewGroup,
                                customFormatAd: NativeCustomFormatAd) {
    val adView = layoutInflater
            .inflate(R.layout.ad_simple_custom_format, null)

    val myHeadlineView = adView.findViewById<TextView>(R.id.headline)
    myHeadlineView.setText(customFormatAd.getText("Headline"));

    // Locate the ImageView that will hold the value for "MainImage" and
    // set its drawable.
    val myMainImageView = adView.findViewById(R.id.main_image);
    myMainImageView.setImageDrawable(
            customFormatAd.getImage("MainImage").drawable);

    ...
    // Continue locating views and displaying assets until finished.
    ...
}

نماد AdChoices را رندر کنید

به عنوان بخشی از حمایت از قانون خدمات دیجیتال (DSA) ، تبلیغات رزرو ارائه شده در منطقه اقتصادی اروپا (EEA) به نماد AdChoices و پیوندی به صفحه درباره این آگهی Google نیاز دارد. هنگام اجرای تبلیغات بومی سفارشی، شما مسئول ارائه نماد AdChoices هستید. توصیه می‌کنیم هنگام رندر کردن دارایی‌های تبلیغاتی اصلی، مراحلی را برای رندر کردن و تنظیم شنونده کلیک برای نماد AdChoices انجام دهید.

مثال زیر فرض می‌کند که شما یک عنصر <ImageView /> را در سلسله‌مراتب view خود برای نگه داشتن لوگوی AdChoices تعریف کرده‌اید.

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android">
    <ImageView
        android:id="@+id/adChoices"
        android:layout_width="15dp"
        android:layout_height="15dp"
        android:adjustViewBounds="true"
        android:contentDescription="AdChoices icon." />
</LinearLayout>

مثال‌های زیر نماد AdChoices را نمایش می‌دهند و رفتار کلیک مناسب را پیکربندی می‌کنند.

جاوا

private AdSimpleCustomTemplateBinding customTemplateBinding;

private void populateAdView(final NativeCustomFormatAd nativeCustomFormatAd) {
  // Render the AdChoices icon.
  String adChoicesKey = NativeAdAssetNames.ASSET_ADCHOICES_CONTAINER_VIEW;
  NativeAd.Image adChoicesAsset = nativeCustomFormatAd.getImage(adChoicesKey);
  if (adChoicesAsset == null) {
    customTemplateBinding.adChoices.setVisibility(View.GONE);
  } else {
    customTemplateBinding.adChoices.setVisibility(View.VISIBLE);
    customTemplateBinding.adChoices.setImageDrawable(adChoicesAsset.getDrawable());

    // Enable clicks on AdChoices.
    customTemplateBinding.adChoices.setOnClickListener(
        new View.OnClickListener() {
          @Override
          public void onClick(View v) {
            nativeCustomFormatAd.performClick(adChoicesKey);
          }
        });
  }
  ...
}

کاتلین

private lateinit var customTemplateBinding: AdSimpleCustomTemplateBinding

private fun populateAdView(nativeCustomFormatAd: NativeCustomFormatAd) {
  // Render the AdChoices icon.
  val adChoicesKey = NativeAdAssetNames.ASSET_ADCHOICES_CONTAINER_VIEW
  val adChoicesAsset = nativeCustomFormatAd.getImage(adChoicesKey)
  if (adChoicesAsset == null) {
    customTemplateBinding.adChoices.visibility = View.GONE
  } else {
    customTemplateBinding.adChoices.setImageDrawable(adChoicesAsset.drawable)
    customTemplateBinding.adChoices.visibility = View.VISIBLE

    // Enable clicks on AdChoices.
    customTemplateBinding.adChoices.setOnClickListener {
      nativeCustomFormatAd.performClick(adChoicesKey)
    }
  }
  ...
}

ویدیوی بومی برای قالب‌های تبلیغاتی سفارشی

هنگام ایجاد یک قالب سفارشی ، این گزینه را دارید که قالب را برای ویدیو واجد شرایط کنید.

در اجرای برنامه خود، می توانید از NativeCustomFormatAd.getMediaContent() برای دریافت محتوای رسانه استفاده کنید. سپس setMediaContent() را فراخوانی کنید تا محتوای رسانه را در نمای رسانه خود تنظیم کنید. به دیدگاه رسانه ای شما اگر تبلیغ محتوای ویدیویی ندارد، برنامه‌های دیگری را برای نمایش آگهی بدون ویدیو تنظیم کنید.

مثال زیر بررسی می‌کند که آیا تبلیغ محتوای ویدیویی دارد یا خیر، و اگر ویدیو در دسترس نباشد، تصویری را در جای خود نمایش می‌دهد:

جاوا

// Called when a custom native ad loads.
@Override
public void onCustomFormatAdLoaded(final NativeCustomFormatAd ad) {

  MediaContent mediaContent = ad.getMediaContent();

  // Assumes you have a FrameLayout in your view hierarchy with the id media_placeholder.
  FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder);

  // Apps can check the MediaContent's hasVideoContent property to determine if the
  // NativeCustomFormatAd has a video asset.
  if (mediaContent != null && mediaContent.hasVideoContent()) {
    MediaView mediaView = new MediaView(mediaPlaceholder.getContext());
    mediaView.setMediaContent(mediaContent);
    mediaPlaceholder.addView(mediaView);

    // Create a new VideoLifecycleCallbacks object and pass it to the VideoController. The
    // VideoController will call methods on this object when events occur in the video
    // lifecycle.
    VideoController vc = mediaContent.getVideoController();
    vc.setVideoLifecycleCallbacks(
        new VideoController.VideoLifecycleCallbacks() {
          @Override
          public void onVideoEnd() {
            // Publishers should allow native ads to complete video playback before
            // refreshing or replacing them with another ad in the same UI location.
            super.onVideoEnd();
          }
        });
  } else {
    ImageView mainImage = new ImageView(this);
    mainImage.setAdjustViewBounds(true);
    mainImage.setImageDrawable(ad.getImage("MainImage").getDrawable());
    mediaPlaceholder.addView(mainImage);
    mainImage.setOnClickListener(
        new View.OnClickListener() {
          @Override
          public void onClick(View view) {
            ad.performClick("MainImage");
          }
        });
  }
}

کاتلین

// Called when a custom native ad loads.
NativeCustomFormatAd.OnCustomFormatAdLoadedListener { ad ->

  val mediaContent = ad.mediaContent

  // Apps can check the MediaContent's hasVideoContent property to determine if the
  // NativeCustomFormatAd has a video asset.
  if (mediaContent != null && mediaContent.hasVideoContent()) {
    val mediaView = MediaView(mediaPlaceholder.getContest())
    mediaView.mediaContent = mediaContent

    val videoController = mediaContent.videoController

    // Create a new VideoLifecycleCallbacks object and pass it to the VideoController. The
    // VideoController will call methods on this object when events occur in the video
    // lifecycle.
    if (videoController != null) {
      videoController.videoLifecycleCallbacks =
        object : VideoController.VideoLifecycleCallbacks() {
          override fun onVideoEnd() {
            // Publishers should allow native ads to complete video playback before refreshing
            // or replacing them with another ad in the same UI location.
            super.onVideoEnd()
          }
        }
    }
  } else {
    val mainImage = ImageView(this)
    mainImage.adjustViewBounds = true
    mainImage.setImageDrawable(ad.getImage("MainImage")?.drawable)

    mainImage.setOnClickListener { ad.performClick("MainImage") }
    customTemplateBinding.simplecustomMediaPlaceholder.addView(mainImage)
  }
}

برای اطلاعات بیشتر در مورد اینکه چگونه می‌توانید تجربه ویدیویی یک آگهی بومی سفارشی را سفارشی کنید، MediaContent را ببینید.

مثال رندر سفارشی Ad Manager را برای مثالی از ویدیوی بومی در عمل دانلود کنید.

کلیک‌ها و نمایش‌های قالب آگهی بومی سفارشی

با قالب‌های تبلیغات بومی سفارشی، برنامه شما مسئول ثبت نمایش‌ها و گزارش رویدادهای کلیک به Google Mobile Ads SDK است.

برداشت ها را ثبت کنید

برای ثبت یک نمایش برای یک تبلیغ با فرمت سفارشی، روش recordImpression را در NativeCustomFormatAd مربوطه فراخوانی کنید:

myCustomFormatAd.recordImpression();

اگر برنامه شما به طور تصادفی دو بار برای یک تبلیغ روش را فراخوانی کند، SDK به طور خودکار از ثبت یک نمایش تکراری برای یک درخواست جلوگیری می کند.

گزارش کلیک ها

برای گزارش به SDK مبنی بر اینکه کلیک روی نمای دارایی رخ داده است، متد performClick را در NativeCustomFormatAd مربوطه فراخوانی کنید و نام دارایی روی آن کلیک کنید. به عنوان مثال، اگر دارایی در قالب سفارشی خود به نام "MainImage" داشته باشید و بخواهید یک کلیک بر روی ImageView که مطابق با آن دارایی است گزارش دهید، کد شما به این صورت خواهد بود:

myCustomFormatAd.performClick("MainImage");

توجه داشته باشید که لازم نیست این روش را برای هر نمای مرتبط با تبلیغ خود فراخوانی کنید. اگر فیلد دیگری به نام «Caption» داشتید که قرار بود نمایش داده شود اما کاربر روی آن کلیک یا ضربه نخورد، برنامه شما نیازی به تماس performClick برای مشاهده آن دارایی ندارد.

به اقدامات کلیک سفارشی پاسخ دهید

هنگامی که یک کلیک روی یک تبلیغ با فرمت سفارشی انجام می شود، سه پاسخ ممکن از SDK وجود دارد که به این ترتیب تلاش می شود:

اگر OnCustomClickListener از AdLoader ارائه شده بود، فراخوانی کنید.
برای هر یک از URL های پیوند عمیق آگهی، سعی کنید یک حل کننده محتوا را پیدا کنید و اولین موردی را که حل می شود شروع کنید.
یک مرورگر باز کنید و به URL مقصد سنتی تبلیغ بروید.

متد forCustomFormatAd یک OnCustomClickListener می پذیرد. اگر یک شی شنونده را وارد کنید، SDK در عوض متد onCustomClick خود را فراخوانی می کند و هیچ اقدام دیگری انجام نمی دهد. با این حال، اگر یک مقدار تهی را به عنوان شنونده ارسال کنید، SDK به پیوند عمیق و/یا آدرس‌های اینترنتی مقصد ثبت‌شده در آگهی بازمی‌گردد.

شنوندگان کلیک سفارشی به برنامه شما اجازه می‌دهند بهترین اقدام را در پاسخ به کلیک انجام دهد، چه به‌روزرسانی رابط کاربری، راه‌اندازی یک فعالیت جدید یا صرفاً ثبت کلیک. در اینجا یک مثال آورده شده است که به سادگی گزارش می کند که یک کلیک انجام شده است:

جاوا

AdLoader adLoader = new AdLoader.Builder(context, "/21775744923/example/native")
    .forCustomFormatAd("10063170",
      new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() {
        // Display the ad.
      },
      new NativeCustomFormatAd.OnCustomClickListener() {
          @Override
          public void onCustomClick(NativeCustomFormatAd ad, String assetName) {
            Log.i("MyApp", "A custom click just happened for " + assetName + "!");
          }
      }).build();

کاتلین

val adLoader = AdLoader.Builder(this, "/21775744923/example/native")
    .forCustomFormatAd("10063170",
        { ad ->
            // Display the ad.
        },
        { ad, assetName ->
                Log.i("MyApp", "A custom click just happened for $assetName!")
    }).build()

در ابتدا، ممکن است عجیب به نظر برسد که شنوندگان کلیک سفارشی وجود دارند. به هر حال، برنامه شما فقط به SDK گفت که یک کلیک اتفاق افتاده است، پس چرا SDK باید برگردد و آن را به برنامه گزارش دهد؟

این جریان اطلاعات به چند دلیل مفید است، اما مهمتر از همه به SDK اجازه می دهد تا کنترل پاسخ به کلیک را حفظ کند. می تواند به طور خودکار URL های ردیابی شخص ثالث را که برای خلاق تنظیم شده اند، پینگ کند و کارهای دیگر را در پشت صحنه بدون هیچ کد اضافی انجام دهد.