सुरक्षित सिग्नल का इस्तेमाल शुरू करना

प्लैटफ़ॉर्म चुनें: HTML5 Android iOS tvOS

सुरक्षित सिग्नल, एन्कोड किया गया डेटा होता है. इसे क्लाइंट डिवाइस पर इकट्ठा किया जाता है और कुछ बिडर के साथ शेयर किया जाता है. इस गाइड में, IMA SDK का इस्तेमाल करके Google Ad Manager को सुरक्षित सिग्नल इकट्ठा करने और भेजने का तरीका बताया गया है.

Secure Signals API के लिए, IMA SDK for Android का वर्शन 3.29.0 या इसके बाद का होना चाहिए.

सिग्नल और बिडर चुनने के लिए, बिडर के साथ सुरक्षित सिग्नल शेयर करना लेख पढ़ें. इसमें सुरक्षित सिग्नल शेयर करने की सुविधा चालू करने के बारे में भी बताया गया है.

तीसरे पक्ष की सिग्नल प्रोवाइडर कंपनी का इस्तेमाल करना

सुरक्षित सिग्नल का इस्तेमाल करने के लिए, आपको अपने ऐप्लिकेशन में सिग्नल कलेक्टर अडैप्टर क्लास डिप्लॉय करनी होगी. इससे सिग्नल इकट्ठा किए जा सकेंगे, उन्हें कोड में बदला जा सकेगा, और IMA SDK को पास किया जा सकेगा.

तीसरे पक्ष की सेवा देने वाली कंपनी के साथ खाता सेट अप करने के लिए, उसके निर्देशों का पालन करें. बिल्ड डिपेंडेंसी जोड़ें. इसके बाद, अपने ऐप्लिकेशन में सुरक्षित सिग्नल अडैप्टर सेट अप करें.

Android के लिए IMA SDK, हर सुरक्षित सिग्नल अडैप्टर को अपने-आप शुरू करता है. इसके लिए, आपको अपने कोड में कोई बदलाव करने की ज़रूरत नहीं होती.

यहां एक उदाहरण दिया गया है, जिसमें बताया गया है कि अपने प्रोजेक्ट में सुरक्षित सिग्नल अडैप्टर कैसे जोड़ा जा सकता है:

कस्टम डेटा भेजना

तीसरे पक्ष की सिग्नल सेवा देने वाली कंपनी का इस्तेमाल करने के अलावा, कस्टम डेटा के साथ सिग्नल इकट्ठा, कोड में बदला, और भेजा भी जा सकता है. कस्टम डेटा के साथ सुरक्षित सिग्नल भेजने के लिए, आपको Ad Manager में कस्टम सिग्नल चालू करने होंगे.

हर विज्ञापन अनुरोध के लिए , एक SecureSignals ऑब्जेक्ट बनाएं. इसमें स्ट्रिंग के तौर पर, एन्कोड किया गया कस्टम डेटा शामिल करें. इसके बाद, SecureSignals ऑब्जेक्ट को अपने विज्ञापन अनुरोध में जोड़ें. इसके लिए, adsRequest.setSecureSignals() तरीके को कॉल करें:

app/src/main/java/com/example/project name/MainActivity.java

...
private void requestAds(String adTagUrl) {
  // Create the ads request.
  AdsRequest request = sdkFactory.createAdsRequest();
  request.setAdTagUrl(adTagUrl);
  request.setContentProgressProvider(
      () -> {
        if (videoPlayer.getDuration() <= 0) {
          return VideoProgressUpdate.VIDEO_TIME_NOT_READY;
        }
        return new VideoProgressUpdate(
            videoPlayer.getCurrentPosition(), videoPlayer.getDuration());
      });
  
  SecureSignals signal = SecureSignals.create("My encoded signal string");
  request.setSecureSignals(signal);
  
  // Request the ad. After the ad is loaded, onAdsManagerLoaded() will be called.
  adsLoader.requestAds(request);
}
...