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

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

सुरक्षित सिग्नल एपीआई के लिए, iOS के IMA SDK टूल का वर्शन 3.18.1 या इसके बाद का होना ज़रूरी है.

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

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

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

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

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

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

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

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

हर विज्ञापन अनुरोध के लिए, एक IMASecureSignals ऑब्जेक्ट बनाएं. इसमें, स्ट्रिंग के तौर पर एन्कोड किया गया कस्टम डेटा शामिल होना चाहिए. इसके बाद, IMAAdsRequest.secureSignals एट्रिब्यूट को कॉल करके, अपने विज्ञापन अनुरोध में IMASecureSignals ऑब्जेक्ट जोड़ें.

यहां Objective-C और Swift में सैंपल दिए गए हैं:

...
- (void)requestAds {
  // Create an ad display container for ad rendering.
  IMAAdDisplayContainer *adDisplayContainer =
      [[IMAAdDisplayContainer alloc] initWithAdContainer:self.videoView
                                          viewController:self
                                          companionSlots:nil];
  // Create an ad request with our ad tag, display container, and optional user context.
  IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:kTestAppAdTagUrl
                                                adDisplayContainer:adDisplayContainer
                                                   contentPlayhead:self.contentPlayhead
                                                       userContext:nil];
  
  IMASecureSignals *signals =
      [[IMASecureSignals alloc] initWithCustomData:@"My encoded signal string"];
  request.secureSignals = signals;
  
  [self.adsLoader requestAdsWithRequest:request];
}
...

...
private func requestAds() {
  // Create ad display container for ad rendering.
  let adDisplayContainer = IMAAdDisplayContainer(
    adContainer: videoView, viewController: self, companionSlots: nil)
  // Create an ad request with our ad tag, display container, and optional user context.
  let request = IMAAdsRequest(
    adTagUrl: ViewController.testAppAdTagURL,
    adDisplayContainer: adDisplayContainer,
    contentPlayhead: contentPlayhead,
    userContext: nil)
  
  let signals = IMASecureSignals(customData: "My encoded signal string")
  request.secureSignals = signals
  
  adsLoader.requestAds(with: request)
}
...