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

यहां पर सेटअप और खास जानकारी के साथ शुरुआत करने का तरीका बताया गया है.

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

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

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

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

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

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

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

कार्यान्वयन

शुरू करने के लिए, यहां दिया गया तरीका आज़माएं.

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

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

इवेंट-लेवल की रिपोर्ट जनरेट करने के लिए, इन ज़रूरी चरणों को पूरा करें:

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

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

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

ज़्यादा जानकारी के लिए, इवेंट लेवल की रिपोर्ट की जानकारी देखें.

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

खास जानकारी वाली रिपोर्ट जनरेट करने के लिए, यह तरीका अपनाएं:

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

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

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

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

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

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

खास जानकारी में अतिरिक्त कॉन्सेप्ट को शामिल किया जाता है

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

वैकल्पिक चरण

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

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

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

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

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

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

अगले चरण

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

सेटअप

बैकग्राउंड

डेमो और टूल

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

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