डिसप्ले-टाइप के कस्टम नेटिव विज्ञापन फ़ॉर्मैट और Open Measurement

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

ज़रूरी शर्तें

जारी रखने से पहले, यह काम करें:

इंटिग्रेशन

अगर आपको कस्टम नेटिव विज्ञापन फ़ॉर्मैट के साथ ओपन मेज़रमेंट का इस्तेमाल करना है और उनमें वीडियो ऐसेट शामिल नहीं है, तो आपको Open Measurement API को खुद कॉल करना होगा.

अगर वीडियो ऐसेट के साथ कस्टम नेटिव विज्ञापन फ़ॉर्मैट का इस्तेमाल किया जा रहा है, तो आपको इस गाइड को पढ़ने की ज़रूरत नहीं है. Mobile Ads SDK, आपकी ओर से वीडियो ऐसेट की दृश्यता को ट्रैक करता है.

अपनी व्यू को रजिस्टर करें और मेज़रमेंट शुरू करें

कस्टम नेटिव विज्ञापन पर ओपन मेज़रमेंट की सुविधा चालू करने के लिए, पहले विज्ञापन दिखाएं. इसके बाद, कस्टम नेटिव विज्ञापन से जुड़े DisplayOpenMeasurement ऑब्जेक्ट के साथ, कस्टम विज्ञापन व्यू रजिस्टर करें. DisplayOpenMeasurement ऑब्जेक्ट, setView() तरीका उपलब्ध कराता है. इससे ओपन मेज़रमेंट के साथ अपने कंटेनर व्यू को रजिस्टर किया जा सकता है.

आपको एसडीके को यह भी बताना होगा कि वह आपके विज्ञापन को मेज़र करना शुरू करे. इसके लिए, अपने कस्टम नेटिव विज्ञापन के DisplayOpenMeasurement ऑब्जेक्ट पर start() तरीके को कॉल करें. start() तरीके को मुख्य थ्रेड से कॉल किया जाना चाहिए. इसके बाद के कॉल का कोई असर नहीं होता.

यहां बताया गया है कि यह कैसा दिखता है:

Kotlin

@MainThread
private fun displayCustomNativeAd(
  customNativeAd: CustomNativeAd,
  nativeAdViewContainer: FrameLayout,
) {
  // TODO: Render the custom native ad inside the nativeAdViewContainer.

  // ...

  // Start measuring the ad view.
  val displayOpenMeasurement = customNativeAd.getDisplayOpenMeasurement()
  if (displayOpenMeasurement != null) {
    displayOpenMeasurement.setView(nativeAdViewContainer)
    displayOpenMeasurement.start()
  }
}

Java

@MainThread
private void displayCustomNativeAd(
    CustomNativeAd customNativeAd, FrameLayout nativeAdViewContainer) {
  // TODO: Render the custom native ad inside the nativeAdViewContainer.

  // ...

  // Start measuring the ad view.
  DisplayOpenMeasurement displayOpenMeasurement = customNativeAd.getDisplayOpenMeasurement();
  if (displayOpenMeasurement != null) {
    displayOpenMeasurement.setView(nativeAdViewContainer);
    displayOpenMeasurement.start();
  }
}

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

nativeAdViewContainer लेआउट, कस्टम नेटिव विज्ञापन के लिए विज्ञापन कंटेनर होता है. इसमें व्यू के बाउंडिंग बॉक्स में मौजूद सभी ऐसेट शामिल होनी चाहिए.

IAB से सर्टिफ़िकेट पाना

ऐप्लिकेशन रिलीज़ करने के बाद, आपको मेज़रमेंट का डेटा मिलना शुरू हो जाएगा. हालांकि, जब तक IAB सर्टिफ़िकेशन की प्रोसेस पूरी नहीं हो जाती, तब तक आपके डेटा को सर्टिफ़िकेट नहीं मिलेगा.