पसंद के मुताबिक नेटिव विज्ञापन फ़ॉर्मैट

कस्टम नेटिव विज्ञापन फ़ॉर्मैट

सिस्टम के तय किए गए नेटिव फ़ॉर्मैट के अलावा, Ad Manager पब्लिशर के पास एसेट की कस्टम सूचियां तय करके, अपने नेटिव विज्ञापन फ़ॉर्मैट बनाने का विकल्प होता है. इन्हें कस्टम नेटिव विज्ञापन फ़ॉर्मैट कहा जाता है. इनका इस्तेमाल, रिज़र्व किए गए विज्ञापनों के साथ किया जा सकता है. इससे पब्लिशर, अपने ऐप्लिकेशन में मनमुताबिक स्ट्रक्चर्ड डेटा पास कर सकते हैं. इन विज्ञापनों को NativeCustomFormatAd ऑब्जेक्ट से दिखाया जाता है.

कस्टम नेटिव विज्ञापन फ़ॉर्मैट लोड करना

इस गाइड में, पसंद के मुताबिक नेटिव विज्ञापन फ़ॉर्मैट लोड और दिखाने का तरीका बताया गया है.

AdLoader बनाना

नेटिव विज्ञापनों की तरह ही, कस्टम नेटिव विज्ञापन फ़ॉर्मैट AdLoader क्लास का इस्तेमाल करके लोड किए जाते हैं:

Java

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();

Kotlin

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. इस Listener के बारे में ज़्यादा जानने के लिए, नीचे दिया गया "क्लिक और इंप्रेशन मैनेज करना" सेक्शन देखें.

एक विज्ञापन यूनिट को एक से ज़्यादा क्रिएटिव फ़ॉर्मैट दिखाने के लिए सेट अप किया जा सकता है. इसलिए, forCustomFormatAd को यूनीक फ़ॉर्मैट आईडी के साथ कई बार कॉल किया जा सकता है, ताकि विज्ञापन लोडर को एक से ज़्यादा कस्टम नेटिव विज्ञापन फ़ॉर्मैट के लिए तैयार किया जा सके.

कस्टम नेटिव विज्ञापन फ़ॉर्मैट का आईडी

कस्टम नेटिव विज्ञापन फ़ॉर्मैट की पहचान करने के लिए इस्तेमाल किया जाने वाला फ़ॉर्मैट आईडी, Ad Manager के यूज़र इंटरफ़ेस (यूआई) में डिलीवरी ड्रॉपडाउन में नेटिव सेक्शन में देखा जा सकता है:

हर कस्टम नेटिव विज्ञापन फ़ॉर्मैट आईडी, उसके नाम के बगल में दिखता है. इनमें से किसी एक नाम पर क्लिक करने से, आपको ज़्यादा जानकारी वाली स्क्रीन पर ले जाया जाता है. इस स्क्रीन पर, फ़ॉर्मैट के फ़ील्ड के बारे में जानकारी दिखती है:

यहां से, अलग-अलग फ़ील्ड जोड़े जा सकते हैं, उनमें बदलाव किया जा सकता है, और उन्हें हटाया जा सकता है. हर ऐसेट का नाम नोट करें. नाम वह कुंजी है जिसका इस्तेमाल, कस्टम नेटिव विज्ञापन फ़ॉर्मैट दिखाते समय हर एसेट का डेटा पाने के लिए किया जाता है.

कस्टम नेटिव विज्ञापन फ़ॉर्मैट दिखाना

कस्टम नेटिव विज्ञापन फ़ॉर्मैट, सिस्टम से तय किए गए फ़ॉर्मैट से अलग होते हैं. इसकी वजह यह है कि पब्लिशर के पास, विज्ञापन बनाने वाली एसेट की अपनी सूची तय करने का विकल्प होता है. इसलिए, किसी एक फ़ॉर्मैट को दिखाने की प्रोसेस, सिस्टम के तय किए गए फ़ॉर्मैट से कुछ तरीकों से अलग होती है:

  1. NativeCustomFormatAd क्लास का मकसद, Ad Manager में तय किए गए किसी भी कस्टम नेटिव विज्ञापन फ़ॉर्मैट को मैनेज करना है. इसलिए, इसमें ऐसेट के लिए नाम वाले "गेटर" नहीं होते. इसके बजाय, यह getText और getImage जैसे तरीके उपलब्ध कराता है, जो फ़ील्ड के नाम को पैरामीटर के तौर पर लेते हैं.
  2. NativeCustomFormatAd के साथ इस्तेमाल करने के लिए, NativeAdView जैसी कोई खास विज्ञापन व्यू क्लास नहीं है. आपके पास अपने उपयोगकर्ता अनुभव के हिसाब से, किसी भी लेआउट का इस्तेमाल करने का विकल्प है.
  3. कोई खास ViewGroup क्लास न होने की वजह से, आपको विज्ञापन की ऐसेट दिखाने के लिए इस्तेमाल किए गए किसी भी व्यू को रजिस्टर करने की ज़रूरत नहीं है. इससे विज्ञापन दिखाते समय, कोड की कुछ लाइनों को बचाया जा सकता है. हालांकि, इसका मतलब यह भी है कि आपको बाद में क्लिक मैनेज करने के लिए थोड़ा ज़्यादा काम करना होगा.

यहां एक उदाहरण फ़ंक्शन दिया गया है, जो NativeCustomFormatAd दिखाता है:

Java

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

Kotlin

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 आइकॉन को रेंडर करना

डिजिटल सर्विसेज़ ऐक्ट (डीएसए) का पालन करने के लिए, यूरोपियन इकनॉमिक एरिया (ईईए) में दिखाए जाने वाले रिज़र्वेशन विज्ञापनों में AdChoices आइकॉन और Google के 'इस विज्ञापन के बारे में जानकारी' पेज का लिंक होना ज़रूरी है. कस्टम नेटिव विज्ञापनों को लागू करते समय, AdChoices आइकॉन को रेंडर करने की ज़िम्मेदारी आपकी होती है. हमारा सुझाव है कि मुख्य विज्ञापन एसेट को रेंडर करते समय, AdChoices आइकॉन के लिए क्लिक Listener को रेंडर और सेट करें.

इस उदाहरण में, यह माना गया है कि आपने 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 आइकॉन को रेंडर किया गया है और क्लिक के सही व्यवहार को कॉन्फ़िगर किया गया है.

Java

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

Kotlin

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() को कॉल करें. अगर विज्ञापन में वीडियो कॉन्टेंट नहीं है, तो विज्ञापन को बिना वीडियो के दिखाने के लिए अन्य विकल्प बनाएं.

नीचे दिए गए उदाहरण में यह जांच की जाती है कि विज्ञापन में वीडियो कॉन्टेंट है या नहीं. अगर वीडियो उपलब्ध नहीं है, तो उसकी जगह पर इमेज दिखती है:

Java

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

Kotlin

// 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 को क्लिक इवेंट की रिपोर्ट करने की ज़िम्मेदारी होती है.

इंप्रेशन रिकॉर्ड करना

कस्टम फ़ॉर्मैट वाले विज्ञापन के लिए इंप्रेशन रिकॉर्ड करने के लिए, उससे जुड़े NativeCustomFormatAd पर recordImpression तरीका कॉल करें:

myCustomFormatAd.recordImpression();

अगर आपका ऐप्लिकेशन किसी एक विज्ञापन के लिए, गलती से दो बार मेथड को कॉल करता है, तो SDK टूल अपने-आप किसी एक अनुरोध के लिए डुप्लीकेट इंप्रेशन को रिकॉर्ड होने से रोकता है.

क्लिक की रिपोर्ट

SDK टूल को यह बताने के लिए कि किसी ऐसेट व्यू पर क्लिक हुआ है, उससे जुड़े NativeCustomFormatAd पर performClick तरीका कॉल करें और उस ऐसेट का नाम पास करें जिस पर क्लिक किया गया था. उदाहरण के लिए, अगर आपके कस्टम फ़ॉर्मैट में "MainImage" नाम की कोई ऐसेट है और आपको उस ऐसेट से जुड़े ImageView पर क्लिक की रिपोर्ट करनी है, तो आपका कोड ऐसा दिखेगा:

myCustomFormatAd.performClick("MainImage");

ध्यान दें कि आपको अपने विज्ञापन से जुड़े हर व्यू के लिए, इस तरीके को कॉल करने की ज़रूरत नहीं है. अगर आपके पास "कैप्शन" नाम का कोई दूसरा फ़ील्ड था, जिसे दिखाना था, लेकिन उपयोगकर्ता ने उस पर क्लिक या टैप नहीं किया, तो आपके ऐप्लिकेशन को उस एसेट के व्यू के लिए performClick को कॉल करने की ज़रूरत नहीं होगी.

कस्टम क्लिक ऐक्शन का जवाब देना

जब कस्टम फ़ॉर्मैट वाले विज्ञापन पर क्लिक किया जाता है, तो SDK टूल से तीन संभावित जवाब मिल सकते हैं. ये जवाब इस क्रम में मिलते हैं:

  1. अगर AdLoader दिया गया है, तो उससे OnCustomClickListener को लागू करें.
  2. विज्ञापन के हर डीप लिंक यूआरएल के लिए, कॉन्टेंट रिज़ॉल्वर ढूंढने की कोशिश करें और सबसे पहले उस रिज़ॉल्वर को शुरू करें जो काम करता है.
  3. कोई ब्राउज़र खोलें और विज्ञापन के पारंपरिक डेस्टिनेशन यूआरएल पर जाएं.

forCustomFormatAd तरीके में OnCustomClickListener का इस्तेमाल किया जा सकता है. अगर आपने किसी listener ऑब्जेक्ट को पास किया है, तो SDK टूल इसके बजाय अपने onCustomClick तरीके को शुरू करता है और कोई और कार्रवाई नहीं करता. हालांकि, अगर आपने श्रोता के तौर पर कोई शून्य वैल्यू दी है, तो SDK, विज्ञापन के साथ रजिस्टर किए गए डीपलिंक और/या डेस्टिनेशन यूआरएल पर वापस चला जाता है.

कस्टम क्लिक लिसनर की मदद से, आपके ऐप्लिकेशन को क्लिक के जवाब में सबसे सही कार्रवाई करने का विकल्प मिलता है. भले ही, वह यूज़र इंटरफ़ेस (यूआई) को अपडेट करना हो, नई गतिविधि लॉन्च करना हो या सिर्फ़ क्लिक को लॉग करना हो. यहां एक उदाहरण दिया गया है, जिसमें सिर्फ़ यह लॉग किया गया है कि क्लिक हुआ है:

Java

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();

Kotlin

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 टूल, क्लिक के जवाब को कंट्रोल कर पाता है. उदाहरण के लिए, यह क्रिएटिव के लिए सेट किए गए तीसरे पक्ष के ट्रैकिंग यूआरएल को अपने-आप पिंग कर सकता है. साथ ही, बिना किसी अतिरिक्त कोड के बैकग्राउंड में अन्य टास्क को मैनेज कर सकता है.