এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাট ব্যবহার করুন,কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাট ব্যবহার করুন

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড (বিটা)

সিস্টেম-সংজ্ঞায়িত নেটিভ ফরম্যাটগুলো ছাড়াও, অ্যাড ম্যানেজার পাবলিশারদের কাছে অ্যাসেটের কাস্টম তালিকা নির্ধারণ করে তাদের নিজস্ব নেটিভ অ্যাড ফরম্যাট তৈরি করার বিকল্প রয়েছে। এগুলোকে কাস্টম নেটিভ অ্যাড ফরম্যাট বলা হয় এবং এগুলো সংরক্ষিত বিজ্ঞাপনের সাথে ব্যবহার করা যেতে পারে। এটি পাবলিশারদের তাদের অ্যাপে যথেচ্ছ স্ট্রাকচার্ড ডেটা পাঠাতে সক্ষম করে। এই বিজ্ঞাপনগুলো NativeCustomFormatAd অবজেক্ট দ্বারা উপস্থাপিত হয়।

কাস্টম নেটিভ বিজ্ঞাপন ফরম্যাট লোড করুন

এই নির্দেশিকায় কাস্টম নেটিভ বিজ্ঞাপন ফরম্যাট লোড ও প্রদর্শন করার পদ্ধতি ব্যাখ্যা করা হয়েছে।

একটি কাস্টম নেটিভ বিজ্ঞাপন লোড করুন

নেটিভ বিজ্ঞাপনের মতোই, কাস্টম নেটিভ বিজ্ঞাপন ফরম্যাটগুলো AdLoader ক্লাস ব্যবহার করে লোড করা হয়:

জাভা

AdLoader adLoader = new AdLoader.Builder(this, "/21775744923/example/native")
    .forCustomFormatAd("12387226",
        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
          }
        })
    .forCustomFormatAd("12406343",
        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
          }
        })
    .build();

কোটলিন

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

forCustomFormatAd মেথডটি কাস্টম নেটিভ অ্যাড ফরম্যাট অনুরোধ করার জন্য AdLoader কে কনফিগার করে। বিভিন্ন কাস্টম ফরম্যাট আইডির জন্য আপনি এই মেথডটি একাধিকবার কল করতে পারেন। মেথডটি নিম্নলিখিত প্যারামিটারগুলো গ্রহণ করে:

কাস্টম নেটিভ বিজ্ঞাপন ফরম্যাটের আইডি, যা AdLoader অনুরোধ করবে। প্রতিটি কাস্টম নেটিভ বিজ্ঞাপন ফরম্যাটের সাথে একটি আইডি যুক্ত থাকে। এই প্যারামিটারটি নির্দেশ করে যে আপনার অ্যাপ AdLoader কোন ফরম্যাটটি অনুরোধ করতে চায়।
একটি OnCustomFormatAdLoadedListener যা বিজ্ঞাপন সফলভাবে লোড হলে চালু হবে।
ব্যবহারকারী বিজ্ঞাপনে ট্যাপ বা ক্লিক করলে চালু হওয়ার জন্য একটি ঐচ্ছিক OnCustomClickListener । এই লিসেনার সম্পর্কে আরও জানতে, "ক্লিক এবং ইম্প্রেশন পরিচালনা" বিভাগটি দেখুন।

যেহেতু একটি একক অ্যাড ইউনিট একাধিক ক্রিয়েটিভ ফরম্যাট পরিবেশন করার জন্য সেট আপ করা যেতে পারে, তাই একাধিক সম্ভাব্য কাস্টম নেটিভ অ্যাড ফরম্যাটের জন্য অ্যাড লোডারকে প্রস্তুত করতে forCustomFormatAd অনন্য ফরম্যাট আইডি সহ একাধিকবার কল করা যেতে পারে।

কাস্টম নেটিভ বিজ্ঞাপন ফরম্যাট আইডি

কাস্টম নেটিভ অ্যাড ফরম্যাট শনাক্ত করতে ব্যবহৃত ফরম্যাট আইডিটি অ্যাড ম্যানেজার UI-এর নেটিভ সেকশনের ডেলিভারি ড্রপ-ডাউনের ভেতরে পাওয়া যাবে:

প্রতিটি কাস্টম নেটিভ অ্যাড ফরম্যাটের আইডি তার নামের পাশে প্রদর্শিত হয়। নামগুলোর কোনো একটিতে ক্লিক করলে একটি ডিটেইলস স্ক্রিনে নিয়ে যাওয়া হয়, যেখানে ফরম্যাটটির ফিল্ডগুলো সম্পর্কে তথ্য দেখানো হয়:

এখান থেকে স্বতন্ত্র ফিল্ড যোগ, সম্পাদনা এবং অপসারণ করা যায়। প্রতিটি অ্যাসেটের নামটি নোট করুন। আপনার কাস্টম নেটিভ বিজ্ঞাপন ফরম্যাট প্রদর্শন করার সময় প্রতিটি অ্যাসেটের ডেটা পাওয়ার জন্য এই নামটিই হলো মূল চাবিকাঠি।

কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাট প্রদর্শন করুন

কাস্টম নেটিভ বিজ্ঞাপন ফরম্যাটগুলো সিস্টেম-সংজ্ঞায়িত ফরম্যাট থেকে এই কারণে আলাদা যে, প্রকাশকদের একটি বিজ্ঞাপন তৈরির জন্য প্রয়োজনীয় অ্যাসেটগুলোর নিজস্ব তালিকা নির্ধারণ করার ক্ষমতা থাকে। তাই, এটি প্রদর্শনের প্রক্রিয়াটি সিস্টেম-সংজ্ঞায়িত ফরম্যাটগুলো থেকে কয়েকটি দিক দিয়ে ভিন্ন হয়:

getText() এবং getImage() গেটারগুলোর মাধ্যমে টেক্সট এবং ইমেজ অ্যাসেট পাওয়া যায়, যেগুলো প্যারামিটার হিসেবে ফিল্ডের নাম গ্রহণ করে।
যেহেতু গুগলে নিবন্ধন করার জন্য কোনো নির্দিষ্ট ViewGroup ক্লাস নেই, তাই আপনাকে ইম্প্রেশন এবং ক্লিক ম্যানুয়ালি রেকর্ড করতে হবে।
একটি কাস্টম নেটিভ অ্যাডের মিডিয়া কন্টেন্ট null থাকে, যদি অ্যাডটিতে কোনো ভিডিও অ্যাসেট না থাকে।

এখানে একটি উদাহরণ ফাংশন দেওয়া হল যা একটি 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.
    ...
}

কাস্টম নেটিভ বিজ্ঞাপন ফরম্যাটের জন্য নেটিভ ভিডিও

কাস্টম ফরম্যাট তৈরি করার সময়, আপনার কাছে ফরম্যাটটিকে ভিডিওর জন্য উপযুক্ত করে তোলার বিকল্প থাকে।

আপনার অ্যাপ বাস্তবায়নে, মিডিয়া কন্টেন্ট পেতে আপনি NativeCustomFormatAd.getMediaContent() ব্যবহার করতে পারেন। এরপর আপনার মিডিয়া ভিউতে মিডিয়া কন্টেন্ট সেট করার জন্য setMediaContent() কল করুন। যদি বিজ্ঞাপনটির মিডিয়া কন্টেন্ট null হয়, তবে ভিডিও ছাড়া বিজ্ঞাপনটি দেখানোর জন্য বিকল্প পরিকল্পনা করুন।

নিম্নলিখিত উদাহরণটি পরীক্ষা করে দেখে যে বিজ্ঞাপনটিতে ভিডিও কন্টেন্ট আছে কিনা, এবং ভিডিও না থাকলে তার পরিবর্তে একটি ছবি প্রদর্শন করে:

জাভা

// 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)
  }
}

নেটিভ ভিডিওর একটি কার্যকরী উদাহরণ দেখতে অ্যাড ম্যানেজার কাস্টম রেন্ডারিং উদাহরণটি ডাউনলোড করুন।

একটি কাস্টম নেটিভ অ্যাডের ভিডিও অভিজ্ঞতা কীভাবে কাস্টমাইজ করবেন, সে সম্পর্কে আরও তথ্যের জন্য ভিডিও অ্যাডস দেখুন।

AdChoices আইকনটি রেন্ডার করুন

ডিজিটাল পরিষেবা আইন (DSA) সমর্থনের অংশ হিসেবে, ইউরোপীয় অর্থনৈতিক অঞ্চলে (EEA) পরিবেশিত রিজার্ভেশন বিজ্ঞাপনগুলিতে একটি AdChoices আইকন এবং Google-এর 'এই বিজ্ঞাপন সম্পর্কে' পৃষ্ঠার একটি লিঙ্ক থাকা আবশ্যক। কাস্টম নেটিভ বিজ্ঞাপন প্রয়োগ করার সময়, AdChoices আইকনটি রেন্ডার করার দায়িত্ব আপনার। আমরা সুপারিশ করি যে, মূল বিজ্ঞাপন অ্যাসেটগুলি রেন্ডার করার সময় আপনি AdChoices আইকনটি রেন্ডার করুন এবং এর জন্য ক্লিক লিসেনার সেট করুন।

নিম্নলিখিত উদাহরণটি ধরে নেয় যে আপনি আপনার ভিউ হায়ারার্কিতে AdChoices লোগোটি রাখার জন্য একটি <ImageView /> এলিমেন্ট সংজ্ঞায়িত করেছেন।

<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)
    }
  }
  ...
}

ইম্প্রেশন রেকর্ড করুন এবং ক্লিক রিপোর্ট করুন

আপনার অ্যাপটি ইম্প্রেশন রেকর্ড করা এবং Google Mobile Ads SDK তে ক্লিক ইভেন্ট রিপোর্ট করার জন্য দায়ী।

রেকর্ড ইমপ্রেশন

একটি কাস্টম নেটিভ অ্যাডের জন্য ইম্প্রেশন রেকর্ড করতে, অ্যাডটির recordImpression() মেথডটি কল করুন:

myCustomFormatAd.recordImpression();

আপনার অ্যাপ যদি ভুলবশত একই বিজ্ঞাপনের জন্য মেথডটি দুইবার কল করে, তাহলে SDK স্বয়ংক্রিয়ভাবে একটিমাত্র অনুরোধের জন্য ডুপ্লিকেট ইম্প্রেশন রেকর্ড হওয়া প্রতিরোধ করে।

রিপোর্ট ক্লিক

কোনো অ্যাসেট ভিউতে ক্লিক হয়েছে তা SDK-কে জানাতে, অ্যাডটির performClick() মেথডটি কল করুন। অ্যাড ম্যানেজার UI-তে আপনি যে স্ট্রিংটি নির্ধারণ করেছেন, সেটি ব্যবহার করে ক্লিক করা অ্যাসেটটির নাম প্রদান করুন।

myCustomFormatAd.performClick("MainImage");

মনে রাখবেন, আপনার বিজ্ঞাপনের সাথে যুক্ত প্রতিটি ভিউয়ের জন্য এই মেথডটি কল করার প্রয়োজন নেই। যদি আপনার "ক্যাপশন" নামে আরেকটি ফিল্ড থাকে যা শুধু প্রদর্শিত হওয়ার জন্য, কিন্তু ব্যবহারকারী তাতে ক্লিক বা ট্যাপ করবে না, তাহলে আপনার অ্যাপকে সেই অ্যাসেটের ভিউয়ের জন্য performClick কল করার প্রয়োজন হবে না।

কাস্টম ক্লিক অ্যাকশনগুলিতে সাড়া দিন

যখন কোনো কাস্টম ফরম্যাটের বিজ্ঞাপনে ক্লিক করা হয়, তখন SDK থেকে তিনটি সম্ভাব্য প্রতিক্রিয়া আসতে পারে, যা এই ক্রমে চেষ্টা করা হয়:

যদি OnCustomClickListener প্রদান করা হয়ে থাকে, তবে সেটিকে কল করুন।
বিজ্ঞাপনটির প্রতিটি ডিপ লিঙ্ক ইউআরএল-এর জন্য, একটি কন্টেন্ট রিজলভার খুঁজে বের করার চেষ্টা করুন এবং যেটি প্রথমে রিজলভ হয়, সেটি চালু করুন।
একটি ব্রাউজার খুলুন এবং বিজ্ঞাপনটির গন্তব্য ইউআরএল-এ যান।

কাস্টম ক্লিক অ্যাকশন প্রয়োগ করতে, একটি OnCustomClickListener প্রদান করুন:

জাভা

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-কে ক্লিকের প্রতিক্রিয়ার উপর নিয়ন্ত্রণ বজায় রাখতে সাহায্য করে। উদাহরণস্বরূপ, এটি কোনো অতিরিক্ত কোড ছাড়াই ক্রিয়েটিভের জন্য সেট করা থার্ড-পার্টি ট্র্যাকিং URL-গুলোতে স্বয়ংক্রিয়ভাবে পিং করতে পারে এবং নেপথ্যে অন্যান্য কাজও সামলাতে পারে।