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

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

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

इंटिग्रेशन

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

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

अब जानते हैं कि NativeCustomTemplateAd के साथ, मेज़रमेंट के सभी विकल्प इस्तेमाल करने का तरीका कैसे इस्तेमाल किया जाता है. आम तौर पर, विज्ञापन दिखने से जुड़े आंकड़ों का आकलन करने और अपनी पसंद के मुताबिक विज्ञापन व्यू को रजिस्टर करने के लिए, आपको मोबाइल विज्ञापन SDK टूल को इसकी सूचना देनी होगी.

विज्ञापन लोड करें

विज्ञापन को लोड करने का तरीका एक जैसा ही होता है, चाहे आप ओपन मेज़रमेंट का इस्तेमाल कर रहे हों या नहीं. यहां NativeCustomTemplateAd का अनुरोध करने का तरीका बताया गया है:

public void loadAd() {
   AdLoader adLoader = new AdLoader.Builder(context, "YOUR-AD-UNIT-ID")
    .forCustomTemplateAd("YOUR-TEMPLATE-ID",
      new NativeCustomTemplateAd.OnCustomTemplateAdLoadedListener() {
          @Override
          public void onCustomTemplateAdLoaded(NativeCustomTemplateAd ad) {
              // Register your view and begin open measurement.
              // We will define this method below.
              MyActivity.this.registerOpenMeasurementAndShowAd(ad);
          }
      },
      new NativeCustomTemplateAd.OnCustomClickListener() {
          @Override
          public void onCustomClick(NativeCustomTemplateAd ad, String s) {
              // Handle the click action
          }
      })
    .withAdListener( ... )
    .withNativeAdOptions( ... )
    .build();
}

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

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

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

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

public void  registerOpenMeasurementAndShowAd(NativeCustomTemplateAd ad) {

...
// Show ad
...
displayCustomTemplateAd(ad)
// Begin Open Measurement
// The FrameLayout that will contain your native custom ad
FrameLayout customTemplateAdFrame = (FrameLayout) findViewById(R.id.custom_ad_frame);
ad.getDisplayOpenMeasurement().setView(customTemplateAdFrame);
ad.getDisplayOpenMeasurement().start();

}

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

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

IAB से प्रमाणित करें

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