एट्रिब्यूशन रिपोर्टिंग का इस्तेमाल शुरू करना

यहां देखें कि आपको कहां से शुरू करना है. इसमें सेटअप और खास जानकारी भी शामिल है.

कोई रिपोर्ट टाइप चुनें

Attribution Reporting API का इस्तेमाल करके, दो तरह की रिपोर्ट जनरेट की जा सकती हैं: इवेंट-लेवल और खास जानकारी वाली रिपोर्ट. एग्रीगेट या खास जानकारी वाली रिपोर्ट के मुकाबले, इवेंट-लेवल की रिपोर्ट को सेटअप करने की ज़रूरत कम होती है. इसलिए, शुरुआत करने के लिए यह एक बेहतर विकल्प हो सकता है. खास जानकारी वाली रिपोर्ट को एग्रीगेशन सेवा के साथ इंटिग्रेट करने की ज़रूरत होती है. हालांकि, इवेंट-लेवल की रिपोर्ट में ऐसा नहीं होता.

इवेंट-लेवल और खास जानकारी, दोनों के लिए रिपोर्टिंग सेट अप की जा सकती है. वे पूरक होते हैं.

इवेंट-लेवल की रिपोर्ट

इवेंट-लेवल की रिपोर्ट किसी खास विज्ञापन पर क्लिक या व्यू (विज्ञापन की ओर मौजूद) को कन्वर्ज़न साइड के डेटा से जोड़ती हैं. सभी साइटों पर उपयोगकर्ता की पहचान को सीमित करके, उपयोगकर्ता की निजता बनाए रखने के लिए, कन्वर्ज़न साइड का डेटा बहुत सीमित होता है और इसमें ज़्यादा जानकारी नहीं होती.

खास जानकारी वाली रिपोर्ट

खास जानकारी वाली रिपोर्ट, एक एट्रिब्यूशन रिपोर्टिंग एपीआई और प्राइवेट एग्रीगेशन एपीआई रिपोर्ट टाइप होती है. खास जानकारी वाली रिपोर्ट में, उपयोगकर्ता का एग्रीगेट किया गया डेटा शामिल होता है. इसमें ग़ैर-ज़रूरी आवाज़ों के साथ, कन्वर्ज़न की पूरी जानकारी वाला डेटा भी शामिल हो सकता है. खास जानकारी वाली रिपोर्ट में सभी रिपोर्ट शामिल होती हैं.

लागू करने का तरीका

आगे दिए गए तरीकों को आज़माकर देखें.

ध्यान दें कि किसी दिए गए इवेंट सोर्स के लिए, इवेंट-लेवल और इकट्ठा करने लायक, दोनों रिपोर्ट जनरेट की जा सकती हैं. डेमो में आपको प्रक्रिया के बारे में बताया जाता है.

इवेंट-लेवल की रिपोर्ट जनरेट करना

इवेंट-लेवल की रिपोर्ट जनरेट करने के लिए, कम से कम चरण यहां दिए गए हैं:

  1. सोर्स को रजिस्टर करें. निर्देशों के लिए, एट्रिब्यूशन सोर्स रजिस्टर करना लेख पढ़ें. ध्यान दें कि क्लिक और व्यू के लिए चरण अलग-अलग होते हैं.

  2. ट्रिगर रजिस्टर करें. निर्देशों के लिए, एट्रिब्यूशन ट्रिगर रजिस्टर करें लेख पढ़ें.

  3. इस यूआरएल के साथ एंडपॉइंट सेट अप करें:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
    post तरीका देखने के लिए, adtech.js में कोड का उदाहरण देखें. .well-known के बारे में ज़्यादा जानकारी यहां दी गई है.

इवेंट के लेवल की रिपोर्ट के बारे में ज़्यादा जानकारी यहां दी गई है.

खास जानकारी वाली रिपोर्ट जनरेट करना

खास जानकारी वाली रिपोर्ट जनरेट करने के लिए, इन हाई-लेवल चरणों का पालन करें:

  1. सोर्स को रजिस्टर करें. निर्देशों के लिए, एट्रिब्यूशन सोर्स रजिस्टर करना लेख पढ़ें. ध्यान दें कि क्लिक और व्यू के लिए चरण अलग-अलग होते हैं. ज़्यादा जानकारी, एट्रिब्यूशन सोर्स रजिस्ट्रेशन में देखी जा सकती है.

  2. ट्रिगर रजिस्टर करें. निर्देशों के लिए, एट्रिब्यूशन ट्रिगर रजिस्टर करें लेख पढ़ें.

  3. इस यूआरएल के साथ एग्रीगेट की जा सकने वाली रिपोर्ट के लिए एंडपॉइंट सेट अप करें:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution
    post तरीका देखने के लिए, adtech.js में कोड का उदाहरण देखें. .well-known के बारे में ज़्यादा जानकारी यहां दी गई है.

  4. एग्रीगेशन सेवा से रिपोर्ट को बैच बनाएं और भेजें, ताकि उन्हें आगे की प्रोसेस के लिए एग्रीगेशन सेवा में शामिल किया जा सके. इस तरह, खास जानकारी वाली रिपोर्ट तैयार की जाएंगी. बैच की गई एग्रीगेटेड रिपोर्ट देखें.

खास जानकारी वाली रिपोर्ट के बारे में ज़्यादा जानकारी यहां दी गई है.

एट्रिब्यूशन रिपोर्टिंग डीबग करने की सीरीज़ में, डीबग रिपोर्ट सेट अप करने का तरीका जानें.

खास जानकारी वाली रिपोर्ट से जुड़े अन्य कॉन्सेप्ट

लागू करने के तरीकों को समझने के अलावा, यहां दिए गए कॉन्सेप्ट से आपको खास जानकारी देने वाली रिपोर्ट की रणनीति बनाने में मदद मिलेगी:

वैकल्पिक चरण

  1. फ़िल्टर सेट अप करना (ज़रूरी नहीं):
    1. फ़िल्टर का इस्तेमाल करके पसंद के मुताबिक नियम तय करना में दिए गए निर्देशों का पालन करें.
    2. जानकारी देने वाले के ट्रिगर सेक्शन में, इकट्ठा की जा सकने वाली रिपोर्ट के लिए फ़िल्टर से जुड़ी जानकारी की समीक्षा करें.

सुविधा की पहचान का इस्तेमाल करना न भूलें

एपीआई का इस्तेमाल करने से पहले, अनुमतियों की नीति का इस्तेमाल करके यह पता लगाएं कि कहीं इसे पेज पर ब्लॉक तो नहीं किया गया है. ऐसा करने के लिए, नीचे दिया गया कोड चलाएं:

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // the Attribution Reporting API is enabled
}

अगर सुविधा की पहचान करने की जांच का नतीजा सही दिखता है, तो एपीआई को उस पेज (पेज) में अनुमति दी जाती है जहां जांच की जा रही है.

ध्यान दें कि सिर्फ़ इस जांच से इस बात की गारंटी नहीं मिलती कि उस पेज पर एपीआई का इस्तेमाल किया जा सकता है. ऐसा भी हो सकता है कि उपयोगकर्ता ने अपने ब्राउज़र की सेटिंग का इस्तेमाल करके, एपीआई को बंद कर दिया हो या उसके पास ऐसी अन्य सेटिंग हों जो एपीआई के इस्तेमाल को रोकती हों. उपयोगकर्ता की निजता को सुरक्षित रखने के लिए, प्रोग्राम की मदद से इसकी जांच करने का कोई तरीका नहीं है.

अगले चरण

अगर आप लागू करने के लिए तैयार हैं, तो ये दस्तावेज़ देखें:

सेटअप

बैकग्राउंड

डेमो और टूल

प्लानिंग करना

अगर आप अब भी प्लान बनाने की प्रक्रिया में हैं, तो इन दस्तावेज़ों को देखें: