কাস্টম নেটিভ বিজ্ঞাপন বিন্যাস

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

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

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

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

একটি অ্যাডলোডার তৈরি করুন

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

জাভা

AdLoader adLoader = new AdLoader.Builder(context, "/6499/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, "/6499/example/native")
        .forCustomFormatAd("10063170",
            { ad ->
                // Show the custom format and record an impression.
            },
            { ad, s ->
            // Handle the click action
            })
        .withAdListener( ... )
        .withNativeAdOptions( ... )
        .build()

forCustomFormatAd পদ্ধতি AdLoader কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাটের অনুরোধ করতে কনফিগার করে। পদ্ধতিতে পাস করা তিনটি পরামিতি রয়েছে:

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

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

দ্রষ্টব্য: forNativeAd এবং forCustomFormatAd একটি একক AdLoader এর সাথে একই সাথে ব্যবহার করা যেতে পারে যদি আপনার একটি বিজ্ঞাপন ইউনিট থাকে যা একাধিক বিজ্ঞাপন ফর্ম্যাট পরিবেশন করার জন্য কনফিগার করা থাকে।

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

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

প্রতিটি কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাট আইডি তার নামের পাশে প্রদর্শিত হয়। নামগুলির একটিতে ক্লিক করা আপনাকে একটি বিশদ স্ক্রিনে নিয়ে আসে যা ফর্ম্যাটের ক্ষেত্রগুলি সম্পর্কে তথ্য প্রদর্শন করে:

এখান থেকে, পৃথক ক্ষেত্র যোগ করা, সম্পাদনা করা এবং সরানো যেতে পারে। প্রতিটি সম্পদের নাম নোট করুন। আপনার কাস্টম নেটিভ বিজ্ঞাপন বিন্যাস প্রদর্শন করার সময় প্রতিটি সম্পদের ডেটা পেতে নামটি ব্যবহার করা হয়।

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

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

1. যেহেতু NativeCustomFormatAd ক্লাসটি অ্যাড ম্যানেজারে আপনার সংজ্ঞায়িত কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাটগুলির যেকোনো একটি পরিচালনা করার জন্য বোঝানো হয়েছে, এতে সম্পদের জন্য "গেটার" নাম দেওয়া হয় না। পরিবর্তে, এটি getText এবং getImage মতো পদ্ধতিগুলি অফার করে যা একটি প্যারামিটার হিসাবে ক্ষেত্রের নাম নেয়।
2. NativeCustomFormatAd সাথে ব্যবহার করার জন্য NativeAdView মতো কোনও ডেডিকেটেড বিজ্ঞাপন ভিউ ক্লাস নেই। আপনি যেকোন লেআউট ব্যবহার করতে পারবেন যা আপনার ব্যবহারকারীর অভিজ্ঞতার জন্য বোধগম্য।
3. যেহেতু কোনো ডেডিকেটেড 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.
    ...
}

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

একটি কাস্টম বিন্যাস তৈরি করার সময়, আপনার কাছে ভিডিওর জন্য বিন্যাসটিকে যোগ্য করার বিকল্প রয়েছে৷

আপনার অ্যাপ বাস্তবায়নে, আপনি মিডিয়া বিষয়বস্তু পেতে 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 দেখুন৷

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

কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাট ক্লিক এবং ইমপ্রেশন

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

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

একটি কাস্টম ফরম্যাট বিজ্ঞাপনের জন্য একটি ইমপ্রেশন রেকর্ড করতে, সংশ্লিষ্ট NativeCustomFormatAd এ recordImpression পদ্ধতিতে কল করুন:

myCustomFormatAd.recordImpression();

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

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

SDK-কে রিপোর্ট করতে যে একটি সম্পদ দৃশ্যে একটি ক্লিক ঘটেছে, সংশ্লিষ্ট NativeCustomFormatAd এ performClick পদ্ধতিতে কল করুন এবং ক্লিক করা সম্পদের নামে পাস করুন। উদাহরণস্বরূপ, যদি আপনার কাস্টম ফর্ম্যাটে "MainImage" নামে একটি সম্পদ থাকে এবং আপনি সেই সম্পত্তির সাথে সম্পর্কিত ImageView এ একটি ক্লিকের প্রতিবেদন করতে চান, তাহলে আপনার কোডটি এরকম দেখাবে:

myCustomFormatAd.performClick("MainImage");

মনে রাখবেন যে আপনার বিজ্ঞাপনের সাথে যুক্ত প্রতিটি দৃশ্যের জন্য আপনাকে এই পদ্ধতিটি কল করার দরকার নেই৷ যদি আপনার কাছে "ক্যাপশন" নামে অন্য একটি ক্ষেত্র থাকে যা প্রদর্শনের জন্য ছিল কিন্তু ব্যবহারকারী দ্বারা ক্লিক করা বা ট্যাপ করা হয়নি, তাহলে আপনার অ্যাপটিকে সেই সম্পদের দৃশ্যের জন্য performClick কল করার প্রয়োজন হবে না।

কাস্টম ক্লিক কর্মের প্রতিক্রিয়া

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

1. AdLoader থেকে OnCustomClickListener আহ্বান করুন, যদি একটি প্রদান করা হয়।
2. বিজ্ঞাপনের প্রতিটি ডিপ লিঙ্ক URL-এর জন্য, একটি বিষয়বস্তু সমাধানকারীকে খুঁজে বের করার চেষ্টা করুন এবং সমাধান করা প্রথমটি শুরু করুন।
3. একটি ব্রাউজার খুলুন এবং বিজ্ঞাপনের ঐতিহ্যগত গন্তব্য URL-এ নেভিগেট করুন।

forCustomFormatAd পদ্ধতি একটি OnCustomClickListener গ্রহণ করে। যদি আপনি একটি শ্রোতা বস্তু পাস করেন, SDK পরিবর্তে তার onCustomClick পদ্ধতি চালু করে এবং আর কোনো পদক্ষেপ নেয় না। আপনি যদি শ্রোতা হিসাবে একটি শূন্য মান পাস করেন, তবে, SDK বিজ্ঞাপনের সাথে নিবন্ধিত ডিপলিংক এবং/অথবা গন্তব্য URL-এ ফিরে আসে।

কাস্টম ক্লিক শ্রোতারা আপনার অ্যাপটিকে একটি ক্লিকের প্রতিক্রিয়ায় নেওয়ার জন্য সর্বোত্তম পদক্ষেপের সিদ্ধান্ত নিতে দেয়, এটি UI আপডেট করা, একটি নতুন কার্যকলাপ চালু করা বা শুধুমাত্র ক্লিক লগ করা। এখানে একটি উদাহরণ যা সহজভাবে লগ করে যে একটি ক্লিক ঘটেছে:

জাভা

AdLoader adLoader = new AdLoader.Builder(context, "/6499/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, "/6499/example/native")
    .forCustomFormatAd("10063170",
        { ad ->
            // Display the ad.
        },
        { ad, assetName ->
                Log.i("MyApp", "A custom click just happened for $assetName!")
    }).build()

প্রথমে, এটি অদ্ভুত বলে মনে হতে পারে যে কাস্টম ক্লিক শ্রোতারা বিদ্যমান। সর্বোপরি, আপনার অ্যাপটি SDK কে বলেছে যে একটি ক্লিক ঘটেছে, তাহলে কেন SDK ঘুরে এসে অ্যাপে রিপোর্ট করবে?

তথ্যের এই প্রবাহটি কয়েকটি কারণে কার্যকর, তবে সবচেয়ে গুরুত্বপূর্ণভাবে এটি SDK-কে ক্লিকের প্রতিক্রিয়া নিয়ন্ত্রণে রাখতে দেয়। এটি স্বয়ংক্রিয়ভাবে তৃতীয় পক্ষের ট্র্যাকিং ইউআরএলগুলিকে পিং করতে পারে যা সৃজনশীলের জন্য সেট করা হয়েছে, উদাহরণস্বরূপ, এবং কোনও অতিরিক্ত কোড ছাড়াই পর্দার পিছনে অন্যান্য কাজগুলি পরিচালনা করতে পারে৷