सुरक्षित ऑडियंस के लिए, ऐप्लिकेशन इंस्टॉल करने का बढ़ावा देने वाले विज्ञापन फ़िल्टर करना

ध्यान दें: लागू करने के दिशा-निर्देश के लिए, इस सुविधा की डेवलपर गाइड.

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

इस प्रस्ताव में बताया गया है कि Android पर Protected Audience, कॉन्टेंट के हिसाब से विज्ञापन दिखाने की सुविधा कैसे देता है विज्ञापन फ़िल्टर करने की सुविधा, खास तौर पर, ऐप्लिकेशन इंस्टॉल करने का बढ़ावा देने वाले विज्ञापनों को फ़िल्टर करने की सुविधा. तरीका है. इसका इस्तेमाल करने के लिए, डिवाइस पर मौजूद ऐप्लिकेशन को उसमें साफ़ तौर पर ऑप्ट-इन करना होगा विज्ञापन फ़िल्टर करने की सुविधा इंस्टॉल करने का सुझाव देते हैं. विज्ञापन चुनने के दौरान, विज्ञापन के उम्मीदवारों को डिवाइस पर इंस्टॉल किए गए ऐप्लिकेशन की सूची पर दिखेगा.

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

ऐप्लिकेशन इंस्टॉल विज्ञापनों को फ़िल्टर करने की सुविधा सेट अप करने के लिए, यह तरीका अपनाएं:

चरण 1: ऐप्लिकेशन इंस्टॉल विज्ञापनों को फ़िल्टर करने के लिए ऐप्लिकेशन रजिस्टर करें

ऐप्लिकेशन इंस्टॉल विज्ञापन फ़िल्टर करने के लिए ऑप्ट-इन करने के लिए, ऐप्लिकेशन डेवलपर अपने ऐप्लिकेशन से, registerForAdFiltering ऐप्लिकेशन रजिस्ट्रेशन एपीआई या AdTech SDK टूल का इस्तेमाल करके, जिसमें विज्ञापन टेक्नोलॉजी से जुड़े खरीदार eTLD+1s की सूची मिलेगी. इससे सूची में मौजूद खरीदारों को अनुमति मिलती है और केवल उन खरीदारों को ही शामिल कर सकते हैं, ताकि ऐप्लिकेशन की इंस्टॉल स्थिति के आधार पर विज्ञापनों को फ़िल्टर किया जा सके, चाहे या विज्ञापन टेक्नोलॉजी के SDK टूल का इस्तेमाल करके ऐसा किया जा सकता है. रजिस्ट्रेशन के दौरान पूरा कंट्रोल मिलता है कि ऐप्लिकेशन डेवलपर से यह तय करने का तरीका कि उनके ऐप्लिकेशन को ऐप्लिकेशन इंस्टॉल विज्ञापनों में हिस्सा लेना चाहिए या नहीं फ़िल्टर करना. java void registerForAdFiltering(List<AdTechIdentifier> buyers); अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

दूसरा चरण: ऐप्लिकेशन इंस्टॉल करने का बढ़ावा देने वाले विज्ञापनों को फ़िल्टर करने का अनुरोध करना

जब बिडिंग के लिए किसी विज्ञापन पर विचार किया जाता है, तो खरीदार विज्ञापन को को ऐप्लिकेशन के इंस्टॉल की स्थिति के आधार पर फ़िल्टर करके बाहर निकाल दिया जाता है. ऐसा करने के लिए, विज्ञापन के मेटाडेटा में ऐप्लिकेशन के पैकेज का नाम डालें. ऐप्लिकेशन इंस्टॉल विज्ञापन फ़िल्टर करने का अनुरोध Protected Audience नीलामी की प्रोसेस में दिए गए विज्ञापनों के डेटा का हिस्सा है. यह विज्ञापन डेटा बनाने का तरीका अलग-अलग होता है. यह इस बात पर निर्भर करता है कि यह रीमार्केटिंग विज्ञापन.

• विज्ञापन के इस्तेमाल के उदाहरण के लिए, जो ऐप्लिकेशन इंस्टॉल करते समय मुख्य रूप से इस्तेमाल होता है विज्ञापन फ़िल्टर करने की सुविधा, फ़िल्टर करने की जानकारी को विज्ञापन डेटा के हिस्से के रूप में शामिल किया जाता है जिसे खरीदार, बाहरी कॉन्टेक्स्ट के हिसाब से बिड का जवाब देते समय सेलर को दे सकते हैं Protected Audience से जुड़ी ज़रूरी शर्तें पूरी करता है. Protected Audience, फ़िल्टर की गई जानकारी के लिए यह उम्मीद करता है कि वह किसी भी अन्य जनरेट की तरह, काम के हिसाब से दिए गए जवाब के तौर पर दिखाए जाएंगे विज्ञापन के लिए खास मेटाडेटा.
• रीमार्केटिंग के इस्तेमाल के उदाहरण के लिए, Protected Audience को फ़िल्टर करने की ज़रूरत होती है कस्टम ऑडियंस में शामिल की जाने वाली जानकारी. इसके लिए दो तरीके हैं ऑडियंस में शामिल होने पर और फ़ेच करने के दौरान नई ऑडियंस का डेटा भी शामिल किया है. ऐप्लिकेशन इंस्टॉल विज्ञापनों को फ़िल्टर करने का अनुरोध AdData JSON ऑब्जेक्ट: json { "render_uri": "https://..", "metadata": {..}, "filters": { "app_install": { "app_package_names": ["app1.package", "app2.package"] } } }
  ध्यान दें: एक साथ कई ऐप्लिकेशन के लिए, ऐप्लिकेशन इंस्टॉल विज्ञापनों को फ़िल्टर किया जा सकता है. ऐसा करें इसके बाद, उन सभी ऐप्लिकेशन पैकेज के नाम बताएं जिनका आकलन होना चाहिए. अगर कोई पैकेज ऐप्लिकेशन इंस्टॉल सूची में पाए जाते हैं और विज्ञापन फ़िल्टर करके बाहर कर दिए जाते हैं. हम कॉन्टेंट के हिसाब से दिखाए जाने वाले विज्ञापनों को एन्क्रिप्ट (सुरक्षित) करने और/या उन पर साइन करने की सुविधा को चालू करने के तरीके खोज रहे हैं और हम इस विषय पर आपसे सुझाव, शिकायत या राय मांगते हैं.

तीसरा चरण: विज्ञापन चुनने के दौरान, ऐप्लिकेशन इंस्टॉल करने का बढ़ावा देने वाले विज्ञापनों को फ़िल्टर करें

किसी विज्ञापन अनुरोध के दौरान, खरीदार फ़िल्टर करने की जानकारी है, ताकि इंस्टॉल किए गए ऐप्लिकेशन के विज्ञापनों को फ़िल्टर किया जा सके. कॉन्टेंट बनाने सेल-साइड (विज्ञापन की जगह बेचने वाला पक्ष) को, फ़िल्टर करने की जानकारी को adData फ़ील्ड में selectAds फ़ंक्शन कॉन्फ़िगरेशन. Android को उम्मीद है कि मैसेज का फ़ॉर्मैट नीचे दिया गया है.

ध्यान दें: संदर्भ के हिसाब से दिखाए जाने वाले विज्ञापनों के लिए, विज्ञापनों का डेटा फ़ंक्शन में पास किया जाता है, क्योंकि यह डिवाइस पर पहले से मौजूद हैं. यह रीमार्केटिंग विज्ञापनों के मामले में ऐसा नहीं होता जहां विज्ञापनों में डेटा, कस्टम ऑडियंस पर आधारित होता है.

AdData myAdData = new AdData.Builder()
        .setRenderUri(Uri.parse("https://.."))
        .setMetadata("{...}")
        .setFilters(new AdFilters.Builder()
                .setAppInstalledFilter(new AppInstalledFilter.Builder()
                    .setPackageNames(ImmutableList.of("app1.package", "app2.package"))
                    .build())
                .build())
        .build();
AdSelectionConfig myAdSelectionConfig = new AdSelectionConfig.Builder()
    .setSeller(AdTechIdentifier.fromString("example-ssp1.com"))
    .setDecisionLogicUri(Uri.parse("https://..."))
    ...
    .setContextualAds(ImmutableList.of(new ContextualAd.Builder()
                      .setBuyer(AdTechIdentifier.fromString("example.com"))
                      .setReportingUri("https://example.com/reporting")
                      .setBid(20)
                      // myAdData could be taken from the JSON above
                      .setAd(myAdData)
                      .build()))
    .build();
// Invoke ad services API to initiate ad selection workflow.
selectAds(myAdSelectionConfig);

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

• सूची में ऐप्लिकेशन नहीं मिला. इसका मतलब है कि यह ऐप्लिकेशन इंस्टॉल नहीं है और इसे खोला नहीं गया है.
• ऐप्लिकेशन इस सूची में मौजूद है. इसका मतलब है कि ऐप्लिकेशन इंस्टॉल हो गया है और खुल गया है. अगर Protected Audience को पता चलता है कि कोई ऐप्लिकेशन पहले से मौजूद है, तो विज्ञापन को उन विज्ञापनों की सूची से बाहर रखा गया है जिनका इस्तेमाल नीलामी scoreAds चलाने के लिए करती है.

कॉन्टेंट के हिसाब से दिखाए जाने वाले विज्ञापन शामिल करते समय इन बातों का ध्यान रखें

ऐप्लिकेशन इंस्टॉल करने का बढ़ावा देने वाले विज्ञापनों को फ़िल्टर करने की सुविधा की मदद से, Protected Audience API से, यह प्रासंगिक विज्ञापन फ़िल्टर करने की सुविधा. इसमें कुछ चीज़ें बताना ज़रूरी है ऐसी स्थितियां जिनमें नीलामी में, संदर्भ के हिसाब से और रीमार्केटिंग, दोनों तरह के विज्ञापन शामिल होते हैं या जिसमें सिर्फ़ संदर्भ के हिसाब से विज्ञापन शामिल होते हैं.

• selectAd की नीलामी के दौरान, खरीदार के पास सूची में शामिल होने का विकल्प होता है कुल ContextualAd ऑब्जेक्ट में से. इन ऑब्जेक्ट में विज्ञापन खरीदार का eTLD+1 होता है, विज्ञापन के लिए बिड, विज्ञापन के रिपोर्टिंग लॉजिक पर ले जाने वाला यूआरएल, और AdData में विज्ञापन के कॉन्टेंट का असल यूआरएल शामिल हो और पुष्टि करने के लिए खरीदार से संबंधित हस्ताक्षर (अधिक जानकारी के लिए संदर्भित विज्ञापन साइनिंग देखें विवरण. ध्यान दें कि AdData फ़ॉर्मैट का इस्तेमाल कॉन्टेक्स्ट और कॉन्टेक्स्ट, दोनों के लिए किया जाता है रीमार्केटिंग विज्ञापन.
• नीलामी प्रक्रिया की शुरुआत में, प्रासंगिक और रीमार्केटिंग विज्ञापन पैकेज नामों के सेट का उपयोग करके फ़िल्टर किया गया है, जो AdData.adFilters.appInstallFilters.packageNames. तो, बोली की वैल्यू किसी भी रीमार्केटिंग विज्ञापन, और रीमार्केटिंग और प्रासंगिक विज्ञापनों को दिए गए scoreAds फ़ंक्शन का इस्तेमाल करके स्कोर किया जाता है. विज्ञापन सबसे ज़्यादा स्कोर पाने वाले गेम. ध्यान दें कि यह प्रोसेस तब भी काम करती है, जब: रीमार्केटिंग विज्ञापन मौजूद हैं.

• अगर प्रासंगिक विज्ञापन नीलामी जीतता है और इंप्रेशन रिपोर्टिंग ऐप्लिकेशन, Protected Audience नाम का JS फ़ंक्शन डाउनलोड करता और उसे एक्ज़ीक्यूट करता है reportWin() को काम के विज्ञापन के डेटा में शामिल रिपोर्टिंग यूआरएल से लिया गया है. यह ठीक उसी तरह है जैसे किसी रीमार्केटिंग विज्ञापन को जीतने वाले नीलामी.

  JavaScript रिपोर्टिंग फ़ंक्शन का उदाहरण:

  function reportWin(ad_selection_signals, per_buyer_signals, signals_for_buyer,
  contextual_signals) {
  let reporting_address = 'https://reporting.example.com';
  return {'status': 0, 'results': {'reporting_uri':
       reporting_address + '?some_signal=' + per_buyer_signals.some_signal} };
  }
  

कॉन्टेंट के हिसाब से विज्ञापन पर हस्ताक्षर करना

• काम के हिसाब से दिखाए जाने वाले जिन विज्ञापनों में ऐप्लिकेशन इंस्टॉल फ़िल्टर करने की सुविधा शामिल है उन्हें खरीदार. यह प्लैटफ़ॉर्म, इस हस्ताक्षर का इस्तेमाल विज्ञापन टेक्नोलॉजी की पुष्टि करने के लिए करता है कौन-सा फ़िल्टर लागू किया जा सकता है. यह है नुकसान पहुंचाने वाली विज्ञापन टेक्नोलॉजी को, किसी अन्य विज्ञापन टेक्नोलॉजी की पहचान का इस्तेमाल करने से रोकने के लिए ऐसा किया गया है आपको अन्य विज्ञापन टेक्नोलॉजी के ऐप्लिकेशन इंस्टॉल को फ़िल्टर करने की सुविधा के रजिस्ट्रेशन का फ़ायदा मिल सकता है.

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

• प्राइवसी सैंडबॉक्स आपसे पूछेगा कि विज्ञापन टेक्नोलॉजी से, विज्ञापन की उपलब्धता की पुष्टि की जाए तकनीक से इकट्ठा किया गया एंडपॉइंट है. ज़्यादा जानकारी के लिए मौजूदा और नई रजिस्टर की गई विज्ञापन टेक्नोलॉजी के लिए ज़रूरी कार्रवाई के बारे में ज़्यादा जानने के लिए, नाम रजिस्टर कराने के लिए निर्देश.

• लागू करने के लिए ज़्यादा जानकारी वाले निर्देशों के साथ एक डेवलपर गाइड पब्लिश करने में कैसे मदद मिलेगी.